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 на родительском каталоге.

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

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

• foreign_schema_name

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

• foreign_table_name

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

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

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

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

  При выполнении REFRESH FOREIGN SCHEMA с этим параметром каталог Unity обновляет как разрешенное расположение DBFS схемы, так и каскадирует разрешение для всех таблиц в схеме.

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;

Ограничения

Для дельта-таблиц REFRESH FOREIGN CATALOG и REFRESH FOREIGN SCHEMA не обновляют схему таблицы и key-value карту свойств (поля столбцов и поля свойств соответственно). Для этого выполните команду REFRESH FOREIGN TABLE.

Связанные выражения

• CREATE CATALOG