Přečtěte si, jak řešit problémy s modulem runtime U-SQL kvůli změnám za běhu

  • Článek
  • 3 min ke čtení

Modul runtime Azure Data Lake U-SQL, včetně kompilátoru, Optimalizátoru a Správce úloh, je, který zpracovává váš kód U-SQL.

Výběr verze modulu runtime U-SQL

Když odesíláte úlohy U-SQL ze sady Visual Studio, ADL SDK nebo portálu Azure Data Lake Analytics, bude vaše úloha používat aktuálně dostupný výchozí modul runtime. Nové verze modulu runtime U-SQL jsou vydávány pravidelně a zahrnují dílčí aktualizace a opravy zabezpečení.

Můžete také zvolit vlastní verzi modulu runtime; vzhledem k tomu, že chcete vyzkoušet novou aktualizaci, je nutné zůstat ve starší verzi modulu runtime nebo byly poskytnuty v případě nahlášeného problému s opravou hotfix, kde nelze čekat na běžnou novou aktualizaci.

Upozornění

Výběr modulu runtime, který je jiný než výchozí, má potenciál rozdělit úlohy U-SQL. Použijte tyto další verze pouze pro testování.

Ve výjimečných případech může podpora Microsoftu připnout jinou verzi modulu runtime jako výchozí pro váš účet. Ujistěte se prosím, že jste Tento PIN kód znovu navrátili co nejdříve. Pokud zůstane připnuté k této verzi, platnost vyprší později.

Monitorování úloh verze modulu runtime U-SQL

V historii úloh v prohlížeči úloh sady Visual Studio nebo v historii úloh Azure Portal můžete zobrazit historii, které verze modulu runtime v minulých úlohách používala v historii úloh vašeho účtu.

  1. V Azure Portal přejít na účet Data Lake Analytics.
  2. Vyberte Zobrazit všechny úlohy. Zobrazí se seznam všech aktivních a nedávno dokončených úloh v účtu.
  3. V případě potřeby můžete kliknout na tlačítko Filtr , což vám umožní najít úlohy podle časového rozsahu, názvu úlohy a hodnot autora .
  4. Můžete zobrazit modul runtime použitý v dokončených úlohách.

Zobrazení běhové verze minulé úlohy

Dostupné verze modulu runtime se v průběhu času mění. Výchozí modul runtime se vždy nazývá "výchozí" a v některých případech udržujeme alespoň předchozí modul runtime, který je k dispozici pro nejrůznější účely. Explicitně pojmenované moduly runtime se obecně řídí následujícím formátem (kurzíva se používají pro proměnné části a [] označuje volitelné části):

release_YYYYMMDD_adl_buildno [_modifier]

Například release_20190318_adl_3394512_2 znamená druhou verzi sestavení 3394512 běhové verze z března 18 2019 a release_20190318_adl_3394512_private znamená privátní sestavení stejné verze. Poznámka: datum se vztahuje na dobu, kdy se poslední vrácení se změnami povedlo pro danou verzi, a ne nutně na oficiální datum vydání.

Řešení potíží s verzí modulu runtime U-SQL

Existují dva možné problémy s verzí modulu runtime, se kterými se můžete setkat:

  1. Skript nebo některé uživatelské kódy mění chování z jedné verze na další. Tyto zásadní změny se většinou sdělují před časem a s publikací poznámky k verzi. Pokud narazíte na zásadní změnu, kontaktujte podpora Microsoftu, abyste nahlásili toto porušení chování (v případě, že ještě není dokumentované), a odešlete úlohy proti starší verzi modulu runtime.

  2. V případě, že jste připnuli k vašemu účtu a tento modul runtime byl po určitou dobu odstraněn, používali jste nevýchozí modul runtime buď explicitně, nebo implicitně. Pokud narazíte na chybějící moduly runtime, upgradujte skripty, aby běžely s aktuálním výchozím modulem runtime. Pokud potřebujete další čas, obraťte se na podpora Microsoftu

Známé problémy

  1. Odkazování na Newtonsoft.Jsverze souboru 12.0.3 nebo vyšší ve skriptu USQL způsobí následující selhání kompilace:

    "Je nám líto, ale úlohy běžící v účtu Data Lake Analytics pravděpodobně poběží pomaleji nebo se nedaří dokončit. Neočekávaný problém nám brání v automatickém obnovení této funkce na váš Azure Data Lake Analytics účet. Byly kontaktovány Azure Data Lake technici k prošetření. "

    Kde zásobník volání bude obsahovat:
    System.IndexOutOfRangeException: Index was outside the bounds of the array.
    at Roslyn.Compilers.MetadataReader.PEFile.CustomAttributeTableReader.get_Item(UInt32 rowId)
    ...

    Řešení: použijte Newtonsoft.Jsv souboru File v 12.0.2 nebo Lower.

  2. Zákazníci můžou na svém úložišti vidět dočasné soubory a složky. Ty se vytvářejí jako součást normálního provádění úlohy, ale obvykle se odstraňují předtím, než je uvidí zákazníci. Za určitých okolností, které jsou vzácné a náhodné, můžou zůstat po určitou dobu viditelné. Jsou nakonec odstraněny a nikdy se nepočítají jako součást úložiště uživatelů ani negenerují žádné formy poplatků. V závislosti na logice úloh zákazníků může dojít k problémům. Například pokud úloha vytvoří výčet všech souborů ve složce a pak porovná seznamy souborů, může selhat kvůli neočekávaným dočasným souborům. Podobně platí, že pokud úloha pro příjem dat vytvoří z dané složky všechny soubory pro další zpracování, může také vytvořit výčet dočasných souborů.

    Řešení: v modulu runtime je zjištěna oprava, kde dočasné soubory budou uloženy v dočasné složce na úrovni účtu, než je aktuální výstupní složka. Dočasné soubory budou zapsány do této nové dočasné složky a budou odstraněny na konci provádění úlohy.
    Vzhledem k tomu, že tato oprava zpracovává zákaznická data, je velmi důležité, abyste tuto opravu dobře ověřili v rámci protokolu MSFT předtím, než se uvolní. Očekává se, že tato oprava bude k dispozici jako beta verze za běhu v polovině roku 2021 a jako výchozí modul runtime v druhé polovině roku 2021.

Viz také