Limpar cache de esquema para consultas entre clusters
Aplica-se a: ✅Azure Data Explorer
Ao executar uma consulta entre clusters, o cluster que executa a interpretação da consulta inicial deve ter o esquema das entidades referenciadas nos clusters remotos. O envio do comando pode ser uma operação de rede cara e, portanto, as entidades de esquema remoto são armazenadas em cache.
Quaisquer alterações no esquema da entidade remota podem resultar em efeitos indesejados. Por exemplo, novas colunas não são reconhecidas ou as colunas excluídas podem causar um 'Erro de Consulta Parcial' em vez de um erro semântico. Para obter mais informações, consulte Consultas entre clusters e alterações de esquema.
Você pode usar o comando a seguir quando precisar atualizar o esquema sem aguardar o tempo de expiração do cache.
Permissões
Você deve ter pelo menos as permissões Usuário do Banco de Dados, Visualizador do Banco de Dados ou Monitor do Banco de Dados para executar esse comando. Para obter mais informações, confira Controle de acesso baseado em função.
Sintaxe
.clearcache remote-schema cluster('ClusterName').database('DatabaseName')
Saiba mais sobre as convenções de sintaxe.
Parâmetros
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| ClusterName | string |
✔️ | O nome do cluster que contém o banco de dados para o qual limpar o cache. |
| DatabaseName | string |
✔️ | O nome do banco de dados para o qual limpar o cache. |
Devoluções
O comando retorna uma tabela com as seguintes colunas:
| Coluna | Type | Descrição |
|---|---|---|
| NodeId | string |
Identificador do nó do cluster |
| Status | string |
Êxito/Falha |
Exemplo
.clear cache remote-schema cluster("cluster1").database("database1")
Retorna
| NodeId | Status |
|---|---|
| 0 | Cache limpo para banco de dados database1 |