Очистка кэша схемы для запросов между кластерами

Область применения: ✅Azure Data Explorer

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

Любые изменения в схеме удаленной сущности могут привести к нежелательным последствиям. Например, новые столбцы не распознаются или удаляются, могут привести к частичной ошибке запроса вместо семантической ошибки. Дополнительные сведения см. в разделе "Запросы между кластерами" и изменения схемы.

Следующую команду можно использовать, если необходимо обновить схему, не ожидая истечения срока действия кэша.

Разрешения

Для выполнения этой команды необходимо иметь по крайней мере разрешения пользователя базы данных, средства просмотра баз данных или монитора баз данных. Дополнительные сведения см. в разделе "Управление доступом на основе ролей".

Синтаксис

.clearcache remote-schema cluster('Имя базы данных ClusterName').database('')

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название)	Type	Обязательно	Описание
Имя кластера	string	✔️	Имя кластера, содержащего базу данных, для которой необходимо очистить кэш.
DatabaseName	string	✔️	Имя базы данных, для которой необходимо очистить кэш.

Возвраты

Команда возвращает таблицу со следующими столбцами:

Column	Type	Описание
NodeId	string	Идентификатор узла кластера
Состояние	string	Успешное выполнение или сбой

Пример

.clear cache remote-schema cluster("cluster1").database("database1")

Возвраты

NodeId	Состояние
0	Кэш, очищенный для базы данных1