Operátor evaluate plugin
Platí pro: ✅Microsoft Fabric✅Azure Data Explorer
Vyvolá rozšíření dotazu na straně služby (plugin).
Operátor evaluate je tabulkový operátor, který umožňuje vyvolat rozšíření dotazovacího jazyka označovaná jako moduly plug-in. Na rozdíl od jiných konstruktorů jazyka je možné moduly plug-in povolit nebo zakázat. Moduly plug-in nejsou "vázány" relační povahou jazyka. Jinými slovy, nemusí mít předdefinované staticky určené výstupní schéma.
Poznámka:
- Syntakticky
evaluatese chová podobně jako operátor invoke, který vyvolává tabulkové funkce. - Moduly plug-in poskytované prostřednictvím operátoru vyhodnocení nejsou vázány pravidelnými pravidly provádění dotazu nebo vyhodnocením argumentů.
- Konkrétní moduly plug-in můžou mít určitá omezení. Například moduly plug-in, jejichž výstupní schéma závisí na datech. Například modul plug-in bag_unpack a modul plug-in pivotu nejde použít při provádění dotazů mezi clustery.
Syntaxe
[T |] evaluate [ evaluateParameters ] PluginName ([ PluginArgs ])
Přečtěte si další informace o konvencích syntaxe.
Parametry
| Název | Type | Požadováno | Popis |
|---|---|---|---|
| T | string |
Tabulkový vstup do modulu plug-in. Některé moduly plug-in nepřebírají žádný vstup a fungují jako tabulkový zdroj dat. | |
| evaluateParameters | string |
Vyhodnocujte parametry oddělené nulou nebo více mezerami ve formě hodnoty názvu = , které řídí chování vyhodnocovací operace a plánu provádění. Každý modul plug-in se může rozhodnout jinak, jak zpracovat jednotlivé parametry. Konkrétní chování najdete v dokumentaci ke každému modulu plug-in. |
|
| PluginName | string |
✔️ | Povinný název vyvolání modulu plug-in. |
| PluginArgs | string |
Nula nebo více argumentů oddělených čárkami, které se mají poskytnout modulu plug-in. |
Vyhodnocení parametrů
Podporují se následující parametry:
| Název | Hodnoty | Popis |
|---|---|---|
hint.distribution |
single, , per_nodeper_shard |
Tipy pro distribuci |
hint.pass_filters |
true, false |
Umožňuje evaluate operátoru předat všechny odpovídající filtry před modulem plug-in. Filtr se považuje za "spárovaný", pokud odkazuje na sloupec existující před operátorem evaluate . Výchozí: false |
hint.pass_filters_column |
column_name | Povolit operátoru modulu plug-in předávat filtry odkazující na column_name před modulem plug-in. Parametr lze použít vícekrát s různými názvy sloupců. |
Moduly plug-in
Podporují se následující moduly plug-in:
- modul plug-in autocluster
- modul plug-in azure-digital-twins-query-request
- modul plug-in bag-unpack
- modul plug-in košíku
- Modul plug-in cosmosdb-sql-request
- modul plug-in dcount-intersect
- modul plug-in diffpatterns
- modul plug-in diffpatterns-text
- infer-storage-schema plugin
- modul plug-in ipv4-lookup
- modul plug-in ipv6-lookup
- mysql-request-plugin
- úzký modul plug-in
- modul plug-in pivot
- Modul plug-in preview
- Modul plug-in R
- modul plug-in rolling-percentil
- modul plug-in v blízkosti řádků
- Modul plug-in pro sloučení schématu
- Modul plug-in sql-request
- modul plug-in sequence-detect
Tipy pro distribuci
Tipy pro distribuci určují, jak se bude spouštění modulu plug-in distribuovat napříč několika uzly clusteru. Každý modul plug-in může implementovat jinou podporu distribuce. Dokumentace modulu plug-in určuje možnosti distribuce podporované modulem plug-in.
Možné hodnoty:
single: Jedna instance modulu plug-in se spustí přes celá data dotazu.per_node: Pokud se dotaz před voláním modulu plug-in distribuuje mezi uzly, instance modulu plug-in se spustí na každém uzlu přes data, která obsahuje.per_shard: Pokud se data před voláním modulu plug-in distribuují napříč horizontálními oddíly, instance modulu plug-in se spustí přes každý horizontální oddíl dat.