メインコンテンツまでスキップ

clean-room-assets コマンド グループ

注記

この情報は、Databricks CLI バージョン 0.205 以降に適用されます。Databricks CLI は パブリック プレビュー段階です。

Databricks CLI 使用には、使用状況データを含む Databricks ライセンス および Databricks プライバシー通知が適用されます。

Databricks CLI内のclean-room-assetsコマンドグループを使用すると、クリーンルームアセットを管理できます。クリーンルームアセットは、テーブル、ボリューム、ノートブックなどのデータとオブジェクトであり、クリーンルームと共有されます。 サポートされているアセットタイプには、 FOREIGN_TABLENOTEBOOK_FILETABLEVIEW、および VOLUMEがあります。

databricks clean-room-assets create

クリーンルーム資産を作成します。この方法で追加される Unity Catalog 資産ごとに、クリーンルームの所有者は、資産を使用するのに十分な権限も持っている必要があります。 クリーンルームが資産にアクセスできるようにするには、権限を無期限に維持する必要があります。通常、クリーンルームの所有者としてグループを使用する必要があります。

databricks clean-room-assets create CLEAN_ROOM_NAME [flags]

引数

CLEAN_ROOM_NAME

クリーンルームの名前。

オプション

--asset-type CleanRoomAssetAssetType

資産のタイプ。サポートされている値: FOREIGN_TABLENOTEBOOK_FILETABLEVIEWVOLUME

--json JSON

インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。

--name string

クリーンルーム内の資産を一意に識別する完全修飾名。

グローバルフラグ

次の例では、クリーンルームにテーブル資産を作成します。

Bash
databricks clean-room-assets create my-clean-room --asset-type TABLE --name "catalog.schema.table_name"

次の例では、クリーンルームにノートブック資産を作成します。

Bash
databricks clean-room-assets create my-clean-room --asset-type NOTEBOOK_FILE --name "my_notebook.py"

次の例では、クリーンルームにボリューム資産を作成します。

Bash
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_TABLENOTEBOOK_FILETABLEVIEWVOLUME

NAME

アセットの完全修飾名で、CleanRoomAssetの名前フィールドと同じです。

オプション

グローバルフラグ

次の例では、クリーンルームからテーブル資産を削除します。

Bash
databricks clean-room-assets delete my-clean-room TABLE "catalog.schema.table_name"

次の例では、クリーンルームからノートブック資産を削除します。

Bash
databricks clean-room-assets delete my-clean-room NOTEBOOK_FILE "my_notebook.py"

次の例では、クリーンルームからボリューム資産を削除します。

Bash
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_TABLENOTEBOOK_FILETABLEVIEWVOLUME

NAME

アセットの完全修飾名で、CleanRoomAssetの名前フィールドと同じです。

オプション

グローバルフラグ

次の例では、クリーンルームのテーブル資産の詳細を取得します。

Bash
databricks clean-room-assets get my-clean-room TABLE "catalog.schema.table_name"

次の例では、クリーンルーム内のノートブック資産の詳細を取得します。

Bash
databricks clean-room-assets get my-clean-room NOTEBOOK_FILE "my_notebook.py"

次の例では、クリーンルーム内のビューアセットの詳細を取得します。

Bash
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

前のクエリに基づいて次のページに移動するための不透明なページネーショントークン。

グローバルフラグ

次の例は、クリーンルーム内のすべての資産をリストします。

Bash
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_TABLENOTEBOOK_FILETABLEVIEWVOLUME

NAME

クリーンルーム内の資産を一意に識別する完全修飾名。これは、クリーンルームUIに表示される名前でもあります。 Unity Catalog のセキュリティ保護可能な資産 (テーブル、ボリュームなど) の場合、形式は shared_catalog.shared_schema.asset_nameです。ノートブックの場合、名前はノートブックのファイル名です。

オプション

--asset-type CleanRoomAssetAssetType

資産のタイプ。サポートされている値: FOREIGN_TABLENOTEBOOK_FILETABLEVIEWVOLUME

--json JSON

インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。

--name string

クリーンルーム内の資産を一意に識別する完全修飾名。

グローバルフラグ

次の例では、クリーンルームのテーブル資産を更新します。

Bash
databricks clean-room-assets update my-clean-room TABLE "catalog.schema.table_name" --json '{
"asset_type": "TABLE",
"name": "catalog.schema.table_name"
}'

次の例では、クリーンルームのノートブック資産を更新します。

Bash
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

進行状況ログを表示する形式: defaultappendinplacejson

-t, --target string

該当する場合は、使用するバンドル・ターゲット