settings 命令群組

settings Databricks CLI 中的指令群組包含管理工作區層級設定的指令，這些設定控制適用於整個工作區的各種功能與政策。 請參閱 管理您的工作區。

databricks 設定 aibi-dashboard-embedding-access-policy

控制在工作區層級是否啟用、按條件啟用或停用 AI/BI 發佈的儀表板內嵌功能。 根據預設，此設定會有條件地啟用 （ALLOW_APPROVED_DOMAINS）。

• delete - 刪除 AI/BI 儀錶板嵌入存取政策
• get - 取得 AI/BI 儀錶板嵌入存取政策
• update - 更新 AI/BI 儀錶板內嵌存取原則

databricks 設定 aibi-dashboard-embedding-access-policy get

取得 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-dashboard-embedding-access-policy 更新

更新工作區層級的 AI/BI 儀錶板內嵌存取原則。

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

選項

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

全域旗標

Examples

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

databricks 設定 aibi-dashboard-embedding-access-policy 刪除

刪除 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 設定 Automatic-Cluster-Update get

取得自動叢集更新設定。

databricks settings automatic-cluster-update get [flags]

選項

--etag string

    用於版本控制的 etag。

全域旗標

Examples

databricks settings automatic-cluster-update get

databricks 設定 automatic-cluster-update 更新

更新工作區的自動叢集更新設定。 在更新要求中必須提供新的 etag（作為設定欄位的一部分）。 您可以在更新請求之前發送 get 請求來取得 etag。

databricks settings automatic-cluster-update update [flags]

選項

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

全域旗標

Examples

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

databricks 設定 合規安全配置文件

控制是否啟用當前工作區的合規安全性設定檔。 啟用它在工作區上是永久性的。 預設情況下會關閉。

• get - 取得合規性安全設定檔設定
• update - 更新合規性安全性配置檔設定

選項

全域旗標

Examples

databricks settings compliance-security-profile get

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

databricks 設定 dashboard-email-subscriptions

控制工作區中重新整理 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 設定 預設命名空間

設定 Databricks 工作區的預設命名空間。

透過此命令，使用者可以擷取、設定或修改查詢未參考完整三層名稱時所使用的預設命名空間。 例如，如果您使用 API 來設定 retail_prod 為預設目錄，則查詢 SELECT * FROM myTable 會參考物件 retail_prod.default.myTable （一律假設架構 default ）。

• 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中繼存放區同盟存取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 設定： enable-results-downloading

控制使用者是否可以下載筆記本結果。 預設會啟用此設定。

• 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、、appendinplace、 或json

-t, --target 字串

    如果適用，要使用的套件組合目標