カタログの管理

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

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

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

必要条件

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

• タスクを実行する ワークスペースにリンクされた Unity Catalog メタストアが必要です。

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

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

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

カタログの詳細を表示する

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

注記

フォーリンカタログに対する BROWSE 権限を持つユーザーは、カタログエクスプローラ で、または Unity Catalog APIを介してメタデータにアクセスするときに、古いメタデータが表示される場合があります。 メタデータの表示は REFRESH フォーリンカタログが最後に実行された日時によって異なります。

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

Catalog Explorer

1. メタストアにリンクされているワークスペースにログインします。

2. [カタログ] をクリックします。

3. [ カタログ ] ウィンドウで、カタログを見つけてその名前をクリックします。

   一部の詳細はページの上部に記載されています。その他の項目は、「 スキーマ 」、「 詳細 」、「 権限 」および 「ワークスペース 」タブで表示できます。

SQL

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

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

SQL

DESCRIBE CATALOG <catalog-name>;

CATALOG EXTENDED を使用して、完全な詳細を取得します。

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

カタログを更新する

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

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

• 所有者を変更するには、所有者であるか、カタログに MANAGE と USE CATALOG が必要です。
• カタログの名前を変更するには、所有者であるか、カタログに MANAGE と USE CATALOG を持っている必要があります。
• コメントやタグを追加または更新するには、自分が所有者であるか、カタログに MANAGE または MODIFY と USE CATALOG を持っている必要があります。
• カタログに対するアクセス許可を付与および取り消すには、カタログの所有者、メタストア管理者、またはカタログに対する MANAGE と USE CATALOG を持っている必要があります。

Catalog Explorer

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

SQL

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

カタログの削除

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

警告

mainカタログは、未使用に見えても削除しないでください。これを削除すると、それに依存する既存のデータ操作が中断される可能性があります。

権限が必要 : カタログの所有者またはカタログの MANAGE と USE CATALOG 。

Catalog Explorer

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

1. メタストアにリンクされているワークスペースにログインします。
2. [カタログ] をクリックします。
3. [ カタログ ] ウィンドウの左側で、削除するカタログをクリックします。
4. 詳細ペインで、[ データベースの作成] ボタンの左側にあるケバブ メニュー をクリックし、[ 削除] を選択します。
5. [ カタログの削除 ] ダイアログで、[ 削除 ] をクリックします。

SQL

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

パラメーターの説明については、 DROP CATALOGを参照してください。

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

SQL

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

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

SQL

DROP CATALOG vaccine CASCADE