tables 命令群組

Note

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

tables Databricks CLI 中的指令群組包含管理 Unity 目錄中資料表的指令。 數據表位於 Unity 目錄三層命名空間的第三層。 其中包含數據列。

Databricks 的表格建立

在指定的目錄和結構中建立一個新的資料表。

Note

此 API 僅支援建立 外部 Delta 資料表。 僅支援 TABLE_TYPE=EXTERNAL 和 DATA_SOURCE_FORMAT=DELTA。 透過此 API 建立資料表時不支援欄位遮罩。

要建立外部 Delta 資料表，呼叫者除了標準EXTERNAL_USE_SCHEMA的 、 、 EXTERNAL_USE_LOCATIONUSE_CATALOG、 和 CREATE_TABLE 權限外，還必須在父架構和USE_SCHEMA外部位置擁有 CREATE_EXTERNAL_TABLE 。 columns欄位必須是與 Spark 相容的格式。

databricks tables create NAME CATALOG_NAME SCHEMA_NAME TABLE_TYPE DATA_SOURCE_FORMAT STORAGE_LOCATION [flags]

Arguments

NAME

    相對於父架構的資料表名稱。

CATALOG_NAME

    母目錄名稱。

SCHEMA_NAME

    父結構的名稱，相對於其母目錄。

TABLE_TYPE

    數據表的類型。 支援值：EXTERNAL、、EXTERNAL_SHALLOW_CLONEFOREIGN、MANAGED、MANAGED_SHALLOW_CLONE、。 MATERIALIZED_VIEWMETRIC_VIEWSTREAMING_TABLEVIEW

DATA_SOURCE_FORMAT

    數據表的數據源格式。 支援值：AVRO、CSV、DELTA、DELTASHARINGHIVEICEBERGJSONORCPARQUETTEXT及其他。

STORAGE_LOCATION

    資料表的儲存根網址（與資料表的必要條件MANAGEDEXTERNAL）。

選項

--json JSON

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

全域旗標

Examples

以下範例建立一個外部 Delta 表格：

databricks tables create my_table my_catalog my_schema EXTERNAL DELTA s3://my-bucket/my-table

刪除Databricks資料表

從指定的父目錄和架構中刪除資料表。 呼叫者必須是父目錄的擁有者並對父目錄擁有USE_CATALOG許可權且是父架構的擁有者，或是數據表的擁有者並對父目錄擁有USE_CATALOG許可權以及對父架構擁有USE_SCHEMA許可權。

databricks tables delete FULL_NAME [flags]

Arguments

FULL_NAME

    數據表的完整名稱。

選項

全域旗標

Examples

下列範例會刪除資料表：

databricks tables delete my_catalog.my_schema.my_table

databricks 數據表存在

取得數據表是否存在於特定目錄和架構的中繼存放區中。 呼叫端必須滿足下列其中一個需求：

  • 成為中繼存放區管理員
  • 成為父目錄的擁有者
  • 成為父結構的擁有者，並在父目錄上具有 USE_CATALOG 權限
  • 具有 USE_CATALOG 父資料庫的許可權和 USE_SCHEMA 父結構的許可權，並且是資料表的擁有者或擁有 SELECT 資料表的許可權。
  • 具有 BROWSE 父目錄的權限
  • 具有 BROWSE 父架構上的特權。
databricks tables exists FULL_NAME [flags]

Arguments

FULL_NAME

    數據表的完整名稱。

選項

全域旗標

Examples

下列範例會檢查數據表是否存在：

databricks tables exists my_catalog.my_schema.my_table

databricks 取得數據表

從中繼存放區取得特定目錄和架構的數據表。 呼叫端必須滿足下列其中一個需求：

  • 成為中繼存放區管理員
  • 成為父目錄的擁有者
  • 成為父結構的擁有者，並在父目錄上具有 USE_CATALOG 權限
  • 具有 USE_CATALOG 父資料庫的許可權和 USE_SCHEMA 父結構的許可權，並且是資料表的擁有者或擁有 SELECT 資料表的許可權。
databricks tables get FULL_NAME [flags]

Arguments

FULL_NAME

    數據表的完整名稱。

選項

--include-browse

    是否要在管理者只能存取選擇性元數據的回應中包含資料表。

--include-delta-metadata

    差異元數據是否應該包含在回應中。

--include-manifest-capabilities

    是否要包含數據表的功能清單。

全域旗標

Examples

下列範例會取得數據表的相關信息：

databricks tables get my_catalog.my_schema.my_table

下列範例會取得包含差異元資料的數據表：

databricks tables get my_catalog.my_schema.my_table --include-delta-metadata

databricks 數據表列表

列出父目錄和架構下目前中繼存放區的所有數據表。 呼叫端必須是中繼存放區管理員或擁有者（或具有 SELECT 資料表的權限）。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。 不保證陣列中的元素有特定的順序。

databricks tables list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    相關數據表的父目錄名稱。

SCHEMA_NAME

    數據表的父架構。

選項

--include-browse

    是否要在管理者只能存取選擇性元數據的回應中包含資料表。

--include-delta-metadata

    差異元數據是否應該包含在回應中。

--include-manifest-capabilities

    是否要包含數據表的功能清單。

--max-results int

    要傳回的數據表數目上限。

--omit-columns

    是否要從回應中省略數據表的列。

--omit-properties

    是否要從回應中省略數據表的屬性。

--omit-username

    是否要省略數據表的用戶名稱（例如

--page-token string

    要針對結果下一頁傳送的不透明令牌（分頁）。

全域旗標

Examples

下列範例會列出目錄和架構中的所有資料表：

databricks tables list my_catalog my_schema

下列範例列出包含省略資料欄的資料表：

databricks tables list my_catalog my_schema --omit-columns

databricks 數據表清單摘要

列出中繼存放區內架構和目錄之數據表的摘要。 傳回的數據表摘要為：

  • 當使用者是中繼存放區管理員時，數據表的摘要（在目前的中繼存放區和父目錄和架構內）
  • 或數據表和架構的摘要（在目前的中繼存放區和父目錄內），如果使用者擁有表格的擁有權或 SELECT 許可權，並且擁有架構的擁有權或 USE_SCHEMA 許可權，前提是使用者也必須具備父目錄的擁有權或 USE_CATALOG 許可權。

不保證陣列中的元素有特定的順序。

databricks tables list-summaries CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    相關數據表的父目錄名稱。

選項

--include-manifest-capabilities

    是否要包含數據表的功能清單。

--max-results int

    要傳回之數據表的摘要數目上限。

--page-token string

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

--schema-name-pattern string

    使用於架構名稱的 SQL LIKE 模式（% 和 _）。

--table-name-pattern string

    SQL LIKE 模式 （% 和 _）適用於數據表名稱。

全域旗標

Examples

下列範例會列出目錄的資料表摘要：

databricks tables list-summaries my_catalog

下列範例列出具有架構名稱模式的數據表摘要：

databricks tables list-summaries my_catalog --schema-name-pattern "prod_%"

下列範例列出符合資料表名稱模式的表格摘要：

databricks tables list-summaries my_catalog --table-name-pattern "fact_%"

全域旗標

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

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

  • Last updated on