メインコンテンツまでスキップ

デフォルトカタログの管理

この記事では、デフォルト Unity Catalog カタログについて紹介し、デフォルトとして使用するカタログを決定する方法と、それを変更する方法を示します。

Unity Catalog のデフォルトのカタログは何ですか?​

デフォルト カタログは、 Unity Catalogが有効になっているワークスペースごとに構成されます。 デフォルトのカタログでは、カタログを指定せずにデータ操作を実行できます。 データ操作を実行するときに最上位のカタログ名を省略すると、デフォルトのカタログが想定されます。

ワークスペース管理者は、管理者設定 UI を使用してデフォルト カタログを表示または切り替えることができます。 Spark 構成を使用して、クラスターのデフォルト カタログを設定することもできます。

カタログを指定しないコマンド ( GRANT CREATE TABLE ON SCHEMA myschema TO mygroupなど) は、次の順序でカタログに対して評価されます。

  1. セッションのカタログは、 USE CATALOG ステートメントまたは JDBC 設定を使用して設定されていますか?
  2. Spark構成はクラスターでspark.databricks.sql.initial.catalog.namespace設定されていますか?
  3. クラスター用にワークスペース デフォルト カタログが設定されていますか?
important

DLT のパイプライン構成は、ワークスペースのデフォルトを上書きするデフォルト カタログを設定します。

Unity Catalogが有効になっている場合のデフォルトカタログ構成​

ワークスペースに対して最初に構成されたデフォルト カタログは、ワークスペースが Unity Catalogに対してどのように有効にされたかによって異なります。

  • Unity Catalogが自動的に有効になった一部のワークスペースでは、 ワークスペース カタログ がデフォルト カタログとして設定されていました。「Unity Catalog の自動有効化」を参照してください。
  • 他のすべてのワークスペースでは、 hive_metastore カタログがデフォルト カタログとして設定されました。

Hive metastore から Unity Catalogに移行する場合は、デフォルトカタログを hive_metastore に設定して、Hive metastoreを参照する既存のコードに影響を与えないようにすることができます。

デフォルトのカタログを変更する​

ワークスペース管理者は、ワークスペースのデフォルト カタログを変更できます。 コンピュート リソースを作成または編集する権限を持つユーザーは、コンピュート リソースに別のデフォルト カタログを設定できます。

警告

デフォルトのカタログを変更すると、それに依存する既存のデータ操作が中断される可能性があります。

ワークスペースに別のデフォルトカタログを設定するには:

  1. ワークスペース管理者としてワークスペースにログインします。
  2. ワークスペースの上部バーでユーザー名をクリックし、ドロップダウンから[ 管理設定 ] を選択します。
  3. 詳細設定 タブをクリックします。
  4. ワークスペース行 のデフォルト カタログ で、カタログ名を入力し、[ 保存 ] をクリックします。

SQLウェアハウスとクラスターを再起動して、変更を有効にします。ウェアハウスとクラスター SQL新規および再開されたすべてのカタログは、このカタログをワークスペースのデフォルトとして使用します。

また、特定のクラスターのデフォルト カタログをオーバーライドするには、クラスターで次の Spark 構成を設定します。 この方法は、 SQLウェアハウスでは使用できません。

spark.databricks.sql.initial.catalog.namespace

手順については、「 Spark の設定」を参照してください。

現在のデフォルトカタログを表示する​

ワークスペースの現在のデフォルト カタログを取得するには、ノートブックまたはSQL Editor クエリで SQL ステートメントを使用できます。ワークスペース管理者は、管理者設定 UI を使用してデフォルト カタログを取得できます。

  1. Log in to your workspace as a workspace admin.
  2. Click your username in the top bar of the workspace and select Admin Settings from the dropdown.
  3. Click the Advanced tab.
  4. On the Default catalog for the workspace row, view the catalog name.
に最終更新