注释
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明,包括任何数据使用规定。
permissions
CLI 中的命令组允许管理不同对象上各种用户的访问控制,包括以下内容:
应用权限 管理哪些用户可以管理或使用应用。
群集权限 管理哪些用户可以管理、重启或附加到群集。
群集策略权限 管理哪些用户可以使用群集策略。
管道权限 管理哪些用户可以查看、管理、运行、取消或拥有管道。
作业权限 管理哪些用户可以查看、管理、触发、取消或拥有作业。
MLflow 试验权限 管理哪些用户可以读取、编辑或管理 MLflow 试验。
MLflow 已注册的模型权限管理哪些用户可以读取、编辑或管理 MLflow 注册的模型。
密码权限 管理启用 SSO 时可以使用密码登录的用户。
实例池权限 管理哪些用户可以管理或附加到池。
存储库权限 管理哪些用户可以读取、运行、编辑或管理存储库。
提供终结点权限 管理哪些用户可以查看、查询或管理服务终结点。
SQL 仓库权限 管理哪些用户可以使用或管理 SQL 仓库。
令牌权限 - 管理哪些用户可以创建或使用令牌。
工作区对象权限 管理哪些用户可以读取、运行、编辑或管理警报、dbsql 仪表板、目录、文件、笔记本和查询。
有关特定操作或功能及其他重要信息所需权限的映射,请参阅 访问控制。
若要管理服务主体上的access control,请使用帐户访问控制代理。
databricks 权限获取
获取对象的权限。 对象可以从其父对象或根对象继承权限。
databricks permissions get REQUEST_OBJECT_TYPE REQUEST_OBJECT_ID [flags]
论据
REQUEST_OBJECT_TYPE
请求对象的类型。 可以是以下之一:alerts, alertsv2, authorization, clusterscluster-policiesdashboardsdatabase-projectsdbsql-dashboardsdirectoriesexperimentsfilesgenieinstance-poolsjobsknowledge-assistantsnotebookspipelinesqueriesregistered-modelsreposserving-endpointssupervisor-agentsvector-search-endpoints或 。warehouses
REQUEST_OBJECT_ID
请求对象的 ID。
选项
例子
以下示例获取特定作业的权限:
databricks permissions get jobs 12345
以下示例获取群集的权限:
databricks permissions get clusters cluster-id-123
以下示例获取笔记本的权限:
databricks permissions get notebooks /Users/someone@example.com/my-notebook
databricks 权限设置
设置对象权限。
设置对象的权限,替换现有权限(如果存在)。 如果未指定任何权限,则删除所有直接权限。 对象可以从其父对象或根对象继承权限。
databricks permissions set REQUEST_OBJECT_TYPE REQUEST_OBJECT_ID [flags]
论据
REQUEST_OBJECT_TYPE
请求对象的类型。 可以是以下之一:alerts, alertsv2, authorization, clusterscluster-policiesdashboardsdatabase-projectsdbsql-dashboardsdirectoriesexperimentsfilesgenieinstance-poolsjobsknowledge-assistantsnotebookspipelinesqueriesregistered-modelsreposserving-endpointssupervisor-agentsvector-search-endpoints或 。warehouses
REQUEST_OBJECT_ID
请求对象的 ID。
选项
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件
例子
以下示例使用 JSON 设置作业的权限:
databricks permissions set jobs 12345 --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_MANAGE"}]}'
以下示例使用 JSON 文件设置群集的权限:
databricks permissions set clusters cluster-id-123 --json @permissions.json
databricks 权限更新
更新对象权限。
更新对象的权限。 对象可以从其父对象或根对象继承权限。
databricks permissions update REQUEST_OBJECT_TYPE REQUEST_OBJECT_ID [flags]
论据
REQUEST_OBJECT_TYPE
请求对象的类型。 可以是以下之一:alerts, alertsv2, authorization, clusterscluster-policiesdashboardsdatabase-projectsdbsql-dashboardsdirectoriesexperimentsfilesgenieinstance-poolsjobsknowledge-assistantsnotebookspipelinesqueriesregistered-modelsreposserving-endpointssupervisor-agentsvector-search-endpoints或 。warehouses
REQUEST_OBJECT_ID
请求对象的 ID。
选项
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件
例子
以下示例展示了如何更新一个作业的权限:
databricks permissions update jobs 12345 --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_VIEW"}]}'
以下示例更新管道的权限:
databricks permissions update pipelines pipeline-id-456 --json @update-permissions.json
databricks 权限 获取权限级别
获取用户可以对对象拥有的权限级别。
databricks permissions get-permission-levels REQUEST_OBJECT_TYPE REQUEST_OBJECT_ID [flags]
论据
REQUEST_OBJECT_TYPE
请求对象的类型。 可以是以下之一:alerts, alertsv2, authorization, clusterscluster-policiesdashboardsdatabase-projectsdbsql-dashboardsdirectoriesexperimentsfilesgenieinstance-poolsjobsknowledge-assistantsnotebookspipelinesqueriesregistered-modelsreposserving-endpointssupervisor-agentsvector-search-endpoints或 。warehouses
REQUEST_OBJECT_ID
请求对象的 ID。
选项
例子
以下示例获取作业的可用权限级别:
databricks permissions get-permission-levels jobs 12345
以下示例获取群集的可用权限级别:
databricks permissions get-permission-levels clusters cluster-id-123
全局标志
--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 字符串
如果适用,要使用的捆绑包目标