operador de plugin de avaliação
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer
Invoca uma extensão de consulta do lado do serviço (plug-in).
O evaluate operador é um operador tabular que permite invocar extensões de linguagem de consulta conhecidas como plug-ins. Ao contrário de outras construções de linguagem, os plug-ins podem ser ativados ou desativados. Os plug-ins não são "vinculados" pela natureza relacional da linguagem. Em outras palavras, eles podem não ter um esquema de saída predefinido e determinado estaticamente.
Observação
- Sintaticamente,
evaluatese comporta de forma semelhante ao operador invoke, que invoca funções tabulares. - Os plug-ins fornecidos por meio do operador evaluate não são associados às regras regulares de execução de consulta ou avaliação de argumento.
- Plugins específicos podem ter restrições específicas. Por exemplo, plug-ins cujo esquema de saída depende dos dados. Por exemplo, bag_unpack plug-in e plug-in dinâmico não podem ser usados ao executar consultas entre clusters.
Sintaxe
[T|] evaluate [ evaluateParameters ] PluginName ([ PluginArgs ])
Saiba mais sobre as convenções de sintaxe.
Parâmetros
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| T | string |
Uma entrada tabular para o plug-in. Alguns plug-ins não recebem nenhuma entrada e atuam como uma fonte de dados tabular. | |
| evaluateParameters | string |
Zero ou mais parâmetros de avaliação separados por espaço na forma de Valor de Nome = que controlam o comportamento da operação de avaliação e do plano de execução. Cada plug-in pode decidir de forma diferente como lidar com cada parâmetro. Consulte a documentação de cada plug-in para obter um comportamento específico. |
|
| Nome do plug-in | string |
✔️ | O nome obrigatório do plug-in que está sendo invocado. |
| PluginArgs | string |
Zero ou mais argumentos separados por vírgula para fornecer ao plug-in. |
Avaliar parâmetros
Os seguintes parâmetros são compatíveis:
| Nome | Valores | Descrição |
|---|---|---|
hint.distribution |
single, per_node, per_shard |
Dicas de distribuição |
hint.pass_filters |
true, false |
Permita que evaluate o operador passe por quaisquer filtros correspondentes antes do plug-in. O filtro é considerado como 'correspondido' se se referir a uma coluna existente antes do evaluate operador. Padrão: false |
hint.pass_filters_column |
column_name | Permitir que o operador do plug-in passe filtros referentes a column_name antes do plug-in. O parâmetro pode ser usado várias vezes com nomes de coluna diferentes. |
Plugins
Os seguintes plug-ins são suportados:
- plug-in autocluster
- plug-in azure-digital-twins-query-request
- plug-in bag-unpack
- plugin de cesta
- plug-in cosmosdb-sql-request
- plug-in dcount-intersect
- Plugin Diffpatterns
- plugin diffpatterns-text
- Plug-in infer-storage-schema
- plug-in de pesquisa ipv4
- plug-in de pesquisa ipv6
- mysql-request-plugin
- Plugin estreito
- plug-in pivô
- Plugin de visualização
- Plugin R
- plug-in de percentil rolante
- plug-in de linhas próximas
- plug-in schema-merge
- plug-in de solicitação sql
- plug-in de detecção de sequência
Dicas de distribuição
As dicas de distribuição especificam como a execução do plug-in será distribuída em vários nós de cluster. Cada plugin pode implementar um suporte diferente para a distribuição. A documentação do plug-in especifica as opções de distribuição suportadas pelo plug-in.
Valores possíveis:
single: Uma única instância do plug-in será executada em todos os dados da consulta.per_node: Se a consulta antes da chamada do plug-in for distribuída entre nós, uma instância do plug-in será executada em cada nó sobre os dados que ele contém.per_shard: se os dados antes da chamada do plug-in forem distribuídos entre fragmentos, uma instância do plug-in será executada em cada fragmento dos dados.