REFRESH FOREIGN (CATALOG, SCHEMAés TABLE)

A következőkre vonatkozik:(jelölve, hogy igen) Databricks SQL (jelölve, hogy igen) Databricks Runtime 13.3 LTS és újabb verziók (jelölve, hogy igen) csak a Unity Catalog esetén.

Frissíti a Unity Katalógusban karbantartott metaadatokat a következőhöz:

  • Külföldi katalógus és a hozzá tartozó biztonsági elemek
  • Idegen séma és annak biztonsági objektumai, vagy
  • Idegen tábla.

A futtatáshoz REFRESH FOREIGN CATALOGlegalább az alábbiak egyikére van szüksége:

  • Legyen metaadattár-rendszergazda
  • Rendelkezik a katalógus USE CATALOG jogosultságával, az összes alárendelt séma USE SCHEMA jogosultságával, valamint az összes alárendelt tábla SELECT jogosultságával.

A futtatáshoz REFRESH FOREIGN SCHEMAlegalább az alábbiak egyikére van szüksége:

  • Legyen metastore-rendszergazda
  • Legyen a szülőkatalógus tulajdonosa
  • MANAGE és USE SCHEMA jogosultságokkal rendelkezik a sémán, és USE CATALOG a szülőkatalógusban
  • Rendelkezik a szülőkatalógus USE CATALOG jogosultságával, a séma USE SCHEMA jogosultságával, valamint az SELECT jogosultsággal az összes gyermektáblán

A végrehajtáshoz REFRESH FOREIGN TABLE legalább az alábbiak egyikére van szüksége:

  • Legyen metastore-rendszergazda
  • Legyen a szülőkatalógus tulajdonosa
  • Legyen a törzsséma tulajdonosa, és rendelkezzen a törzskatalógus USE CATALOG jogosultságával
  • Rendelkezzen MANAGE és USE SCHEMA jogosultságokkal a szülősémán és USE CATALOG a szülőkatalógusban
  • USE CATALOG és USE SCHEMA jogosultságokkal rendelkezik a szülőkatalógusban és a sémában, illetve a SELECT jogosultsággal a táblában

Az opcionális RESOLVE DBFS LOCATION záradék végrehajtásához egy Hive metaadattár-összevont tábla feloldott DBFS-helyének frissítéséhez legalább az alábbiak egyikére van szükség:

  • Legyen a tábla tulajdonosa.
  • A MANAGE jogosultsággal rendelkezik a táblában, valamint USE SCHEMA a sémában, és USE CATALOG a szülőkatalógusban

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

    Azonosítja a frissíteni kívánt idegen katalógust.

  • foreign_schema_name

    Azonosítja a frissíteni kívánt idegen sémát.

  • foreign_table_name

    Azonosítja a frissíteni kívánt idegen táblát. A név nem tartalmazhat időbeli specifikációt vagy beállításspecifikációt.

  • DBFS HELY MEGHATÁROZÁSA

    Ezzel a beállítással frissítheti a megadott DBFS-helyet, ha az idegen tábla vagy séma Hive metaadattára federált, a DBFS-ben van tárolva, és a táblát támogató DBFS csatlakoztatási pont a tábla legutóbbi elérése óta át lett térképezve.

    A táblánál OWNER kell lennie vagy rendelkeznie kell MANAGE jogosultsággal a táblán vagy a sémán. További információ a Hive metaadattár-összevonásáról: Hive metaadattár-összevonás: engedélyezze a Unity Catalog számára a Hive-metaadattárbanregisztrált táblák szabályozását.

    Ha ezzel a beállítással hajtja végre a REFRESH FOREIGN SCHEMA parancsot, a Unity Catalog frissíti a séma DBFS helyét, és láncban érvényesíti a frissítést a séma összes táblájára.

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;

Korlátozások

Delta-táblák REFRESH FOREIGN CATALOGREFRESH FOREIGN SCHEMA esetén ne frissítse a táblaséma és a tulajdonságok kulcs-érték leképezését (oszlopmező és tulajdonságok mező). Ehhez futtassa a REFRESH FOREIGN TABLE parancsot.