Löschen des Schema-Caches für clusterübergreifende Abfragen

Gilt für: ✅Azure Data Explorer

Beim Ausführen einer clusterübergreifenden Abfrage muss der Cluster, der die anfängliche Abfrageinterpretation durchführt, das Schema der Entitäten aufweisen, auf die auf den Remoteclustern verwiesen wird. Das Senden des Befehls kann ein kostspieliger Netzwerkvorgang sein und daher werden die Remoteschemaentitäten zwischengespeichert.

Alle Änderungen am Schema der Remoteentität können zu unerwünschten Auswirkungen führen. Beispielsweise werden neue Spalten nicht erkannt oder gelöscht, kann anstelle eines semantischen Fehlers ein "Partieller Abfragefehler" verursachen. Weitere Informationen finden Sie unter Clusterübergreifende Abfragen und Schemaänderungen.

Sie können den folgenden Befehl verwenden, wenn Sie das Schema aktualisieren müssen, ohne auf die Ablaufzeit des Caches zu warten.

Berechtigungen

Sie müssen mindestens über die Berechtigungen "Datenbankbenutzer", "Datenbankanzeige" oder "Datenbankmonitor" verfügen, um diesen Befehl auszuführen. Weitere Informationen finden Sie unter Rollenbasierte Zugriffssteuerung mit Microsoft Intune.

Syntax

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

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
ClusterName	string	✔️	Der Name des Clusters, der die Datenbank enthält, für die der Cache gelöscht werden soll.
DatabaseName	string	✔️	Der Name der Datenbank, für die der Cache gelöscht werden soll.

Gibt zurück

Der Befehl gibt eine Tabelle mit den folgenden Spalten zurück:

Spalte	Type	BESCHREIBUNG
NodeId	string	Bezeichner des Clusterknotens
Status	string	Erfolgreich/fehlgeschlagen

Beispiel

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

Rückgaben

NodeId	Status
0	Cache für Datenbank 1 gelöscht