postgres 命令群組

備註

此資訊適用於 Databricks CLI 版本 0.285 及以上版本。

Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。

postgres Databricks CLI 中的指令群組包含管理 Lakebase Postgres 資源的指令，包括專案、分支、端點、角色、目錄及同步資料表。 Postgres API 透過 REST API 或直接 SQL 提供對 Postgres 資料庫的存取。

Databricks Postgres create-branch

建立分支。 建立分支時，必須指定永久分支的 no_expiry: true 到期政策。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres create-branch PARENT BRANCH_ID [flags]

Arguments

PARENT

    這個分支成立的專案。 格式：projects/{project_id}

BRANCH_ID

    用於分支的 ID，成為分支資源名稱的最後一個組件。 必須長度為 1 到 63 個字元，以小寫字母開頭，且僅包含小寫字母、數字及連字號（RFC 1123）。

選項

--json JSON

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

--name string

    分支的資源名稱。

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例在專案中建立分支：

databricks postgres create-branch projects/my-project-id my-branch \
  --json '{
    "spec": {
      "no_expiry": true
    }
  }'

以下範例是從現有分支建立分支：

databricks postgres create-branch projects/my-project-id dev-branch \
  --json '{
    "spec": {
      "source_branch": "projects/my-project-id/branches/main",
      "no_expiry": true
    }
  }'

Databricks postgres create-catalog

在 Unity 目錄中註冊一個 Postgres 資料庫。

備註

需要 Databricks CLI 版本 0.298 或以上。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres create-catalog CATALOG_ID [flags]

Arguments

CATALOG_ID

    Unity 目錄中目錄的 ID。 它成為目錄資源名稱的最後一個組件（例如， my_catalog 變成 catalogs/my_catalog）。

選項

--json JSON

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

--name string

    目錄的資源名稱（僅輸出）。

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例是在 Unity 目錄中註冊一個 Postgres 資料庫：

databricks postgres create-catalog my-catalog \
  --json '{
    "spec": {
      "postgres_database": "mydb",
      "branch": "projects/my-project-id/branches/production"
    }
  }'

Databricks Postgres create-endpoint

建立一個端點。 一個分支可以有一個讀寫運算端點，以及多個唯讀端點（讀取副本），以擴展讀取操作。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres create-endpoint PARENT ENDPOINT_ID [flags]

Arguments

PARENT

    建立這個端點的分支。 格式：projects/{project_id}/branches/{branch_id}

ENDPOINT_ID

    用於端點的 ID，成為端點資源名稱的最後一個元件。 必須長度為 1 到 63 個字元，以小寫字母開頭，且僅包含小寫字母、數字及連字號（RFC 1123）。

選項

--json JSON

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

--name string

    端點的資源名稱。

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例在分支中建立一個讀寫端點：

databricks postgres create-endpoint projects/my-project-id/branches/my-branch-id my-endpoint \
  --json '{
    "spec": {
      "endpoint_type": "ENDPOINT_TYPE_READ_WRITE",
      "autoscaling_limit_min_cu": 0.5,
      "autoscaling_limit_max_cu": 4.0
    }
  }'

以下範例建立一個唯讀端點（讀取副本）：

databricks postgres create-endpoint projects/my-project-id/branches/my-branch-id read-replica-1 \
  --json '{
    "spec": {
      "endpoint_type": "ENDPOINT_TYPE_READ_ONLY",
      "autoscaling_limit_min_cu": 0.5,
      "autoscaling_limit_max_cu": 4.0
    }
  }'

Databricks postgres create-project

建立一個專案。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

當你建立專案時，它會自動包含預設的生產分支和一個讀寫計算端點，兩者都有自動產生的 ID。

databricks postgres create-project PROJECT_ID [flags]

Arguments

PROJECT_ID

    專案使用的 ID，成為專案資源名稱的最終元件。 必須長度為 1 到 63 個字元，以小寫字母開頭，且僅包含小寫字母、數字及連字號（RFC 1123）。

選項

--json JSON

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

--name string

    專案的資源名稱。

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例建立一個專案：

databricks postgres create-project my-project \
  --json '{
    "spec": {
      "display_name": "My Project"
    }
  }'

以下範例建立一個特定 PostgreSQL 版本的專案：

databricks postgres create-project my-project \
  --json '{
    "spec": {
      "display_name": "My Project",
      "pg_version": "17"
    }
  }'

Databricks postgres create-role

為分支建立一個 Postgres 角色。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres create-role PARENT [flags]

Arguments

PARENT

    這個角色就是在設立的分支。 格式：projects/{project_id}/branches/{branch_id}。

選項

--json JSON

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

--name string

    角色的資源名稱（僅輸出）。

--no-wait

    不要等到完成狀態。

--role-id string

    角色使用的 ID，成為角色資源名稱的最後一個組件。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例在分支中建立一個基於密碼的角色：

databricks postgres create-role projects/my-project-id/branches/my-branch-id \
  --role-id my-role \
  --json '{"spec": {"postgres_role": "my-role"}}'

以下範例為 Databricks 使用者建立一個 OAuth 角色：

databricks postgres create-role projects/my-project-id/branches/my-branch-id \
  --role-id my-user-role \
  --json '{"spec": {"identity_type": "USER", "postgres_role": "user@example.com"}}'

Databricks Postgres create-synced-table

建立一個同步表格，持續將 Unity 目錄的資料表複製到 Lakebase Postgres 資料庫中。

備註

需要 Databricks CLI 版本 0.298 或以上。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres create-synced-table SYNCED_TABLE_ID [flags]

Arguments

SYNCED_TABLE_ID

    用於同步表格的 ID，格式化。{catalog}.{schema}.{table} 例如： my-catalog.sales.orders 。 這會建立一個 Unity Catalog 同步的表格，以及一個在結構{table}中命名{schema}的 Postgres 表格。

選項

--json JSON

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

--name string

    同步資料表的資源名稱（僅輸出）。

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例建立一個帶有一次性快照的同步表格：

databricks postgres create-synced-table my-catalog.sales.orders \
  --json '{
    "spec": {
      "source_table_full_name": "main.sales.orders",
      "branch": "projects/my-project-id/branches/production",
      "primary_key_columns": ["order_id"],
      "scheduling_policy": "SNAPSHOT",
      "postgres_database": "mydb",
      "create_database_objects_if_missing": true
    }
  }'

以下範例建立一個連續同步（近即時更新）的同步表：

databricks postgres create-synced-table my-catalog.sales.orders \
  --json '{
    "spec": {
      "source_table_full_name": "main.sales.orders",
      "branch": "projects/my-project-id/branches/production",
      "primary_key_columns": ["order_id"],
      "scheduling_policy": "CONTINUOUS",
      "postgres_database": "mydb",
      "create_database_objects_if_missing": true
    }
  }'

Databricks Postgres Delete-branch

刪除分支。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

受保護的分支無法被刪除。 刪除前會update-branch設定spec.is_protected為 false 。

databricks postgres delete-branch NAME [flags]

Arguments

NAME

    要刪除的分支名稱。 格式：projects/{project_id}/branches/{branch_id}

選項

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例刪除一個分支：

databricks postgres delete-branch projects/my-project-id/branches/my-branch-id

Databricks Postgres Delete-catalog

刪除資料庫目錄。

備註

需要 Databricks CLI 版本 0.298 或以上。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres delete-catalog NAME [flags]

Arguments

NAME

    目錄的完整資源路徑可刪除。 格式：catalogs/{catalog_id}

選項

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例刪除目錄：

databricks postgres delete-catalog catalogs/my-catalog

Databricks postgres delete-endpoint

刪除一個端點。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres delete-endpoint NAME [flags]

Arguments

NAME

    要刪除的端點名稱。 格式：projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

選項

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例刪除了一個端點：

databricks postgres delete-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id

Databricks Postgres Delete-Project

刪除專案。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres delete-project NAME [flags]

Arguments

NAME

    要刪除的專案名稱。 格式：projects/{project_id}

選項

--no-wait

    不要等到完成狀態。

--purge

    如果屬實，專案會永久刪除（硬刪除）。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例可軟刪除專案（可恢復7天）：

databricks postgres delete-project projects/my-project-id

以下範例會永久刪除專案：

databricks postgres delete-project projects/my-project-id --purge

Databricks postgres delete-role

從分支刪除 Postgres 角色。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres delete-role NAME [flags]

Arguments

NAME

    角色的完整資源路徑要刪除。 格式：projects/{project_id}/branches/{branch_id}/roles/{role_id}。

選項

--no-wait

    不要等到完成狀態。

--reassign-owned-to string

    將已刪除角色擁有的物件重新指派到這個角色。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例是從分支中刪除角色：

databricks postgres delete-role projects/my-project-id/branches/my-branch-id/roles/my-role

Databricks Postgres delete-synced-table

刪除同步的表格。

備註

需要 Databricks CLI 版本 0.298 或以上。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres delete-synced-table NAME [flags]

Arguments

NAME

    同步資料表的完整資源名稱。 格式：synced_tables/{catalog}.{schema}.{table}

選項

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例刪除同步資料表：

databricks postgres delete-synced-table "synced_tables/my-catalog.sales.orders"

Databricks postgres 生成-資料庫-credential

為 Postgres 資料庫產生 OAuth 憑證。 回傳的 OAuth 憑證用來驗證並連接到像 S 這類 psqlPostgreSQL 用戶端的資料庫。

databricks postgres generate-database-credential ENDPOINT [flags]

Arguments

ENDPOINT

    此憑證產生的端點。 格式：projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

選項

--json JSON

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

全域旗標

範例

以下範例為端點產生 OAuth 憑證：

databricks postgres generate-database-credential projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id

Databricks Postgres Get-branch

拿枝樹枝。

databricks postgres get-branch NAME [flags]

Arguments

NAME

    要取回的分支名稱。 格式：projects/{project_id}/branches/{branch_id}

選項

全域旗標

範例

以下範例可獲得分支的資訊：

databricks postgres get-branch projects/my-project-id/branches/my-branch-id

Databricks Postgres Get-catalog

取得資料庫目錄。

備註

需要 Databricks CLI 版本 0.298 或以上。

databricks postgres get-catalog NAME [flags]

Arguments

NAME

    目錄的完整資源路徑可供檢索。 格式：catalogs/{catalog_id}

選項

全域旗標

範例

以下範例取得關於目錄的資訊：

databricks postgres get-catalog catalogs/my-catalog

Databricks Postgres Get-Endpoint

買一個終端機。

databricks postgres get-endpoint NAME [flags]

Arguments

NAME

    要取回的端點名稱。 格式：projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

選項

全域旗標

範例

以下範例取得端點的資訊：

databricks postgres get-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id

Databricks postgres get-operation

去動手術吧。

databricks postgres get-operation NAME [flags]

Arguments

NAME

    這個行動資源的名稱。

選項

全域旗標

範例

以下範例可取得操作相關資訊：

databricks postgres get-operation projects/my-project-id/operations/my-operation-id

Databricks postgres Get-Project

找個專案。

databricks postgres get-project NAME [flags]

Arguments

NAME

    要取回的計畫名稱。 格式：projects/{project_id}

選項

全域旗標

範例

以下範例提供關於專案的資訊：

databricks postgres get-project projects/my-project-id

Databricks postgres get-role

去分公司申請Postgres職位。 取得指定角色的資訊，包括其認證方式與權限。

databricks postgres get-role NAME [flags]

Arguments

NAME

    角色的完整資源路徑要取回。 格式：projects/{project_id}/branches/{branch_id}/roles/{role_id}。

選項

全域旗標

範例

以下範例獲得角色：

databricks postgres get-role projects/my-project-id/branches/my-branch-id/roles/my-role

Databricks Postgres Get-synced-table

買一個同步表。

備註

需要 Databricks CLI 版本 0.298 或以上。

databricks postgres get-synced-table NAME [flags]

Arguments

NAME

    同步資料表的完整資源名稱。 格式：synced_tables/{catalog}.{schema}.{table}

選項

全域旗標

範例

以下範例取得關於同步資料表的資訊：

databricks postgres get-synced-table "synced_tables/my-catalog.sales.orders"

DataBricks Postgres list-branches

列表分支。 使用此指令查找分支 ID，包括你專案中預設建立的分支（狀態中標示 "default": true ）。

databricks postgres list-branches PARENT [flags]

Arguments

PARENT

    擁有這批分支的計畫。 格式：projects/{project_id}

選項

--page-size int

    傳回項目的上限。

--page-token string

    來自先前回覆的頁面標記。

全域旗標

範例

以下範例列出專案中的所有分支：

databricks postgres list-branches projects/my-project-id

以下範例列出具有分頁的分支：

databricks postgres list-branches projects/my-project-id --page-size 10

Databricks postgres list-cdf-configs

在資料庫下列出 Lakebase CDF 配置（CdfConfigs）。

databricks postgres list-cdf-configs PARENT [flags]

Arguments

PARENT

    用來列出 CdfConfigs 的父資料庫。 格式：projects/{project}/branches/{branch}/databases/{database}

選項

--limit int

    要傳回的結果數目上限。

--page-size int

    最多可回傳的 CdfConfig 數量。

全域旗標

範例

以下範例列出了湖基CDF的配置：

databricks postgres list-cdf-configs "projects/my-project/branches/my-branch/databases/my-database"

以下範例列出了帶有分頁的 CDF 配置：

databricks postgres list-cdf-configs "projects/my-project/branches/my-branch/databases/my-database" --page-size 10

Databricks postgres list-CDF-statuses

在 Lakebase CDF 配置下列出複製資料表的複製狀態。

databricks postgres list-cdf-statuses PARENT [flags]

Arguments

PARENT

    為 CdfConfig 列出 CdfStatuses。 格式：projects/{project}/branches/{branch}/databases/{database}/cdf-configs/{cdf_config}

選項

--limit int

    要傳回的結果數目上限。

--page-size int

    最多可返回的 CdfStatuss 數量。

全域旗標

範例

以下範例列出 CDF 配置的複寫狀態：

databricks postgres list-cdf-statuses "projects/my-project/branches/my-branch/databases/my-database/cdf-configs/my-cdf-config"

Databricks Postgres 列表-資料庫

在分支中列出 Postgres 資料庫。

databricks postgres list-databases PARENT [flags]

Arguments

PARENT

    擁有這組資料庫的分局。 格式：projects/{project_id}/branches/{branch_id}

選項

--limit int

    要傳回的結果數目上限。

--page-size int

    傳回項目的上限。

全域旗標

範例

以下範例列出分支中的所有資料庫：

databricks postgres list-databases projects/my-project-id/branches/my-branch-id

以下範例列出具有分頁的資料庫：

databricks postgres list-databases projects/my-project-id/branches/my-branch-id --page-size 10

Databricks postgres list-endpoints

列出端點。 使用此指令尋找端點 ID，包括你專案自動建立的預設讀寫端點。

databricks postgres list-endpoints PARENT [flags]

Arguments

PARENT

    擁有這組端點的分支。 格式：projects/{project_id}/branches/{branch_id}

選項

--page-size int

    傳回項目的上限。

--page-token string

    來自先前回覆的頁面標記。

全域旗標

範例

以下範例列出分支中的所有端點：

databricks postgres list-endpoints projects/my-project-id/branches/my-branch-id

以下範例列出具有分頁的端點：

databricks postgres list-endpoints projects/my-project-id/branches/my-branch-id --page-size 10

DataBricks Postgres list-projects

列出專案。

databricks postgres list-projects [flags]

選項

--limit int

    要傳回的結果數目上限。

--page-size int

    傳回項目的上限。

--page-token string

    來自先前回覆的頁面標記。

--show-deleted

    是否在回應中包含軟刪除的專案。

全域旗標

範例

以下範例列出所有專案：

databricks postgres list-projects

以下範例列出具有分頁的專案：

databricks postgres list-projects --page-size 10

以下範例列出所有專案，包括軟刪除的專案：

databricks postgres list-projects --show-deleted

Databricks postgres list-roles

列出分支機構的Postgre職位。

databricks postgres list-roles PARENT [flags]

Arguments

PARENT

    擁有這些角色集合的分部。 格式：projects/{project_id}/branches/{branch_id}。

選項

--page-size int

    傳回項目的上限。

--page-token string

    來自先前回覆的頁面標記。

全域旗標

範例

以下範例列出分支中的所有角色：

databricks postgres list-roles projects/my-project-id/branches/my-branch-id

Databricks postgres undelete-project

還原刪除 Project。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres undelete-project NAME [flags]

Arguments

NAME

    專案的完整資源路徑可復原。 格式：projects/{project_id}

選項

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例是恢復一個軟刪除的專案：

databricks postgres undelete-project projects/my-project-id

Databricks Postgres Update-branch

更新分支。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres update-branch NAME UPDATE_MASK [flags]

Arguments

NAME

    分支的資源名稱。 格式：projects/{project_id}/branches/{branch_id}

UPDATE_MASK

    要更新的欄位清單。 若未指定欄位，則在可能的情況下更新所有欄位。

選項

--json JSON

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

--name string

    分支的資源名稱。

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例更新分支以使其受到保護：

databricks postgres update-branch projects/my-project-id/branches/my-branch-id spec.is_protected \
  --json '{
    "spec": {
      "is_protected": true
    }
  }'

Databricks postgres update-endpoint

更新端點。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres update-endpoint NAME UPDATE_MASK [flags]

Arguments

NAME

    端點的資源名稱。 格式：projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

UPDATE_MASK

    要更新的欄位清單。 若未指定欄位，則在可能的情況下更新所有欄位。

選項

--json JSON

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

--name string

    端點的資源名稱。

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例更新端點的最大運算單元：

databricks postgres update-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id spec.autoscaling_limit_max_cu \
  --json '{
    "spec": {
      "autoscaling_limit_max_cu": 8.0
    }
  }'

以下範例更新多個欄位（最小與最大計算單位）：

databricks postgres update-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id "spec.autoscaling_limit_min_cu,spec.autoscaling_limit_max_cu" \
  --json '{
    "spec": {
      "autoscaling_limit_min_cu": 1.0,
      "autoscaling_limit_max_cu": 8.0
    }
  }'

要設定縮放到零，請在更新遮罩中包含 spec.suspension 。 設定 suspend_timeout_duration （60秒–604800秒）來定義非活動逾時，或 no_suspension: true 停用它。 不要同時設定兩者。 設定會 no_suspension: false 回傳錯誤。

以下範例將縮放為零：

databricks postgres update-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id spec.suspension \
  --json '{
    "spec": {
      "no_suspension": true
    }
  }'

以下範例允許在 5 分鐘不動時時內縮放至零：

databricks postgres update-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id spec.suspension \
  --json '{
    "spec": {
      "suspend_timeout_duration": "300s"
    }
  }'

Databricks Postgres Update-project

更新專案。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres update-project NAME UPDATE_MASK [flags]

Arguments

NAME

    專案的資源名稱。 格式：projects/{project_id}

UPDATE_MASK

    要更新的欄位清單。 若未指定欄位，則在可能的情況下更新所有欄位。

選項

--json JSON

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

--name string

    專案的資源名稱。

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例更新專案的顯示名稱：

databricks postgres update-project projects/my-project-id spec.display_name \
  --json '{
    "spec": {
      "display_name": "Updated Project Name"
    }
  }'

Databricks postgres update-role

更新分支的 Postgres 角色。

備註

這是一個持續很久的行動。 預設情況下，指令會等待操作完成。 用來 --no-wait 立即返回原始操作細節。 操作欄位 name 可用來輪詢完成 get-operation 指令。

databricks postgres update-role NAME UPDATE_MASK [flags]

Arguments

NAME

    完整的資源路徑。 格式：projects/{project_id}/branches/{branch_id}/roles/{role_id}。

UPDATE_MASK

    要更新的欄位清單。 若未指定欄位，則在可能的情況下更新所有欄位。

選項

--json JSON

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

--name string

    角色的資源名稱（僅輸出）。

--no-wait

    不要等到完成狀態。

--timeout duration

    達到完成狀態的最長時間。

全域旗標

範例

以下範例授予 CREATEDB 一個角色。 更新 spec.attributes時，必須提供三個屬性欄位：

databricks postgres update-role projects/my-project-id/branches/my-branch-id/roles/my-role \
  spec.attributes \
  --json '{"spec": {"attributes": {"createdb": true, "createrole": false, "bypassrls": false}}}'

以下範例為成員加入一個角色 databricks_superuser ：

databricks postgres update-role projects/my-project-id/branches/my-branch-id/roles/my-role \
  spec.membership_roles \
  --json '{"spec": {"membership_roles": ["DATABRICKS_SUPERUSER"]}}'

全域旗標

--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 字串

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