Operatore evaluate di plug-in
Richiama un'estensione di query sul lato servizio (plug-in).
L'operatore evaluate
è un operatore tabulare che consente di richiamare le estensioni del linguaggio di query note come plug-in. A differenza di altri costrutti di linguaggio, i plug-in possono essere abilitati o disabilitati. I plug-in non sono "associati" alla natura relazionale del linguaggio. In altre parole, potrebbero non avere uno schema di output predefinito, determinato in modo statico.
Nota
evaluate
Si comporta in modo analogo all'operatore invoke, che richiama funzioni tabulari.- I plug-in forniti tramite l'operatore di valutazione non sono associati alle regole regolari di esecuzione di query o valutazione degli argomenti.
- I plug-in specifici possono avere restrizioni specifiche. Ad esempio, i plug-in il cui schema di output dipende dai dati. Ad esempio, non è possibile usare plug-in e plug-in pivot bag_unpack durante l'esecuzione di query tra cluster.
Sintassi
[T|
] evaluate
[ evaluateParameters ] PlugName(
[ PlugArgs ])
Altre informazioni sulle convenzioni di sintassi.
Parametri
Nome | Tipo | Obbligatoria | Descrizione |
---|---|---|---|
T | string |
Input tabulare per il plug-in. Alcuni plug-in non accettano alcun input e fungono da origine dati tabulare. | |
evaluateParameters | string |
Zero o più parametri di valutazione separati dallo spazio sotto forma diValorenome= che controllano il comportamento dell'operazione di valutazione e del piano di esecuzione. Ogni plug-in può decidere in modo diverso come gestire ogni parametro. Per un comportamento specifico, vedere la documentazione di ogni plug-in. |
|
PlugName | string |
✔️ | Nome obbligatorio del plug-in richiamato. |
Plug-inArgs | string |
Zero o più argomenti separati da virgole da fornire al plug-in. |
Valutare i parametri
Sono supportati i seguenti parametri:
Nome | Valori | Descrizione |
---|---|---|
hint.distribution |
single , per_node , per_shard |
Hint di distribuzione |
hint.pass_filters |
true , false |
Consenti evaluate all'operatore di passare attraverso tutti i filtri corrispondenti prima del plug-in. Il filtro viene considerato come "corrispondente" se fa riferimento a una colonna esistente prima dell'operatore evaluate . Valore predefinito: false |
hint.pass_filters_column |
column_name | Consenti all'operatore plug-in di filtri pass-through che fanno riferimento a column_name prima del plug-in. Il parametro può essere usato più volte con nomi di colonna diversi. |
Plug-in
Sono supportati i plug-in seguenti:
- Plug-in autocluster
- plug-in azure-digital-twins-query-request
- plug-in bag-unpack
- Plug-in basket
- plug-in cosmosdb-sql-request
- plug-in dcount-intersect
- Plug-in diffpatterns
- plug-in diffpatterns-text
- plug-in infer-storage-schema
- Plug-in ipv4-lookup
- mysql-request-plug-in
- Plug-in narrow
- Plug-in pivot
- plug-in preview
- Plug-in R
- plug-in roll-percentile
- plug-in near rows-near
- plug-in di tipo schema-merge
- plug-in sql-request
- plug-in sequence-detect
Hint di distribuzione
Gli hint di distribuzione specificano come l'esecuzione del plug-in verrà distribuita in più nodi del cluster. Ogni plug-in può implementare un supporto diverso per la distribuzione. La documentazione del plug-in specifica le opzioni di distribuzione supportate dal plug-in.
Valori possibili:
single
: un'unica istanza del plug-in verrà eseguita sull'intera query.per_node
: se la query prima della chiamata al plug-in viene distribuita tra nodi, un'istanza del plug-in verrà eseguita in ogni nodo sui dati contenuti.per_shard
: se i dati prima della chiamata al plug-in vengono distribuiti tra partizioni, un'istanza del plug-in verrà eseguita su ogni partizione dei dati.
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per