通过

temporary-path-credentials 命令组

注释

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

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

temporary-path-credentials Databricks CLI 中的命令组包含用于生成用于访问 Databricks 中注册的外部云存储位置的短期缩减凭据的命令。 这些凭据提供对云环境中数据（如 AWS、Azure 和 Google Cloud）的安全和限时访问。 请参阅用于外部系统访问的 Unity Catalog 凭证售卖。

databricks temporary-path-credentials generate-temporary-path-credentials

生成生存期较短的凭据，用于直接访问 Databricks 中注册的云存储位置。 仅外部存储路径（特别是外部位置和外部表）支持生成临时路径凭据 API。 此 API 不支持托管表。

元存储 必须external_access_enabled标志 设置为 true（默认值 false）。 调用方必须对外部位置具有 EXTERNAL_USE_LOCATION 权限;此权限只能由外部位置所有者授予。 对于对现有外部表的请求，调用方还必须对父架构具有 EXTERNAL_USE_SCHEMA 特权;此权限只能由目录所有者授予。

databricks temporary-path-credentials generate-temporary-path-credentials URL OPERATION [flags]

Arguments

URL

    基于路径的访问的 URL。

OPERATION

    在路径上执行的作。 支持的值： PATH_CREATE_TABLE、 PATH_READ、 PATH_READ_WRITE。

选项

--dry-run

    用于测试请求而不生成凭据的可选标志。

--json JSON

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

全局标志

示例

以下示例生成用于读取对 S3 位置的读取访问权限的临时凭据：

databricks temporary-path-credentials generate-temporary-path-credentials s3://my-bucket/my-path PATH_READ

以下示例生成用于对 Azure 存储位置的读写访问的临时凭据：

databricks temporary-path-credentials generate-temporary-path-credentials abfss://container@storage.dfs.core.chinacloudapi.cn/path PATH_READ_WRITE

以下示例生成用于在 GCS 位置创建表的临时凭据：

databricks temporary-path-credentials generate-temporary-path-credentials gs://my-bucket/my-path PATH_CREATE_TABLE

以下示例执行试运行以测试请求：

databricks temporary-path-credentials generate-temporary-path-credentials s3://my-bucket/my-path PATH_READ --dry-run

以下示例使用 JSON 生成凭据：

databricks temporary-path-credentials generate-temporary-path-credentials s3://my-bucket/my-path PATH_READ --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 字符串

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

  • Last updated on