settings コマンド グループ

Note

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

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

settings 内の コマンド グループには、ワークスペース全体に適用されるさまざまな機能とポリシーを制御するワークスペース レベルの設定を管理するコマンドが含まれています。 「ワークスペースを管理する」を参照してください。

データブリックスの設定 aibi-ダッシュボード-埋め込み-アクセス-ポリシー

AI/BI で発行されたダッシュボード埋め込みをワークスペース レベルで有効にするか、条件付きで有効にするか、無効にするかを制御します。 既定では、この設定は条件付きで有効になっています (ALLOW_APPROVED_DOMAINS)。

• delete - AI/BI ダッシュボード埋め込みアクセス ポリシーを削除する
• get - AI/BI ダッシュボード埋め込みアクセス ポリシーを取得する
• update - AI/BI ダッシュボード埋め込みアクセス ポリシーを更新する

databricks の設定から、aibi-dashboard-embedding-access-policy を取得する

アクセス ポリシーを埋め込む AI/BI ダッシュボードを取得します。 既定の設定は ALLOW_APPROVED_DOMAINSであり、承認されたドメインに AI/BI ダッシュボードを埋め込むのを許可します。

databricks settings aibi-dashboard-embedding-access-policy get [flags]

オプション

--etag string

    バージョン管理に使用される etag。

グローバル フラグ

Examples

databricks settings aibi-dashboard-embedding-access-policy get

databricksの設定、aibiダッシュボード埋め込みアクセスポリシーの更新

ワークスペース レベルで AI/BI ダッシュボード埋め込みアクセス ポリシーを更新します。

databricks settings aibi-dashboard-embedding-access-policy update [flags]

オプション

--json JSON

    要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。

グローバル フラグ

Examples

databricks settings aibi-dashboard-embedding-access-policy update --json '{"access_policy": "ALLOW_ALL"}'

databricks 設定 aibi-ダッシュボード-埋め込み-アクセス-ポリシーを削除

アクセス ポリシーを埋め込む AI/BI ダッシュボードを削除し、既定値に戻します。

databricks settings aibi-dashboard-embedding-access-policy delete [flags]

オプション

--etag string

    バージョン管理に使用される etag。

グローバル フラグ

Examples

databricks settings aibi-dashboard-embedding-access-policy delete

databricks 設定 aibi-dashboard-embedding-approved-domains

埋め込み AI/BI ダッシュボードをホストするために承認されたドメインの一覧を制御します。 現在のアクセス ポリシーが ALLOW_APPROVED_DOMAINS に設定されていない場合、承認済みドメインの一覧を変更することはできません。

• delete - 承認済みドメインを埋め込む AI/BI ダッシュボードを削除する
• get - 埋め込み AI/BI ダッシュボードをホストするために承認されたドメインの一覧を取得する
• update - 埋め込み AI/BI ダッシュボードをホストするために承認されたドメインの一覧を更新する

オプション

グローバル フラグ

Examples

databricks settings aibi-dashboard-embedding-approved-domains get

databricks settings aibi-dashboard-embedding-approved-domains update --json '{"approved_domains": ["example.com", "mydomain.org"]}'

Databricks 設定 自動クラスターアップデート

現在のワークスペースでクラスターの自動更新を有効にするかどうかを制御します。 既定では無効になっています。

• get - クラスターの自動更新設定を取得する
• update - クラスターの自動更新設定を更新する

オプション

グローバル フラグ

databricks 設定の自動クラスタ更新を取得する

クラスターの自動更新設定を取得します。

databricks settings automatic-cluster-update get [flags]

オプション

--etag string

    バージョン管理に使用される etag。

グローバル フラグ

Examples

databricks settings automatic-cluster-update get

databricks 設定の自動クラスター更新アップデート

ワークスペースのクラスターの自動更新設定を更新します。 (設定フィールドの一部として) 更新要求で新しい etag を指定する必要があります。 etag は、更新要求の前に get 要求を行うことで取得できます。

databricks settings automatic-cluster-update update [flags]

オプション

--json JSON

    要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。

グローバル フラグ

Examples

databricks settings automatic-cluster-update update --json '{"automatic_cluster_update": {"enabled": true}}'

databricks 設定 コンプライアンス・セキュリティ・プロファイル

現在のワークスペースのコンプライアンス セキュリティ プロファイルを有効にするかどうかを制御します。 ワークスペースで有効にすることは永続的です。 既定では無効になっています。

Warning

この設定は、一度有効にした後は無効にできません。

• get - コンプライアンス セキュリティ プロファイルの設定を取得する
• update - コンプライアンス セキュリティ プロファイル設定を更新する

オプション

グローバル フラグ

Examples

databricks settings compliance-security-profile get

databricks settings compliance-security-profile update --json '{"compliance_security_profile": {"enabled": true}}'

databricks 設定 ダッシュボードメール購読

ワークスペース内の AI/BI ダッシュボードを更新するためのスケジュールまたはワークロード タスクが、PDF やダッシュボードの画像を含むサブスクリプション メールを送信できるかどうかを制御します。 既定では、この設定は有効になっています (true に設定)。

• delete - ダッシュボードのメール サブスクリプション設定を削除する
• get - ダッシュボードのメール サブスクリプション設定を取得する
• update - ダッシュボードのメール サブスクリプション設定を更新する

オプション

グローバル フラグ

Examples

databricks settings dashboard-email-subscriptions get

databricks settings dashboard-email-subscriptions update --json '{"dashboard_email_subscriptions": {"enabled": false}}'

databricks 設定 default-namespace

Databricks ワークスペースの既定の名前空間を構成します。

このコマンドを使用すると、クエリが完全修飾 3 レベルの名前を参照しない場合に使用される既定の名前空間を取得、設定、または変更できます。 たとえば、API を使用して retail_prod を既定のカタログとして設定する場合、クエリ SELECT * FROM myTable はオブジェクト retail_prod.default.myTable を参照します (スキーマ default は常に想定されます)。

Note

この設定を有効にするには、クラスターと SQL ウェアハウスの再起動が必要です。 また、既定の名前空間は、Unity カタログ対応コンピューティングを使用する場合にのみ適用されます。

• delete - 既定の名前空間設定を削除する
• get - 既定の名前空間設定を取得する
• update - 既定の名前空間設定を更新する

オプション

グローバル フラグ

Examples

databricks settings default-namespace get

databricks settings default-namespace update --json '{"namespace": {"value": "retail_prod"}}'

databricks settings default-namespace delete

databricks 設定 レガシーアクセスを無効化

レガシ アクセスを無効にすると、次のような影響があります。

• ワークスペースから Hive メタストアへの直接アクセスを無効にします。 ただし、Hive Metastore フェデレーションを使用して Hive メタストアにアクセスすることはできます。

• ワークスペースからの外部の場所へのアクセスでフォールバック モードを無効にします。

• 13.3 LTS より前の Databricks ランタイム バージョンを無効にします。

• delete - レガシ アクセス無効化の状態を削除する

• get - レガシ アクセス無効化の状態を取得する

• update - レガシ アクセス無効化の状態を更新する

オプション

グローバル フラグ

Examples

databricks settings disable-legacy-access get

databricks settings disable-legacy-access update --json '{"disable_legacy_access": {"disabled": true}}'

databricks 設定 enable-export-notebook

ユーザーがワークスペース UI からノートブックとファイルをエクスポートできるかどうかを制御します。 既定では、この設定は有効です。

• get-enable-export-notebook - ノートブックとファイルのエクスポート設定を取得する
• patch-enable-export-notebook - ノートブックとファイルのエクスポート設定を更新する

オプション

グローバル フラグ

Examples

databricks settings enable-export-notebook get-enable-export-notebook

databricks settings enable-export-notebook patch-enable-export-notebook --json '{"allow_missing": true, "setting": {"enabled": false}}'

databricks 設定 enable-notebook-table-clipboard

ユーザーが UI を介して表形式のデータをクリップボードにコピーできるかどうかを制御します。 既定では、この設定は有効です。

• get-enable-notebook-table-clipboard - 結果テーブルのクリップボード機能の設定を取得する
• patch-enable-notebook-table-clipboard - 結果テーブルのクリップボード機能の設定を更新する

オプション

グローバル フラグ

Examples

databricks settings enable-notebook-table-clipboard get-enable-notebook-table-clipboard

databricks settings enable-notebook-table-clipboard patch-enable-notebook-table-clipboard --json '{"allow_missing": true, "setting": {"enabled": false}}'

Databricksの設定で結果をダウンロード可能にする

ユーザーがノートブックの結果をダウンロードできるかどうかを制御します。 既定では、この設定は有効です。

• get-enable-results-downloading - ノートブックの結果のダウンロード設定を取得する
• patch-enable-results-downloading - ノートブックの結果のダウンロード設定を更新する

オプション

グローバル フラグ

Examples

databricks settings enable-results-downloading get-enable-results-downloading

databricks settings enable-results-downloading patch-enable-results-downloading --json '{"allow_missing": true, "setting": {"enabled": false}}'

databricks 設定の強化されたセキュリティ監視

現在のワークスペースに対して拡張セキュリティ監視を有効にするかどうかを制御します。 コンプライアンス セキュリティ プロファイルが有効になっている場合、これは自動的に有効になります。 デフォルトでは無効になっています。 ただし、コンプライアンス セキュリティ プロファイルが有効になっている場合、これは自動的に有効になります。

コンプライアンス セキュリティ プロファイルが無効になっている場合は、この設定を有効または無効にすることができ、永続的ではありません。

• get - セキュリティの強化された監視設定を取得する
• update - セキュリティ強化の監視設定を更新する

オプション

グローバル フラグ

Examples

databricks settings enhanced-security-monitoring get

databricks settings enhanced-security-monitoring update --json '{"enhanced_security_monitoring": {"enabled": true}}'

Databricks の設定でワークスペース管理者を制限する

[ワークスペース管理者の制限] 設定では、ワークスペース管理者の機能を制御できます。 設定の状態を ALLOW_ALL に設定すると、ワークスペース管理者は、ワークスペース内の任意のサービス プリンシパルに代わってサービス プリンシパルの個人用アクセス トークンを作成できます。 ワークスペース管理者は、自分のワークスペース内の任意のユーザーにジョブ所有者を変更することもできます。 また、ジョブ run_as の設定をワークスペース内の任意のユーザー、またはサービス プリンシパル ユーザー ロールを持っている場合はそのサービス プリンシパルに変更できます。

設定の状態を RESTRICT_TOKENS_AND_JOB_RUN_AS に設定すると、ワークスペース管理者は、サービス プリンシパル ユーザー ロールを持つサービス プリンシパルに代わってのみ、個人用アクセス トークンを作成できます。 自分自身にのみジョブの所有者を変更できます。 また、ジョブ run_as の設定を自分自身、またはサービス プリンシパル ユーザー ロールを持っている場合はそのサービス プリンシパルに変更できます。

• delete - ワークスペース管理者の制限設定を削除する
• get - ワークスペース管理者の制限設定を取得する
• update - ワークスペース管理者の制限設定を更新する

オプション

グローバル フラグ

Examples

databricks settings restrict-workspace-admins get

databricks settings restrict-workspace-admins update --json '{"restrict_workspace_admins": {"status": "RESTRICT_TOKENS_AND_JOB_RUN_AS"}}'

databricks settings restrict-workspace-admins delete

Databricks設定のSQL結果ダウンロード

ワークスペース内のユーザーが SQL エディターと AI/BI ダッシュボード UI から結果をダウンロードできるかどうかを制御します。 既定では、この設定は有効になっています (true に設定)。

• delete - SQL 結果のダウンロード設定を削除する
• get - SQL 結果のダウンロード設定を取得する
• update - SQL 結果のダウンロード設定を更新する

オプション

グローバル フラグ

Examples

databricks settings sql-results-download get

databricks settings sql-results-download update --json '{"sql_results_download": {"enabled": false}}'

databricks settings sql-results-download delete

グローバル フラグ

--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 文字列

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