備註
此資訊適用於 Databricks CLI 版本 0.285 及以上版本。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明,包括任何使用數據條款。
psql
Databricks CLI 中的指令允許你使用 PostgreSQL 用戶端連接到指定的資料庫實例。
Databricks PSQL
連接到指定的資料庫實例。 此指令需要在您的機器上安裝客戶 psql 端。
此指令包含連線失敗的自動重試邏輯。 你可以用旗 --max-retries 標設定重試行為。
databricks psql [DATABASE_INSTANCE_NAME] [-- PSQL_ARGS...] [flags]
Arguments
DATABASE_INSTANCE_NAME
要連接的資料庫實例名稱。
PSQL_ARGS (選用)
還有額外的論點要交給 psql 客戶。 在雙段劃--分符()後指定這些。
選項
--max-retries int
連線重試次數上限。 設定為 0 以停用重試。 預設值:3。
範例
以下範例連接至資料庫實例:
databricks psql my-database
以下範例連接資料庫實例並執行 SQL 查詢:
databricks psql my-database -- -c "SELECT * FROM my_table"
以下範例連結多種 psql 選項:
databricks psql my-database -- --echo-all -d "my-db"
以下範例與自訂重試行為相連結:
databricks psql my-database --max-retries 5
以下範例在關閉重試時連接:
databricks psql my-database --max-retries 0
全域旗標
--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 字串
如果適用,要使用的套件組合目標