Note
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
catalogs
Databricks CLI 中的指令群組允許你管理 Unity 目錄中的目錄。 目錄是 Unity 目錄三層命名空間的第一層。 它用來組織您的數據資產。 請參閱什麼是 Unity Catalog？。
databricks 目錄建立
如果呼叫者是中繼存放區管理員或具有 CREATE_CATALOG 許可權，請在父中繼存放區中建立新的目錄實例。
databricks catalogs create NAME [flags]
Arguments
NAME
目錄的名稱
選項
--comment string
使用者提供的自由格式文字描述
--connection-name string
與外部數據源的連接名稱
--json JSON
內嵌 JSON 字串或 @path 指向 JSON 檔案的要求本文
--provider-name string
Delta分享提供者的名稱
--share-name string
共用提供者下共享的名稱
--storage-root string
目錄內受控數據表的記憶體根 URL
Examples
下列範例會建立名為 的 sales目錄：
databricks catalogs create sales
下列範例會建立具有批注的目錄：
databricks catalogs create sales --comment "Sales data catalog"
databricks 目錄刪除
刪除符合所提供名稱的目錄。 呼叫端必須是中繼存放區管理員或目錄的擁有者。
databricks catalogs delete NAME [flags]
Arguments
NAME
目錄的名稱
選項
--force
即使目錄不是空的，仍強制刪除
Examples
下列範例會刪除名為 的 sales目錄：
databricks catalogs delete sales
下列範例會強制刪除非空白目錄：
databricks catalogs delete sales --force
databricks 目錄取得
在中繼存放區中取得指定的目錄。 呼叫端必須是中繼存放區管理員、目錄的擁有者，或為其 USE_CATALOG 帳戶設定許可權的使用者。
databricks catalogs get NAME [flags]
Arguments
NAME
目錄的名稱
選項
--include-browse
是否要在主體只能存取選擇性元數據的回應中包含目錄
Examples
下列範例會取得名為 sales的目錄相關信息：
databricks catalogs get sales
下列範例會取得目錄資訊，包括僅限瀏覽的目錄：
databricks catalogs get sales --include-browse
Databricks 資料目錄列表
列出中繼存放區中的目錄。 如果呼叫端是中繼存放區管理員，則會擷取所有目錄。 否則，只會擷取呼叫端所擁有的目錄（或呼叫端具有 USE_CATALOG 許可權的目錄）。 不保證陣列中的元素有特定的順序。
databricks catalogs list [flags]
選項
--include-browse
是否要在主體只能存取選擇性元數據的回應中包含目錄
--max-results int
要傳回的目錄數目上限
--page-token string
不透明的分頁令牌，根據先前的查詢移至下一頁
Examples
下列範例會列出所有目錄：
databricks catalogs list
下列範例會列出最多 10 個結果的目錄：
databricks catalogs list --max-results 10
下列範例會列出目錄，包括僅限瀏覽的目錄：
databricks catalogs list --include-browse
databricks 目錄更新
更新符合所提供名稱的目錄。 呼叫端必須是目錄的擁有者或中繼存放區管理員（變更目錄的擁有者字段時）。
databricks catalogs update NAME [flags]
Arguments
NAME
目錄的名稱
選項
--comment string
使用者提供的自由格式文字描述
--enable-predictive-optimization EnablePredictiveOptimization
是否應該為此物件及其下的物件啟用預測優化。 支援的值：DISABLE、ENABLE、INHERIT
--isolation-mode CatalogIsolationMode
當前的安全性實體是否可供所有工作區或特定的一組工作區存取。 支援的值：ISOLATED、OPEN
--json JSON
內嵌 JSON 字串或 @path 指向 JSON 檔案的要求本文
--new-name string
目錄的新名稱
--owner string
目錄目前擁有者的用戶名稱
Examples
下列範例會更新目錄的批註：
databricks catalogs update sales --comment "Updated sales data catalog"
下列範例會重新命名目錄：
databricks catalogs update sales --new-name sales-prod
下列範例會變更目錄的擁有者：
databricks catalogs update sales --owner someone@example.com
以下範例會啟用商品目錄的預測優化：
databricks catalogs update sales --enable-predictive-optimization ENABLE
全域旗標
--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 字串
如果適用，要使用的套件組合目標