カタログの管理
この記事では、Unity Catalog のカタログを表示、更新、削除する方法について説明します。 カタログにはスキーマ (データベース) が含まれており、スキーマにはテーブル、ビュー、ボリューム、モデル、関数が含まれています。
カタログの詳細については、「Azure Databricks のカタログとは」および「カタログを作成する」を参照してください。 カタログへのアクセスを許可および取り消す方法については、「Unity Catalog の権限とセキュリティ保護可能なオブジェクト」を参照してください。
外部データ システム内のデータベースをミラー化する Unity Catalog オブジェクトである "外部カタログ" を管理する方法については、「外部カタログの管理と操作」を参照してください。
要件
カタログを表示、更新、または削除するには、次の前提条件を満たす必要があります。
タスクを実行するワークスペースにリンクされた Unity Catalog のメタストアが必要です。
ノートブックを実行してカタログを作成するために使用するクラスターでは、Unity Catalog 準拠のアクセス モードを使用する必要があります。 「アクセス モード」を参照してください。
SQL ウェアハウスは常に Unity Catalog をサポートします。
必要なアクセス許可はタスクによって異なります。アクセス許可については、以降の各セクションで説明します。
カタログの詳細を表示する
必要なアクセス許可: ユーザーは、自分が所有するすべてのカタログ、または USE CATALOG
または BROWSE
のアクセス許可が割り当てられているすべてのカタログのメタデータを表示できます。
カタログに関する情報を表示するには、カタログ エクスプローラーまたは SQL コマンドを使用できます。
カタログ エクスプローラー
メタストアにリンクされているワークスペースにログインします。
[カタログ] をクリックします。
[カタログ] ウィンドウでカタログを見つけ、その名前をクリックします。
一部の詳細は、ページの上部に一覧表示されます。 その他は、[スキーマ]、[詳細]、[アクセス許可]、および [ワークスペース] タブで表示できます。
SQL
ノートブックまたは SQL クエリ エディターで SHOW CATALOGS
を実行して、メタストア内のすべてのカタログ、または正規表現に一致するカタログを一覧表示します。
カタログの詳細を取得するには、次の SQL コマンドを実行します。 角かっこ内の項目は省略可能です。 プレースホルダー <catalog-name>
を置き換えます。
DESCRIBE CATALOG <catalog-name>;
完全な詳細を取得するには、CATALOG EXTENDED
を使用します。
詳細については、「DESCRIBE CATALOG」を参照してください。
カタログを更新する
カタログを更新 (または変更) するには、カタログ エクスプローラーまたは SQL コマンドを使用できます。
必要なアクセス許可: カタログの更新に必要なアクセス許可は、更新する内容によって異なります。
- 所有者を変更するには、所有者である必要があります。
- カタログの名前を変更するには、所有者である必要があります。
- コメントまたはタグを追加または更新するには、カタログ所有者であるか、カタログに対する
MODIFY
とUSE CATALOG
を持っている必要があります。 - カタログに対するアクセス許可の付与と取り消しを行うには、カタログ所有者またはメタストア管理者である必要があります。
カタログ エクスプローラー
- Unity Catalog メタストアにリンクされているワークスペースにログインします。
[カタログ] をクリックします。
- 左側の [カタログ] ペインで、削除するカタログをクリックします。
- カタログを更新するには、カタログの詳細ページで次のページ要素を使用します。
- [概要] タブ: 所有者の更新、タグの追加または更新、コメントの追加または更新を行います。 「Unity Catalog オブジェクトの所有権を管理する」、「Unity Catalog のセキュリティ保護可能なオブジェクトにタグを適用する」、「データと AI 資産にコメントを追加する」を参照してください。
- [アクセス許可] タブ: カタログに対する特権の付与と取り消しを行います。 「Unity Catalog の特権の管理」を参照してください。
kebab メニュー: カタログの名前を変更します。
- [スキーマの作成] ボタン: スキーマをカタログに追加します。 「スキーマの作成」を参照してください。
SQL
- 所有者の変更、タグの追加または更新、カタログ内のテーブルの予測最適化の管理を行うには、ノートブックまたは SQL クエリ エディターで
ALTER CATALOG
コマンドを実行します。 「ALTER CATALOG」を参照してください。 - 特権の付与または取り消しを行うには、
GRANT
またはREVOKE
コマンドを使用します。 「GRANT」および「REVOKE」を参照してください。 - スキーマをカタログに追加するには、「Azure Databricks のスキーマとは」を参照してください。
- SQL を使用してカタログの名前を変更するには、新しいカタログを作成し、すべての資産をその新しいカタログに移動する必要があります。
カタログを削除する
カタログを削除 (またはドロップ) するには、カタログ エクスプローラーまたは SQL コマンドを使用できます。
必要なアクセス許可: カタログ所有者。
カタログ エクスプローラー
カタログを削除する前に、カタログ内の information_schema
を除くすべてのスキーマを削除する必要があります。 これには、自動的に作成された default
スキーマが含まれます。
- メタストアにリンクされているワークスペースにログインします。
[カタログ] をクリックします。
- [カタログ] ウィンドウの左側で、削除するカタログをクリックします。
- 詳細ペイン内で、[データベースを作成] ボタンの左側にあるケバブ メニュー
をクリックし、[削除] を選択します。
- [カタログの削除] ダイアログで、[削除] をクリックします。
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