metastores 命令组

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

databricks 元存储分配

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

databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]

Arguments

WORKSPACE_ID

    工作区 ID。

METASTORE_ID

    元存储的唯一 ID。

DEFAULT_CATALOG_NAME

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

选项

--json JSON

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

全局标志

Examples

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

databricks metastores assign 123456789 abc123-def456-ghi789 main

创建 Databricks 元数据存储

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

databricks metastores create NAME [flags]

Arguments

NAME

    用户指定的元存储名称。

选项

--json JSON

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

--region string

    元存储提供服务的云区域（例如 us-west-2、westus）。

--storage-root string

    元存储的存储根 URL。

全局标志

Examples

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

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

databricks 元数据存储的当前状态

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

databricks metastores current [flags]

选项

全局标志

Examples

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

databricks metastores current

databricks 元存储删除

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

databricks metastores delete ID [flags]

Arguments

ID

    元存储的唯一 ID。

选项

--force

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

全局标志

Examples

以下示例删除元存储：

databricks metastores delete abc123-def456-ghi789

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

databricks metastores delete abc123-def456-ghi789 --force

databricks 元存储获取

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

databricks metastores get ID [flags]

Arguments

ID

    元存储的唯一 ID。

选项

全局标志

Examples

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

databricks metastores get abc123-def456-ghi789

databricks 元存储列表

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

databricks metastores list [flags]

选项

--max-results int

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

--page-token string

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

全局标志

Examples

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

databricks metastores list

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

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

databricks 元数据存储摘要

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

databricks metastores summary [flags]

选项

全局标志

Examples

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

databricks metastores summary

databricks 元存储解除分配

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

databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]

Arguments

WORKSPACE_ID

    工作区 ID。

METASTORE_ID

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

选项

全局标志

Examples

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

databricks metastores unassign 123456789 abc123-def456-ghi789

databricks 元数据存储更新

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

databricks metastores update ID [flags]

Arguments

ID

    元存储的唯一 ID。

选项

--delta-sharing-organization-name string

    增量共享实体的组织名称，在 Databricks 到 Databricks 增量共享中用作正式名称。

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

    增量共享接收者令牌的生存期（以秒为单位）。

--delta-sharing-scope DeltaSharingScopeEnum

    为元存储启用的增量共享的范围。 支持的值：INTERNAL、INTERNAL_AND_EXTERNAL

--json JSON

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

--new-name string

    元存储的新名称。

--owner string

    元存储的所有者。

--privilege-model-version string

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

--storage-root-credential-id string

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

全局标志

Examples

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

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]

Arguments

WORKSPACE_ID

    工作区 ID。

选项

--default-catalog-name string

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

--json JSON

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

--metastore-id string

    元存储的唯一 ID。

全局标志

Examples

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

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

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