Note
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
tables 内の コマンド グループには、Unity カタログのテーブルを管理するためのコマンドが含まれています。 テーブルは、Unity カタログの 3 レベル名前空間の 3 番目のレイヤーに存在します。 これにはデータの行が含まれます。
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 テーブルの list-summaries
メタストア内のスキーマとカタログのテーブルの概要を一覧表示します。 返されるテーブルの概要は次のいずれかです。
- (現在のメタストアおよび親カタログとスキーマ内の) テーブルの概要。ユーザーがメタストア管理者である場合、
- またはテーブルとスキーマの概要 (現在のメタストアと親カタログ内) で、ユーザーがテーブルと所有権に対する
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、 append、 inplace、または json
-t, --target 文字列
該当する場合は、使用するバンドル ターゲット