Note
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明，包括任何数据使用规定。
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 OpenSharing 的 OpenSharing 实体的组织名称作为官方名称。
--delta-sharing-recipient-token-lifetime-in-seconds int
OpenSharing 收件人令牌的生存期（以秒为单位）。
--delta-sharing-scope DeltaSharingScopeEnum
为元存储启用 OpenSharing 的范围。 支持的值：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
以下示例使用 OpenSharing 配置更新元存储：
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 字符串
如适用，要使用的捆绑包目标