共用方式為


schemas 命令群組

Note

此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態

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

schemas Databricks CLI 中的指令群組包含管理 Unity 目錄中結構的指令。 架構是 Unity 目錄三層命名空間的第二層。 架構會組織數據表、檢視和函式。 請參閱 什麼是 Azure Databricks 中的架構?

databricks 架構建立

在中繼存放區中建立目錄的新架構。 呼叫端必須是中繼存放區管理員,或具有 CREATE_SCHEMA 父目錄中的許可權。

databricks schemas create NAME CATALOG_NAME [flags]

Arguments

NAME

    架構的名稱,相對於父目錄。

CATALOG_NAME

    父目錄的名稱。

選項

--comment string

    使用者提供的自由格式文字描述。

--json JSON

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

--storage-root string

    架構中受控數據表的記憶體根 URL。

全域旗標

Examples

下列範例會在目錄中建立名為 analyticsmain 的新架構:

databricks schemas create analytics main

下列範例會建立具有批注的新架構:

databricks schemas create analytics main --comment "Schema for analytics data"

databricks 架構刪除

從父目錄刪除指定的架構。 呼叫端必須是架構的擁有者或父目錄的擁有者。

databricks schemas delete FULL_NAME [flags]

Arguments

FULL_NAME

    架構的完整名稱。

選項

--force

    即使架構不是空的,仍強制刪除。

全域旗標

Examples

下列範例會刪除架構:

databricks schemas delete main.analytics

下列範例會強制刪除架構,即使它不是空的:

databricks schemas delete main.analytics --force

databricks 架構取得

取得中繼存放區內的指定架構。 呼叫端必須是中繼存放區管理員、架構的擁有者,或具有 USE_SCHEMA 架構許可權的使用者。

databricks schemas get FULL_NAME [flags]

Arguments

FULL_NAME

    架構的完整名稱。

選項

--include-browse

    是否應該在主體只能存取部分元數據的情況下,於回應中包含架構。

全域旗標

Examples

下列範例會取得架構的相關信息:

databricks schemas get main.analytics

下列範例會取得架構資訊,包括瀏覽許可權:

databricks schemas get main.analytics --include-browse

databricks 架構清單

列出中繼存放區中目錄的架構。 如果呼叫端是中繼存放區管理員或父目錄的擁有者,則會擷取目錄的所有架構。 否則,只會擷取呼叫端所擁有的架構(或呼叫端具有 USE_SCHEMA 許可權的架構)。 不保證陣列中的元素有特定的順序。

databricks schemas list CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    感興趣架構的父目錄。

選項

--include-browse

    是否應該在主體只能存取部分元數據的情況下,於回應中包含架構。

--max-results int

    要傳回的架構數目上限。

--page-token string

    不透明分頁令牌會根據上一個查詢移至下一頁。

全域旗標

Examples

下列範例會列出main目錄中的所有架構:

databricks schemas list main

下列範例會列出最多 10 個結果的架構:

databricks schemas list main --max-results 10

下列範例會列出使用分頁的架構:

databricks schemas list main --page-token <token>

databricks 架構更新

更新目錄的架構。 呼叫端必須是資料庫結構的擁有者或中繼存放區管理員。如果呼叫端是中繼存放區管理員,則在更新過程中只能變更 owner 欄位。 如果name欄位必須更新,呼叫者必須是中繼存放區管理員,或具有父目錄的CREATE_SCHEMA許可權。

databricks schemas update FULL_NAME [flags]

Arguments

FULL_NAME

    架構的完整名稱。

選項

--comment string

    使用者提供的自由格式文字描述。

--enable-predictive-optimization EnablePredictiveOptimization

    是否應該為此物件及其下的物件啟用預測優化。 支援的值:[DISABLE、ENABLE、INHERIT]

--json JSON

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

--new-name string

    架構的新名稱。

--owner string

    架構目前擁有者的用戶名稱。

全域旗標

Examples

下列範例會更新架構的批註:

databricks schemas update main.analytics --comment "Updated analytics schema"

下列範例會變更架構的擁有者:

databricks schemas update main.analytics --owner someone@example.com

下列範例會重新命名架構:

databricks schemas update main.analytics --new-name analytics_v2

全域旗標

--debug

  是否要啟用偵錯記錄。

-h--help

    顯示 Databricks CLI、相關命令群組或相關命令的幫助說明。

--log-file 字串

    字串,表示要寫入輸出記錄檔的檔案。 若未指定此旗標,則預設值是將輸出記錄寫入 stderr。

--log-format 格式

    記錄格式類型,textjson。 預設值是 text

--log-level 字串

    表示日誌格式層級的字串。 若未指定,則日誌的格式層級功能將被停用。

-o, --output 類型

    指令輸出類型,textjson。 預設值是 text

-p, --profile 字串

    用於執行命令的~/.databrickscfg檔案中的配置檔名稱。 如果未指定此旗標,則如果存在,則會使用名為 DEFAULT 的配置檔。

--progress-format 格式

    顯示進度記錄的格式:default、、appendinplace、 或json

-t, --target 字串

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