将 Amazon Glue for Spark 作业迁移到 Amazon Glue 版本 4.0

它基于 Apache Spark 3.3.0，拥有对 Amazon Glue 和 Amazon EMR 的优化，如自适应查询运行、矢量化读取器以及优化的随机排序和分区合并。

升级了 JDBC 驱动程序，适用于所有 Amazon Glue 原生源，包括 MySQL、Microsoft SQL Server、Oracle、PostgreSQL、MongoDB，并且升级了 Spark 3.3.0 引入的 Spark 库和依赖项。

更新了新的 Amazon Redshift 连接器和 JDBC 驱动程序。

使用升级的 EMR 文件系统（EMRFS）优化了 Amazon S3 访问，并且默认启用了 Amazon S3 优化的输出提交程序。

使用分区索引、下推谓词、分区列表和升级的 Hive 元存储客户端优了化数据目录访问。

通过单元级筛选条件和数据湖事务，与受监管目录表的 Lake Formation 集成。

减少了启动延迟，改善了整体任务完成时间和交互性。

Spark 任务以 1 秒为增量计费，按 10 倍缩短最短计费持续时间（从最短 10 分钟到最短 1 分钟）。

本机支持 Apache Hudi、Delta Lake 和 Apache Iceberg 的开放数据湖框架。

本机支持基于 Amazon S3 的 Cloud Shuffle 存储插件（Apache Spark 插件），从而使用 Amazon S3 进行洗牌和弹性存储容量。

行级运行时筛选（SPARK-32268）。

ANSI 增强功能（SPARK-38860）。

错误消息改进（SPARK-38781）。

支持 Parquet 矢量化阅读器（SPARK-34863）的复杂类型。

支持 Spark SQL（SPARK-37273）的隐藏文件元数据。

为 Python/Pandas UDF 提供分析器（SPARK-37443）。

推出 Trigger.AvailableNow 来分批运行像 Trigger.Once 这样的流式查询（SPARK-36533）。

更全面的 Datasource V2 下推功能（SPARK-38788）。

从 log4j 1 迁移到 log4j 2（SPARK-37814）。

重大更改

在 Amazon Glue Studio 中，为 Glue version 选择 Glue 4.0 - Supports Spark 3.3, Scala 2, Python 3。

在 API 中，为 UpdateJob API 操作中的 GlueVersion 参数选择 4.0。

在控制台中，为 Glue version 选择 Spark 3.3, Python 3 (Glue Version 4.0) or Spark 3.3, Scala 2 (Glue Version 3.0)。

在 Amazon Glue Studio 中，为 Glue version 选择 Glue 4.0 - Supports Spark 3.3, Scala 2, Python 3。

在 API 中，为 CreateJob API 操作中的 GlueVersion 参数选择 4.0。

您的任务的外部 Python 库是否依赖于 Python 2.7/3.6？

所有现有任务参数和 Amazon Glue 3.0 中存在的主要功能将存在于 Amazon Glue 4.0。

Amazon Glue 3.0 使用 Amazon EMR 优化的 Spark 3.1.1，Amazon Glue 4.0 使用 Amazon EMR 优化的 Spark 3.3.0。

仅有几项 Spark 更改可能需要修订脚本，确保不会引用已删除的功能。

Amazon Glue 4.0 还包括对 EMRFS 和 Hadoop 的更新。有关特定版本，请参阅附录 A：显著依赖项升级。

ETL 任务中提供的 Amazon 开发工具包现已从 1.11 升级到 1.12。

所有 Python 作业都将使用 Python 版本 3.10。以前，Amazon Glue 3.0 中使用 Python 3.7。

因此，Amazon Glue 一些即用的 pymodule 得到了升级。

Log4j 已升级到 Log4j2。

有关迁移某些连接器的信息，请参阅Amazon Glue 4.0 版的连接器和 JDBC 驱动程序迁移。

Amazon 加密 SDK 从 1.x 升级到 2.x。使用 Amazon Glue 安全配置的 Amazon Glue 作业和依赖于运行时提供的 Amazon 加密 SDK 依赖项的作业会受到影响。请参阅 Amazon Glue 作业迁移说明。

您可以安全地将 Amazon Glue 2.0/3.0 作业升级到 Amazon Glue 4.0 作业，因为 Amazon Glue 2.0/3.0 已经包含 Amazon 加密 SDK 桥接版本。

从 Spark SQL 3.1 升级到 3.2

从 Spark SQL 3.2 升级到 3.3

所有现有任务参数和 Amazon Glue 2.0 中存在的主要功能将存在于 Amazon Glue 4.0。

预设情况下，自 Amazon Glue 3.0，将启用经 EMRFS S3 优化的提交程序，用于将 Parquet 数据写入 Amazon S3。但是，您仍然可以通过将 --enable-s3-parquet-optimized-committer 设置为 false 来禁用。

Amazon Glue 2.0 使用开源 Spark 2.4，Amazon Glue 4.0 使用 Amazon EMR 优化的 Spark 3.3.0。

ETL 任务中提供的 Amazon 开发工具包现已从 1.11 升级到 1.12。

Amazon Glue 4.0 还更新了 EMRFS、JDBC 驱动程序，并且对 Amazon Glue 提供的 Spark 进行了额外优化。

Scala 也从 2.11 更新到 2.12，Scala 2.12 不向后兼容 Scala 2.11。

Python 3.10 还是 Python 脚本使用的默认版本，因为 Amazon Glue 2.0 仅使用了 Python 3.7和 2.7。

多个依赖项更新，在 附录 A：显著依赖项升级 中突出显示。

现有 Amazon Glue 2.0 任务中提供的任何额外 JAR 文件都可能会带来导致冲突的依赖项，因为 4.0 中的几个依赖项从 2.0 升级。您可以使用 --user-jars-first Amazon Glue 作业参数，避免 Amazon Glue 4.0 中的类路径冲突。

Amazon Glue 4.0 使用 Spark 3.3。从 Spark 3.1 开始，从/到 parquet 文件加载/保存时间戳的行为发生了变化。有关更多详细信息，请参阅 从 Spark SQL 3.0 升级到 3.1。

在读取/写入包含时间戳列的 parquet 数据时，建议设置以下参数。设置这些参数可以解决 Spark 2 到 Spark 3 升级期间发生的 Amazon Glue 动态帧和 Spark 数据帧的日历不兼容问题。使用 CORRECTED（更正）选项将按原样读取日期时间值；使用 LEGACY（旧式）选项将根据读取期间的日历差异重新设置日期时间值的基础。

- Key: --conf
- Value: spark.sql.legacy.parquet.int96RebaseModeInRead=[CORRECTED|LEGACY] --conf spark.sql.legacy.parquet.int96RebaseModeInWrite=[CORRECTED|LEGACY] --conf spark.sql.legacy.parquet.datetimeRebaseModeInRead=[CORRECTED|LEGACY]

有关迁移某些连接器的信息，请参阅Amazon Glue 4.0 版的连接器和 JDBC 驱动程序迁移。

Amazon 加密 SDK 从 1.x 升级到 2.x。使用 Amazon Glue 安全配置的 Amazon Glue 作业和依赖于运行时提供的 Amazon 加密 SDK 依赖项的作业会受到影响。请参阅以下有关 Amazon Glue 工作迁移的说明：

从 Spark SQL 2.4 升级到 3.0

从 Spark SQL 3.1 升级到 3.2

从 Spark SQL 3.2 升级到 3.3

自 Spark 3.0 以来预期的日期时间行为更改。

Amazon Glue 1.0 使用开源 Spark 2.4，Amazon Glue 4.0 使用 Amazon EMR 优化的 Spark 3.3.0。

Amazon Glue 4.0 中的所有任务均会执行，显著缩短启动时间。Spark 任务以 1 秒为增量计费，按 10 倍缩短最短计费持续时间，因为启动延迟从最长 10 分钟到最长 1 分钟。

在 Amazon Glue 4.0 中，记录行为发生了显著变化，Spark 3.3.0 的最低要求为 Log4j2。

多个依赖项更新，在附录中突出显示。

Scala 也从 2.11 更新到 2.12，Scala 2.12 不向后兼容 Scala 2.11。

Python 3.10 还是 Python 脚本使用的默认版本，因为 Amazon Glue 0.9 仅使用了 Python 2。

Spark 3.3.0 不支持 Python 2.7。任何在作业配置中请求 Python 2 的任务都会因为 IllegalArgumentException 而失败。

从 Amazon Glue 2.0 开始，提供通过 pip 安装额外 Python 模块的新机制。有关更多信息，请参阅使用 pip 在 Amazon Glue 2.0+ 中安装其他 Python 模块。

Amazon Glue 4.0 不会在 Apache YARN 上运行，因此 YARN 设置不适用。

Amazon Glue 4.0 没有 Hadoop Distributed File System (HDFS)。

现有 Amazon Glue 1.0 任务中提供的任何额外 JAR 文件都可能会带来导致冲突的依赖项，因为 4.0 中的几个依赖项从 1.0 升级。为了避免这个问题，我们默认使用 --user-jars-firstAmazon Glue 作业参数启用 Amazon Glue 4.0。

Amazon Glue 4.0 现在支持 Auto Scaling。因此，启用 Auto Scaling 后，ExecutorAllocationManager 指标将可用。

在 Amazon Glue 版本 4.0 任务中，您可以指定工件数量和工件类型，但不能指定 maxCapacity。

Amazon Glue 4.0 尚不支持机器学习转换。

有关迁移某些连接器的信息，请参阅 Amazon Glue 4.0 版的连接器和 JDBC 驱动程序迁移。

Amazon 加密 SDK 从 1.x 升级到 2.x。使用 Amazon Glue 安全配置的 Amazon Glue 作业和依赖于运行时提供的 Amazon 加密 SDK 依赖项的作业会受到影响。有关 Amazon Glue 工作迁移的信息，请参阅这些说明。

从 Spark SQL 2.4 升级到 3.0

从 Spark SQL 3.0 升级到 3.1

从 Spark SQL 3.1 升级到 3.2

从 Spark SQL 3.2 升级到 3.3

自 Spark 3.0 以来预期的日期时间行为更改。

Amazon Glue 0.9 使用开源 Spark 2.2.1，Amazon Glue 4.0 使用 Amazon EMR 优化的 Spark 3.3.0。

Amazon Glue 4.0 中的所有任务均会执行，显著缩短启动时间。Spark 任务以 1 秒为增量计费，按 10 倍缩短最短计费持续时间，因为启动延迟从最长 10 分钟到最长 1 分钟。

自 Amazon Glue 4.0 以来，日志记录行为发生了重大变化，Spark 3.3.0 的最低要求为 Log4j2，如此处所述 (https://spark.apache.org/docs/latest/core-migration-guide.html#upgrading-from-core-32-to-33)。

多个依赖项更新，在附录中突出显示。

Scala 也从 2.11 更新到 2.12，Scala 2.12 不向后兼容 Scala 2.11。

Python 3.10 还是 Python 脚本使用的默认版本，因为 Amazon Glue 0.9 仅使用了 Python 2。

Amazon Glue 4.0 不会在 Apache YARN 上运行，因此 YARN 设置不适用。

Amazon Glue 4.0 没有 Hadoop Distributed File System (HDFS)。

现有 Amazon Glue 0.9 任务中提供的任何额外 JAR 文件都可能会带来导致冲突的依赖项，因为 3.0 中的几个依赖项从 0.9 升级。您可以使用 --user-jars-first Amazon Glue 任务参数，避免 Amazon Glue 3.0 中的类路径冲突。

Amazon Glue 4.0 现在支持 Auto Scaling。因此，启用 Auto Scaling 后，ExecutorAllocationManager 指标将可用。

在 Amazon Glue 版本 4.0 任务中，您可以指定工件数量和工件类型，但不能指定 maxCapacity。

Amazon Glue 4.0 尚不支持机器学习转换。

有关迁移某些连接器的信息，请参阅 Amazon Glue 4.0 版的连接器和 JDBC 驱动程序迁移。

Amazon 加密 SDK 从 1.x 升级到 2.x。使用 Amazon Glue 安全配置的 Amazon Glue 作业和依赖于运行时提供的 Amazon 加密 SDK 依赖项的作业会受到影响。有关 Amazon Glue 工作迁移的信息，请参阅这些说明。

从 Spark SQL 2.2 升级到 2.3

从 Spark SQL 2.3 升级到 2.4

从 Spark SQL 2.4 升级到 3.0

从 Spark SQL 3.0 升级到 3.1

从 Spark SQL 3.1 升级到 3.2

从 Spark SQL 3.2 升级到 3.3

自 Spark 3.0 以来预期的日期时间行为更改。

附录 B：JDBC 驱动程序升级

附录 C：连接器升级

Spark SQL 支持方面的改进：

从 0.10.0 版本开始创建的任何没有 primaryKey 的 Hudi 表都需要使用自版本 0.10.0 起的 primaryKey 字段重新创建。

多个漏洞（CVE）已得到解决。

本机支持 Java 8。

如果任务是使用数组的数组，则除字节数组外，可以将此场景视为多维数组。

当前的 MongoDB 连接器支持 Spark 3.1 或更高版本以及 MongoDB 版本 4.0 或更高版本。

由于连接器升级，一些属性名称发生了变化。例如，URI 属性名更改为 connection.uri。有关当前选项的更多信息，请参阅 MongoDB Spark 连接器博客。

使用 Amazon DocumentDB 托管的 MongoDB 4.0 有一些功能差异。有关更多信息，请参阅以下主题：

“partitioner”（分区程序）选项仅限于 ShardedPartitioner、PaginateIntoPartitionsPartitioner、和 SinglePartitionPartitioner。它不能为 Amazon DocumentDB 使用默认 SamplePartitioner 和 PaginateBySizePartitioner，因为阶段运算符不支持 MongoDB API。有关更多信息，请参阅支持的 MongoDB API、操作和数据类型。

Delta Lake 现在支持在 SQL 中进行时空旅行，以便轻松查询较旧的数据。在此更新中，时空旅行现在既可以在 Spark SQL 中使用，也可以通过 DataFrame API 使用。已在 SQL 中添加了对当前版本的 TIMESTAMP 的支持。

Spark 3.3 推出了用于运行流式查询的 Trigger.AvailableNow，等同于 Trigger.Once 批量查询。在使用 Delta 表作为流媒体源时，此支持也可用。

支持 SHOW COLUMNS 返回表中的列表。

在 Scala 和 Python DeltaTable API 中支持 DESCRIBE DETAIL。它使用 DeltaTable API 或 Spark SQL 检索有关 Delta 表的详细信息。

支持从 SQL 删除、合并和更新命令返回操作指标。以前这些 SQL 命令返回一个空的 DataFrame，现在它们返回一个 DataFrame，其中包含有关所执行操作的有用指标。

优化性能改进：

其他显著的变化：

为扫描计划和 Spark 查询添加了多项性能改进。

添加了一个通用 REST 目录客户端，该客户端使用基于更改的提交来解决服务端的提交冲突。

支持 SQL 时空旅行查询的 AS OF 语法。

为 MERGE 和 UPDATE 查询添加了读取时合并支持。

添加了对使用 Z 顺序重写分区的支持。

为 Puffin 添加了规范和实施，这是一种用于大型统计数据和索引 blob 的格式，例如 Theta sketch 或布隆过滤器。

添加了用于增量使用数据的新接口（追加和更改日志扫描）。

增加了对 FileIO 接口的批量操作和远程读取的支持。

增加了更多元数据表，以显示元数据树中的删除文件。

删除表的行为发生了变化。在 Iceberg 0.13.1 中，运行 DROP TABLE 会将表从目录中移除，同时删除表内容。在 Iceberg 1.0.0 中，DROP TABLE 仅将表从目录中删除。要删除表格内容，请使用 DROP TABLE PURGE。

在 Iceberg 1.0.0 中，Park 矢量化读取默认启用。如果要禁用矢量化读取，请设置 read.parquet.vectorization.enabled 为 false。