カタログの管理

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

カタログの詳細については、Azure Databricks でのカタログとはとカタログの作成を参照してください。 カタログへのアクセスを許可および取り消す方法については、 Unity カタログ権限リファレンスを参照してください。

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

要件

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

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

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

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

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

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

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

注

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

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

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

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

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

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

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

SQL

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

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

DESCRIBE CATALOG <catalog-name>;

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

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

カタログを更新する

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

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

  • 所有者を変更するには、所有者であるかカタログに MANAGE が記載されている必要があります。
  • カタログの名前を変更するには、所有者であるかカタログに MANAGE があり、親メタストアにご CREATE CATALOG いなければなりません。
  • コメントの追加や更新は、所有者であるかカタログに MANAGE がある必要があります。
  • タグの追加や更新には、所有者であるか、カタログに USE CATALOG と APPLY TAG がある必要があります。
  • カタログの権限を付与・取り消すには、カタログの所有者であるか、メタストア管理者であるか、カタログに MANAGE がある必要があります。

MANAGE カタログ上では使用権限は必要ありません。 MANAGEについては使用特権要件を参照してください。

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

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

SQL

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

カタログを削除する

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

カタログまたはその子オブジェクトのいずれかが OpenSharing 共有に含まれている場合は、カタログを削除する前に共有から削除します。 詳細については、「 共有保護を回避する連鎖削除」を参照してください。

カタログを削除すると、マネージド テーブルとボリュームのデータ ファイルが保持され、7 日間の復旧期間が可能になります。 回復ウィンドウが終了すると、データ ファイルは 48 時間以内に完全に削除 (消去) されます。 外部テーブルと外部ボリュームのファイルは削除されません。 データ ファイルのライフサイクル、ストレージの課金、回復オプションの詳細については、 Unity カタログのオブジェクト ストレージ ライフサイクルを参照してください。

Warnung

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

許可が必要です:カタログの所有者またはカタログ MANAGE 。

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

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

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

SQL

ノートブックまたは Databricks SQL エディターで次の SQL コマンドを実行します。 角かっこ内の項目は省略可能です。 プレースホルダー <catalog-name> を置き換えます。

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

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

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

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

DROP CATALOG vaccine CASCADE
  • Last updated on