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, evaluate se 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.