Note
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
tables
Databricks CLI 中的指令群組包含管理 Unity 目錄中資料表的指令。 數據表位於 Unity 目錄三層命名空間的第三層。 其中包含數據列。
刪除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 字串
如果適用，要使用的套件組合目標