Note
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
service-principals 内の コマンド グループを使用すると、Databricks ワークスペースでサービス プリンシパルを管理できます。
CI/CD のサービス プリンシパルを参照してください。
databricks サービス・プリンシパルを作成する
Databricks ワークスペースに新しいサービス プリンシパルを作成します。
databricks service-principals create [flags]
オプション
--active
このユーザーがアクティブな場合。
--application-id string
サービス プリンシパルに関連する UUID。
--display-name string
指定された名前とファミリ名の連結を表す文字列。
--external-id string
サービス プリンシパルの外部 ID。
--id string
Databricks サービス プリンシパル ID。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
Examples
次の例では、表示名を使用してサービス プリンシパルを作成します。
databricks service-principals create --display-name "My Service Principal"
次の例では、JSON を使用してサービス プリンシパルを作成します。
databricks service-principals create --json '{"display_name": "My Service Principal", "active": true}'
databricks サービス プリンシパルを削除
Databricks ワークスペース内の 1 つのサービス プリンシパルを削除します。
databricks service-principals delete ID [flags]
Arguments
ID
Databricks ワークスペース内のサービス プリンシパルの一意の ID。
オプション
Examples
次の例では、ID でサービス プリンシパルを削除します。
databricks service-principals delete 12345
databricks service-principals get
Databricks ワークスペースで定義されている 1 つのサービス プリンシパルの詳細を取得します。
databricks service-principals get ID [flags]
Arguments
ID
Databricks ワークスペース内のサービス プリンシパルの一意の ID。
オプション
Examples
次の例では、サービス プリンシパルの詳細を取得します。
databricks service-principals get 12345
databricks サービス プリンシパル 一覧を表示
Databricks ワークスペースに関連付けられているサービス プリンシパルのセットを一覧表示します。
databricks service-principals list [flags]
オプション
--attributes string
応答で返される属性のコンマ区切りのリスト。
--count int
1 ページあたりの結果の必要な数。
--excluded-attributes string
応答で除外する属性のコンマ区切りのリスト。
--filter string
結果をフィルター処理する必要があるクエリ。
--sort-by string
結果を並べ替える属性。
--sort-order ListSortOrder
結果を並べ替える順序。 サポートされる値: ascending、descending
--start-index int
最初の結果のインデックスを指定します。
Examples
次の例では、すべてのサービス プリンシパルを一覧表示します。
databricks service-principals list
次の例では、フィルター処理を使用するサービス プリンシパルの一覧を示します。
databricks service-principals list --filter "displayName eq 'My Service Principal'"
databricks サービスプリンシパルのパッチ
Databricks ワークスペース内の 1 つのサービス プリンシパルの詳細を部分的に更新します。
databricks service-principals patch ID [flags]
Arguments
ID
Databricks ワークスペースの一意の ID。
オプション
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
Examples
次の例では、サービス プリンシパルにパッチを適用します。
databricks service-principals patch 12345 --json '{"display_name": "Updated Service Principal"}'
Databricks のサービスプリンシパルを更新
1 つのサービス プリンシパルの詳細を更新します。 このアクションにより、既存のサービス プリンシパルが同じ名前に置き換えられます。
databricks service-principals update ID [flags]
Arguments
ID
Databricks サービス プリンシパル ID。
オプション
--active
このユーザーがアクティブな場合。
--application-id string
サービス プリンシパルに関連する UUID。
--display-name string
指定された名前とファミリ名の連結を表す文字列。
--external-id string
サービス プリンシパルの外部 ID。
--id string
Databricks サービス プリンシパル ID。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
Examples
次の例では、サービス プリンシパルを更新します。
databricks service-principals update 12345 --display-name "Updated Service Principal" --active
グローバル フラグ
--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 文字列
該当する場合は、使用するバンドル ターゲット