注释
此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明，包括任何数据使用规定。
warehouses
CLI 中的命令组允许管理 SQL 仓库。 SQL 仓库是一种计算资源，可用于对 Databricks SQL 中的数据对象运行 SQL 命令。 请参阅连接到 SQL 仓库。
Databricks 仓库创建
创建新的 SQL 仓库。
databricks warehouses create [flags]
论据
没有
选项
--auto-stop-mins int
SQL 仓库在自动停止之前必须处于空闲状态（换句话说，无 RUNNING 查询）的时间（以分钟为单位）。
--cluster-size string
此仓库分配的集群大小。
--creator-name string
仓库创建者名称。
--enable-photon
配置仓库是否应使用 Photon 优化群集。
--enable-serverless-compute
配置仓库是否应使用无服务器计算。
--instance-profile-arn string
已弃用。
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
--max-num-clusters int
自动缩放程序将创建的群集的最大数目，用于处理并发查询。
--min-num-clusters int
将为此 SQL 仓库维护的可用群集的最小数量。
--name string
群集的逻辑名称。
--no-wait
不要等待达到“运行”状态
--spot-instance-policy SpotInstancePolicy
配置是否应让仓库使用现货实例。 支持的值：COST_OPTIMIZED、POLICY_UNSPECIFIED、RELIABILITY_OPTIMIZED
--timeout duration
达到 RUNNING 状态的最大时间（默认为 20 毫秒）
--warehouse-type CreateWarehouseRequestWarehouseType
仓库类型：PRO 或 CLASSIC。 支持的值：CLASSIC、PRO、TYPE_UNSPECIFIED
例子
以下示例使用基本配置创建新的 SQL 仓库：
databricks warehouses create --name "my-warehouse" --cluster-size "Small" --min-num-clusters 1 --max-num-clusters 10 --auto-stop-mins 60
以下示例创建启用了 Photon 的无服务器仓库：
databricks warehouses create --name "serverless-warehouse" --enable-serverless-compute --enable-photon --warehouse-type PRO
删除 Databricks 仓库
删除 SQL 仓库。
databricks warehouses delete ID [flags]
论据
ID
必填。 SQL 仓库的 ID。
选项
例子
以下示例删除具有指定 ID 的仓库：
databricks warehouses delete 1234567890abcdef
databricks 数据仓库编辑
更新仓库。 更新 SQL 仓库的配置。
databricks warehouses edit ID [flags]
论据
ID
必填。 要配置的仓库的 ID。
选项
--auto-stop-mins int
SQL 仓库在自动停止之前必须处于空闲状态（换句话说，无 RUNNING 查询）的时间（以分钟为单位）。
--cluster-size string
此仓库分配的集群大小。
--creator-name string
仓库创建者名称。
--enable-photon
配置仓库是否应使用 Photon 优化群集。
--enable-serverless-compute
配置仓库是否应使用无服务器计算。
--instance-profile-arn string
已弃用。
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
--max-num-clusters int
自动缩放程序将创建的群集的最大数目，用于处理并发查询。
--min-num-clusters int
将为此 SQL 仓库维护的可用群集的最小数量。
--name string
群集的逻辑名称。
--no-wait
不要等待到达 RUNNING 状态
--spot-instance-policy SpotInstancePolicy
配置是否应让仓库使用现货实例。 支持的值：COST_OPTIMIZED、POLICY_UNSPECIFIED、RELIABILITY_OPTIMIZED
--timeout duration
达到 RUNNING 状态的最大时间（默认为 20 毫秒）
--warehouse-type EditWarehouseRequestWarehouseType
仓库类型。 支持的值：CLASSIC、PRO、TYPE_UNSPECIFIED
例子
以下示例更新仓库以更改其群集大小和自动停止时间：
databricks warehouses edit 1234567890abcdef --cluster-size "Medium" --auto-stop-mins 30
以下示例为现有仓库启用 Photon：
databricks warehouses edit 1234567890abcdef --enable-photon
databricks 仓库获取
获取单个 SQL 仓库的信息。
databricks warehouses get ID [flags]
论据
ID
必填。 SQL 仓库的 ID。
选项
例子
以下示例获取有关具有指定 ID 的仓库的信息：
databricks warehouses get 1234567890abcdef
databricks 仓库列表
列出用户拥有管理权限的所有 SQL 仓库。
databricks warehouses list [flags]
论据
没有
选项
--run-as-user-id int
用于提取仓库列表的服务主体。
例子
以下示例列出所有仓库：
databricks warehouses list
以下示例使用特定服务主体列出仓库：
databricks warehouses list --run-as-user-id 123456789
启动Databricks仓库
启动 SQL 仓库。
databricks warehouses start ID [flags]
论据
ID
必填。 SQL 仓库的 ID。
选项
--no-wait
不要等待到达 RUNNING 状态
--timeout duration
达到 RUNNING 状态的最大时间（默认为 20 毫秒）
例子
以下示例启动具有指定 ID 的仓库：
databricks warehouses start 1234567890abcdef
以下示例启动一个仓库，而无需等待它达到 RUNNING 状态：
databricks warehouses start 1234567890abcdef --no-wait
databricks 仓库停止
停止 SQL 仓库。
databricks warehouses stop ID [flags]
论据
ID
必填。 SQL 仓库的 ID。
选项
--no-wait
不要等待到达 STOPPED 状态
--timeout duration
达到 STOPPED 状态的最大时间（默认为 20 毫秒）
例子
以下示例停止具有指定 ID 的仓库：
databricks warehouses stop 1234567890abcdef
以下示例停止仓库，而无需等待它达到 STOPPED 状态：
databricks warehouses stop 1234567890abcdef --no-wait
Databricks 仓库 获取工作区仓库配置
获取工作区中所有 SQL 仓库共享的工作区级别配置。
databricks warehouses get-workspace-warehouse-config [flags]
论据
没有
选项
例子
以下示例演示如何获取工作区仓库配置：
databricks warehouses get-workspace-warehouse-config
databricks 仓库 设置工作区仓库配置
设置工作区中所有 SQL 仓库共享的工作区级别配置。
databricks warehouses set-workspace-warehouse-config [flags]
论据
没有
选项
--google-service-account string
仅限 GCP：用于传递给群集以访问 Google 云存储的 Google 服务帐户。
--instance-profile-arn string
仅 AWS：用于将 IAM 角色传递给群集的实例配置文件。
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
--security-policy SetWorkspaceWarehouseConfigRequestSecurityPolicy
仓库的安全策略。 支持的值：DATA_ACCESS_CONTROL、NONE、PASSTHROUGH
例子
以下示例使用安全策略设置工作区仓库配置：
databricks warehouses set-workspace-warehouse-config --security-policy DATA_ACCESS_CONTROL
databricks 仓库获取权限级别
获取 SQL 仓库权限级别。
databricks warehouses get-permission-levels WAREHOUSE_ID [flags]
论据
WAREHOUSE_ID
要为其获取或管理权限的 SQL 仓库。
选项
例子
以下示例获取仓库的访问权限级别：
databricks warehouses get-permission-levels 1234567890abcdef
Databricks 仓库 get-permissions
获取 SQL 仓库的权限。 SQL 仓库可以从其根对象继承权限。
databricks warehouses get-permissions WAREHOUSE_ID [flags]
论据
WAREHOUSE_ID
要为其获取或管理权限的 SQL 仓库。
选项
例子
以下是获取仓库权限的示例：
databricks warehouses get-permissions 1234567890abcdef
Databricks 数据仓库 设置权限
设置 SQL 仓库权限。 设置对象的权限，替换现有权限（如果存在）。 如果未指定任何权限，则删除所有直接权限。 对象可以从其根对象继承权限。
databricks warehouses set-permissions WAREHOUSE_ID [flags]
论据
WAREHOUSE_ID
要为其获取或管理权限的 SQL 仓库。
选项
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
例子
以下示例使用 JSON 文件设置仓库的权限：
databricks warehouses set-permissions 1234567890abcdef --json @permissions.json
Databricks 仓库更新权限
更新对 SQL 仓库的权限。 SQL 仓库可以从其根对象继承权限。
databricks warehouses update-permissions WAREHOUSE_ID [flags]
论据
WAREHOUSE_ID
要为其获取或管理权限的 SQL 仓库。
选项
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
例子
以下示例使用 JSON 文件更新仓库的权限：
databricks warehouses update-permissions 1234567890abcdef --json @permissions.json
全局标志
--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 字符串
如果适用，要使用的捆绑包目标