Condividi tramite


Cancellare la cache dello schema per le query tra cluster

Si applica a: ✅Azure Esplora dati

Quando si esegue una query tra cluster, il cluster che esegue l'interpretazione della query iniziale deve avere lo schema delle entità a cui si fa riferimento nei cluster remoti. L'invio del comando può essere un'operazione di rete costosa e pertanto le entità dello schema remoto vengono memorizzate nella cache.

Eventuali modifiche allo schema dell'entità remota possono causare effetti indesiderati. Ad esempio, le nuove colonne non vengono riconosciute o eliminate possono causare un errore di query parziale anziché un errore semantico. Per altre informazioni, vedere Query tra cluster e modifiche dello schema.

È possibile usare il comando seguente quando è necessario aggiornare lo schema senza attendere la scadenza della cache.

Autorizzazioni

Per eseguire questo comando, è necessario disporre almeno delle autorizzazioni Utente database, Visualizzatore database o Monitoraggio database. Per altre informazioni, vedere Controllo degli accessi in base al ruolo.

Sintassi

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

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
ClusterName string ✔️ Nome del cluster contenente il database per il quale cancellare la cache.
DatabaseName string ✔️ Nome del database per il quale cancellare la cache.

Valori restituiti

Il comando restituisce una tabella con le colonne seguenti:

Column Type Descrizione
NodeId string Identificatore del nodo del cluster
Status string Operazione riuscita/non riuscita

Esempio

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

Resi

NodeId Status
0 Cache cancellata per database database1