metastores 命令组

metastoresDatabricks CLI 中的命令组允许您管理元存储。 元存储是 Unity Catalog 中对象的顶级容器。 它存储数据资产（表和视图）以及管理访问权限的规则。 请参阅元存储。

databricks 元存储分配

创建新的元存储分配。 如果存在相同的 workspace_id 分配，它将被新的 metastore_id 和 default_catalog_name 覆盖。 调用方必须是帐户管理员。

databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]

论据

WORKSPACE_ID

    工作区 ID。

METASTORE_ID

    元存储的唯一 ID。

DEFAULT_CATALOG_NAME

    已弃用。 使用“默认命名空间 API”为 Databricks 工作区配置默认目录。 元存储中默认目录的名称。

选项

--json JSON

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

全局标志

例子

以下示例将一个元存储分配给一个工作区：

databricks metastores assign 123456789 abc123-def456-ghi789 main

databricks 元存储创建

基于提供的名称和可选的存储根路径创建新的元存储。 默认情况下（如果未设置所有者字段），新元存储的所有者是调用 createMetastore API 的用户。 如果所有者字段设置为空字符串（""），则所有权将改为分配给系统用户。

databricks metastores create NAME [flags]

论据

NAME

    元存储的用户指定名称。

选项

--json JSON

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

--region string

    元存储提供服务的云区域（例如 china-east-2、chinaeast2）。

--storage-root string

    元存储的存储根 URL。

全局标志

例子

以下示例将创建一个带有名称和存储根路径的元存储库：

databricks metastores create my-metastore --storage-root s3://my-bucket/metastore-root --region us-west-2

databricks 当前元数据存储

获取要访问的工作区的元存储分配。

databricks metastores current [flags]

选项

全局标志

例子

以下示例获取当前元存储分配：

databricks metastores current

databricks 元存储删除

删除元数据存储。 调用方必须是元存储管理员。

databricks metastores delete ID [flags]

论据

ID

    元存储的唯一 ID。

选项

--force

    即使元存储不为空，也必须强制删除。

全局标志

例子

以下示例删除元存储：

databricks metastores delete abc123-def456-ghi789

以下示例强制删除元存储，即使它不为空：

databricks metastores delete abc123-def456-ghi789 --force

databricks 元存储读取

获取与指定 ID 匹配的元数据存储。 调用方必须是元存储管理员才能检索此信息。

databricks metastores get ID [flags]

论据

ID

    元存储的唯一 ID。

选项

全局标志

例子

以下示例展示如何获取特定元存储的信息：

databricks metastores get abc123-def456-ghi789

databricks 元存储列表

列出可用的元存储。 调用方必须是管理员才能检索此信息。 不能保证列表中项的特定排序。

databricks metastores list [flags]

选项

--max-results int

    要返回的元存储最大数量。

--page-token string

    不透明分页令牌根据上一个查询转到下一页。

全局标志

例子

以下示例列出所有可用的元存储：

databricks metastores list

以下示例列出具有分页的元存储：

databricks metastores list --max-results 10 --page-token abc123token

databricks 元数据存储摘要

获取有关Metastore的摘要信息。 此摘要包括存储凭据、云供应商、云区域和全局元存储 ID。

databricks metastores summary [flags]

选项

全局标志

例子

以下示例获取元存储摘要：

databricks metastores summary

databricks 元存储未分配

删除元存储库分配关系。 调用方必须是帐户管理员。

databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]

论据

WORKSPACE_ID

    工作区 ID。

METASTORE_ID

    查询要删除的元存储的 ID。

选项

全局标志

例子

以下示例将工作区与元存储解除关联：

databricks metastores unassign 123456789 abc123-def456-ghi789

databricks Metastores（元存储）更新

更新特定元存储的信息。 调用方必须是元存储管理员。如果所有者字段设置为空字符串（""），则所有权将更新为系统用户。

databricks metastores update ID [flags]

论据

ID

    元存储的唯一 ID。

选项

--delta-sharing-organization-name string

    用于 Databricks 到 Databricks Delta 共享中的增量共享实体的组织名称，将作为官方名称使用。

--delta-sharing-recipient-token-lifetime-in-seconds int

    增量共享收件人令牌的有效时间（以秒为单位）。

--delta-sharing-scope DeltaSharingScopeEnum

    为 metastore 启用 Delta Sharing 的范围。 支持的值：INTERNAL、INTERNAL_AND_EXTERNAL

--json JSON

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

--new-name string

    元存储的新名称。

--owner string

    元存储的所有者。

--privilege-model-version string

    元存储的特权模型版本，格式为 major.minor（例如 1.0）。

--storage-root-credential-id string

    用于访问元存储库 storage_root 的存储凭据的 UUID。

全局标志

例子

以下示例更新元存储名称：

databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore

以下示例使用 Delta Sharing 配置更新一个元存储：

databricks metastores update abc123-def456-ghi789 --delta-sharing-scope INTERNAL_AND_EXTERNAL --delta-sharing-organization-name my-org

databricks 元存储更新分配

更新元存储分配。 如果工作区已分配元存储，则此操作可用于更新指定工作区的 metastore_id 或 default_catalog_name。 调用方必须是帐户管理员才能更新 metastore_id;否则，呼叫者可以是工作区管理员。

databricks metastores update-assignment WORKSPACE_ID [flags]

论据

WORKSPACE_ID

    工作区 ID。

选项

--default-catalog-name string

    元存储中默认目录的名称。

--json JSON

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

--metastore-id string

    元存储的唯一 ID。

全局标志

例子

以下示例更新元存储分配的默认分类目录：

databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog

以下示例更新元存储分配的元存储 ID。

databricks metastores update-assignment 123456789 --metastore-id new-metastore-id

全局标志

--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 字符串

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