次の方法で共有

カタログの管理

  • [アーティクル]

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

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

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

要件

カタログを表示、更新、または削除するには、次の前提条件を満たす必要があります。

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

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

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

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

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

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

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

カタログ エクスプローラー

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

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

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

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

SQL

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

カタログの詳細を取得するには、次の SQL コマンドを実行します。 角かっこ内の項目は省略可能です。 プレースホルダー <catalog-name> を置き換えます。

DESCRIBE CATALOG <catalog-name>;

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

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

カタログを更新する

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

必要なアクセス許可: カタログの更新に必要なアクセス許可は、更新する内容によって異なります。

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

カタログ エクスプローラー

  1. Unity Catalog メタストアにリンクされているワークスペースにログインします。
  2. カタログ アイコン [カタログ] をクリックします。
  3. 左側の [カタログ] ペインで、削除するカタログをクリックします。
  4. カタログを更新するには、カタログの詳細ページで次のページ要素を使用します。

SQL

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

カタログを削除する

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

必要なアクセス許可: カタログ所有者。

カタログ エクスプローラー

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

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

SQL

ノートブックまたは 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