Partager via


Effacer le cache de schéma pour les requêtes inter-clusters

S’applique à : ✅Azure Data Explorer

Lors de l’exécution d’une requête inter-clusters, le cluster qui effectue l’interprétation initiale de la requête doit avoir le schéma des entités référencées sur les clusters distants. L’envoi de la commande peut être une opération réseau coûteuse et, par conséquent, les entités de schéma distantes sont mises en cache.

Toute modification apportée au schéma de l’entité distante peut entraîner des effets indésirables. Par exemple, les nouvelles colonnes ne sont pas reconnues ou supprimées peuvent entraîner une « erreur de requête partielle » au lieu d’une erreur sémantique. Pour plus d’informations, consultez requêtes inter-clusters et modifications de schéma.

Vous pouvez utiliser la commande suivante lorsque vous devez actualiser le schéma sans attendre l’heure d’expiration du cache.

autorisations

Vous devez disposer au moins des autorisations Utilisateur de base de données, Visionneuse de base de données ou Moniteur de base de données pour exécuter cette commande. Pour plus d’informations, consultez Contrôle d’accès en fonction du rôle.

Syntaxe

.clearcache remote-schema cluster('ClusterName DatabaseName').database('')

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
Nom du cluster string ✔️ Nom du cluster contenant la base de données pour laquelle effacer le cache.
DatabaseName string ✔️ Nom de la base de données pour laquelle effacer le cache.

Retours

La commande retourne une table avec les colonnes suivantes :

Colonne Type Description
NodeId string Identificateur du nœud de cluster
État string Réussite/Échec

Exemple

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

Renvoie

NodeId État
0 Cache effacé pour la base de données de base de données 1