evaluate plugin-operatorn

Anropar ett frågetillägg på tjänstsidan (plugin-program).

Operatorn evaluate är en tabelloperator som gör att du kan anropa frågespråktillägg som kallas plugin-program. Till skillnad från andra språkkonstruktioner kan plugin-program aktiveras eller inaktiveras. Plugin-program är inte "bundna" av språkets relationskaraktär. Med andra ord kanske de inte har ett fördefinierat, statiskt fastställt utdataschema.

Anteckning

• Syntaktiskt evaluate fungerar på samma sätt som anropar operatorn, som anropar tabellfunktioner.
• Plugin-program som tillhandahålls via utvärderaroperatorn är inte bundna av de vanliga reglerna för frågekörning eller argumentutvärdering.
• Specifika plugin-program kan ha specifika begränsningar. Till exempel plugin-program vars utdataschema är beroende av data. Till exempel kan bag_unpack plugin-program och pivot-plugin-program inte användas när du utför frågor mellan kluster.

Syntax

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

Läs mer om syntaxkonventioner.

Parametrar

Namn	Typ	Obligatorisk	Beskrivning
T	string		En tabellinmatning till plugin-programmet. Vissa plugin-program tar inga indata och fungerar som en tabelldatakälla.
evaluateParameters	string		Noll eller fler utrymmesavgränsade utvärdera parametrar i form av Namnvärde= som styr beteendet för utvärderingsåtgärden och körningsplanen. Varje plugin-program kan välja olika sätt att hantera varje parameter. Se dokumentationen för varje plugin-program för specifika beteenden.
PluginName	string	✔️	Det obligatoriska namnet på plugin-programmet som anropas.
PluginArgs	string		Noll eller fler kommaavgränsade argument som ska anges i plugin-programmet.

Utvärdera parametrar

Följande parametrar stöds:

Name	Värden	Beskrivning
hint.distribution	single, per_node, per_shard	Distributionstips
hint.pass_filters	true, false	Tillåt evaluate att operatorn skickar alla matchande filter före plugin-programmet. Filtret betraktas som "matchat" om det refererar till en kolumn som finns före operatorn evaluate . Standard: false
hint.pass_filters_column	column_name	Tillåt att plugin-operatorn skickar filter som refererar till column_name före plugin-programmet. Parametern kan användas flera gånger med olika kolumnnamn.

Plugin-program

Följande plugin-program stöds:

• autocluster-plugin-program
• azure-digital-twins-query-request plugin
• bag-unpack plugin
• basket-plugin-program
• cosmosdb-sql-request plugin
• plugin-program för dcount-intersect
• diffpatterns-plugin-program
• diffpatterns-text plugin-program
• plugin-program för infer-storage-schema
• ipv4-lookup plugin
• mysql-request-plugin
• narrow-plugin-program
• pivot-plugin-program
• förhandsgranska plugin-program
• R-plugin-program
• plugin-program för rullande percentil
• rows-near plugin
• schema-merge plugin
• plugin-program för sql-begäran
• plugin-program för sekvensidentifiering

Distributionstips

Distributionstips anger hur plugin-körningen ska distribueras över flera klusternoder. Varje plugin-program kan implementera olika stöd för distributionen. I plugin-programmets dokumentation anges de distributionsalternativ som stöds av plugin-programmet.

Möjliga värden:

• single: En enda instans av plugin-programmet kör över hela frågedata.
• per_node: Om frågan innan plugin-anropet distribueras mellan noder körs en instans av plugin-programmet på varje nod över de data som den innehåller.
• per_shard: Om data innan plugin-anropet distribueras över shards körs en instans av plugin-programmet över varje fragment av data.