Spark 属性

Dataproc Serverless 使用 Spark 属性来确定 要分配给批量工作负载的计算、内存和磁盘资源。 这些属性设置可能会影响工作负载配额消耗和费用（如需了解详情，请参阅 Dataproc Serverless 配额和 Dataproc Serverless 价格）。

设置 Spark 批处理工作负载属性

使用 Google Cloud 控制台、gcloud CLI 或 Dataproc API 提交 Dataproc Serverless Spark 批处理工作负载时，您可以指定 Spark 属性。

控制台

  1. 在 Google Cloud 控制台中前往“Dataproc 创建批处理”页面。

  2. 在属性部分中，点击添加属性，然后输入受支持的 Spark 属性的 Key（名称）和 Value。

gcloud

gcloud CLI 批量提交示例：

gcloud dataproc batches submit spark
    --properties=spark.checkpoint.compress=true \
    --region=region \
    other args ...

API

设置 RuntimeConfig.properties 包含受支持的 Spark 属性 batches.create 请求。

支持的 Spark 属性

Dataproc Serverless for Spark 支持大多数 Spark 属性，但它不支持与 YARN 和 shuffle 相关的 Spark 属性，例如 spark.master=yarn 和 spark.shuffle.service.enabled。如果 Spark 应用代码设置 YARN 或 shuffle 属性，则应用将失败。

运行时环境属性

Dataproc Serverless for Spark 支持以下自定义 Spark 属性 配置运行时环境：

属性 说明
spark.dataproc.driverEnv.EnvironmentVariableName 将 EnvironmentVariableName 添加到驱动程序进程。您可以指定多个环境变量。

资源分配属性

Dataproc Serverless for Spark 支持以下 Spark 属性 配置资源分配：

属性 说明 默认 示例
spark.driver.cores 要分配给 Spark 驱动程序的核心 (vCPU) 数。 有效值：4、8、16。 4
spark.driver.memory

要分配给 Spark 驱动程序进程的内存量。 使用大小单位后缀（“m”“g”）的 JVM 内存字符串格式指定 或“t”）。

每个驱动程序核心的总驱动程序内存，包括驱动程序内存开销，对于标准计算层级，必须介于 1024m 和 7424m 之间（对于高级计算层级，必须介于 24576m 和 7424m 之间）。例如，如果该查询参数为 spark.driver.cores = 4，则需采用 4096m <= spark.driver.memory + spark.driver.memoryOverhead <= 29696m。

 512m，2g
spark.driver.memoryOverhead

要为 Spark 驱动程序进程分配的额外 JVM 内存量，以 JVM 内存字符串格式指定，并带有大小单位后缀（“m”“g”或“t”）。

这是与 JVM 开销相关的非堆内存， 内部字符串和其他原生开销，并且包括 其他驱动程序进程（如 PySpark 驱动程序进程）使用的内存 以及容器中运行的其他非驱动程序进程使用的内存。 运行驱动程序的容器的最大内存大小为 等于 spark.driver.memoryOverhead 与 spark.driver.memory。

每个驱动程序核心的驱动程序内存总量（包括驱动程序内存开销）， 必须介于 1024m 和 7424m 之间 标准计算层级 （高级计算层级为 24576m）。例如： 如果为 spark.driver.cores = 4，则 4096m <= spark.driver.memory + spark.driver.memoryOverhead <= 29696m。

 10% 的驱动程序内存，但 PySpark 批处理工作负载除外，其默认为 40% 的驱动程序内存 512m，2g
spark.dataproc.driver.compute.tier 要在驱动程序上使用的计算层级。 专业计算层级提供更高的单核心性能，但其计费率较高。 standard 标准、高级
spark.dataproc.driver.disk.size 分配给驱动程序的磁盘空间量，使用大小单位后缀（“k”“m”“g”或“t”）指定。 必须至少为 250GiB。 如果在驱动程序上选择了“高级”磁盘层级，则有效大小为 375g、750g、1500g、3000g、6000g 或 9000g。 每个核心 100GiB 1024g，2t
spark.dataproc.driver.disk.tier 用于驱动程序上的本地存储和 Shuffle 存储的磁盘层级。 高级磁盘层级可在 IOPS 和吞吐量方面提供更好的性能， 而是以较高的费率结算如果在结算时选择了高级磁盘层级 必须使用 spark.dataproc.driver.compute.tier=premium, 磁盘可用空间大小必须使用 spark.dataproc.executor.disk.size。

如果选择了“高级”磁盘层级，驱动程序会为系统存储空间额外分配 50 GiB 的磁盘空间，该空间无法供用户应用使用。

standard 标准、高级
spark.executor.cores 要分配给每个 Spark 执行器的核心 (vCPU) 数。 有效值：4、8、16。 4
spark.executor.memory

要分配给每个 Spark 执行程序进程的内存量，使用 JVM 内存字符串格式指定，并带有大小单位后缀（“m”“g”或“t”）。

每个执行器核心的执行器总内存，包括执行器内存 开销，必须介于 1024m 到 7424m 之间 标准计算层级 （高级计算层级为 24576m）。例如： 如果为 spark.executor.cores = 4，则 4096m <= spark.executor.memory + spark.executor.memoryOverhead <= 29696m。

 512m，2g
spark.executor.memoryOverhead

要分配给 Spark 的额外 JVM 内存量 执行器进程，以具有大小单位的 JVM 内存字符串格式指定 后缀（“m”、“g”或“t”）。

这是用于 JVM 开销、内部字符串和其他原生开销的非堆内存，包括 PySpark 执行器内存以及在容器中运行的其他非执行器进程使用的内存。 执行器运行所在容器的内存大小上限由 spark.executor.memoryOverhead 和 spark.executor.memory 的总和决定。

每个执行器核心的执行器总内存，包括执行器内存 开销，必须介于 1024m 到 7424m 之间 标准计算层级 （高级计算层级为 24576m）。例如： 如果为 spark.executor.cores = 4，则 4096m <= spark.executor.memory + spark.executor.memoryOverhead <= 29696m。

 执行器内存的 10%（PySpark 批处理工作负载除外，其默认为执行器内存的 40%） 512m，2g
spark.dataproc.executor.compute.tier 要对执行器使用的计算层级。 高级计算层级提供更高的单核性能， 而是以较高的费率结算 standard 标准、高级
spark.dataproc.executor.disk.size 分配给每个执行程序的磁盘空间量，使用大小单位后缀（“k”“m”“g”或“t”）指定。 执行器磁盘空间可能会用于 shuffle 数据和暂存 依赖项必须至少为 250GiB。 如果在执行器上选择了高级磁盘层级，则有效大小为 375g、750g、1500g、3000g、6000g 或 9000g。 每个核心 100GiB 1024g，2t
spark.dataproc.executor.disk.tier 用于执行器上的本地和 Shuffle 存储的磁盘层级。 高级磁盘层级可在 IOPS 和吞吐量方面提供更好的性能， 而是以较高的费率结算如果选择了高级磁盘层级， 执行器，还必须使用 spark.dataproc.executor.compute.tier=premium, 磁盘可用空间大小必须使用 spark.dataproc.executor.disk.size。

如果选择了高级磁盘层级，则会为每个执行器分配 另外还有 50GiB 的磁盘可用空间用于系统存储 可供用户应用使用

standard 标准、高级
spark.executor.instances 要分配的初始执行器数量。在批处理工作负载启动后，自动扩缩可能会更改活跃执行程序的数量。必须为 最小值为 2，最大值为 2000。

自动扩缩属性

请参阅 Spark 动态分配属性 ，了解可用于配置集群内的 Spark 属性列表 Dataproc 无服务器自动扩缩。

日志记录属性

属性 说明 默认 示例
spark.log.level 设置后，会覆盖所有用户定义的日志设置，效果相当于在 Spark 启动时调用 SparkContext.setLogLevel()。有效 日志级别包括：ALL、DEBUG、ERROR、 FATAL、INFO、OFF、TRACE、 和 WARN。 INFO，DEBUG
spark.executor.syncLogLevel.enabled 设置为 true 时，通过 SparkContext.setLogLevel() 方法应用的日志级别会传播到所有执行器。 false true，false
spark.log.level.PackageName 设置后，会覆盖任何用户定义的日志设置 通过 SparkContext.setLogLevel(PackageName, level) 调用的效果 有效日志级别包括：ALL、DEBUG、 ERROR、FATAL、INFO、OFF、 TRACE 和 WARN。 spark.log.level.org.apache.spark=error

时间安排属性

属性 说明 默认 示例
spark.scheduler.excludeShuffleSkewExecutors 在调度时排除分块映射偏斜的执行器，这可以减少因分块写入偏斜而导致的长时间分块提取等待时间。 false true
spark.scheduler.shuffleSkew.minFinishedTasks 执行器上已完成的 Shuffle 映射任务的最小数量 视为偏差。 10 100
spark.scheduler.shuffleSkew.maxExecutorsNumber 被视为偏差的执行器数量上限。系统会从当前调度轮次中排除偏向的执行器。 5 10
spark.scheduler.shuffleSkew.maxExecutorsRatio 被视为偏差的总执行程序的最大比率。系统会将偏向的执行器排除在调度之外。 0.05 0.1
spark.scheduler.shuffleSkew.ratio 执行器上完成的平均 shuffle 映射任务的倍数，用于将其视为偏斜。 1.5 2.0

其他属性

属性 说明
dataproc.diagnostics.enabled 启用此属性可对批量工作负载失败或取消运行诊断。如果启用了诊断功能，您的批处理工作负载在完成后会继续使用计算资源，直到诊断完成为止。 指向诊断 tar 压缩文件位置的 URI 列在 Batch.RuntimeInfo.diagnosticOutputUri API 字段中。
dataproc.gcsConnector.version 使用此属性可升级到 Cloud Storage 连接器版本 与批量工作负载中安装的版本不同 运行时版本。
dataproc.sparkBqConnector.version 您可以使用此属性升级到与批处理工作负载的运行时版本一起安装的版本不同的 Spark BigQuery 连接器版本（请参阅将 BigQuery 连接器与 Dataproc Serverless for Spark 搭配使用）。
dataproc.profiling.enabled 将此属性设置为 true 可为 Dataproc Serverless 工作负载启用性能分析。
dataproc.profiling.name 使用此属性设置用于在 Profiler 服务上创建配置文件的名称。