metastores コマンド グループ

The metastores command group within the Databricks CLI allows you to manage metastores. メタストアは、Unity カタログ内のオブジェクトの最上位のコンテナーです。 データ資産 (テーブルとビュー) と、それらに対するアクセス権を管理するアクセス許可が格納されます。 See Metastore.

databricks metastores assign

新しいメタストア割り当てを作成します。 同じ workspace_id の割り当てが存在する場合は、新しい metastore_id および default_catalog_nameによって上書きされます。 呼び出し元はアカウント管理者である必要があります。

databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]

Arguments

WORKSPACE_ID

    ワークスペース ID。

METASTORE_ID

    メタストアの一意の ID。

DEFAULT_CATALOG_NAME

    Deprecated. Databricks ワークスペースの既定のカタログを構成するには、"既定の名前空間 API" を使用します。 メタストア内の既定のカタログの名前。

オプション

--json JSON

    要求本文を含む JSON ファイルへのインライン JSON 文字列または @path 。

Global flags

Examples

次の例では、ワークスペースにメタストアを割り当てます。

databricks metastores assign 123456789 abc123-def456-ghi789 main

databricks metastores create

指定された名前とオプションのストレージ ルート パスに基づいて新しいメタストアを作成します。 既定では (所有者フィールドが設定されていない場合)、新しいメタストアの所有者は createMetastore API を呼び出すユーザーです。 所有者フィールドが空の文字列 ("") に設定されている場合、所有権は代わりにシステム ユーザーに割り当てられます。

databricks metastores create NAME [flags]

Arguments

NAME

    メタストアのユーザー指定の名前。

オプション

--json JSON

    要求本文を含む JSON ファイルへのインライン JSON 文字列または @path 。

--region string

    メタストアが提供するクラウド リージョン (us-west-2、westus など)。

--storage-root string

    メタストアのストレージ ルート URL。

Global flags

Examples

次の例では、名前とストレージ ルートを使用してメタストアを作成します。

databricks metastores create my-metastore --storage-root s3://my-bucket/metastore-root --region us-west-2

databricks metastores current

アクセスするワークスペースのメタストア割り当てを取得します。

databricks metastores current [flags]

オプション

Global flags

Examples

次の例では、現在のメタストアの割り当てを取得します。

databricks metastores current

databricks メタストアの削除

メタストアを削除します。 呼び出し元はメタストア管理者である必要があります。

databricks metastores delete ID [flags]

Arguments

ID

    メタストアの一意の ID。

オプション

--force

    メタストアが空でない場合でも、強制的に削除します。

Global flags

Examples

次の例では、メタストアを削除します。

databricks metastores delete abc123-def456-ghi789

次の例では、メタストアが空でない場合でも強制的に削除します。

databricks metastores delete abc123-def456-ghi789 --force

databricks metastores get

指定された ID と一致するメタストアを取得します。 この情報を取得するには、呼び出し元がメタストア管理者である必要があります。

databricks metastores get ID [flags]

Arguments

ID

    メタストアの一意の ID。

オプション

Global flags

Examples

次の例では、特定のメタストアに関する情報を取得します。

databricks metastores get abc123-def456-ghi789

databricks メタストアの一覧

使用可能なメタストアを一覧表示します。 この情報を取得するには、呼び出し元が管理者である必要があります。 リスト内の項目の特定の順序は保証されません。

databricks metastores list [flags]

オプション

--max-results int

    返されるメタストアの最大数。

--page-token string

    前のクエリに基づいて次のページに移動する不透明な改ページ トークン。

Global flags

Examples

次の例では、使用可能なすべてのメタストアを一覧表示します。

databricks metastores list

次の例では、改ページ位置付きのメタストアの一覧を示します。

databricks metastores list --max-results 10 --page-token abc123token

databricks メタストアの概要

メタストアに関する概要情報を取得します。 この概要には、ストレージ資格情報、クラウド ベンダー、クラウド リージョン、グローバル メタストア ID が含まれます。

databricks metastores summary [flags]

オプション

Global flags

Examples

次の例では、メタストアの概要を取得します。

databricks metastores summary

databricks metastores unassign

メタストアの割り当てを削除します。 呼び出し元はアカウント管理者である必要があります。

databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]

Arguments

WORKSPACE_ID

    ワークスペース ID。

METASTORE_ID

    削除するメタストアの ID を照会します。

オプション

Global flags

Examples

次の例では、ワークスペースからメタストアの割り当てを解除します。

databricks metastores unassign 123456789 abc123-def456-ghi789

databricks メタストアの更新

特定のメタストアの情報を更新します。 呼び出し元はメタストア管理者である必要があります。所有者フィールドが空の文字列 ("") に設定されている場合、所有権はシステム ユーザーに更新されます。

databricks metastores update ID [flags]

Arguments

ID

    メタストアの一意の ID。

オプション

--delta-sharing-organization-name string

    Databricks-to-Databricks Delta Sharing で公式名として使用されるデルタ共有エンティティの組織名。

--delta-sharing-recipient-token-lifetime-in-seconds int

    差分共有受信者トークンの有効期間 (秒単位)。

--delta-sharing-scope DeltaSharingScopeEnum

    メタストアに対して有効になっている差分共有のスコープ。 サポートされる値: INTERNAL、 INTERNAL_AND_EXTERNAL

--json JSON

    要求本文を含む JSON ファイルへのインライン JSON 文字列または @path 。

--new-name string

    メタストアの新しい名前。

--owner string

    メタストアの所有者。

--privilege-model-version string

    metastore の特権モデル バージョン。major.minor 形式 (例: 1.0)。

--storage-root-credential-id string

    メタストア storage_rootにアクセスするためのストレージ資格情報の UUID。

Global flags

Examples

次の例では、メタストア名を更新します。

databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore

次の例では、デルタ共有構成でメタストアを更新します。

databricks metastores update abc123-def456-ghi789 --delta-sharing-scope INTERNAL_AND_EXTERNAL --delta-sharing-organization-name my-org

databricks metastores update-assignment

メタストアの割り当てを更新します。 ワークスペースにメタストアが既に割り当てられている場合は、この操作を使用して、指定したワークスペースの metastore_id または default_catalog_name を更新できます。 呼び出し元は、 metastore_idを更新するアカウント管理者である必要があります。それ以外の場合は、呼び出し元をワークスペース管理者にすることができます。

databricks metastores update-assignment WORKSPACE_ID [flags]

Arguments

WORKSPACE_ID

    ワークスペース ID。

オプション

--default-catalog-name string

    メタストア内の既定のカタログの名前。

--json JSON

    要求本文を含む JSON ファイルへのインライン JSON 文字列または @path 。

--metastore-id string

    メタストアの一意の ID。

Global flags

Examples

次の例では、メタストア割り当ての既定のカタログを更新します。

databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog

次の例では、メタストア割り当てのメタストア ID を更新します。

databricks metastores update-assignment 123456789 --metastore-id new-metastore-id

Global flags

--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 糸

    該当する場合は、使用するバンドル ターゲット