Note
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
storage-credentials 内の コマンド グループには、Unity カタログのストレージ資格情報を管理するためのコマンドが含まれています。 ストレージ資格情報は、クラウド テナントに格納されているデータにアクセスするための認証と承認のメカニズムを表します。 各ストレージ資格情報は、資格情報にアクセスできるユーザーとグループを制御する Unity カタログアクセス制御ポリシーの対象となります。 ユーザーが Unity カタログのストレージ資格情報にアクセスできない場合、要求は失敗し、Unity カタログはユーザーの代わりにクラウド テナントに対する認証を試みません。
ストレージの資格情報を管理するを参照してください。
databricks storage-credentials create (Note: No literal improvements were made as the terms seem to be specific to a technical command and should remain in English for accuracy and functionality.)
新しいストレージ資格情報を作成します。
呼び出し元はメタストア管理者であるか、メタストアに対する CREATE_STORAGE_CREDENTIAL 特権を持っている必要があります。
databricks storage-credentials create NAME [flags]
Arguments
NAME
資格情報名。 名前は、メタストア内のストレージ資格情報とサービス資格情報の間で一意である必要があります。
オプション
--comment string
資格情報に関連付けられているコメント。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
--read-only
資格情報が読み取り操作にのみ使用できるかどうか。
--skip-validation
この引数に true を指定すると、作成された資格情報の検証はスキップされます。
Examples
次の例では、新しいストレージ資格情報を作成します。
databricks storage-credentials create my-storage-credential
次の例では、コメントを含むストレージ資格情報を作成します。
databricks storage-credentials create my-storage-credential --comment "S3 credential for analytics data"
次の例では、読み取り専用ストレージ資格情報を作成します。
databricks storage-credentials create my-storage-credential --read-only
databricks ストレージ資格情報 削除
メタストアからストレージ資格情報を削除します。 呼び出し元は、ストレージ資格情報の所有者である必要があります。
databricks storage-credentials delete NAME [flags]
Arguments
NAME
ストレージ資格情報の名前。
オプション
--force
依存する外部の場所または外部テーブル (目的が STORAGEの場合) または依存サービス (目的が SERVICEされている場合) がある場合でも、強制的に更新します。
Examples
次の例では、ストレージ資格情報を削除します。
databricks storage-credentials delete my-storage-credential
次の例では、ストレージ資格情報を強制的に削除します。
databricks storage-credentials delete my-storage-credential --force
databricks storage-credentials get (データブリックスのストレージ資格情報を取得)
メタストアからストレージ資格情報を取得します。 呼び出し元は、メタストア管理者、ストレージ資格情報の所有者、またはストレージ資格情報に対する何らかのアクセス許可を持っている必要があります。
databricks storage-credentials get NAME [flags]
Arguments
NAME
ストレージ資格情報の名前。
オプション
Examples
次の例では、ストレージ資格情報に関する情報を取得します。
databricks storage-credentials get my-storage-credential
databricks storage-credentials list
ストレージ資格情報を一覧表示します。 リストは、呼び出し元がアクセス許可を持つストレージ資格情報のみに制限されます。 呼び出し元がメタストア管理者の場合、資格情報の取得は制限されません。 配列内の要素の特定の順序は保証されません。
databricks storage-credentials list [flags]
オプション
--max-results int
返されるストレージ資格情報の最大数。
--page-token string
前のクエリに基づいて次のページに移動する不透明な改ページ トークン。
Examples
次の例では、すべてのストレージ資格情報を一覧表示します。
databricks storage-credentials list
Databricksストレージ資格情報を更新する
メタストアのストレージ資格情報を更新します。
呼び出し元は、ストレージ資格情報またはメタストア管理者の所有者である必要があります。呼び出し元がメタストア管理者の場合は、 owner フィールドのみを変更できます。
databricks storage-credentials update NAME [flags]
Arguments
NAME
ストレージ資格情報の名前。
オプション
--comment string
資格情報に関連付けられているコメント。
--force
依存する外部の場所または外部テーブルがある場合でも、強制的に更新します。
--isolation-mode IsolationMode
現在のセキュリティ保護可能なリソースがすべてのワークスペースからアクセスできるか、特定のワークスペース のセットからアクセスできるか。 サポートされている値: [ISOLATION_MODE_ISOLATED,ISOLATION_MODE_OPEN]
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
--new-name string
ストレージ資格情報の新しい名前。
--owner string
資格情報の現在の所有者のユーザー名。
--read-only
資格情報が読み取り操作にのみ使用できるかどうか。
--skip-validation
この引数に true を指定すると、更新された資格情報の検証はスキップされます。
Examples
次の例では、ストレージ資格情報のコメントを更新します。
databricks storage-credentials update my-storage-credential --comment "Updated S3 credential"
次の例では、ストレージ資格情報の所有者を変更します。
databricks storage-credentials update my-storage-credential --owner someone@example.com
次の例では、ストレージ資格情報の名前を変更します。
databricks storage-credentials update my-storage-credential --new-name updated-credential
databricks ストレージ認証情報の検証
ストレージ資格情報を検証します。 少なくとも 1 つの external_location_name と url を指定する必要があります。 そのうちの 1 つだけが指定されている場合は、検証に使用されます。 また、両方が指定されている場合、 url は検証に使用され、重複する URL をチェックするときに external_location_name は無視されます。
storage_credential_nameまたはクラウド固有の資格情報を指定する必要があります。
呼び出し元は、メタストア管理者またはストレージ資格情報の所有者であるか、メタストアとストレージ資格情報に対する CREATE_EXTERNAL_LOCATION 特権を持っている必要があります。
databricks storage-credentials validate [flags]
オプション
--external-location-name string
検証する既存の外部の場所の名前。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
--read-only
ストレージ資格情報が読み取り操作でのみ使用できるかどうか。
--storage-credential-name string
Required.
--url string
検証する外部の場所の URL。
Examples
次の例では、外部の場所に対してストレージ資格情報を検証します。
databricks storage-credentials validate --storage-credential-name my-storage-credential --external-location-name my-external-location
次の例では、URL に対してストレージ資格情報を検証します。
databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path
グローバル フラグ
--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 文字列
該当する場合は、使用するバンドル ターゲット