カタログの管理

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

カタログの詳細については、「 Databricksのカタログとは」および「カタログの作成」を参照してください。カタログへのアクセスを許可および取り消す方法については、 Unity Catalog権限とセキュリティ保護可能なオブジェクト」を参照してください。

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

要件

カタログを表示、更新、または削除するには:

Unity Catalogタスクを実行するワークスペースにリンクされたメタストアが必要です。
カタログを管理するためにノートブックを実行するために使用するクラスターは、Unity Catalog に準拠したアクセスモードを使用する必要があります。アクセス・モードを参照してください。

SQLウェアハウスは常にUnity Catalogをサポートしています。

必要な権限はタスクによって異なり、以降の各セクションで説明します。

必要な権限: ユーザーは、自分が所有するすべてのカタログ、または USE CATALOG または BROWSE 権限が割り当てられているすべてのカタログのメタデータを表示できます。

カタログに関する情報を表示するには、カタログエクスプローラーまたは SQL コマンドを使用できます。

メタストアにリンクされているワークスペースにログインします。
[ カタログ ] をクリックします。
[ カタログ ] ウィンドウで、カタログを検索し、その名前をクリックします。

一部の詳細は、ページの上部に一覧表示されます。その他は、 [スキーマ] 、 [詳細] 、 [権限] 、および[ワークスペース]タブで表示できます。

ノートブックまたは SQL クエリエディターでSHOW CATALOGSを実行して、メタストア内のすべてのカタログまたは正規表現に一致するカタログを一覧表示します。

カタログの詳細を取得するには、次の SQL コマンドを実行します。括弧内の項目はオプションです。プレースホルダー <catalog-name>を置き換えます。

DESCRIBE CATALOG <catalog-name>;

CATALOG EXTENDED を使用して詳細を取得します。

詳細については、 DESCRIBE CATALOGを参照してください。

カタログを更新 (または変更) するには、カタログエクスプローラーまたは SQL コマンドを使用できます。

必要な権限: カタログの更新に必要な権限は、更新によって異なります。

Unity Catalogメタストアにリンクされているワークスペースにログインします。
[ カタログ ] をクリックします。
左側の [カタログ ] ウィンドウで、更新するカタログをクリックします。
カタログを更新するには、カタログの詳細ページで次のページ要素を使用します。
- 概要タブ: 所有者を更新し、タグを追加または更新し、コメントを追加または更新します。「Unity Catalog オブジェクトの所有権を管理する」、「Unity Catalog のセキュリティ保護可能なオブジェクトにタグを適用する」、および「データと AI アセットにコメントを追加する」を参照してください。
- 権限タブ: カタログに対する権限を付与および取り消します。「Unity Catalog での権限の管理」を参照してください。
- ケバブメニュー:カタログの名前を変更します。
- [スキーマの作成 ] ボタン: カタログにスキーマを追加します。「スキーマの作成」を参照してください。

カタログ内のテーブルの所有者を変更したり、タグを追加または更新したり、予測的最適化を管理したりするには、データベースまたはSQLクエリエディターで ALTER CATALOG コマンドを実行します。 ALTER CATALOG を参照してください。
権限を付与または取り消すには、 GRANTまたはREVOKEコマンドを使用します。 GRANTおよびREVOKE を参照してください。
カタログにスキーマを追加するには、「Databricks のスキーマとは」を参照してください。
SQL を使用してカタログの名前を変更するには、新しいカタログを作成し、すべてのアセットを新しいカタログに移動する必要があります。

カタログを削除 (またはドロップ) するには、カタログエクスプローラーまたは SQL コマンドを使用できます。

必要な権限: カタログ所有者。

カタログを削除する前に、 information_schema カタログ内のすべてのスキーマを削除する必要があります。これには、自動作成された default スキーマが含まれます。

ノートブックまたは Databricks SQL エディターで次の SQL コマンドを実行します。括弧内の項目はオプションです。プレースホルダー <catalog-name>を置き換えます。

詳細については、 DROP CATALOGを参照してください。

CASCADE オプションを指定せずに DROP CATALOG を使用する場合は、カタログを削除する前に、information_schemaを除くカタログ内のすべてのスキーマを削除する必要があります。これには、自動作成された default スキーマが含まれます。

DROP CATALOG [ IF EXISTS ] <catalog-name> [ RESTRICT | CASCADE ]

たとえば、 vaccine という名前のカタログとそのスキーマを削除するには、次のようにします。

DROP CATALOG vaccine CASCADE