evaluate plugin işleci

Hizmet tarafı sorgu uzantısını (eklenti) çağırır.

evaluate işleci, eklenti olarak bilinen sorgu dili uzantılarını çağırmanıza olanak tanıyan bir tablo işlecidir. Diğer dil yapılarından farklı olarak eklentiler etkinleştirilebilir veya devre dışı bırakılabilir. Eklentiler, dilin ilişkisel yapısına "bağlı" değildir. Başka bir deyişle, önceden tanımlanmış, statik olarak belirlenmiş bir çıkış şemasına sahip olmayabilirler.

Not

  • Bozulmadan, evaluate tablosal işlevleri çağıran invoke işlecine benzer şekilde davranır.
  • Değerlendirme işleci aracılığıyla sağlanan eklentiler, normal sorgu yürütme veya bağımsız değişken değerlendirme kurallarına bağlı değildir.
  • Belirli eklentilerin belirli kısıtlamaları olabilir. Örneğin, çıktı şeması verilere bağlı olan eklentiler. Örneğin, bag_unpack eklentisi ve özet eklentisi , kümeler arası sorgular gerçekleştirirken kullanılamaz.

Syntax

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

Söz dizimi kuralları hakkında daha fazla bilgi edinin.

Parametreler

Ad Tür Gerekli Açıklama
T string Eklentiye tablosal giriş. Bazı eklentiler herhangi bir giriş almaz ve tablosal veri kaynağı görevi görür.
evaluateParameters string Sıfır veya daha fazla boşlukla ayrılmış değerlendirme parametresi, değerlendirme işleminin ve yürütme planının davranışını denetleen Ad=Değeri biçimindedir. Her eklenti, her parametreyi nasıl işleyeceklerine farklı karar verebilir. Belirli davranışlar için her eklentinin belgelerine bakın.
PluginName string ✔️ Çağrılan eklentinin zorunlu adı.
PluginArgs string Eklentiye sağlayabilecek sıfır veya daha fazla virgülle ayrılmış bağımsız değişken.

Parametreleri değerlendirme

Aşağıdaki parametreler desteklenir:

Name Değerler Açıklama
hint.distribution single, per_node, per_shard Dağıtım ipuçları
hint.pass_filters true, false Operatörün eklentiden önce eşleşen filtreleri geçirmesine izin verin evaluate . İşleç öncesinde evaluate var olan bir sütuna başvuruyorsa filtre 'eşleştirildi' olarak kabul edilir. Varsayılan: false
hint.pass_filters_column Column_name Eklenti işlecinin eklentiden önce column_name başvuran geçiş filtrelerine izin verin. Parametre, farklı sütun adlarıyla birden çok kez kullanılabilir.

Eklentiler

Aşağıdaki eklentiler desteklenir:

Dağıtım ipuçları

Dağıtım ipuçları, eklenti yürütmenin birden çok küme düğümü arasında nasıl dağıtılacağını belirtir. Her eklenti dağıtım için farklı bir destek uygulayabilir. Eklentinin belgeleri, eklenti tarafından desteklenen dağıtım seçeneklerini belirtir.

Olası değerler:

  • single: Eklentinin tek bir örneği sorgu verilerinin tamamı üzerinde çalışır.
  • per_node: Eklenti çağrısından önceki sorgu düğümler arasında dağıtılırsa, eklentinin bir örneği içerdiği veriler üzerinde her düğümde çalışır.
  • per_shard: Eklenti çağrısından önceki veriler parçalar arasında dağıtılırsa, eklentinin bir örneği verilerin her parçası üzerinde çalışır.