Complemento operator evaluate

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

Invoca una extensión de consulta del lado del servicio (complemento).

El evaluate operador es un operador tabular que permite invocar extensiones de lenguaje de consulta conocidas como complementos. A diferencia de otras construcciones de lenguaje, los complementos se pueden habilitar o deshabilitar. Los complementos no están "enlazados" por la naturaleza relacional del lenguaje. Es decir, es posible que no tengan un esquema de salida predefinido, determinado estáticamente.

Nota:

• Sintácticamente, evaluate se comporta de forma similar al operador invoke, que invoca funciones tabulares.
• Los complementos proporcionados a través del operador evaluate no están enlazados por las reglas normales de ejecución de consultas o evaluación de argumentos.
• Los complementos específicos pueden tener restricciones específicas. Por ejemplo, los complementos cuyo esquema de salida depende de los datos. Por ejemplo, bag_unpack complemento y complemento dinámico no se pueden usar al realizar consultas entre clústeres.

Sintaxis

[T |] evaluate [ evaluateParameters ] PluginName ([ PluginArgs ])

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Type	Obligatorio	Descripción
T	string		Entrada tabular en el complemento. Algunos complementos no toman ninguna entrada y actúan como origen de datos tabulares.
evaluateParameters	string		Cero o más parámetros de evaluación separados por espacios en forma de Valor de nombre = que controlan el comportamiento de la operación de evaluación y el plan de ejecución. Cada complemento puede decidir de forma diferente cómo controlar cada parámetro. Consulte la documentación de cada complemento para obtener un comportamiento específico.
PluginName	string	✔️	Nombre obligatorio del complemento que se va a invocar.
PluginArgs	string		Cero o más argumentos separados por comas para proporcionar al complemento.

Evaluar parámetros

Se admiten los siguientes parámetros:

Nombre	Valores	Descripción
hint.distribution	single, , per_node, per_shard	Sugerencias de distribución
hint.pass_filters	true, false	Permitir que evaluate el operador pase a través de los filtros coincidentes antes del complemento. El filtro se considera "coincidente" si hace referencia a una columna existente antes del evaluate operador . Opción predeterminada: false
hint.pass_filters_column	column_name	Permitir que el operador del complemento pase los filtros que hacen referencia a column_name antes del complemento. El parámetro se puede usar varias veces con nombres de columna diferentes.

Complementos

Se admiten los siguientes complementos:

• complemento de autocluster
• complemento azure-digital-twins-query-request
• complemento bag-unpack
• complemento basket
• complemento cosmosdb-sql-request
• complemento dcount-intersect
• Complemento diffpatterns
• Complemento diffpatterns-text
• complemento infer-storage-schema
• Complemento ipv4-lookup
• Complemento ipv6-lookup
• mysql-request-plugin
• complemento estrecho
• Complemento dinámico
• complemento de vista previa
• Complemento R
• complemento rolling-percentile
• complemento rows-near
• complemento schema-merge
• complemento sql-request
• complemento de detección de secuencias

Sugerencias de distribución

Las sugerencias de distribución especifican cómo se distribuirá la ejecución del complemento entre varios nodos de clúster. Cada complemento puede implementar una compatibilidad diferente para la distribución. La documentación del complemento especifica las opciones de distribución admitidas por el complemento.

Valores posibles:

• single: una sola instancia del complemento se ejecutará en todos los datos de consulta.
• per_node: si la consulta antes de la llamada del complemento se distribuye entre nodos, se ejecutará una instancia del complemento en cada nodo sobre los datos que contiene.
• per_shard: si los datos anteriores a la llamada del complemento se distribuyen entre particiones, una instancia del complemento se ejecutará en cada partición de los datos.