providers 命令组

providers Databricks CLI 中的命令组包含用于管理 Delta 共享提供程序的命令。 数据提供者代表现实世界中共享数据的组织。 请参阅什么是 Delta Sharing？。

databricks 提供者创建

至少基于名称和身份验证类型创建新的身份验证提供程序。 调用方必须是元存储上的管理员。

databricks providers create NAME AUTHENTICATION_TYPE [flags]

Arguments

NAME

    提供程序的名称。

AUTHENTICATION_TYPE

    增量共享身份验证类型。 支持的值：DATABRICKS、OAUTH_CLIENT_CREDENTIALS、OIDC_FEDERATION、TOKEN

选项

--comment string

    有关提供商的说明。

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件。

--recipient-profile-str string

    当authentication_type是TOKEN、OAUTH_CLIENT_CREDENTIALS或者未提供时，此字段是必需的。

全局标志

Examples

以下示例使用 TOKEN 身份验证创建提供程序：

databricks providers create my_provider TOKEN --comment "My data provider" --recipient-profile-str "my_profile"

以下示例使用 DATABRICKS 身份验证创建提供程序：

databricks providers create my_provider DATABRICKS --comment "Internal provider"

databricks 提供程序删除

如果调用方是元存储管理员或提供程序的所有者，请删除身份验证提供程序。

databricks providers delete NAME [flags]

Arguments

NAME

    提供程序的名称。

选项

全局标志

Examples

以下示例删除提供程序：

databricks providers delete my_provider

databricks 提供程序获取

获取特定的身份验证提供程序。 调用方必须提供提供程序的名称，并且必须是元存储管理员或提供程序的所有者。

databricks providers get NAME [flags]

Arguments

NAME

    提供程序的名称。

选项

全局标志

Examples

以下示例获取服务提供商的详细信息：

databricks providers get my_provider

databricks 提供者列表

列出可用的身份验证提供程序。 调用方必须是元存储管理员或提供程序的所有者。 响应中不包括非调用方拥有的提供程序。 不能保证数组中元素的特定排序。

databricks providers list [flags]

选项

--data-provider-global-metastore-id string

    如果未提供，将返回所有提供程序。

--max-results int

    要返回的提供程序的最大数量。

--page-token string

    基于先前查询转到下一页的不透明分页令牌。

全局标志

Examples

以下示例列出所有提供者：

databricks providers list

以下示例列出带有分页的供应商：

databricks providers list --max-results 10

以下示例列出了特定的元存储的供应商：

databricks providers list --data-provider-global-metastore-id "my-metastore-id"

databricks 提供程序列出提供者共享资产

列出与指定提供程序的份额相关的资产。 调用方是共享的接收者。

databricks providers list-provider-share-assets PROVIDER_NAME SHARE_NAME [flags]

Arguments

PROVIDER_NAME

    拥有共享的提供程序的名称。

SHARE_NAME

    共享的名称。

选项

--function-max-results int

    要返回的最大函数数。

--notebook-max-results int

    要返回的笔记本的最大数量。

--table-max-results int

    要返回的表的最大数量。

--volume-max-results int

    要返回的卷的最大数量。

全局标志

Examples

以下示例列出提供者共享目录中的所有资产：

databricks providers list-provider-share-assets my_provider my_share

以下示例列出了对每种类型有限制的资产：

databricks providers list-provider-share-assets my_provider my_share --table-max-results 5 --function-max-results 3

databricks providers 列出共享

列出元存储中指定提供程序的共享（其中：

• 调用方是元存储管理员，
• 或调用方是所有者。

databricks providers list-shares NAME [flags]

Arguments

NAME

    要列出其共享的提供程序的名称。

选项

--max-results int

    要返回的共享的最大数量。

--page-token string

    基于先前查询转到下一页的不透明分页令牌。

全局标志

Examples

以下示例列出提供程序的所有共享：

databricks providers list-shares my_provider

以下示例列出带分页的共享：

databricks providers list-shares my_provider --max-results 10

Databricks 提供程序更新

如果调用方是元存储管理员或提供程序的所有者，请更新身份验证提供程序的信息。 如果更新更改了提供程序名称，则调用方必须是元存储管理员和提供程序的所有者。

databricks providers update NAME [flags]

Arguments

NAME

    提供程序的名称。

选项

--comment string

    有关提供商的说明。

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件。

--new-name string

    服务提供商的新名称。

--owner string

    提供者所有者的用户名

--recipient-profile-str string

    当authentication_type是TOKEN、OAUTH_CLIENT_CREDENTIALS或者未提供时，此字段是必需的。

全局标志

Examples

以下示例更新供应商的评论：

databricks providers update my_provider --comment "Updated provider description"

以下示例更新提供程序的名称和所有者：

databricks providers update my_provider --new-name "my_new_provider" --owner "new_owner@example.com"

全局标志

--debug

  是否启用调试日志记录。

-h 或 --help

    显示 Databricks CLI、相关命令组或相关命令的帮助。

--log-file 字符串

    一个字符串，表示要将输出日志写入到的文件。 如果未指定此标志，则默认会将输出日志写入到 stderr。

--log-format 格式

    日志格式类型，text 或 json。 默认值是 text。

--log-level 字符串

    一个表示日志格式级别的字符串。 如果未指定，则禁用日志格式级别。

-o, --output 类型

    命令输出类型为text或json。 默认值是 text。

-p, --profile 字符串

     ~/.databrickscfg 文件中用于运行命令的配置文件的名称。 如果未指定此标志，则如果存在，将使用名为 DEFAULT 的配置文件。

--progress-format 格式

    显示进度日志的格式： default、 append、 inplace或 json

-t, --target 字符串

    如适用，要使用的捆绑包目标