workspace-bindings
コマンド グループ
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。Databricks CLI は パブリック プレビュー段階です。
Databricks CLI 使用には、使用状況データを含む Databricks ライセンス および Databricks プライバシー通知が適用されます。
Databricks CLI内のworkspace-bindings
コマンド グループには、Unity Catalogでセキュリティ保護可能なオブジェクトを構成 (バインド) するコマンドが含まれています。Databricks のセキュリティ保護対象は、 OPEN
または ISOLATED
として構成できます。OPEN
セキュリティ保護可能オブジェクトには任意のワークスペースからアクセスできますが、ISOLATED
セキュリティ保護オブジェクトには、ワークスペースの構成されたリストからのみアクセスできます。
バインディングをサポートするセキュリティ保護可能な型: catalog
、 storage_credential
、 credential
、 external_location
。
databricks workspace-bindings get
カタログのワークスペース バインディングを取得します。呼び出し元は、メタストア管理者またはカタログの所有者である必要があります。
databricks workspace-bindings get NAME [flags]
引数
NAME
カタログの名前。
オプション
例
次の例では、カタログのワークスペース バインディングを取得します。
databricks workspace-bindings get my_catalog
databricks workspace-bindings get-bindings
セキュリティ保護可能なワークスペース バインディングを取得します。呼び出し元は、メタストア管理者またはセキュリティ保護可能なオブジェクトの所有者である必要があります。
databricks workspace-bindings get-bindings SECURABLE_TYPE SECURABLE_NAME [flags]
引数
SECURABLE_TYPE
ワークスペースにバインドするセキュリティ保護可能なオブジェクトの種類 (カタログ、storage_credential、資格情報、またはexternal_location)。
SECURABLE_NAME
セキュリティ保護可能な名前。
オプション
--max-results int
返すワークスペース バインディングの最大数。
--page-token string
前のクエリに基づいて次のページに移動するための不透明なページネーショントークン。
例
次の例では、カタログのワークスペース バインディングを取得します。
databricks workspace-bindings get-bindings catalog my_catalog
次の例では、ページネーションを使用してストレージ資格情報のワークスペース バインディングを取得します。
databricks workspace-bindings get-bindings storage_credential my_storage_credential --max-results 10
次の例では、外部ロケーションのワークスペース バインディングを取得します。
databricks workspace-bindings get-bindings external_location my_external_location
databricks workspace-bindings update
カタログのワークスペース バインディングを更新します。呼び出し元は、メタストア管理者またはカタログの所有者である必要があります。
databricks workspace-bindings update NAME [flags]
引数
NAME
カタログの名前。
オプション
--json JSON
インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。
例
次の例では、JSON を使用してカタログのワークスペース バインディングを更新します。
databricks workspace-bindings update my_catalog --json '{"bindings": [{"workspace_id": 123456789, "binding_type": "BINDING_TYPE_READ_WRITE"}]}'
次の例では、JSON ファイルを使用してワークスペース バインディングを更新します。
databricks workspace-bindings update my_catalog --json @bindings.json
databricks workspace-bindings update-bindings
セキュリティ保護可能なワークスペース バインディングを更新します。呼び出し元は、メタストア管理者またはセキュリティ保護可能なオブジェクトの所有者である必要があります。
databricks workspace-bindings update-bindings SECURABLE_TYPE SECURABLE_NAME [flags]
引数
SECURABLE_TYPE
ワークスペースにバインドするセキュリティ保護可能なオブジェクトの種類 (カタログ、storage_credential、資格情報、またはexternal_location)。
SECURABLE_NAME
セキュリティ保護可能な名前。
オプション
--json JSON
インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。
例
次の例では、カタログのワークスペース・バインディングを更新します。
databricks workspace-bindings update-bindings catalog my_catalog --json '{"bindings": [{"workspace_id": 123456789, "binding_type": "BINDING_TYPE_READ_WRITE"}]}'
グローバルフラグ
--debug
デバッグログを有効にするかどうか。
-h
または --help
Databricks CLI、関連するコマンド グループ、または関連するコマンドのヘルプを表示します。
--log-file
string
出力ログの書き込み先となるファイルを表す文字列。このフラグが指定されていない場合、デフォルトでは出力ログが stderr に書き込まれます。
--log-format
format
ログ・フォーマット・タイプ ( text
または json
) 。デフォルト値は text
です。
--log-level
string
ログ形式レベルを表す文字列。指定しない場合、ログ・フォーマット・レベルは使用不可になります。
-o, --output
タイプ
コマンド出力タイプ text
または json
。デフォルト値は text
です。
-p, --profile
string
コマンドの実行に使用する ~/.databrickscfg
ファイル内のプロファイルの名前。このフラグが指定されていない場合、存在する場合は、 DEFAULT
という名前のプロファイルが使用されます。
--progress-format
format
進行状況ログを表示する形式: default
、 append
、 inplace
、 json
-t, --target
string
該当する場合は、使用するバンドル・ターゲット