REFRESH FOREIGN (CATALOG, SCHEMAet TABLE)

S’applique à : Databricks SQL Databricks Runtime 13.3 LTS et versions ultérieures Unity Catalog uniquement

Actualise les métadonnées conservées dans Unity Catalog pour :

• un catalogue étranger et ses éléments sécurisables ;
• un schéma étranger et ses éléments sécurisables ; ou
• Table étrangère.

Pour exécuter REFRESH FOREIGN CATALOG, vous devez avoir au moins un des droits suivants :

• Être administrateur du metastore
• Disposer du privilège USE CATALOG sur le catalogue, du privilège USE SCHEMA sur tous les schémas enfants et du privilège SELECT sur toutes les tables enfants

Pour exécuter REFRESH FOREIGN SCHEMA, vous devez avoir au moins un des droits suivants :

• Être administrateur du metastore
• Être propriétaire du catalogue parent
• Avoir les privilèges MANAGE et USE SCHEMA sur le schéma et USE CATALOG sur le catalogue parent
• Disposer du privilège USE CATALOG sur le catalogue parent, du privilège USE SCHEMA sur le schéma et du privilège SELECT sur toutes les tables enfants

Pour exécuter REFRESH FOREIGN TABLE, vous devez avoir au moins un des droits suivants :

• Être administrateur du metastore
• Être propriétaire du catalogue parent
• Être propriétaire du schéma parent et disposer du privilège USE CATALOG sur le catalogue parent
• Avoir les privilèges MANAGE et USE SCHEMA sur le schéma parent et USE CATALOG sur le catalogue parent
• Disposer des privilèges USE CATALOG et USE SCHEMA sur le catalogue et le schéma parent, respectivement, et le privilège SELECT sur la table

Pour exécuter la clause facultative RESOLVE DBFS LOCATION pour mettre à jour l’emplacement DBFS résolu d’une table fédérée Hive, vous devez avoir au moins un des droits suivants :

• Être propriétaire de la table
• Disposer du privilège MANAGE sur la table, ainsi que USE SCHEMA sur le schéma et USE CATALOG sur le catalogue parent

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

  Identifie le catalogue étranger à actualiser.

• foreign_schema_name

  Identifie le schéma étranger à actualiser.

• foreign_table_name

  Identifie la table source contenant une clé étrangère à actualiser. Le nom ne doit pas inclure de spécification temporelle ou de spécification d’options.

• EMPLACEMENT DBFS RÉSOLU

  Utilisez cette option pour mettre à jour l’emplacement DBFS résolu si la table ou le schéma étranger est un metastore Hive fédéré, stocké sur DBFS et que le point de montage DBFS qui prend en charge la table a été remappé depuis que la table a été consultée pour la dernière fois.

  Vous devez être un OWNER ou disposer des privilèges MANAGE sur la table ou le schéma. Pour plus d'informations sur la fédération du metastore Hive, consultez Fédération du metastore Hive : permettre au catalogue Unity de régir les tables enregistrées dans un metastore Hive.

  Lors de l’exécution REFRESH FOREIGN SCHEMA avec cette option, Unity Catalog met à jour à la fois l’emplacement DBFS résolu du schéma et cascade la résolution sur toutes les tables du schéma.

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;

Limites

Pour les tables Delta, REFRESH FOREIGN CATALOG et REFRESH FOREIGN SCHEMA n’actualisez pas le schéma de table et le mappage clé-valeur de table (champ de colonnes et champ propriétés, respectivement). Pour cela, exécutez REFRESH FOREIGN TABLE.

Déclarations connexes

• CREATE CATALOG