注
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
Databricks CLI 内の tag-policies コマンド グループには、Databricks の管理タグのポリシーを管理するためのコマンドが含まれています。
管理タグを参照してください。
databricks tag-policies create-tag-policy
新しいタグ ポリシーを作成し、関連付けられているタグ キーを管理します。
databricks tag-policies create-tag-policy TAG_KEY [flags]
論争
TAG_KEY
ポリシーを作成するタグ キー。
オプション
--description string
タグ ポリシーの説明。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path
例示
次の例では、タグ キーのタグ ポリシーを作成します。
databricks tag-policies create-tag-policy environment --description "Policy for environment tags"
次の例では、JSON を使用してタグ ポリシーを作成します。
databricks tag-policies create-tag-policy department --json '{"description": "Policy for department classification", "allowed_values": ["engineering", "sales", "marketing"]}'
次の例では、JSON ファイルを使用してタグ ポリシーを作成します。
databricks tag-policies create-tag-policy compliance --json @tag-policy.json
databricks tag-policies delete-tag-policy
関連付けられている管理タグのキーによってタグ ポリシーを削除し、そのタグ キーはアンオーバーしたままにします。
databricks tag-policies delete-tag-policy TAG_KEY [flags]
論争
TAG_KEY
ポリシーを削除するタグ キー。
オプション
例示
次の例では、タグ ポリシーを削除します。
databricks tag-policies delete-tag-policy environment
databricks tag-policies get-tag-policy
関連付けられている管理タグのキーによって、1 つのタグ ポリシーを取得します。
databricks tag-policies get-tag-policy TAG_KEY [flags]
論争
TAG_KEY
ポリシーを取得するタグ キー。
オプション
例示
次の例では、タグ ポリシーを取得します。
databricks tag-policies get-tag-policy environment
databricks tag-policies list-tag-policies
アカウント内のすべての管理タグのタグ ポリシーを一覧表示します。
databricks tag-policies list-tag-policies [flags]
オプション
--page-size int
ページごとに返されるタグ ポリシーの最大数。
--page-token string
結果の次のページを取得するトークン。
例示
次の例では、すべてのタグ ポリシーを一覧表示します。
databricks tag-policies list-tag-policies
次の例では、改ページ位置付きのタグ ポリシーの一覧を示します。
databricks tag-policies list-tag-policies --page-size 10
databricks tag-policies update-tag-policy
1 つの管理タグの既存のタグ ポリシーを更新します。
databricks tag-policies update-tag-policy TAG_KEY UPDATE_MASK [flags]
論争
TAG_KEY
ポリシーを更新するタグ キー。
UPDATE_MASK
フィールド マスクは 1 つの文字列で、複数のフィールドをコンマで区切る必要があります (スペースなし)。 フィールド パスはリソース オブジェクトに対する相対パスであり、ドット (.) を使用してサブフィールド ( author.given_name など) を移動します。 コレクション フィールド全体のみを指定できるため、シーケンス フィールドまたはマップ フィールド内の要素の指定は許可されません。 フィールド名は、リソース フィールド名と完全に一致する必要があります。
アスタリスク (*) フィールド マスクは、完全な置換を示します。 今後 API が変更されると意図しない結果が生じる可能性があるため、更新されるフィールドを常に明示的に一覧表示し、ワイルドカードを使用しないようにすることをお勧めします。
オプション
--description string
タグ ポリシーの説明。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path
例示
次の例では、タグ ポリシーの説明を更新します。
databricks tag-policies update-tag-policy environment "description" --description "Updated policy for environment tags"
次の例では、JSON を使用してタグ ポリシーを更新します。
databricks tag-policies update-tag-policy department "allowed_values" --json '{"allowed_values": ["engineering", "sales", "marketing", "operations"]}'
次の例では、JSON ファイルを使用してタグ ポリシーを更新します。
databricks tag-policies update-tag-policy compliance "description,allowed_values" --json @updated-policy.json
グローバル フラグ
--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 文字列
該当する場合は、使用するバンドル ターゲット