REFRESH FOREIGN (CATALOG, SCHEMAi TABLE)

Dotyczy: Databricks SQL Databricks Runtime 13.3 LTS lub nowsze Katalog Unity

Odświeża metadane przechowywane w Katalogu Unity dla:

• Katalog zagraniczny i jego zabezpieczenia
• Schemat obcy i jego elementy zabezpieczalne, itp.
• Tabela zewnętrzna.

Aby uruchomić polecenie REFRESH FOREIGN CATALOG, potrzebne jest co najmniej jedno z następujących elementów:

• Zostań administratorem magazynu metadanych
• USE CATALOG Uprawnienie do katalogu, USE SCHEMA uprawnienie do wszystkich schematów podrzędnych i SELECT uprawnienie dla wszystkich tabel podrzędnych

Aby uruchomić polecenie REFRESH FOREIGN SCHEMA, potrzebne jest co najmniej jedno z następujących elementów:

• Być administratorem metamagazynu
• Zostań właścicielem wykazu nadrzędnego
• Uprawnienia MANAGE i USE SCHEMA w schemacie i USE CATALOG w katalogu nadrzędnym
• Posiadaj uprawnienie USE CATALOG do wykazu nadrzędnego, uprawnienie USE SCHEMA do schematu oraz uprawnienie SELECT do wszystkich tabel podrzędnych.

Do wykonania REFRESH FOREIGN TABLE potrzebne jest co najmniej jedno z następujących elementów:

• Być administratorem metastore
• Być właścicielem katalogu nadrzędnego
• Być właścicielem schematu nadrzędnego i mieć USE CATALOG uprawnienia do katalogu nadrzędnego
• Miej uprawnienia MANAGE i USE SCHEMA w schemacie nadrzędnym oraz USE CATALOG w katalogu nadrzędnym
• Miej uprawnienia USE CATALOG do katalogu nadrzędnego i USE SCHEMA do schematu oraz uprawnienia SELECT do tabeli.

Aby wykonać opcjonalną klauzulę RESOLVE DBFS LOCATION w celu zaktualizowania rozpoznanej lokalizacji systemu plików DBFS w tabeli federacyjnej magazynu metadanych Programu Hive, należy wykonać co najmniej jedną z następujących czynności:

• Zostań właścicielem tabeli.
• Posiadaj uprawnienie MANAGE na tabeli, wraz z USE SCHEMA na schemacie oraz USE CATALOG w katalogu nadrzędnym.

Składnia

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

Parametry

• nazwa_katalogu_zagranicznego

  Identyfikuje zagraniczny katalog do odświeżenia.

• foreign_schema_name

  Identyfikuje obcy schemat do odświeżenia.

• foreign_table_name

  Identyfikuje tabelę obcą do odświeżenia. Nazwa nie może zawierać specyfikacji czasowej ani specyfikacji opcji.

• ROZWIĄZYWANIE LOKALIZACJI SYSTEMU PLIKÓW DBFS

  Użyj tej opcji, aby zaktualizować zmapowaną lokalizację DBFS, jeśli tabela obca jest zawarta w federowanym magazynie metadanych Hive, przechowywana w systemie plików DBFS, a punkt montowania DBFS, który obsługuje tabelę, został ponownie zamapowany od czasu ostatniego dostępu do tabeli.

  Musisz być WŁAŚCICIELEM lub mieć uprawnienie ZARZĄDZANIE w odniesieniu do tabeli. Aby uzyskać więcej informacji na temat federacji magazynu metadanych Hive, zobacz włączanie Unity Catalog do zarządzania tabelami zarejestrowanymi w magazynie metadanych Hive.

Przykłady

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

Powiązane oświadczenia

• CREATE CATALOG