備註
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
database
Databricks CLI 內的命令群組包含管理資料庫實例的命令。 資料庫實例會管理記憶體和計算資源，並提供用戶連線的端點。
請參閱 什麼是資料庫實例？。
databricks 資料庫 create-database-catalog
建立資料庫目錄。
databricks database create-database-catalog NAME DATABASE_INSTANCE_NAME DATABASE_NAME [flags]
論點
NAME
Unity 目錄中目錄的名稱。
DATABASE_INSTANCE_NAME
DatabaseInstance 儲存資料庫的名稱。
DATABASE_NAME
與目錄相關聯的資料庫名稱（在 實例中）。
選項
--create-database-if-not-exists
如果資料庫不存在，請建立資料庫。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。 如需 JSON 參考，請參閱 資料庫目錄。
範例
下列範例會建立資料庫目錄：
databricks database create-database-catalog my-catalog my-instance my-database
databricks 資料庫 create-database-instance
建立資料庫實例。
備註
若要設定無法作為引數使用的巢狀欄位，請使用選項 --json 來指定完整的請求內文。
databricks database create-database-instance NAME [flags]
論點
NAME
實例的名稱。 這是實例的唯一標識碼。
選項
--capacity string
執行個體的容量SKU。 有效值為： CU_1， CU_2， CU_4， 。 CU_8
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。 如需 JSON 參考，請參閱 資料庫執行個體。
--stopped
實例是否已停止。
範例
下列範例會建立資料庫實例：
databricks database create-database-instance my-instance --capacity CU_1
databricks 資料庫 create-database-table
建立資料庫數據表。
databricks database create-database-table NAME [flags]
論點
NAME
數據表的完整三部分（目錄、架構、數據表）名稱。
選項
--database-instance-name string
目標資料庫實例的名稱。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。 如需 JSON 參考，請參閱 資料庫資料表。
--logical-database-name string
此資料表的目標 Postgres 資料庫物件 （邏輯資料庫） 名稱。
範例
下列範例會建立資料庫資料表：
databricks database create-database-table my-catalog.my-schema.my-table --database-instance-name my-instance --logical-database-name dbname
databricks 資料庫 create-synced-database-table
建立同步處理的資料庫數據表。
備註
若要設定無法作為引數使用的巢狀欄位，請使用選項 --json 來指定完整的請求內文。
databricks database create-synced-database-table NAME [flags]
論點
NAME
數據表的完整三部分（目錄、架構、數據表）名稱。
選項
--database-instance-name string
目標資料庫實例的名稱。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。 如需 JSON 參考，請參閱 同步資料庫資料表。
--logical-database-name string
此資料表的目標 Postgres 資料庫物件 （邏輯資料庫） 名稱。
範例
下列範例會建立同步處理的資料庫資料表：
databricks database create-synced-database-table --json '{"name": "main.my-schema.my-table", "database_instance_name": "my-instance", "logical_database_name": "testdb", "spec": {"primary_key_columns": ["col1"], "existing_pipeline_id": "999999z9-dz9b-4zf7-c178-15b777772e6z", "scheduling_policy": "SNAPSHOT", "source_table_full_name": "main.my-instance.t"}}'
databricks 資料庫 delete-database-catalog
刪除資料庫型錄。
databricks database delete-database-catalog NAME [flags]
論點
NAME
要刪除的目錄名稱。
選項
範例
下列範例會移除資料庫目錄：
databricks database delete-database-catalog my-catalog
databricks 資料庫 delete-database-instance
刪除資料庫實例。
databricks database delete-database-instance NAME [flags]
論點
NAME
要刪除的實例名稱。
選項
--force
根據預設，如果實例具有透過 PITR 建立的子代實例，則無法刪除實例。
--purge
注意 purge=false 是在開發中。
範例
下列範例會移除資料庫實例：
databricks database delete-database-instance my-instance --force
databricks 資料庫 delete-database-table
刪除資料庫數據表。
databricks database delete-database-table NAME [flags]
論點
NAME
要刪除之數據表的完整三部分（目錄、架構、數據表）名稱。
選項
範例
下列範例會移除資料庫資料表：
databricks database delete-database-table catalog.schema.table
databricks 資料庫 delete-synced-database-table
刪除同步處理的資料庫數據表。
databricks database delete-synced-database-table NAME [flags]
論點
NAME
要刪除之同步數據表的完整三部分（目錄、架構、數據表）名稱。
選項
範例
下列範例會刪除同步處理的資料庫資料表：
databricks database delete-synced-database-table catalog.schema.table
databricks 資料庫 find-database-instance-by-uid
依 uid 尋找資料庫實例。
databricks database find-database-instance-by-uid [flags]
選項
--uid string
要取得之叢集的UID。
範例
下列範例會依 UID 尋找資料庫實例：
databricks database find-database-instance-by-uid --uid 12345-abcdef-67890
databricks 資料庫 generate-database-credential
產生可用來存取資料庫實例的認證。
databricks database generate-database-credential [flags]
選項
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--request-id string
認證產生的要求標識碼。
範例
下列範例會產生資料庫認證：
databricks database generate-database-credential --request-id my-request-123
databricks 資料庫 get-database-catalog
取得資料庫目錄。
databricks database get-database-catalog NAME [flags]
論點
NAME
要取得的目錄名稱。
選項
範例
下列範例會取得資料庫目錄的相關信息：
databricks database get-database-catalog my-catalog
databricks 資料庫 get-database-instance
取得資料庫實例。
databricks database get-database-instance NAME [flags]
論點
NAME
要取得的叢集名稱。
選項
範例
下列範例會取得資料庫實例的相關信息：
databricks database get-database-instance my-instance
databricks 資料庫 get-database-table
取得資料庫數據表。
databricks database get-database-table NAME [flags]
論點
NAME
要取得之數據表的完整三部分（目錄、架構、數據表）名稱。
選項
範例
下列範例會取得資料庫數據表的相關信息：
databricks database get-database-table catalog.schema.table
databricks 資料庫 get-synced-database-table
取得同步處理的資料庫數據表。
databricks database get-synced-database-table NAME [flags]
論點
NAME
要取得之同步數據表的完整三部分（目錄、架構、數據表）名稱。
選項
範例
下列範例會取得已同步資料庫資料表的相關信息：
databricks database get-synced-database-table catalog.schema.table
databricks 資料庫 list-database-instances
列出資料庫實例。
databricks database list-database-instances [flags]
選項
--page-size int
傳回項目的上限。
--page-token string
分頁令牌可移至資料庫實例的下一頁。
範例
下列範例會列出所有資料庫實例：
databricks database list-database-instances
下列範例會列出具有分頁的資料庫實例：
databricks database list-database-instances --page-size 10
databricks 資料庫 update-database-instance
更新資料庫實例。
databricks database update-database-instance NAME [flags]
論點
NAME
實例的名稱。 這是實例的唯一標識碼。
選項
--capacity string
實例的 SKU。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--stopped
實例是否已停止。
範例
下列範例會更新資料庫實例容量：
databricks database update-database-instance my-instance --capacity large
下列範例會停止資料庫實例：
databricks database update-database-instance my-instance --stopped
全域旗標
--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 字串
如果適用，要使用的套件組合目標