Note
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
recipients 内の コマンド グループには、Unity カタログで共有受信者を管理するためのコマンドが含まれています。 「Delta Sharing とは」を参照してください。
databricks 受信者が作成する
メタストアでデルタ共有認証タイプの新しい受信エンティティを作成します。 呼び出し元はメタストア管理者であるか、メタストアに対する CREATE_RECIPIENT 特権を持っている必要があります。
databricks recipients create NAME AUTHENTICATION_TYPE [flags]
Arguments
NAME
受信者の名前。
AUTHENTICATION_TYPE
Delta Sharing の認証の種類。 サポートされている値: DATABRICKS、OAUTH_CLIENT_CREDENTIALS、OIDC_FEDERATION、TOKEN
オプション
--comment string
受信者に関する説明。
--data-recipient-global-metastore-id string
データ受信者によって提供されるグローバル Unity カタログメタストア ID。
--expiration-time int
トークンの有効期限のタイムスタンプ (エポック ミリ秒単位)。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
--owner string
受信者の所有者のユーザー名。
--sharing-code string
データ受信者によって提供される 1 回限りの共有コード。
databricks 受信者を削除
指定した受信者をメタストアから削除します。 呼び出し元は受信者の所有者である必要があります。
databricks recipients delete NAME [flags]
Arguments
NAME
受信者の名前。
オプション
databricks 受信者が取得する
次の場合は、メタストアから共有受信者を取得します。
- 呼び出し元は共有受信者の所有者です。
- またはメタストア管理者です。
databricks recipients get NAME [flags]
Arguments
NAME
受信者の名前。
オプション
databricks 受信者リスト
現在のメタストア内のすべての共有受信者を一覧表示します。
- 呼び出し元はメタストア管理者です。
- または呼び出し元が所有者です。
配列内の要素の特定の順序は保証されません。
databricks recipients list [flags]
Arguments
None
オプション
--data-recipient-global-metastore-id string
指定しない場合は、すべての受信者が返されます。
--max-results int
戻される受信者の最大数。
--page-token string
前のクエリに基づいて次のページに移動する不透明な改ページ トークン。
databricks 受信者のトークンをローテーションする
指定された受信者の Delta Sharing 認証トークンを、指定されたトークン情報でローテーションします。 呼び出し元は受信者の所有者である必要があります。
databricks recipients rotate-token NAME EXISTING_TOKEN_EXPIRE_IN_SECONDS [flags]
Arguments
NAME
受信者の名前。
EXISTING_TOKEN_EXPIRE_IN_SECONDS
ISO 8601 形式のベアラー トークンの有効期限。 これにより、既存のトークンのexpiration_timeが小さいタイムスタンプにのみ設定され、expiration_timeを拡張することはできません。 既存のトークンをすぐに期限切れにするには 0 を使用します。負の値を指定するとエラーが返されます。
オプション
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
databricks 受信者情報の更新
メタストア内の既存の受信者を更新します。 呼び出し元は、メタストア管理者または受信者の所有者である必要があります。 受信者名が更新される場合、ユーザーはメタストア管理者と受信者の所有者の両方である必要があります。
databricks recipients update NAME [flags]
Arguments
NAME
受信者の名前。
オプション
--comment string
受信者に関する説明。
--expiration-time int
トークンの有効期限のタイムスタンプ (エポック ミリ秒単位)。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
--new-name string
受信者の新しい名前。
--owner string
受信者の所有者のユーザー名。
databricks 受信者の共有アクセス許可
指定した受信者の共有アクセス許可を取得します。 呼び出し元は、メタストア管理者または受信者の所有者である必要があります。
databricks recipients share-permissions NAME [flags]
Arguments
NAME
受信者の名前。
オプション
--max-results int
返されるアクセス許可の最大数。
--page-token string
前のクエリに基づいて次のページに移動する不透明な改ページ トークン。
グローバル フラグ
--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 文字列
該当する場合は、使用するバンドル ターゲット