Sdílet prostřednictvím

REFRESH FOREIGN (CATALOG, SCHEMAa TABLE)

platí pro:označeno jako ano Databricks SQL označeno jako ano Databricks Runtime 13.3 LTS a vyšší označeno jako anopouze katalog Unity.

Aktualizuje metadata udržovaná v katalogu Unity pro:

  • Zahraniční katalog a jeho zabezpečitelné objekty
  • Cizí schéma a jeho zabezpečitelné objekty, nebo
  • Cizí tabulka.

Ke spuštění REFRESH FOREIGN CATALOGpotřebujete aspoň jednu z následujících možností:

  • Být správcem metastoru
  • Mít oprávnění USE CATALOG v katalogu, oprávnění USE SCHEMA pro všechna podřízená schémata a oprávnění SELECT pro všechny podřízené tabulky

Ke spuštění REFRESH FOREIGN SCHEMApotřebujete aspoň jednu z následujících možností:

  • Být správcem metastoru
  • Staň se vlastníkem nadřazeného katalogu
  • Mít oprávnění MANAGE a USE SCHEMA u schématu a USE CATALOG u nadřazeného katalogu
  • Mít oprávnění USE CATALOG k nadřazenému katalogu, oprávnění USE SCHEMA ke schématu a oprávnění SELECT ke všem podřízeným tabulkám.

K provedení REFRESH FOREIGN TABLE potřebujete aspoň jednu z následujících možností:

  • Být správcem metastoru
  • Staň se vlastníkem nadřazeného katalogu
  • Buďte vlastníkem nadřazeného schématu a mějte právo USE CATALOG na nadřazený katalog.
  • Mít oprávnění MANAGE a USE SCHEMA v rámci nadřazeného schématu a USE CATALOG v rámci nadřazeného katalogu
  • Mít oprávnění USE CATALOG a USE SCHEMA na nadřazený katalog a schéma, a oprávnění SELECT na tabulce

Pokud chcete spustit volitelnou klauzuli RESOLVE DBFS LOCATION pro aktualizaci vyřešeného umístění DBFS federované tabulky metastoru Hive, potřebujete alespoň jednu z těchto věcí:

  • Buďte vlastníkem tabulky.
  • Mít oprávnění na MANAGE tabulku, ve schématu USE SCHEMA a na nadřazeném katalogu 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

    Identifikuje cizí katalog, který se má aktualizovat.

  • foreign_schema_name

    Identifikuje cizí schéma, které se má aktualizovat.

  • foreign_table_name

    Identifikuje cizí tabulku, která se má aktualizovat. Název nesmí obsahovat dočasnou specifikaci ani specifikaci možností.

  • URČIT UMÍSTĚNÍ DBFS

    Tuto možnost použijte k aktualizaci vyřešeného umístění DBFS, pokud je cizí tabulka nebo schéma federovaná s Hive metastore, uložená v DBFS a přípojný bod DBFS, který podporuje tabulku, byl znovu namapován od posledního přístupu k tabulce.

    Musíte být OWNER nebo mít oprávnění MANAGE k tabulce nebo schématu. Další informace o federaci metastoru Hive najdete v tématu federace metastoru Hive: Povolením katalogu Unity řídit tabulky registrované v metastoru Hive.

    Při provádění REFRESH FOREIGN SCHEMA s touto možností aktualizuje katalog Unity jak vyřešené umístění DBFS schématu, tak i kaskádové rozlišení pro všechny tabulky v rámci schématu.

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;

Omezení

Tabulky Delta REFRESH FOREIGN CATALOG a REFRESH FOREIGN SCHEMA neaktualizují schéma ani mapování vlastností klíč-hodnota (pole sloupců a pole vlastností). Použijte k tomu příkaz REFRESH FOREIGN TABLE.

  • Last updated on