AWS Security ChangesHomeSearch

AWS prescriptive-guidance documentation change

Service: prescriptive-guidance · 2026-07-10 · Documentation low

File: prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/optimize-shuffles.md

Summary

Updated image paths, converted section headings to markdown level 4 (####), reformatted note about Spark collect() best practices

Security assessment

Changes involve documentation formatting, image path updates, and minor editorial improvements. The note about avoiding Spark collect() addresses performance/reliability (OOM errors), not security vulnerabilities. No security-specific content was added or modified.

Diff

diff --git a/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/optimize-shuffles.md b/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/optimize-shuffles.md
index 5d0a9d84f..1aa3a3696 100644
--- a//prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/optimize-shuffles.md
+++ b//prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/optimize-shuffles.md
@@ -38 +38 @@ If the **Shuffle Bytes Written** value is high compared with **Shuffle Bytes Rea
-![Data Shuffle Across Executors \(Bytes\) graph showing a spike in shuffle bytes written.](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/data-shuffle-across-executors.png)
+![Data Shuffle Across Executors \(Bytes\) graph showing a spike in shuffle bytes written.](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/guide-img/ee14755c-1401-4ea5-afc7-732eb483b047/images/2e033b62-cdff-4bb0-9bea-b8529167c960.png)
@@ -48 +48 @@ The **Shuffle Spill (Disk)** column shows a large amount of data spill memory to
-![""](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/shuffle-spill.png)
+![""](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/guide-img/ee14755c-1401-4ea5-afc7-732eb483b047/images/fda93bf5-86f4-47b7-b04d-b1141ec6b987.png)
@@ -65 +65 @@ After you confirm that your join operations are essential to your business requi
-_Use pushdown before join_
+#### Use pushdown before join
@@ -88 +88 @@ Filter out unnecessary rows and columns in the DataFrame before performing a joi
-_Use DataFrame Join_
+#### Use DataFrame Join
@@ -92 +92 @@ Try using a [Spark high-level API](https://archive.apache.org/dist/spark/docs/3.
-_Shuffle and broadcast hash joins and hints_
+#### Shuffle and broadcast hash joins and hints
@@ -98 +98 @@ The following diagram shows the high-level structure and steps of a broadcast ha
-![Broadcast join with direct connections between tables and joined table, and shuffle join with two shuffle phases in between the tables and joined table.](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/broadcast-join-shuffle-join.png)
+![Broadcast join with direct connections between tables and joined table, and shuffle join with two shuffle phases in between the tables and joined table.](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/guide-img/ee14755c-1401-4ea5-afc7-732eb483b047/images/09eae7f2-2f0f-4f42-8aec-39b27baf77fb.png)
@@ -157 +157 @@ In AWS Glue 3.0 and or later, you can use other join hints for shuffle to tune y
-_Use bucketing_
+#### Use bucketing
@@ -161 +161 @@ _The sort-merge join_ requires two phases, shuffle and sort, and then merge. The
-![Sort-merge join has the additional shuffle and sort steps.](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/sort-merge-join-bucket-join.png)
+![Sort-merge join has the additional shuffle and sort steps.](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/guide-img/ee14755c-1401-4ea5-afc7-732eb483b047/images/ce03432b-a979-40da-ae19-0f7084968f38.png)
@@ -177 +177 @@ You can create a bucketed table by using the following code.
-_Repartition DataFrames on join keys before the join_
+#### Repartition DataFrames on join keys before the join
@@ -197 +197 @@ To identify data skew, assess the following metrics in the Spark UI:
-![Executor computing time is much longer for one task than for the others.](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/event-timeline.png)
+![Executor computing time is much longer for one task than for the others.](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/guide-img/ee14755c-1401-4ea5-afc7-732eb483b047/images/1ceb4119-615b-42be-b563-83b3b66d703f.png)
@@ -201 +201 @@ To identify data skew, assess the following metrics in the Spark UI:
-![Summary Metrics table with the Duration row highlighted.](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/summary-metrics.png)
+![Summary Metrics table with the Duration row highlighted.](/images/prescriptive-guidance/latest/tuning-aws-glue-for-apache-spark/images/guide-img/ee14755c-1401-4ea5-afc7-732eb483b047/images/58037157-4a0f-4847-89f4-1a279a214068.png)
@@ -263,3 +263,2 @@ If you don't need `collect()` or other actions in your commercial environment, c
-###### Note
-
-Avoid using Spark `collect()` in commercial environments as much as possible. The `collect()` action returns all the results of a calculation in the Spark executor to the Spark driver, which might cause the Spark driver to return an OOM error. To avoid an OOM error, Spark sets `spark.driver.maxResultSize = 1GB` by default, which limits the maximum data size returned to the Spark driver to 1 GB.
+Note: Avoid using Spark `collect()` in commercial environments as much as possible. The `collect()` action returns all the results of a calculation in the Spark executor to the Spark driver, which might cause the Spark driver to return an OOM error. To avoid an OOM error, Spark sets `spark.driver.maxResultSize = 1GB` by default, which limits the maximum data size returned to the Spark driver to 1 GB.  
+---