다음을 통해 공유

workspace 命令组

注释

此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。

Databricks CLI 的使用须遵守 Databricks 许可Databricks 隐私声明,包括任何数据使用规定。

workspace CLI 中的命令组允许列出、导入、导出和删除工作区文件和文件夹。 请参阅什么是工作区文件?

databricks 工作区删除

删除工作区对象。

删除对象或目录(并选择性地递归删除目录中的所有对象)。 如果路径不存在,此调用将返回错误 RESOURCE_DOES_NOT_EXIST。 如果路径为非空目录,且递归设置为 false,则此调用将返回错误 DIRECTORY_NOT_EMPTY

对象删除不能撤消,以递归方式删除目录不是原子的。

databricks workspace delete PATH [flags]

论据

PATH

    笔记本或目录的绝对路径。

选项

--json JSON

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

--recursive

    指定是否以递归方式删除对象的标志。

全局标志

databricks 工作区导出

导出工作区对象或整个目录的内容。

如果路径不存在,此调用将返回错误 RESOURCE_DOES_NOT_EXIST

如果导出的数据超出大小限制,则此调用将 MAX_NOTEBOOK_SIZE_EXCEEDED返回。 目前,此 API 不支持导出库。

databricks workspace export SOURCE_PATH [flags]

论据

PATH

    对象或目录的绝对路径。 仅 DBC、SOURCE 和 AUTO 格式支持导出目录。

选项

--file string

    用于保存导出文件的本地文件系统上的路径。

--format ExportFormat

    这指定导出的文件的格式。 支持的值:AUTO、、、DBCHTMLJUPYTERRAW、、 R_MARKDOWNSOURCE

全局标志

databricks 工作区导出目录

以递归方式将目录从 Databricks 工作区导出到本地文件系统。

databricks workspace export-dir SOURCE_PATH TARGET_PATH [flags]

论据

SOURCE_PATH

    工作区中的源目录路径

TARGET_PATH

    本地文件系统上的目标目录路径

选项

--overwrite

    覆盖现有本地文件

全局标志

databricks 工作区 获取状态

获取对象或目录的状态。 如果路径不存在,此调用将返回错误 RESOURCE_DOES_NOT_EXIST

databricks workspace get-status PATH [flags]

论据

PATH

    笔记本或目录的绝对路径。

选项

全局标志

Databricks 工作区导入

导入工作区对象(例如笔记本或文件)或整个目录的内容。 如果路径已存在且覆盖设置为 false,则此调用将返回错误 RESOURCE_ALREADY_EXISTS。 要导入目录,可以使用DBC格式或未设置语言字段的SOURCE格式。 若要导入单个文件 SOURCE,必须设置语言字段。

databricks workspace import TARGET_PATH [flags]

论据

PATH

    对象或目录的绝对路径。 仅 DBCSOURCE 格式支持导入目录。

选项

--content string

    base64 编码的内容。

--file string

    要导入的本地文件的路径

--format ImportFormat

    这指定要导入的文件的格式。 支持的值:AUTO、、、DBCHTMLJUPYTERRAW、、 R_MARKDOWNSOURCE

--json JSON

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

--language Language

    对象的语言。 支持的值:PYTHONRSCALASQL

--overwrite

    指定是否覆盖现有对象的标志。

全局标志

databricks 工作区 导入目录

以递归方式将目录从本地文件系统导入 Databricks 工作区。

笔记本的插件将被移除。

databricks workspace import-dir SOURCE_PATH TARGET_PATH [flags]

论据

SOURCE_PATH

    本地文件系统上的源目录路径

TARGET_PATH

    工作区中的目标目录路径

选项

--overwrite

    将现有工作区文件覆盖

全局标志

databricks 工作区列表

列出目录的内容,或对象(如果不是目录)。 如果输入路径不存在,此调用将返回错误 RESOURCE_DOES_NOT_EXIST

databricks workspace list PATH [flags]

论据

PATH

    笔记本或目录的绝对路径。

选项

--notebooks-modified-after int

    UTC 时间戳(以毫秒为单位)。

全局标志

databricks 工作区 mkdirs

创建指定的目录(如果它们不存在)和必要的父目录。 如果输入路径的任何前缀处有对象(不是目录),则此调用将返回错误 RESOURCE_ALREADY_EXISTS

请注意,如果此操作失败,则可能已经成功创建了一些必要的父目录。

databricks workspace mkdirs PATH [flags]

论据

PATH

    目录的绝对路径。 如果父目录不存在,它还会创建它们。 如果目录已存在,此命令不会执行任何操作并直接成功。

选项

--json JSON

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

全局标志

databricks 工作区 get-permission-levels

获取工作区对象权限级别。

databricks workspace get-permission-levels WORKSPACE_OBJECT_TYPE WORKSPACE_OBJECT_ID [flags]

论据

WORKSPACE_OBJECT_TYPE

    要为其获取或管理权限的工作区对象类型。

WORKSPACE_OBJECT_ID

    要为其获取或管理权限的工作区对象。

选项

全局标志

databricks 工作区 获取权限

获取工作区对象的权限。 工作区对象可以从其父对象或根对象继承权限。

databricks workspace get-permissions WORKSPACE_OBJECT_TYPE WORKSPACE_OBJECT_ID [flags]

论据

WORKSPACE_OBJECT_TYPE

    要为其获取或管理权限的工作区对象类型。

WORKSPACE_OBJECT_ID

    要为其获取或管理权限的工作区对象。

选项

全局标志

databricks 工作区设置权限

设置工作区对象权限。

设置对象的权限,替换现有权限(如果存在)。 如果未指定任何权限,则删除所有直接权限。 对象可以从其父对象或根对象继承权限。

databricks workspace set-permissions WORKSPACE_OBJECT_TYPE WORKSPACE_OBJECT_ID [flags]

论据

WORKSPACE_OBJECT_TYPE

    要为其获取或管理权限的工作区对象类型。

WORKSPACE_OBJECT_ID

    要为其获取或管理权限的工作区对象。

选项

--json JSON

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

全局标志

databricks 工作区更新权限

更新工作区对象的权限。 工作区对象可以从其父对象或根对象继承权限。

databricks workspace update-permissions WORKSPACE_OBJECT_TYPE WORKSPACE_OBJECT_ID [flags]

论据

WORKSPACE_OBJECT_TYPE

    要为其获取或管理权限的工作区对象类型。

WORKSPACE_OBJECT_ID

    要为其获取或管理权限的工作区对象。

选项

--json JSON

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

全局标志

全局标志

--debug

  是否启用调试日志记录。

-h--help

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

--log-file 字符串

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

--log-format 格式

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

--log-level 字符串

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

-o, --output 类型

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

-p, --profile 字符串

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

--progress-format 格式

    显示进度日志的格式: defaultappendinplacejson

-t, --target 字符串

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