REFRESH FOREIGN (CATALOG、SCHEMA、TABLE)

2025-03-26

適用対象: check marked yes Databricks SQL Databricks Runtime 13.3 LTS 以降「はい」のチェックマーク Unity Catalog のみ

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

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

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 を持つ

構文

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

パラメーター

外国カタログ名

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

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

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

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

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

例

> 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;

CREATE CATALOG