Note
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
schemas 内の コマンド グループには、Unity カタログでスキーマを管理するためのコマンドが含まれています。 スキーマは、Unity カタログの 3 レベル名前空間の 2 番目のレイヤーです。 スキーマは、テーブル、ビュー、関数を整理します。
「Azure Databricks のスキーマとは」を参照してください。
databricks スキーマを作成
メタストアにカタログの新しいスキーマを作成します。 呼び出し元はメタストア管理者であるか、親カタログの CREATE_SCHEMA 特権を持っている必要があります。
databricks schemas create NAME CATALOG_NAME [flags]
Arguments
NAME
親カタログを基準としたスキーマの名前。
CATALOG_NAME
親カタログの名前。
オプション
--comment string
ユーザー指定の自由形式のテキストの説明。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
--storage-root string
スキーマ内のマネージド テーブルのストレージ ルート URL。
Examples
次の例では、analytics カタログに main という名前の新しいスキーマを作成します。
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 ファイルに対するインライン JSON 文字列または @path。
--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 形式
ログ形式の種類、 text 、または json。 既定値は text です。
--log-level 文字列
ログ形式レベルを表す文字列。 指定しない場合、ログ形式レベルは無効になります。
-o, --output 型
コマンド出力の種類( text または json)。 既定値は text です。
-p, --profile 文字列
コマンドの実行に使用する ~/.databrickscfg ファイル内のプロファイルの名前。 このフラグが指定されていない場合は、存在する場合は、 DEFAULT という名前のプロファイルが使用されます。
--progress-format 形式
進行状況ログを表示する形式: default、 append、 inplace、または json
-t, --target 文字列
該当する場合は、使用するバンドル ターゲット