注
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
Databricks CLI 内の temporary-path-credentials コマンド グループには、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]
論争
URL
パスベースのアクセスの URL。
OPERATION
パスで実行されている操作。 サポートされる値: PATH_CREATE_TABLE、 PATH_READ、 PATH_READ_WRITE。
オプション
--dry-run
資格情報を生成せずに要求をテストするための省略可能なフラグ。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path
例示
次の例では、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.windows.net/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 文字列
該当する場合は、使用するバンドル ターゲット