schemas 命令组

The schemas command group within the Databricks CLI contains commands to manage schemas in Unity Catalog. 架构是 Unity 目录的三级命名空间的第二层。 架构组织表、视图和函数。 请参阅 Azure Databricks 中的架构是什么？。

databricks 架构创建

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

databricks schemas create NAME CATALOG_NAME [flags]

Arguments

NAME

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

CATALOG_NAME

    父目录的名称。

选项

--comment string

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

--json JSON

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

--storage-root string

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

Global flags

Examples

以下示例在目录中创建一analyticsmain个名为的新架构：

databricks schemas create analytics main

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

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

databricks 架构删除

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

databricks schemas delete FULL_NAME [flags]

Arguments

FULL_NAME

    架构的全名。

选项

--force

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

Global flags

Examples

以下示例删除架构：

databricks schemas delete main.analytics

以下示例强制删除架构，即使架构不为空：

databricks schemas delete main.analytics --force

databricks 架构获取

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

databricks schemas get FULL_NAME [flags]

Arguments

FULL_NAME

    架构的全名。

选项

--include-browse

    是否在主体只能访问其选择性元数据的响应中包含架构。

Global flags

Examples

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

databricks schemas get main.analytics

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

databricks schemas get main.analytics --include-browse

databricks 架构列表

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

databricks schemas list CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    感兴趣的架构的父目录。

选项

--include-browse

    是否在主体只能访问其选择性元数据的响应中包含架构。

--max-results int

    要返回的最大架构数。

--page-token string

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

Global flags

Examples

以下示例列出目录中的所有架构 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]

Arguments

FULL_NAME

    架构的全名。

选项

--comment string

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

--enable-predictive-optimization EnablePredictiveOptimization

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

--json JSON

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

--new-name string

    架构的新名称。

--owner string

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

Global flags

Examples

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

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

Global flags

--debug

  是否启用调试日志记录。

-h 或 --help

    显示 Databricks CLI、相关命令组或相关命令的帮助。

--log-file 字符串

    一个字符串，表示要将输出日志写入到的文件。 如果未指定此标志，则默认会将输出日志写入到 stderr。

--log-format 格式

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

--log-level 字符串

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

-o, --output 类型

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

-p, --profile 字符串

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

--progress-format 格式

    显示进度日志的格式： default、 append、 inplace或 json

-t, --target 字符串

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