了解如何排查由于运行时更改而导致的 U-SQL 运行时故障
重要
Azure Data Lake Analytics于 2024 年 2 月 29 日停用。 通过此公告了解更多信息。
对于数据分析，组织可以使用 Azure Synapse Analytics 或 Microsoft Fabric。
Azure Data Lake U-SQL 运行时（包括编译器、优化器和作业管理器）用于处理 U SQL 代码。
选择 U-SQL 运行时版本
从 Visual Studio、ADL SDK 或 Azure Data Lake Analytics 门户提交 U-SQL 作业时，你的作业将使用当前可用的默认运行时。 新版本的 U-SQL 运行时会定期发布，包括次要更新和安全修补程序。
还可以选择自定义运行时版本;要么是因为你想要尝试新更新，需要继续使用较旧版本的运行时，要么为报告的问题提供了修补程序，在该修补程序中，你无法等待常规的新更新。
注意
选择与默认运行时不同的运行时可能会中断 U-SQL 作业。 使用其他版本仅供测试。
在极少数情况下，Microsoft 支持部门可以将不同版本的运行时固定为帐户的默认版本。 请确保尽快还原此固定。 如果保持锁定该版本，不久后它将会过期。
监视作业 U-SQL 运行时版本
可以通过 Visual Studio 的作业浏览器或 Azure 门户的作业历史记录，在帐户的作业历史记录中查看过去作业使用的运行时版本的历史记录。
- 在 Azure 门户中转到 Data Lake Analytics 帐户。
- 选择“查看所有作业”。 将显示帐户中所有活动作业和最近已完成作业的列表。
- （可选）选择“筛选”以帮助你按时间范围、作业名称和作者值查找作业。
- 可以看到已完成作业中使用的运行时。
可用的运行时版本随时间发生变化。 默认运行时始终称为“default”，我们至少将以前的运行时保留一段时间，并出于各种原因使特殊运行时可用。 显式命名的运行时通常遵循以下格式（斜体用于变量部分，[] 表示可选部分）：
release_YYYYMMDD_adl_buildno[_modifier]
例如，release_20190318_adl_3394512_2 表示 2019 年 3 月 18 日的运行时版本的 3394512 版本的第二个版本，而 release_20190318_adl_3394512_private 则表示同一版本的专用版本。 注意：日期与该版本的最后一次签入时间有关，不一定是正式发布日期。
排查 U-SQL 运行时版本问题
可能会遇到两个可能的运行时版本问题：
脚本或一些用户代码的行为因版本而异。 此类中断性变更通常会在发行说明发布之前提前传达。 如果遇到此类中断性变更，请联系 Microsoft 支持部门 报告此中断行为 (以防尚未记录) ，并针对较旧的运行时版本提交作业。
在将非默认运行时固定到帐户时，你一直在显式或隐式使用非默认运行时，并且该运行时在一段时间后已被删除。 如果遇到运行时缺失的情况，请升级脚本以使用当前默认运行时来运行。 如果需要更多时间，请联系 Microsoft 支持部门
已知问题
在 USQL 脚本中引用 Newtonsoft.Json 文件 12.0.3 版本或更高版本将导致以下编译故障：
“很抱歉，Data Lake Analytics 帐户中运行的作业可能运行更加缓慢或无法完成。 意外问题导致无法为 Azure Data Lake Analytics 帐户自动恢复此功能。 已联系 Azure Data Lake 工程师进行调查。”
其中调用堆栈将包含：
System.IndexOutOfRangeException: Index was outside the bounds of the array.
at Roslyn.Compilers.MetadataReader.PEFile.CustomAttributeTableReader.get_Item(UInt32 rowId)
...解决方案：使用 Newtonsoft.Json 文件 v12.0.2 或更高版本。
客户可能会在其存储中看到临时文件和文件夹。 它们在正常作业执行期间生成，但是通常在客户看到它们之前就已被删除。 在某些情况下（这是罕见的和随机的），它们可能保持可见。 它们最终会被删除，并且永远不会计入用户存储，也不会产生任何形式的费用。 根据客户的作业逻辑，它们可能会导致问题。 例如，如果作业枚举文件夹中的所有文件，然后比较文件列表，则可能由于意外存在的临时文件而失败。 同样的，如果下游作业枚举给定文件夹中的所有文件以进行进一步处理，它也可能会枚举临时文件。
解决方案：在运行时中标识了一个修补程序，其中临时文件将存储在帐户级别的临时文件夹中，而不是当前输出文件夹中。 临时文件将被写入此新的临时文件夹，并在作业执行结束时删除。
由于此修补程序正在处理客户数据，因此在发布之前，请务必在 MSFT 中充分验证此修补程序。 预计此修补程序将在 2021 年年中作为 beta 运行时提供，在 2021 年下半年作为默认运行时提供。