groups-v2コマンドグループ

注記

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

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

Databricks CLI内のgroups-v2コマンド グループを使用すると、 Databricksワークスペースのグループを管理できます。 グループは ID 管理を簡素化し、 Databricksワークスペース、データ、その他のセキュリティ保護可能なオブジェクトへのアクセスを簡単に割り当てられるようにします。 Unity Catalogにおけるワークスペースおよびアクセス制御ポリシーへのアクセス権は、個々のユーザーではなく、グループに割り当てるのがベストプラクティスです。

databricks グループ-v2 作成

Databricksワークスペースに一意の名前で新しいグループを作成します。

databricks groups-v2 create [flags]

議論

なし

オプション

--display-name string

人間が読みやすいグループ名を表す文字列。

--external-id string

グループの外部ID。

--id string

DatabricksグループID。

--json JSON

インラインJSON構文、またはリクエストボディを含むJSONファイルへの@path。

世界の国旗

例

次の例では、新しいグループを作成します。

Bash

databricks groups-v2 create --display-name "Data Engineers"

databricks グループ-v2 の削除

Databricksワークスペースからグループを削除します。

databricks groups-v2 delete ID [flags]

議論

ID

Databricksワークスペース内のグループの一意のID。

オプション

世界の国旗

例

次の例はグループを削除するものです。

Bash

databricks groups-v2 delete 12345678

databricks グループ-v2 取得

Databricksワークスペース内の特定のグループの情報を取得します。

databricks groups-v2 get ID [flags]

議論

ID

Databricksワークスペース内のグループの一意のID。

オプション

世界の国旗

例

以下の例は、グループの詳細を取得するものです。

Bash

databricks groups-v2 get 12345678

databricks グループ-v2 リスト

Databricksワークスペースに関連付けられているグループの詳細をすべて取得します。

databricks groups-v2 list [flags]

議論

なし

オプション

--attributes string

レスポンスで返す属性をカンマ区切りで指定します。

--count int

1ページあたりの表示件数。

--excluded-attributes string

レスポンスから除外する属性をカンマ区切りで指定します。

--filter string

結果を絞り込むためのクエリ。

--sort-by string

結果を並べ替えるための属性。

--sort-order ListSortOrder

結果を並べ替える順序。サポートされている値: ascending 、 descending

--start-index int

最初の検索結果のインデックスを指定します。

世界の国旗

例

以下の例は、すべてのグループを一覧表示したものです。

Bash

databricks groups-v2 list

次の例は、フィルターに一致するグループを一覧表示したものです。

Bash

databricks groups-v2 list --filter "displayName sw \"Data\""

databricks グループ-v2 パッチ

グループの詳細情報を部分的に更新します。

databricks groups-v2 patch ID [flags]

議論

ID

Databricksワークスペース内の一意のID。

オプション

--json JSON

インラインJSON構文、またはリクエストボディを含むJSONファイルへの@path。

世界の国旗

例

次の例は、JSONファイルを使用してグループにパッチを適用する方法です。

Bash

databricks groups-v2 patch 12345678 --json @patch.json

databricks グループ-v2 更新

グループエンティティ全体を置き換えることで、グループの詳細を更新します。

databricks groups-v2 update ID [flags]

議論

ID

DatabricksグループID。

オプション

--display-name string

人間が読みやすいグループ名を表す文字列。

--external-id string

グループの外部ID。

--json JSON

インラインJSON構文、またはリクエストボディを含むJSONファイルへの@path。

世界の国旗

例

次の例は、グループの表示名を更新するものです。

Bash

databricks groups-v2 update 12345678 --display-name "Data Engineers Team"

世界の国旗

--debug

デバッグログを有効にするかどうか。

-h または --help

Databricks CLI、関連するコマンドグループ、または関連するコマンドのヘルプを表示します。

--log-file string

出力ログを書き込むファイルを表す文字列。このフラグが指定されていない場合、デフォルトでは出力ログは標準エラー出力に書き込まれます。

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

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