schemas 命令组

schemas Databricks CLI 中的命令组包含用于管理 Unity 目录中架构的命令。 架构是Unity Catalog三层命名空间中的第二层。 架构用于组织表、视图和函数。 请参阅 Azure Databricks 中的架构是什么？。

databricks 模式创建

在元存储中为目录创建新架构。 调用方必须是元存储管理员，或具有 CREATE_SCHEMA 父目录中的权限。

databricks schemas create NAME CATALOG_NAME [flags]

论据

NAME

    相对于父目录的架构名称。

CATALOG_NAME

    父目录的名称。

选项

--comment string

    用户提供的自由格式文本说明。

--json JSON

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

--storage-root string

    架构中托管表的存储根目录 URL。

全局标志

例子

以下示例在analytics目录中创建一个名为main的新架构。

databricks schemas create analytics main

以下示例使用注释创建新的架构：

databricks schemas create analytics main --comment "Schema for analytics data"

删除 Databricks 模式

从父目录中删除指定的架构。 调用方必须是架构的所有者或父目录的所有者。

databricks schemas delete FULL_NAME [flags]

论据

FULL_NAME

    架构的全名。

选项

--force

    即使架构不为空，也强制删除。

全局标志

例子

以下示例删除架构：

databricks schemas delete main.analytics

以下示例将强制删除模式，即使该模式非空：

databricks schemas delete main.analytics --force

databricks 架构获取

获取元存储中的指定架构。 调用方必须是元存储管理员、架构的所有者或对架构具有 USE_SCHEMA 权限的用户。

databricks schemas get FULL_NAME [flags]

论据

FULL_NAME

    架构的全名。

选项

--include-browse

    是否在主体只能访问有限元数据的情况下包含在响应中的架构。

全局标志

例子

以下示例获取有关架构的信息：

databricks schemas get main.analytics

以下示例获取架构信息，包括浏览权限：

databricks schemas get main.analytics --include-browse

databricks 架构列表

列出元存储中目录的架构。 如果调用方是元存储管理员或父目录的所有者，则会检索目录的所有架构。 否则，只会检索调用方拥有的架构（或者调用方具有 USE_SCHEMA 权限的架构）。 不能保证数组中元素的特定排序。

databricks schemas list CATALOG_NAME [flags]

论据

CATALOG_NAME

    感兴趣的架构的父目录。

选项

--include-browse

    是否在主体只能访问有限元数据的情况下包含在响应中的架构。

--max-results int

    要返回的最大模式数。

--page-token string

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

全局标志

例子

以下示例列出 main 目录中的所有模式：

databricks schemas list main

以下示例列出了最多 10 个结果的架构：

databricks schemas list main --max-results 10

以下示例使用分页列出架构：

databricks schemas list main --page-token <token>

databricks 架构更新

更新目录的架构。 调用方必须是架构或元存储管理员的所有者。如果调用方是元存储管理员，则只能在 owner 更新中更改字段。 name如果字段必须更新，则调用方必须是元存储管理员或具有CREATE_SCHEMA父目录的权限。

databricks schemas update FULL_NAME [flags]

论据

FULL_NAME

    架构的全名。

选项

--comment string

    用户提供的自由格式文本说明。

--enable-predictive-optimization EnablePredictiveOptimization

    是否应为此对象及其下的对象启用预测优化。 支持的值：[DISABLE、ENABLE、INHERIT]

--json JSON

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

--new-name string

    架构的新名称。

--owner string

    架构的当前所有者的用户名。

全局标志

例子

以下示例更新架构的注释：

databricks schemas update main.analytics --comment "Updated analytics schema"

以下示例更改架构的所有权：

databricks schemas update main.analytics --owner someone@example.com

以下示例重命名架构：

databricks schemas update main.analytics --new-name analytics_v2

全局标志

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

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