providers 命令组

注释

Databricks CLI 的使用须遵守 Databricks 许可Databricks 隐私声明,包括任何数据使用规定。

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

databricks 供应商创建

根据最低要求,仅基于名称和身份验证类型创建一个新的身份验证提供程序。 调用方必须是元存储上的管理员。

databricks providers create NAME AUTHENTICATION_TYPE [flags]

论据

NAME

    提供程序的名称。

AUTHENTICATION_TYPE

    OpenSharing 身份验证类型。 支持的值:DATABRICKSOAUTH_CLIENT_CREDENTIALSOIDC_FEDERATIONTOKEN

选项

--comment string

    有关提供商的说明。

--json JSON

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

--recipient-profile-str string

    当authentication_typeTOKENOAUTH_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_typeTOKENOAUTH_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 格式

    日志格式类型,textjson。 默认值是 text

--log-level 字符串

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

-o, --output 类型

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

-p, --profile 字符串

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

--progress-format 格式

    显示进度日志的格式: defaultappendinplacejson

-t, --target 字符串

    如果适用,要使用的捆绑包目标