REFRESH FOREIGN (CATALOG, SCHEMAoch TABLE)

Gäller för: Databricks SQL Databricks Runtime 13.3 LTS och senare endast i Unity Catalog

Uppdaterar metadata som underhålls i Unity Catalog för en:

• Utländsk katalog och dess skyddsbara objekt,
• Externt schema och dess säkerhetsskyddade objekt, eller
• Externtabell.

Om du vill köra REFRESH FOREIGN CATALOGbehöver du minst något av följande:

• Vara metaarkivadministratör
• Ha privilegium USE CATALOG på katalogen, privilegium USE SCHEMA på alla underordnade scheman och privilegium SELECT på alla underordnade tabeller

Om du vill köra REFRESH FOREIGN SCHEMAbehöver du minst något av följande:

• Vara metaarkivadministratör
• Bli ägare till den överordnade katalogen
• Ha MANAGE och USE SCHEMA behörigheter på schemat och USE CATALOG i den överordnade katalogen
• Ha USE CATALOG-behörighet i den överordnade katalogen, USE SCHEMA-behörighet i schemat och SELECT-behörighet i alla underordnade tabeller

För att köra REFRESH FOREIGN TABLE behöver du minst något av följande:

• Vara metaarkivadministratör
• Bli ägare till den överordnade katalogen
• Vara ägare till det överordnade schemat och ha USE CATALOG-behörighet på den överordnade katalogen
• Ha MANAGE och USE SCHEMA behörigheter på det överordnade schemat och USE CATALOG i den överordnade katalogen
• Ha behörigheter USE CATALOG och USE SCHEMA för den överordnade katalogen och schemat respektive, samt behörigheten SELECT på tabellen.

För att köra den valfria RESOLVE DBFS LOCATION-satsen för att uppdatera den lösta DBFS-platsen för en Hive-federerad metastore-tabell behöver du minst en av följande:

• Var tabellägare.
• Ha MANAGE-behörighet på tabellen, tillsammans med USE SCHEMA på schemat och USE CATALOG på den överordnade katalogen.

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

  Identifierar den utländska katalog som ska uppdateras.

• foreign_schema_name

  Identifierar det utländska schema som ska uppdateras.

• foreign_table_name

  Identifierar den utländska tabell som ska uppdateras. Namnet får inte innehålla en temporal specifikation eller alternativspecifikation.

• ÅTGÄRDA DBFS-PLATS

  Använd det här alternativet för att uppdatera den lösta DBFS-platsen om den externa tabellen eller schemat är Hive-metaarkiv federerat, lagrat på DBFS och DBFS-monteringspunkten som säkerhetskopierar tabellen har mappats på nytt sedan tabellen senast användes.

  Du måste vara en OWNER eller ha behörigheten MANAGE i tabellen eller schemat. För mer information om Hive-metastore-federation, se Hive-metastore-federation: aktivera Unity Catalog för att hantera tabeller som är registrerade i ett Hive-metastore.

  När du kör REFRESH FOREIGN SCHEMA med det här alternativet uppdaterar Unity Catalog både schemats lösta DBFS-plats och överför upplösningen till alla tabeller i schemat.

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;

Begränsningar

För Delta-tabeller REFRESH FOREIGN CATALOG och REFRESH FOREIGN SCHEMA uppdatera inte tabellschemat och egenskaper för nyckel/värde-karta (kolumnfält respektive egenskapsfält). Gör detta genom att köra REFRESH FOREIGN TABLE.

Relaterade instruktioner

• CREATE CATALOG