clean-room-assets
コマンド グループ
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。Databricks CLI は パブリック プレビュー段階です。
Databricks CLI 使用には、使用状況データを含む Databricks ライセンス および Databricks プライバシー通知が適用されます。
Databricks CLI内のclean-room-assets
コマンドグループを使用すると、クリーンルームアセットを管理できます。クリーンルームアセットは、テーブル、ボリューム、ノートブックなどのデータとオブジェクトであり、クリーンルームと共有されます。 サポートされているアセットタイプには、 FOREIGN_TABLE
、 NOTEBOOK_FILE
、 TABLE
、 VIEW
、および VOLUME
があります。
databricks clean-room-assets create
クリーンルーム資産を作成します。この方法で追加される Unity Catalog 資産ごとに、クリーンルームの所有者は、資産を使用するのに十分な権限も持っている必要があります。 クリーンルームが資産にアクセスできるようにするには、権限を無期限に維持する必要があります。通常、クリーンルームの所有者としてグループを使用する必要があります。
databricks clean-room-assets create CLEAN_ROOM_NAME [flags]
引数
CLEAN_ROOM_NAME
クリーンルームの名前。
オプション
--asset-type CleanRoomAssetAssetType
資産のタイプ。サポートされている値: FOREIGN_TABLE
、 NOTEBOOK_FILE
、 TABLE
、 VIEW
、 VOLUME
--json JSON
インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。
--name string
クリーンルーム内の資産を一意に識別する完全修飾名。
例
次の例では、クリーンルームにテーブル資産を作成します。
databricks clean-room-assets create my-clean-room --asset-type TABLE --name "catalog.schema.table_name"
次の例では、クリーンルームにノートブック資産を作成します。
databricks clean-room-assets create my-clean-room --asset-type NOTEBOOK_FILE --name "my_notebook.py"
次の例では、クリーンルームにボリューム資産を作成します。
databricks clean-room-assets create my-clean-room --asset-type VOLUME --name "catalog.schema.volume_name"
databricks clean-room-assets delete
クリーンルーム資産を削除します。共有を解除し、クリーンルームから資産を削除します。
databricks clean-room-assets delete CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]
引数
CLEAN_ROOM_NAME
クリーンルームの名前。
ASSET_TYPE
資産のタイプ。サポートされている値: FOREIGN_TABLE
、 NOTEBOOK_FILE
、 TABLE
、 VIEW
、 VOLUME
NAME
アセットの完全修飾名で、CleanRoomAssetの名前フィールドと同じです。
オプション
例
次の例では、クリーンルームからテーブル資産を削除します。
databricks clean-room-assets delete my-clean-room TABLE "catalog.schema.table_name"
次の例では、クリーンルームからノートブック資産を削除します。
databricks clean-room-assets delete my-clean-room NOTEBOOK_FILE "my_notebook.py"
次の例では、クリーンルームからボリューム資産を削除します。
databricks clean-room-assets delete my-clean-room VOLUME "catalog.schema.volume_name"
databricks clean-room-assets get
クリーンルーム資産の詳細を、そのタイプとフルネームで取得します。
databricks clean-room-assets get CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]
引数
CLEAN_ROOM_NAME
クリーンルームの名前。
ASSET_TYPE
資産のタイプ。サポートされている値: FOREIGN_TABLE
、 NOTEBOOK_FILE
、 TABLE
、 VIEW
、 VOLUME
NAME
アセットの完全修飾名で、CleanRoomAssetの名前フィールドと同じです。
オプション
例
次の例では、クリーンルームのテーブル資産の詳細を取得します。
databricks clean-room-assets get my-clean-room TABLE "catalog.schema.table_name"
次の例では、クリーンルーム内のノートブック資産の詳細を取得します。
databricks clean-room-assets get my-clean-room NOTEBOOK_FILE "my_notebook.py"
次の例では、クリーンルーム内のビューアセットの詳細を取得します。
databricks clean-room-assets get my-clean-room VIEW "catalog.schema.view_name"
Databricks clean-room-assets list
クリーンルームで資産をリストアップします。
databricks clean-room-assets list CLEAN_ROOM_NAME [flags]
引数
CLEAN_ROOM_NAME
クリーンルームの名前。
オプション
--page-token string
前のクエリに基づいて次のページに移動するための不透明なページネーショントークン。
例
次の例は、クリーンルーム内のすべての資産をリストします。
databricks clean-room-assets list my-clean-room
Databricks clean-room-assets の更新
クリーンルーム資産を更新します。たとえば、ノートブックの内容を更新したり、テーブルの共有パーティションを変更したりします。
databricks clean-room-assets update CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]
引数
CLEAN_ROOM_NAME
クリーンルームの名前。
ASSET_TYPE
資産のタイプ。サポートされている値: FOREIGN_TABLE
、 NOTEBOOK_FILE
、 TABLE
、 VIEW
、 VOLUME
NAME
クリーンルーム内の資産を一意に識別する完全修飾名。これは、クリーンルームUIに表示される名前でもあります。 Unity Catalog のセキュリティ保護可能な資産 (テーブル、ボリュームなど) の場合、形式は shared_catalog.shared_schema.asset_name
です。ノートブックの場合、名前はノートブックのファイル名です。
オプション
--asset-type CleanRoomAssetAssetType
資産のタイプ。サポートされている値: FOREIGN_TABLE
、 NOTEBOOK_FILE
、 TABLE
、 VIEW
、 VOLUME
--json JSON
インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。
--name string
クリーンルーム内の資産を一意に識別する完全修飾名。
例
次の例では、クリーンルームのテーブル資産を更新します。
databricks clean-room-assets update my-clean-room TABLE "catalog.schema.table_name" --json '{
"asset_type": "TABLE",
"name": "catalog.schema.table_name"
}'
次の例では、クリーンルームのノートブック資産を更新します。
databricks clean-room-assets update my-clean-room NOTEBOOK_FILE "my_notebook.py" --name "updated_notebook.py"
グローバルフラグ
--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
該当する場合は、使用するバンドル・ターゲット