注释
此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明,包括任何数据使用规定。
providers
Databricks CLI 中的命令组包含用于管理 Delta 共享提供程序的命令。 数据提供者代表现实世界中共享数据的组织。 请参阅什么是 Delta Sharing?。
databricks 供应商创建
根据最低要求,仅基于名称和身份验证类型创建一个新的身份验证提供程序。 调用方必须是元存储上的管理员。
databricks providers create NAME AUTHENTICATION_TYPE [flags]
论据
NAME
提供程序的名称。
AUTHENTICATION_TYPE
增量共享身份验证类型。 支持的值:DATABRICKS
、OAUTH_CLIENT_CREDENTIALS
、OIDC_FEDERATION
、TOKEN
选项
--comment string
有关提供商的说明。
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
--recipient-profile-str string
当authentication_type
是TOKEN
、OAUTH_CLIENT_CREDENTIALS
或者未提供时,此字段是必需的。
例子
以下示例使用 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]
论据
NAME
提供程序的名称。
选项
例子
以下示例删除提供程序:
databricks providers delete my_provider
databricks 提供者列表获取
获取特定的身份验证提供程序。 调用方必须提供提供程序的名称,并且必须是元存储管理员或提供程序的所有者。
databricks providers get NAME [flags]
论据
NAME
提供程序的名称。
选项
例子
以下示例获取服务提供商的详细信息:
databricks providers get my_provider
databricks 提供者列表
列出可用的身份验证提供程序。 调用方必须是元存储管理员或提供程序的所有者。 调用方不拥有的提供程序不包括在响应中。 不能保证数组中元素的特定排序。
databricks providers list [flags]
选项
--data-provider-global-metastore-id string
如果未提供,将返回所有提供者。
--max-results int
要返回的提供程序的最大数量。
--page-token string
不透明分页令牌根据上一个查询转到下一页。
例子
以下示例列出所有提供者:
databricks providers list
以下示例列出带有分页的供应商:
databricks providers list --max-results 10
以下示例列出了特定的元存储的供应商:
databricks providers list --data-provider-global-metastore-id "my-metastore-id"
databricks providers 列出提供者共享资产
列出与指定提供程序的份额相关的资产。 调用方是共享的接收方。
databricks providers list-provider-share-assets PROVIDER_NAME SHARE_NAME [flags]
论据
PROVIDER_NAME
共享拥有者的提供者名称。
SHARE_NAME
共享的名称。
选项
--function-max-results int
要返回的最大函数数。
--notebook-max-results int
要返回的最大笔记本数。
--table-max-results int
要返回的最大表数。
--volume-max-results int
要返回的最大卷数。
例子
以下示例列出提供者共享目录中的所有资产:
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 提供者 list-shares
列出元数据存储中的指定提供者的共享内容,其中:
- 调用方是元存储管理员,
- 或调用方是所有者。
databricks providers list-shares NAME [flags]
论据
NAME
要列出的股票代码的提供商名称。
选项
--max-results int
要返回的最大共享数。
--page-token string
不透明分页令牌根据上一个查询转到下一页。
例子
以下示例列出提供程序的所有共享:
databricks providers list-shares my_provider
以下示例列出具有分页的股份:
databricks providers list-shares my_provider --max-results 10
databricks 提供程序更新
如果调用方是元存储管理员或提供程序的所有者,请更新身份验证提供程序的信息。 如果更新更改了提供程序名称,则调用方必须是元存储管理员和提供程序的所有者。
databricks providers update NAME [flags]
论据
NAME
提供程序的名称。
选项
--comment string
有关提供商的说明。
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
--new-name string
服务提供商的新名称。
--owner string
提供者所有者的用户名
--recipient-profile-str string
当authentication_type
是TOKEN
、OAUTH_CLIENT_CREDENTIALS
或者未提供时,此字段是必需的。
例子
以下示例更新供应商的评论:
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
字符串
如果适用,要使用的捆绑包目标