REFRESH FOREIGN (CATALOG, SCHEMAy TABLE)

Se aplica a: Databricks SQL Databricks Runtime 13.3 LTS y superior Solo Unity Catalog

Actualiza los metadatos mantenidos en el Catálogo de Unity para:

• Catálogo externo y sus elementos protegibles,
• Esquema externo y sus elementos protegibles, o
• Tabla externa.

Para ejecutar REFRESH FOREIGN CATALOG, necesita al menos una de las siguientes opciones:

• Ser administrador del metastore
• Tener el privilegio USE CATALOG en el catálogo, el privilegio USE SCHEMA en todos los esquemas secundarios y el privilegio SELECT en todas las tablas secundarias

Para ejecutar REFRESH FOREIGN SCHEMA, necesita al menos una de las siguientes opciones:

• Ser administrador del metastore
• Ser el propietario del catálogo primario
• Tener MANAGE y USE SCHEMA privilegios en el esquema y USE CATALOG en el catálogo primario
• Tener el privilegio USE CATALOG en el catálogo primario, el privilegio USE SCHEMA en todos el esquema y el privilegio SELECT en todas las tablas secundarias

Para ejecutarlo REFRESH FOREIGN TABLE necesita al menos una de las siguientes cosas:

• Ser administrador del metastore
• Ser el propietario del catálogo primario
• Ser el propietario del esquema primario y tener el privilegio USE CATALOG en el catálogo primario
• Tener MANAGE y USE SCHEMA privilegios en el esquema primario y USE CATALOG en el catálogo primario
• Tener USE CATALOG y USE SCHEMA privilegios sobre el catálogo principal y el esquema, respectivamente, y el SELECT privilegio sobre la tabla

Para ejecutar la cláusula opcional RESOLVE DBFS LOCATION para actualizar la ubicación de DBFS resuelta de una tabla federada de Metastore de Hive, necesita al menos una de las siguientes opciones:

• Sea el propietario de la mesa.
• Tener el privilegio MANAGE en la tabla, junto con USE SCHEMA en el esquema y USE CATALOG en el catálogo principal

Sintaxis

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

Parámetros

• foreign_catalog_name

  Identifica el catálogo externo que se va a actualizar.

• nombre_de_esquema_extranjero

  Identifica el esquema externo que se va a actualizar.

• foreign_table_name

  Identifica la tabla externa que se va a actualizar. El nombre no debe incluir una especificación temporal ni una especificación de opciones .

• DETERMINAR LA LOCALIZACIÓN DE DBFS

  Utilice esta opción para actualizar la ubicación resuelta de DBFS si la tabla externa o el esquema utiliza un metastore federado de Hive, está almacenado en DBFS, y el punto de montaje de DBFS que respalda la tabla se ha reasignado desde que se accedió a ella por última vez.

  Usted tiene que ser un OWNER o disponer del privilegio MANAGE en la tabla o en el esquema. Para obtener más información sobre la federación de metastore de Hive, consulte Federación de metastore de Hive: habilitar el catálogo de Unity para controlar las tablas registradas en un metastore de Hive.

  Al ejecutar REFRESH FOREIGN SCHEMA con esta opción, Unity Catalog actualiza la ubicación DBFS resuelta del esquema y propaga la resolución a todas las tablas dentro del esquema.

Ejemplos

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

Instrucciones relacionadas

• CREATE CATALOG