evaluate-Plug-In-Operator
Ruft eine dienstseitige Abfrageerweiterung (Plug-In) auf.
Der evaluate
Operator ist ein tabellarischer Operator, mit dem Sie Abfragespracherweiterungen aufrufen können, die als Plug-Ins bezeichnet werden. Im Gegensatz zu anderen Sprachkonstrukten können Plug-Ins aktiviert oder deaktiviert werden. Plugins sind nicht durch die relationale Natur der Sprache "gebunden". Mit anderen Worten, sie verfügen möglicherweise nicht über ein vordefiniertes, statisch bestimmtes Ausgabeschema.
Hinweis
- Syntaktisch
evaluate
verhält sich ähnlich wie der Aufrufoperator, der tabellarische Funktionen aufruft. - Plugins, die über den Evaluate-Operator bereitgestellt werden, sind nicht an die regulären Regeln der Abfrageausführung oder Argumentauswertung gebunden.
- Bestimmte Plug-Ins können bestimmte Einschränkungen aufweisen. Beispielsweise Plug-Ins, deren Ausgabeschema von den Daten abhängt. Beispielsweise können bag_unpack Plug-In und Pivot-Plug-In nicht verwendet werden, wenn Clusterübergreifende Abfragen ausgeführt werden.
Syntax
[T|
] evaluate
[ evaluateParameters ] PluginName(
[ PluginArgs ])
Erfahren Sie mehr über Syntaxkonventionen.
Parameter
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
T | string |
Eine tabellarische Eingabe für das Plug-In. Einige Plug-Ins nehmen keine Eingaben und fungieren als tabellarische Datenquelle. | |
evaluateParameters | string |
Null oder mehr leergetrennte Auswertungsparameter in Form von Name= Value , die das Verhalten des Auswertungsvorgangs und des Ausführungsplans steuern. Jedes Plug-In kann unterschiedlich entscheiden, wie die einzelnen Parameter behandelt werden sollen. Spezifisches Verhalten finden Sie in der Dokumentation der einzelnen Plug-Ins. |
|
Plug-In-Name | string |
✔️ | Der obligatorische Name des aufgerufenen Plug-Ins. |
PluginArgs | string |
Null oder mehr durch Trennzeichen getrennte Argumente, die für das Plug-In bereitgestellt werden sollen. |
Parameter auswerten
Die folgenden Parameter werden unterstützt:
Name | Werte | Beschreibung |
---|---|---|
hint.distribution |
single , per_node , per_shard |
Verteilungshinweise |
hint.pass_filters |
true , false |
Erlauben Sie evaluate dem Operator, alle übereinstimmenden Filter vor dem Plug-In zu durchlaufen. Filter wird als "übereinstimmend" betrachtet, wenn er auf eine Spalte verweist, die vor dem evaluate Operator vorhanden ist. Standardwert: false |
hint.pass_filters_column |
column_name | Zulassen, dass der Plug-In-Operator Filter durchlaufen kann, die sich auf column_name vor dem Plug-In beziehen. Parameter können mehrmals mit unterschiedlichen Spaltennamen verwendet werden. |
Plug-Ins
Die folgenden Plug-Ins werden unterstützt:
- 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-Plug-In
- mysql-request-plugin
- narrow-Plug-In
- pivot-Plug-In
- preview-Plug-In
- R-Plug-In
- Rolling-Percentile-Plug-In
- zeilennahes Plug-In
- Schema-Merge-Plug-In
- sql-request-Plug-In
- Sequence-Detect-Plug-In
Verteilungshinweise
Verteilungshinweise geben an, wie die Plug-In-Ausführung auf mehrere Clusterknoten verteilt wird. Jedes Plug-In kann eine andere Unterstützung für die Distribution implementieren. Die Dokumentation des Plug-Ins gibt die vom Plug-In unterstützten Verteilungsoptionen an.
Mögliche Werte:
single
: Ein einzelner instance des Plug-Ins wird über die gesamten Abfragedaten ausgeführt.per_node
: Wenn die Abfrage vor dem Plug-In-Aufruf auf Knoten verteilt wird, wird ein instance des Plug-Ins auf jedem Knoten über die darin enthaltenen Daten ausgeführt.per_shard
: Wenn die Daten vor dem Plug-In-Aufruf auf Shards verteilt werden, wird ein instance des Plug-Ins über jeden Shard der Daten ausgeführt.
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für