Note
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
metastores
Databricks CLI 中的指令群組允許你管理元儲存庫。 中繼存放區是 Unity 目錄中物件的最上層容器。 它會儲存數據資產（數據表和檢視表）以及管理其存取權的許可權。 請參閱 Metastore。
databricks 元存儲分配
建立新建的 Metastore 指派。 如果相同的workspace_id指派存在，新的metastore_id和default_catalog_name將會覆寫它。 呼叫端必須是帳戶管理員。
databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]
Arguments
WORKSPACE_ID
工作區標識碼。
METASTORE_ID
中繼存放區的唯一標識符。
DEFAULT_CATALOG_NAME
Deprecated. 使用「預設命名空間 API」來設定 Databricks 工作區的預設目錄。 中繼存放區中預設目錄的名稱。
選項
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
Examples
下列範例會將中繼存放區指派給工作區：
databricks metastores assign 123456789 abc123-def456-ghi789 main
databricks 中繼資料存放區創建
根據提供的名稱和選擇性的記憶體根路徑，建立新的中繼存放區。 根據預設（如果未設定擁有者字段），新中繼存放區的擁有者是呼叫 createMetastore API 的使用者。 如果擁有者欄位設定為空字串 （""），則擁有權會改為指派給系統使用者。
databricks metastores create NAME [flags]
Arguments
NAME
中繼存放區的名稱，由使用者指定。
選項
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--region string
中繼存放區提供服務的雲端區域（例如 us-west-2、westus）。
--storage-root string
中繼存放區的記憶體根 URL。
Examples
下列範例會建立具有名稱和記憶體根目錄的中繼存放區：
databricks metastores create my-metastore --storage-root s3://my-bucket/metastore-root --region us-west-2
databricks 中繼存放區目前
取得要存取之工作區的中繼存放區指派。
databricks metastores current [flags]
選項
Examples
下列範例會取得目前的中繼存放區指派：
databricks metastores current
databricks 中繼存放區刪除
刪除中繼存放區。 呼叫端必須是中繼存放區管理員。
databricks metastores delete ID [flags]
Arguments
ID
中繼存放區的唯一標識符。
選項
--force
即使中繼存放區不是空的，仍強制刪除。
Examples
下列範例會刪除中繼存放區：
databricks metastores delete abc123-def456-ghi789
下列範例會強制刪除中繼存放區，即使它不是空的：
databricks metastores delete abc123-def456-ghi789 --force
databricks 中繼資料庫獲取
取得符合所提供標識碼的中繼存放區。 呼叫端必須是中繼存放區管理員，才能擷取這項資訊。
databricks metastores get ID [flags]
Arguments
ID
中繼存放區的唯一標識符。
選項
Examples
下列範例會取得特定中繼存放區的相關信息：
databricks metastores get abc123-def456-ghi789
databricks 中繼資料庫列表
列出可用的中繼存放區。 呼叫端必須是系統管理員，才能擷取這項資訊。 不保證清單中專案的特定順序。
databricks metastores list [flags]
選項
--max-results int
傳回的 Metastore 數量上限。
--page-token string
不透明分頁令牌會根據上一個查詢移至下一頁。
Examples
下列範例會列出所有可用的中繼存放區：
databricks metastores list
下列範例會列出具有分頁的中繼存放區：
databricks metastores list --max-results 10 --page-token abc123token
databricks 中繼資料庫摘要
取得中繼存放區的摘要資訊。 此摘要包含記憶體認證、雲端廠商、雲端區域，以及全域中繼存放區標識符。
databricks metastores summary [flags]
選項
Examples
下列範例會取得中繼存放區摘要：
databricks metastores summary
databricks 中繼存放區未指派
刪除中繼存放區指派。 呼叫端必須是帳戶管理員。
databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]
Arguments
WORKSPACE_ID
工作區標識碼。
METASTORE_ID
提供要刪除的中繼存放區的 ID。
選項
Examples
以下範例將 Metastore 從工作區解除分配：
databricks metastores unassign 123456789 abc123-def456-ghi789
databricks 元資料庫更新
更新特定中繼存放區的資訊。 呼叫端必須是中繼存放區管理員。如果擁有者欄位設定為空字串 （""），則擁有權會更新為 [系統使用者]。
databricks metastores update ID [flags]
Arguments
ID
中繼存放區的唯一標識符。
選項
--delta-sharing-organization-name string
作為 Databricks 對 Databricks Delta Sharing 官方名稱使用的 Delta Sharing 實體的組織名稱。
--delta-sharing-recipient-token-lifetime-in-seconds int
差異分享接收者令牌的存留期，以秒為單位。
--delta-sharing-scope DeltaSharingScopeEnum
針對中繼資料庫啟用 Delta Sharing 的範圍。 支援的值：INTERNAL、INTERNAL_AND_EXTERNAL
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--new-name string
中繼存放區的新名稱。
--owner string
中繼存放區的擁有者。
--privilege-model-version string
中繼存放區的權限模型版本，格式為 major.minor（例如 1.0）。
--storage-root-credential-id string
記憶體認證的 UUID，可存取中繼存放區storage_root。
Examples
下列範例會更新中繼存放區名稱：
databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore
下列範例透過 Delta Sharing 配置進行更新中繼資料庫：
databricks metastores update abc123-def456-ghi789 --delta-sharing-scope INTERNAL_AND_EXTERNAL --delta-sharing-organization-name my-org
Databricks Metastore 更新指派
更新中繼存放區指派。 如果工作區已獲指派中繼存放區，此作業可用來更新 metastore_id 或 default_catalog_name 指定工作區。 呼叫端必須是帳戶管理員才能更新 metastore_id;否則，呼叫端可以是工作區管理員。
databricks metastores update-assignment WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
工作區標識碼。
選項
--default-catalog-name string
中繼存放區中預設目錄的名稱。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--metastore-id string
中繼存放區的唯一標識符。
Examples
下列範例會更新中繼存放區指派的預設目錄：
databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog
下列範例會更新中繼存放區指派的中繼存放區標識碼：
databricks metastores update-assignment 123456789 --metastore-id new-metastore-id
全域旗標
--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 字串
如果適用，要使用的套件組合目標