Condividi tramite

REFRESH FOREIGN (CATALOG, SCHEMAe TABLE)

Si applica a:contrassegnato con sì Databricks SQL contrassegnato con sì Databricks Runtime 13.3 LTS e versioni successive contrassegnato con sì solo Unity Catalog

Aggiorna i metadati manutenuti in Unity Catalog per:

  • Catalogo esterno e relative risorse securabili.
  • Schema esterno e relativi elementi securabili o
  • Tabella esterna.

Per eseguire REFRESH FOREIGN CATALOG, è necessario almeno uno dei seguenti:

  • Diventa un amministratore del metastore
  • Disporre del privilegio USE CATALOG nel catalogo, del privilegio USE SCHEMA per tutti gli schemi figlio e del privilegio SELECT in tutte le tabelle figlio

Per eseguire REFRESH FOREIGN SCHEMA, è necessario almeno uno dei seguenti:

  • Essere amministratore del metastore
  • Essere proprietario del catalogo principale
  • Disporre di privilegi MANAGE e USE SCHEMA sullo schema e USE CATALOG sul catalogo padre
  • Disporre del privilegio di USE CATALOG nel catalogo padre, del privilegio di USE SCHEMA nello schema e del privilegio di SELECT in tutte le tabelle figlio

Per eseguire REFRESH FOREIGN TABLE è necessario almeno uno dei seguenti:

  • Essere amministratore del metastore
  • Essere proprietario del catalogo principale
  • Essere proprietario dello schema padre e possedere il privilegio USE CATALOG sul catalogo padre
  • Disporre di privilegi di MANAGE e USE SCHEMA sullo schema padre e di USE CATALOG sul catalogo padre
  • Disporre dei privilegi USE CATALOG e USE SCHEMA sul catalogo padre e sullo schema, rispettivamente, e del privilegio SELECT sulla tabella

Per eseguire la clausola facoltativa RESOLVE DBFS LOCATION per aggiornare il percorso DBFS risolto di una tabella federata metastore Hive, è necessario almeno uno dei seguenti:

  • Sii il proprietario della tabella.
  • Disporre del privilegio MANAGE sulla tabella, insieme a USE SCHEMA sullo schema e USE CATALOG nel catalogo padre

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

    Identifica il catalogo straniero da aggiornare.

  • foreign_schema_name

    Identifica lo schema esterno da aggiornare.

  • foreign_table_name

    Identifica la tabella esterna da aggiornare. Il nome non deve includere una specifica temporale o una specifica delle opzioni.

  • RISOLVERE POSIZIONE DBFS

    Usare questa opzione per aggiornare il percorso DBFS risolto se la tabella esterna o lo schema è federato con Hive metastore, è archiviato su DBFS e il punto di montaggio DBFS che supporta la tabella è stato rimappato da quando la tabella è stata acceduta l'ultima volta.

    Devi essere un OWNER o avere il privilegio MANAGE sulla tabella o sullo schema. Per altre informazioni sulla federazione del metastore Hive, vedere federazione del metastore Hive: abilitare il Catalogo Unity per la gestione delle tabelle registrate in un metastore Hive.

    Quando si esegue REFRESH FOREIGN SCHEMA con questa opzione, Unity Catalog aggiorna il percorso DBFS risolto dello schema e propaga la risoluzione a tutte le tabelle dello schema.

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;

Limitazioni

Per le tabelle REFRESH FOREIGN CATALOG e REFRESH FOREIGN SCHEMA non aggiornano lo schema della tabella e le proprietà della mappa chiave-valore (campo colonne e campo delle proprietà, rispettivamente). A tale scopo, eseguire REFRESH FOREIGN TABLE.

  • Last updated on