データベースを Unity Catalog に登録する

備考

プレビュー

この機能は、us-east-1、us-west-2、eu-west-1、ap-southeast-1、ap-southeast-2、eu-central-1、us-east-2、ap-south-1の各地域でパブリック プレビュー段階です。

このページでは、Lakebaseデータベースを読み取り専用のUnity Catalogカタログとして登録する方法について説明します。これにより、Unity Catalog の特権を使用してデータ アクセスを管理し、マネージド データ同期などの統合を活用できます。

所有権と権限

• データベース が存在しない場合は 、カタログと共に作成できます。この場合、オブジェクトの所有権は これらのガイドラインに従います。
• カタログ作成者は、Unity Catalogメタストアに対するCREATE CATALOG権限を追加で持っている必要があります。

カタログを作成する

データベースを Unity Catalog に登録するには、Databricks UI または API 呼び出しを使用します。

UI

1. ワークスペースのサイドバーで「 コンピュート 」をクリックします。

2. [ データベースインスタンス ] タブで、データベースインスタンスを選択します。

3. 「カタログ」 タブで、「 カタログの作成 」をクリックします。

4. 既存のデータベースを Unity Catalog カタログとして登録するか、新しいデータベースを作成できます。次のいずれかのオプションを使用します。

   • 既存のデータベースを使用するには、目的の Unity Catalog カタログ名と既存のPostgresデータベースの名前を入力します。 デフォルトのデータベース databricks_postgres をデータベース名として使用できます。
   • 新しいPostgresデータベースと Unity Catalog カタログを同時に作成するには、目的のカタログ名を入力し、[ 新しいデータベースの作成 ]をオンにします。

5. 作成 をクリックします。

6. 作成後、 カタログ リストでカタログをクリックして、カタログ エクスプローラービューを表示します。

curl

Bash

export PG_DATABASE_NAME="<name of the PG database to sync to UC>"
export CATLAOG_NAME="<name of UC catalog to create>"

Bash

// Optional
export CREATE_DATABASE_IF_NOT_EXISTS="<whether to create a new database>"

Bash

curl -X POST --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/catalogs \
--data-binary @- << EOF
{
  "name": "$CATALOG_NAME",
  "database_name": "$PG_DATABASE_NAME",
  "instance_name": "$INSTANCE_NAME",
  "create_database_if_not_exists": "$CREATE_DATABASE_IF_NOT_EXISTS" // optional
}

制限

• データベース名には、英数字またはアンダースコア文字のみを含める必要があります。注 データベース名にハイフンを含めることはできません。

• データベースに基づいて Unity Catalog で作成されたカタログは読み取り専用です。

• カタログ名は、Unity Catalog のセキュリティ保護可能なオブジェクト名の 既存の制約 に従う必要があります。

データベースカタログを使用してUnity CatalogのPostgresオブジェクトを探索する

カタログを表示するには、実行中のサーバレス SQLウェアハウスが接続されていることを確認してください。

1. ワークスペースのサイドバーで カタログ をクリックします。
2. カタログ ブラウザでクラスターをクリックし、実行中のサーバレス SQLウェアハウスをコンピュート リソースとして選択します。
3. 開始して閉じる をクリックします。

カタログ、スキーマ、およびテーブルを開くと、同期が自動的にトリガーされます。ただし、UI は Postgres リクエストの数を減らすためにデータをキャッシュする場合があるため、新しいオブジェクトがすぐに表示されない場合があります。

完全更新をトリガーするには、[ ] をクリックします。

Unity Catalog でデータベース カタログを削除する

データベース カタログを削除するには、データベース カタログの所有者またはメタストア管理者である必要があります。

Databricks では、最初にデータベース カタログから同期されたすべてのテーブルを削除することをお勧めします。各ソース テーブルは 20 個の同期テーブルを作成するためにのみ使用でき、データベース カタログが削除された後、同期されたテーブルが Unity Catalog でクリーンアップされるまでに最大 3 日かかる場合があります。Unity Catalog で削除を保留している同期テーブルは、ソース テーブルあたりの同期テーブル数の制限にカウントされます。

Databricks UI を使用して、データベース カタログを削除します。

1. ワークスペースのサイドバーで カタログ をクリックします。
2. 削除するデータベース・カタログを「 カタログ 」ペインから選択します。
3. 「 」をクリックし、「 削除 」をクリックします。

カタログを削除した後、Postgres データベースの名前を変更したり、削除したりできます。