次の方法で共有

REFRESH FOREIGN (CATALOG、SCHEMA、TABLE)

適用対象: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 を持つ

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;

制限事項

デルタ テーブルの場合、 REFRESH FOREIGN CATALOG と REFRESH FOREIGN SCHEMA では、テーブル スキーマとプロパティのキー値マップ (列フィールド と プロパティ フィールド) は更新されません。 これを行うには、REFRESH FOREIGN TABLE を実行します。

  • Last updated on