REFRESH FOREIGN (CATALOG, SCHEMA e TABLE)

Aplica-se a: SQL do Databricks LTS do Databricks Runtime 13.3 e superior com somente Catálogo do Unity

Atualiza os metadados mantidos no Catálogo do Unity para um:

• Catálogo estrangeiro e seus protegíveis,
• Esquema estrangeiro e seus protegíveis ou
• Tabela externa

Para executar REFRESH FOREIGN CATALOG, você precisa de pelo menos um dos seguintes:

• Ser um administrador do metastore
• Tenha o privilégio USE CATALOG no catálogo, o privilégio USE SCHEMA em todos os esquemas filhos e o privilégio SELECT em todas as tabelas filho

Para executar REFRESH FOREIGN SCHEMA, você precisa de pelo menos um dos seguintes:

• Seja administrador do metastore
• Seja o proprietário do catálogo pai
• Tenha privilégios de MANAGE e USE SCHEMA no esquema e USE CATALOG no catálogo pai
• Tenha privilégio USE CATALOG no catálogo pai, privilégio USE SCHEMA no esquema e privilégio SELECT em todas as tabelas filho

Para executar REFRESH FOREIGN TABLE você precisa de pelo menos um dos seguintes:

• Seja administrador do metastore
• Seja o proprietário do catálogo pai
• Seja o proprietário do esquema pai e tenha privilégio USE CATALOG no catálogo pai
• Tenha privilégios de MANAGE e USE SCHEMA no esquema e USE CATALOG no catálogo pai
• Tenha privilégios USE CATALOG e USE SCHEMA no catálogo pai e no esquema, respectivamente, e o privilégio SELECT na tabela

Para executar a cláusula RESOLVE DBFS LOCATION opcional para atualizar o local do DBFS resolvido de uma tabela federada do metastore do Hive, você precisa de pelo menos um dos seguintes:

• Seja o proprietário da tabela.
• Tenha o privilégio MANAGE na tabela, juntamente com USE SCHEMA no esquema e USE CATALOG no catálogo pai

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 o catálogo estrangeiro a ser atualizado.

• foreign_schema_name

  Identifica o esquema estrangeiro a ser atualizado.

• foreign_table_name

  Identifica a tabela estrangeira a ser atualizada. O nome não deve incluir uma especificação temporal ou uma especificação de opções.

• RESOLVER A LOCALIZAÇÃO DO DBFS

  Use esta opção para atualizar a localização resolvida do DBFS caso a tabela ou o esquema estrangeiro esteja federado no metastore do Hive, armazenado no DBFS, e o ponto de montagem do DBFS vinculado à tabela tenha sido reconfigurado desde a última vez que a tabela foi acessada.

  É necessário ser um OWNER ou ter o privilégio MANAGE sobre a tabela ou esquema. Para obter mais informações sobre a federação de metastore de Hive, consulte Federação de metastore de Hive: habilitar o Unity Catalog para governar tabelas registradas em um metastore de Hive.

  Ao executar REFRESH FOREIGN SCHEMA com essa opção, o Catálogo do Unity atualiza o local DBFS resolvido do esquema e propaga a resolução para todas as tabelas dentro do esquema.

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;

Limitações

Para tabelas Delta, REFRESH FOREIGN CATALOG e REFRESH FOREIGN SCHEMA não atualizam o esquema de tabela e o mapa de chave-valor das propriedades (campo de colunas e campo de propriedades, respectivamente). Para fazer isso, execute REFRESH FOREIGN TABLE.

Declarações relacionadas

• CREATE CATALOG