カタログの作成

この記事では、Unity Catalog でカタログを作成する方法を説明します。カタログにはスキーマ (データベース) が含まれ、スキーマにはテーブル、ビュー、ボリューム、モデル、および関数が含まれます。

カタログの詳細については、「Databricks のカタログとは何ですか?」を参照してください。

注：

外部データシステムのデータベースをミラーリングする Unity Catalog オブジェクトである外部カタログを作成する方法については、「外部カタログの作成」を参照してください。「外部カタログの管理と操作」も参照してください。

要件

カタログの種類に関係なく、カタログを作成するには:

Databricks メタストア管理者であるか、メタストアに対するCREATE CATALOG権限を持っている必要があります。
カタログを作成するために使用するデータベースは、 Databricks Runtime 11.3 以上であり、Unity Catalog に準拠したアクセスモードを使用する必要があります。アクセス・モードを参照してください。SQLウェアハウスは常にUnity Catalogをサポートしています。

共有カタログを作成するには:

Delta Sharing 共有はワークスペース内にすでに存在している必要があります。「共有データをチームで利用できるようにする方法」を参照してください。
メタストア管理者であるか、メタストアに対する USE PROVIDER 特権を持っているか、共有を含むプロバイダーオブジェクトを所有している必要があります。

標準カタログを作成するには:

カタログの管理対象ストレージ場所を指定する場合は、ターゲット外部場所に対するCREATE MANAGED STORAGE権限が必要です。
メタストアレベルの管理対象ストレージが存在しない場合は、カタログの管理対象ストレージの場所を指定する 必要があります 。

外部カタログを作成するには:

外部カタログを作成するために使用する接続の所有者であるか、接続に対するCREATE FOREIGN CATALOG権限を持っている必要があります。
コンピュートはDatabricks Runtime 13.1 以上で使用する必要があります。 SQLウェアハウスはProまたはサーバーレスである必要があります。

カタログを作成する

カタログを作成するには、カタログエクスプローラー、SQL コマンド、REST API、Databricks CLI、または Terraform を使用できます。カタログを作成すると、 default と information_schemaの 2 つのスキーマ (データベース) が自動的に作成されます。

カタログを作成した後は、カタログエクスプローラーを使用して、いつでも所有者、タグ、コメント、ワークスペースバインディング、および権限を更新できます。

標準カタログを作成するには、ノートブックまたは SQL クエリエディターで次の SQL コマンドを実行します。括弧内の項目はオプションです。プレースホルダーの値を置き換えます。

<catalog-name>: カタログの名前。
<location-path>: オプションですが、強くお勧めします。このカタログ内の管理対象テーブルを、メタストア用に構成されたデフォルトのルートストレージとは異なる場所に保存する場合は、ストレージの場所のパスを指定します。

重要

ワークスペースにメタストアレベルのストレージの場所がない場合は、カタログを作成するときに管理されたストレージの場所を指定する必要があります。

このパスは外部ロケーション構成で定義する必要があり、外部ロケーション構成に対するCREATE MANAGED STORAGE権限を持っている必要があります。外部ロケーション構成で定義されているパスまたはサブパス (つまり、 's3://depts/finance'または's3://depts/finance/product' ) を使用できます。
<comment>: オプションの説明またはその他のコメント。

CREATE CATALOG [ IF NOT EXISTS ] <catalog-name>
   [ MANAGED LOCATION '<location-path>' ]
   [ COMMENT <comment> ];

たとえば、 exampleという名前のカタログを作成するには、次のようにします。

CREATE CATALOG IF NOT EXISTS example;

共有カタログを作成するには、ノートブックまたは SQL クエリエディターで次のコマンドを実行します。括弧内の項目はオプションです。

CREATE CATALOG [IF NOT EXISTS] <catalog-name>
USING SHARE <provider-name>.<share-name>;
[ COMMENT <comment> ];

外部カタログを作成するには、ノートブックまたは SQL クエリエディターで次のコマンドを実行します。括弧内の項目はオプションです。プレースホルダーの値を置き換えます。

<catalog-name>: Databricks のカタログの名前。
<connection-name>: データソース、パス、およびアクセス資格情報を指定する接続オブジェクト。
<database-name>: Databricks でカタログとしてミラーリングするデータベースの名前。 2 層の名前空間を使用する MySQL では必要ありません。 Databricks-to-Databricks場合は、代わりに catalog '<external-catalog-name>' を使用します。
<external-catalog-name>: Databricks-to-Databricksのみ: ミラーリングする外部Databricksワークスペース内のカタログの名前。「別の Databricks ワークスペースでフェデレーションクエリを実行する」を参照してください。

CREATE FOREIGN CATALOG [IF NOT EXISTS] <catalog-name> USING CONNECTION <connection-name>
OPTIONS [(database '<database-name>') | (catalog '<external-catalog-name>')];

「外部カタログを作成する」も参照してください。

アカウント内の特定のワークスペースへのカタログアクセスを制限するには(ワークスペース-カタログバインディングとも呼ばれます)、「特定のワークスペースへのカタログアクセスを制限する」を参照してください。

詳細な引数の説明については、 CREATE CATALOGを参照してください。

カタログを作成したら、カタログに特権を割り当てます。 Unity Catalog権限とセキュリティ保護可能なオブジェクトを参照してください。

Terraform : Databricks Terraform プロバイダーとdatabricks_catalogを使用してカタログを作成できます。 databricks_catalogsを使用してカタログに関する情報を取得できます。

REST API : POST /api/2.1/unity-catalog/catalogsを使用します。

Databricks CLI : databricks catalogs create <catalog-name> [options]オプションの一覧については、 databricks catalogs create -hを実行してください。オプションについては API リファレンスにも記載されています。前の段落の API リンクに従ってください。

カタログを作成したら、カタログに特権を割り当てます。 Unity Catalog権限とセキュリティ保護可能なオブジェクトを参照してください。

カタログの作成

要件

カタログを作成する

詳細情報