REFRESH FOREIGN (CATALOG, SCHEMAи TABLE)

применимо: Databricks SQL Databricks Runtime 13.3 LTS и выше только Unity Catalog

Обновляет метаданные, сохраненные в каталоге Unity для:

• Внешний каталог и его защищаемые объекты,
• Внешняя схема и ее объекты безопасности или
• Внешняя таблица.

Чтобы запустить REFRESH FOREIGN CATALOG, вам потребуется по крайней мере одно из следующих действий:

• Быть администратором хранилища метаданных
• Имеются привилегии USE CATALOG на каталог, привилегии USE SCHEMA на все дочерние схемы и привилегии SELECT на все дочерние таблицы.

Чтобы запустить REFRESH FOREIGN SCHEMA, вам потребуется по крайней мере одно из следующих действий:

• Быть администратором хранилища метаданных
• Стать владельцем родительского каталога
• Обладают привилегиями MANAGE и USE SCHEMA в схеме и USE CATALOG в родительском каталоге
• У вас есть привилегия USE CATALOG в родительском каталоге, привилегия USE SCHEMA на схему и привилегия SELECT на все дочерние таблицы.

Для выполнения REFRESH FOREIGN TABLE необходимо по крайней мере одно из следующих действий:

• Быть администратором хранилища метаданных
• Стать владельцем родительского каталога
• Быть владельцем родительской схемы и иметь привилегию USE CATALOG в родительском каталоге
• Иметь права MANAGE и USE SCHEMA для родительской схемы и USE CATALOG для родительского каталога
• Имеют привилегии USE CATALOG и USE SCHEMA в родительском каталоге и схеме соответственно, и привилегию SELECT в таблице

Чтобы выполнить необязательное предложение RESOLVE DBFS LOCATION для обновления разрешенного расположения DBFS федеративной таблицы хранилища метаданных Hive, вам потребуется по крайней мере одно из следующих элементов:

• Будьте владельцем таблицы.
• Иметь привилегию MANAGE на таблице, а также USE SCHEMA на схеме и USE CATALOG на родительском каталоге.

Синтаксис

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

Параметры

• foreign_catalog_name

  Определяет внешний каталог для обновления.

• foreign_schema_name

  Определяет чужую схему для обновления.

• foreign_table_name

  Определяет внешнюю таблицу для обновления. Имя не должно включать темпоральную спецификацию или спецификацию опций.

• РЕШИТЬ МЕСТОПОЛОЖЕНИЕ DBFS

  Используйте этот параметр, чтобы обновить расположение DBFS, если внешняя таблица подключена к федеративному метахранилищу Hive, хранящемуся в DBFS, и если точка монтирования DBFS, поддерживающая таблицу, была переназначена с момента последнего доступа к таблице.

  Вы должны быть владельцем или иметь привилегию управления в таблице. Для получения дополнительных сведений о федерации хранилища метаданных Hive см. "Федерация хранилища метаданных Hive: включите каталог Unity для управления таблицами, зарегистрированными в хранилище метаданных Hive".

Примеры

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

Связанные утверждения

• CREATE CATALOG