REFRESH FOREIGN (CATALOG、SCHEMA、TABLE)

適用対象: Databricks SQL Databricks Runtime 13.3 LTS 以降 Unity Catalog のみ

Unity カタログに保持されている次のメタデータを更新します。

• 外部カタログとそのセキュリティ保護可能なリソース、
• 外部スキーマとそのセキュリティ保護可能なリソース、または
• Foreign table.

REFRESH FOREIGN CATALOG を実行するには、少なくとも次のいずれかが必要です。

• メタストア管理者である
• カタログに対する USE CATALOG 権限、すべての子スキーマに対する USE SCHEMA 権限、およびすべての子テーブルに対する SELECT 権限を持つ

REFRESH FOREIGN SCHEMA を実行するには、少なくとも次のいずれかが必要です。

• メタストア管理者である
• 親カタログの所有者である
• スキーマに対して MANAGE および USE SCHEMA 権限を持ち、親カタログに対して USE CATALOG 権限を持つ
• 親カタログに対する USE CATALOG 権限、スキーマに対する USE SCHEMA 権限、およびすべての子テーブルに対する SELECT 権限を持つ

REFRESH FOREIGN TABLE を実行するには、少なくとも次のいずれかが必要です。

• メタストア管理者である
• 親カタログの所有者である
• 親スキーマの所有者であり、親カタログに対する USE CATALOG 権限を持っている
• 親スキーマに対して MANAGE および USE SCHEMA 権限を持ち、親カタログに対して USE CATALOG 権限を持つ
• 親カタログとスキーマに対する USE CATALOG 権限と USE SCHEMA 権限、およびテーブルに対する SELECT 権限を持つ

オプションの RESOLVE DBFS LOCATION 句を実行して Hive メタストア フェデレーション テーブルの解決済み DBFS の場所を更新するには、少なくとも次のいずれかが必要です。

• テーブルの所有者になる。
• テーブルに対する MANAGE 権限と、スキーマに対する USE SCHEMA と親カタログの USE CATALOG を持つ

Syntax

REFRESH FOREIGN
 { CATALOG foreign_catalog_name |
   SCHEMA foreign_schema_name [ RESOLVE DBFS LOCATION ] |
   TABLE foreign_table_name [ RESOLVE DBFS LOCATION ] }

Parameters

• foreign_catalog_name

  更新する外部カタログを特定します。

• foreign_schema_name

  更新する外部スキーマを識別します。

• foreign_table_name

  更新する外部テーブルを識別します。 名前には、 時仕様またはオプション指定を含めてはなりません。

• DBFS の場所を解決する

  外部テーブルまたはスキーマが Hive メタストア フェデレーションであり、DBFS に格納されていて、テーブルをバックアップする DBFS マウント ポイントがテーブルが最後にアクセスされてから再マップされている場合は、このオプションを使用して、解決された DBFS の場所を更新します。

  OWNERであるか、テーブルまたはスキーマに対するMANAGE権限を持っている必要があります。 Hive メタストア フェデレーションの詳細については、「Hive メタストア フェデレーション : Hive メタストアに登録されているテーブルを Unity カタログで管理できるようにする」を参照してください。

  このオプションを使用して REFRESH FOREIGN SCHEMA を実行すると、Unity カタログは、スキーマの解決された DBFS の場所の両方を更新し、解決をスキーマ内のすべてのテーブルにカスケードします。

Examples

> REFRESH FOREIGN CATALOG some_catalog;

> REFRESH FOREIGN SCHEMA some_catalog.some_schema;

> REFRESH FOREIGN TABLE some_catalog.some_schema.some_table;

—- Resolves the DBFS ___location of the foreign table and updates it in Unity Catalog.
> REFRESH FOREIGN TABLE hms_fed_catalog.schema.table RESOLVE DBFS LOCATION;

-- Resolves the DBFS ___location of the foreign schema and all eligible foreign tables within the schema.
> REFRESH FOREIGN SCHEMA hms_fed_catalog.schema RESOLVE DBFS LOCATION;

Related statements

• CREATE CATALOG