注释
此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明，包括任何数据使用规定。
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 字符串
如果适用，要使用的捆绑包目标