From d4a9ca84f37e04a2ea72c6bca43b47650221eaf1 Mon Sep 17 00:00:00 2001
From: claudevdm <33973061+claudevdm@users.noreply.github.com>
Date: Fri, 22 Nov 2024 12:54:03 -0500
Subject: [PATCH 001/135] Add input boxes for required user inputs (#33183)

* Add input boxes for required user inputs

* Remove unnecessary comments.

---------

Co-authored-by: Claude <cvandermerwe@google.com>
---
 .../beam-ml/automatic_model_refresh.ipynb     |  621 +++----
 .../bigquery_enrichment_transform.ipynb       |  458 +++---
 .../bigtable_enrichment_transform.ipynb       |   40 +-
 .../vertex_ai_text_embeddings.ipynb           |  211 +--
 .../beam-ml/dataframe_api_preprocessing.ipynb | 1428 +++++++----------
 .../gemma_2_sentiment_and_summarization.ipynb |    2 +-
 .../beam-ml/nlp_tensorflow_streaming.ipynb    |   46 +-
 .../beam-ml/run_inference_pytorch.ipynb       |  146 +-
 .../beam-ml/run_inference_sklearn.ipynb       |  208 +--
 .../beam-ml/run_inference_tensorflow.ipynb    |    4 +-
 .../run_inference_tensorflow_with_tfx.ipynb   |  404 +++--
 .../beam-ml/run_inference_vertex_ai.ipynb     |   19 +-
 .../beam-ml/run_inference_vllm.ipynb          |  345 ++--
 .../vertex_ai_feature_store_enrichment.ipynb  |    8 +-
 examples/notebooks/healthcare/beam_nlp.ipynb  |  413 +++--
 15 files changed, 1998 insertions(+), 2355 deletions(-)

diff --git a/examples/notebooks/beam-ml/automatic_model_refresh.ipynb b/examples/notebooks/beam-ml/automatic_model_refresh.ipynb
index 96717cfef60c..2f80846f313b 100644
--- a/examples/notebooks/beam-ml/automatic_model_refresh.ipynb
+++ b/examples/notebooks/beam-ml/automatic_model_refresh.ipynb
@@ -1,22 +1,21 @@
 {
-  "nbformat": 4,
-  "nbformat_minor": 0,
-  "metadata": {
-    "colab": {
-      "provenance": [],
-      "include_colab_link": true
-    },
-    "kernelspec": {
-      "name": "python3",
-      "display_name": "Python 3"
-    },
-    "language_info": {
-      "name": "python"
-    }
-  },
   "cells": [
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "cellView": "form",
+        "id": "OsFaZscKSPvo"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "# @title ###### Licensed to the Apache Software Foundation (ASF), Version 2.0 (the \"License\")\n",
         "\n",
@@ -36,22 +35,13 @@
         "# KIND, either express or implied. See the License for the\n",
         "# specific language governing permissions and limitations\n",
         "# under the License"
-      ],
-      "metadata": {
-        "cellView": "form",
-        "id": "OsFaZscKSPvo"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "ZUSiAR62SgO8"
+      },
       "source": [
         "# Update ML models in running pipelines\n",
         "\n",
@@ -63,20 +53,13 @@
         "    <a target=\"_blank\" href=\"https://github.com/apache/beam/blob/master/examples/notebooks/beam-ml/automatic_model_refresh.ipynb\"><img src=\"https://raw.githubusercontent.com/google/or-tools/main/tools/github_32px.png\" />View source on GitHub</a>\n",
         "  </td>\n",
         "</table>\n"
-      ],
-      "metadata": {
-        "id": "ZUSiAR62SgO8"
-      },
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "tBtqF5UpKJNZ"
+      },
       "source": [
         "This notebook demonstrates how to perform automatic model updates without stopping your Apache Beam pipeline.\n",
         "You can use side inputs to update your model in real time, even while the Apache Beam pipeline is running. The side input is passed in a `ModelHandler` configuration object. You can update the model either by leveraging one of Apache Beam's provided patterns, such as the `WatchFilePattern`, or by configuring a custom side input `PCollection` that defines the logic for the model update.\n",
@@ -85,36 +68,19 @@
         "For more information about side inputs, see the [Side inputs](https://beam.apache.org/documentation/programming-guide/#side-inputs) section in the Apache Beam Programming Guide.\n",
         "\n",
         "This example uses `WatchFilePattern` as a side input. `WatchFilePattern` is used to watch for file updates that match the `file_pattern` based on timestamps. It emits the latest `ModelMetadata`, which is used in the RunInference `PTransform` to automatically update the ML model without stopping the Apache Beam pipeline.\n"
-      ],
-      "metadata": {
-        "id": "tBtqF5UpKJNZ"
-      },
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "SPuXFowiTpWx"
+      },
       "source": [
         "## Before you begin\n",
         "Install the dependencies required to run this notebook.\n",
         "\n",
         "To use RunInference with side inputs for automatic model updates, use Apache Beam version 2.46.0 or later."
-      ],
-      "metadata": {
-        "id": "SPuXFowiTpWx"
-      },
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "code",
@@ -122,23 +88,39 @@
       "metadata": {
         "id": "1RyTYsFEIOlA"
       },
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}],
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "!pip install apache_beam[gcp]>=2.46.0  tensorflow==2.15.0 tensorflow_hub==0.16.1 keras==2.15.0 Pillow==11.0.0 --quiet"
       ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "Rs4cwwNrIV9H"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "# Imports required for the notebook.\n",
         "import logging\n",
         "import time\n",
+        "import os\n",
         "from typing import Iterable\n",
         "from typing import Tuple\n",
         "\n",
@@ -156,21 +138,23 @@
         "import numpy\n",
         "from PIL import Image\n",
         "import tensorflow as tf"
-      ],
-      "metadata": {
-        "id": "Rs4cwwNrIV9H"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "jAKpPcmmGm03"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "# Authenticate to your Google Cloud account.\n",
         "def auth_to_colab():\n",
@@ -178,21 +162,13 @@
         "  auth.authenticate_user()\n",
         "\n",
         "auth_to_colab()"
-      ],
-      "metadata": {
-        "id": "jAKpPcmmGm03"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "ORYNKhH3WQyP"
+      },
       "source": [
         "## Configure the runner\n",
         "\n",
@@ -202,24 +178,37 @@
         "* Configure the pipeline options for the pipeline to run on Dataflow. Make sure the pipeline is using streaming mode.\n",
         "\n",
         "In the following code, replace `BUCKET_NAME` with the the name of your Cloud Storage bucket."
-      ],
-      "metadata": {
-        "id": "ORYNKhH3WQyP"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "wWjbnq6X-4uE"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "options = PipelineOptions()\n",
         "options.view_as(StandardOptions).streaming = True\n",
         "\n",
-        "BUCKET_NAME = '<BUCKET_NAME>' # Replace with your bucket name.\n",
+        "# Replace with your bucket name.\n",
+        "BUCKET_NAME = '<BUCKET_NAME>' # @param {type:'string'} \n",
+        "os.environ['BUCKET_NAME'] = BUCKET_NAME\n",
         "\n",
         "# Provide required pipeline options for the Dataflow Runner.\n",
         "options.view_as(StandardOptions).runner = \"DataflowRunner\"\n",
         "\n",
         "# Set the project to the default project in your current Google Cloud environment.\n",
-        "options.view_as(GoogleCloudOptions).project = '<PROJECT_NAME>'\n",
+        "PROJECT_NAME = '<PROJECT_NAME>' # @param {type:'string'}\n",
+        "options.view_as(GoogleCloudOptions).project = PROJECT_NAME\n",
         "\n",
         "# Set the Google Cloud region that you want to run Dataflow in.\n",
         "options.view_as(GoogleCloudOptions).region = 'us-central1'\n",
@@ -244,113 +233,120 @@
         "# To expedite the model update process, it's recommended to set num_workers>1.\n",
         "# https://github.com/apache/beam/issues/28776\n",
         "options.view_as(WorkerOptions).num_workers = 5"
-      ],
-      "metadata": {
-        "id": "wWjbnq6X-4uE"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Install the `tensorflow` and `tensorflow_hub` dependencies on Dataflow. Use the `requirements_file` pipeline option to pass these dependencies."
-      ],
       "metadata": {
         "id": "HTJV8pO2Wcw4"
-      }
+      },
+      "source": [
+        "Install the `tensorflow` and `tensorflow_hub` dependencies on Dataflow. Use the `requirements_file` pipeline option to pass these dependencies."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "lEy4PkluWbdm"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "# In a requirements file, define the dependencies required for the pipeline.\n",
         "!printf 'tensorflow==2.15.0\\ntensorflow_hub==0.16.1\\nkeras==2.15.0\\nPillow==11.0.0' > ./requirements.txt\n",
         "# Install the pipeline dependencies on Dataflow.\n",
         "options.view_as(SetupOptions).requirements_file = './requirements.txt'"
-      ],
-      "metadata": {
-        "id": "lEy4PkluWbdm"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "_AUNH_GJk_NE"
+      },
       "source": [
         "## Use the TensorFlow model handler\n",
         " This example uses `TFModelHandlerTensor` as the model handler and the `resnet_101` model trained on [ImageNet](https://www.image-net.org/).\n",
         "\n",
         "\n",
         "For the Dataflow runner, you need to store the model in a remote location that the Apache Beam pipeline can access. For this example, download the `ResNet101` model, and upload it to the Google Cloud Storage bucket.\n"
-      ],
-      "metadata": {
-        "id": "_AUNH_GJk_NE"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "ibkWiwVNvyrn"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "model = tf.keras.applications.resnet.ResNet101()\n",
         "model.save('resnet101_weights_tf_dim_ordering_tf_kernels.keras')\n",
         "# After saving the model locally, upload the model to GCS bucket and provide that gcs bucket `URI` as `model_uri` to the `TFModelHandler`\n",
-        "# Replace `BUCKET_NAME` value with actual bucket name.\n",
-        "!gsutil cp resnet101_weights_tf_dim_ordering_tf_kernels.keras gs://<BUCKET_NAME>/dataflow/resnet101_weights_tf_dim_ordering_tf_kernels.keras"
-      ],
-      "metadata": {
-        "id": "ibkWiwVNvyrn"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+        "!gsutil cp resnet101_weights_tf_dim_ordering_tf_kernels.keras gs://${BUCKET_NAME}/dataflow/resnet101_weights_tf_dim_ordering_tf_kernels.keras"
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "model_handler = TFModelHandlerTensor(\n",
-        "    model_uri=dataflow_gcs_location + \"/resnet101_weights_tf_dim_ordering_tf_kernels.keras\")"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "kkSnsxwUk-Sp"
       },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
+      "source": [
+        "model_handler = TFModelHandlerTensor(\n",
+        "    model_uri=dataflow_gcs_location + \"/resnet101_weights_tf_dim_ordering_tf_kernels.keras\")"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "tZH0r0sL-if5"
+      },
       "source": [
         "## Preprocess images\n",
         "\n",
         "Use `preprocess_image` to run the inference, read the image, and convert the image to a TensorFlow tensor."
-      ],
-      "metadata": {
-        "id": "tZH0r0sL-if5"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "dU5imgTt-8Ne"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "def preprocess_image(image_name, image_dir):\n",
         "  img = tf.keras.utils.get_file(image_name, image_dir + image_name)\n",
@@ -358,21 +354,23 @@
         "  img = numpy.array(img) / 255.0\n",
         "  img_tensor = tf.cast(tf.convert_to_tensor(img[...]), dtype=tf.float32)\n",
         "  return img_tensor"
-      ],
-      "metadata": {
-        "id": "dU5imgTt-8Ne"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "6V5tJxO6-gyt"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "class PostProcessor(beam.DoFn):\n",
         "  \"\"\"Process the PredictionResult to get the predicted label.\n",
@@ -387,62 +385,66 @@
         "    imagenet_labels = numpy.array(open(labels_path).read().splitlines())\n",
         "    predicted_class_name = imagenet_labels[predicted_class]\n",
         "    yield predicted_class_name.title(), element.model_id"
-      ],
-      "metadata": {
-        "id": "6V5tJxO6-gyt"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "# Define the pipeline object.\n",
-        "pipeline = beam.Pipeline(options=options)"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "GpdKk72O_NXT"
       },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
+      "source": [
+        "# Define the pipeline object.\n",
+        "pipeline = beam.Pipeline(options=options)"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "elZ53uxc_9Hv"
+      },
       "source": [
         "Next, review the pipeline steps and examine the code.\n",
         "\n",
         "### Pipeline steps\n"
-      ],
-      "metadata": {
-        "id": "elZ53uxc_9Hv"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "305tkV2sAD-S"
+      },
       "source": [
         "1. Create a `PeriodicImpulse` transform, which emits output every `n` seconds. The `PeriodicImpulse` transform generates an infinite sequence of elements with a given runtime interval.\n",
         "\n",
         "   In this example, `PeriodicImpulse` mimics the Pub/Sub source. Because the inputs in a streaming pipeline arrive in intervals, use `PeriodicImpulse` to output elements at `m` intervals.\n",
         "To learn more about `PeriodicImpulse`, see the [`PeriodicImpulse` code](https://github.com/apache/beam/blob/9c52e0594d6f0e59cd17ee005acfb41da508e0d5/sdks/python/apache_beam/transforms/periodicsequence.py#L150)."
-      ],
-      "metadata": {
-        "id": "305tkV2sAD-S"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "vUFStz66_Tbb"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "start_timestamp = time.time() # start timestamp of the periodic impulse\n",
         "end_timestamp = start_timestamp + 60 * 20 # end timestamp of the periodic impulse (will run for 20 minutes).\n",
@@ -455,72 +457,76 @@
         "          start_timestamp=start_timestamp,\n",
         "          stop_timestamp=end_timestamp,\n",
         "          fire_interval=main_input_fire_interval))"
-      ],
-      "metadata": {
-        "id": "vUFStz66_Tbb"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "8-sal2rFAxP2"
+      },
       "source": [
         "2. To read and preprocess the images, use the `preprocess_image` function. This example uses `Cat-with-beanie.jpg` for all inferences.\n",
         "\n",
         "  **Note**: The image used for prediction is licensed in CC-BY. The creator is listed in the [LICENSE.txt](https://storage.googleapis.com/apache-beam-samples/image_captioning/LICENSE.txt) file."
-      ],
-      "metadata": {
-        "id": "8-sal2rFAxP2"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "![download.png](data:image/png;base64,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)"
-      ],
       "metadata": {
         "id": "gW4cE8bhXS-d"
-      }
+      },
+      "source": [
+        "![download.png](data:image/png;base64,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)"
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "dGg11TpV_aV6"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "image_data = (periodic_impulse | beam.Map(lambda x: \"Cat-with-beanie.jpg\")\n",
         "      | \"ReadImage\" >> beam.Map(lambda image_name: preprocess_image(\n",
         "          image_name=image_name, image_dir='https://storage.googleapis.com/apache-beam-samples/image_captioning/')))"
-      ],
-      "metadata": {
-        "id": "dGg11TpV_aV6"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "eB0-ewd-BCKE"
+      },
       "source": [
         "3. Pass the images to the RunInference `PTransform`. RunInference takes `model_handler` and `model_metadata_pcoll` as input parameters.\n",
         "  * `model_metadata_pcoll` is a side input `PCollection` to the RunInference `PTransform`. This side input updates the `model_uri` in the `model_handler` while the Apache Beam pipeline runs.\n",
         "  * Use `WatchFilePattern` as side input to watch a `file_pattern` matching `.keras` files. In this case, the `file_pattern` is `'gs://BUCKET_NAME/dataflow/*keras'`.\n",
         "\n"
-      ],
-      "metadata": {
-        "id": "eB0-ewd-BCKE"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "_AjvvexJ_hUq"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         " # The side input used to watch for the .keras file and update the model_uri of the TFModelHandlerTensor.\n",
         "file_pattern = dataflow_gcs_location + '/*.keras'\n",
@@ -534,108 +540,117 @@
         "      | \"ApplyWindowing\" >> beam.WindowInto(beam.window.FixedWindows(10))\n",
         "      | \"RunInference\" >> RunInference(model_handler=model_handler,\n",
         "                                      model_metadata_pcoll=side_input_pcoll))"
-      ],
-      "metadata": {
-        "id": "_AjvvexJ_hUq"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "lTA4wRWNDVis"
+      },
       "source": [
         "4. Post-process the `PredictionResult` object.\n",
         "When the inference is complete, RunInference outputs a `PredictionResult` object that contains the fields `example`, `inference`, and `model_id`. The `model_id` field identifies the model used to run the inference. The `PostProcessor` returns the predicted label and the model ID used to run the inference on the predicted label."
-      ],
-      "metadata": {
-        "id": "lTA4wRWNDVis"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "9TB76fo-_vZJ"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
       "source": [
         "post_processor = (\n",
         "    inferences\n",
         "    | \"PostProcessResults\" >> beam.ParDo(PostProcessor())\n",
         "    | \"LogResults\" >> beam.Map(logging.info))"
-      ],
-      "metadata": {
-        "id": "9TB76fo-_vZJ"
-      },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "wYp-mBHHjOjA"
+      },
       "source": [
         "### Watch for the model update\n",
         "\n",
         "After the pipeline starts processing data, when you see output emitted from the RunInference `PTransform`, upload a `resnet152` model saved in the `.keras` format to a Google Cloud Storage bucket location that matches the `file_pattern` you defined earlier.\n"
-      ],
-      "metadata": {
-        "id": "wYp-mBHHjOjA"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "model = tf.keras.applications.resnet.ResNet152()\n",
-        "model.save('resnet152_weights_tf_dim_ordering_tf_kernels.keras')\n",
-        "# Replace the `BUCKET_NAME` with the actual bucket name.\n",
-        "!gsutil cp resnet152_weights_tf_dim_ordering_tf_kernels.keras gs://<BUCKET_NAME>/resnet152_weights_tf_dim_ordering_tf_kernels.keras"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "FpUfNBSWH9Xy"
       },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
+      "source": [
+        "model = tf.keras.applications.resnet.ResNet152()\n",
+        "model.save('resnet152_weights_tf_dim_ordering_tf_kernels.keras')\n",
+        "!gsutil cp resnet152_weights_tf_dim_ordering_tf_kernels.keras gs://${BUCKET_NAME}/resnet152_weights_tf_dim_ordering_tf_kernels.keras"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "_ty03jDnKdKR"
+      },
       "source": [
         "## Run the pipeline\n",
         "\n",
         "Use the following code to run the pipeline."
-      ],
-      "metadata": {
-        "id": "_ty03jDnKdKR"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "# Run the pipeline.\n",
-        "result = pipeline.run().wait_until_finish()"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "wd0VJLeLEWBU"
       },
-      "execution_count": null,
-			"outputs": [{
-				"output_type": "stream",
-				"name": "stdout",
-				"text": [
-					"\n"
-				]
-			}]
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n"
+          ]
+        }
+      ],
+      "source": [
+        "# Run the pipeline.\n",
+        "result = pipeline.run().wait_until_finish()"
+      ]
     }
-  ]
+  ],
+  "metadata": {
+    "colab": {
+      "include_colab_link": true,
+      "provenance": []
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
 }
diff --git a/examples/notebooks/beam-ml/bigquery_enrichment_transform.ipynb b/examples/notebooks/beam-ml/bigquery_enrichment_transform.ipynb
index 182b88b9c72a..dedaa6b65a5e 100644
--- a/examples/notebooks/beam-ml/bigquery_enrichment_transform.ipynb
+++ b/examples/notebooks/beam-ml/bigquery_enrichment_transform.ipynb
@@ -1,22 +1,13 @@
 {
-  "nbformat": 4,
-  "nbformat_minor": 0,
-  "metadata": {
-    "colab": {
-      "provenance": [],
-      "include_colab_link": true
-    },
-    "kernelspec": {
-      "name": "python3",
-      "display_name": "Python 3"
-    },
-    "language_info": {
-      "name": "python"
-    }
-  },
   "cells": [
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "cellView": "form",
+        "id": "55h6JBJeJGqg"
+      },
+      "outputs": [],
       "source": [
         "# @title ###### Licensed to the Apache Software Foundation (ASF), Version 2.0 (the \"License\")\n",
         "\n",
@@ -36,16 +27,13 @@
         "# KIND, either express or implied. See the License for the\n",
         "# specific language governing permissions and limitations\n",
         "# under the License"
-      ],
-      "metadata": {
-        "id": "55h6JBJeJGqg",
-        "cellView": "form"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "YrOuxMeKJZxC"
+      },
       "source": [
         "# Use Apache Beam and BigQuery to enrich data\n",
         "\n",
@@ -57,13 +45,13 @@
         "    <a target=\"_blank\" href=\"https://github.com/apache/beam/blob/master/examples/notebooks/beam-ml/bigquery_enrichment_transform.ipynb\"><img src=\"https://raw.githubusercontent.com/google/or-tools/main/tools/github_32px.png\" />View source on GitHub</a>\n",
         "  </td>\n",
         "</table>\n"
-      ],
-      "metadata": {
-        "id": "YrOuxMeKJZxC"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "pf2bL-PmJScZ"
+      },
       "source": [
         "This notebook shows how to enrich data by using the Apache Beam [enrichment transform](https://beam.apache.org/documentation/transforms/python/elementwise/enrichment/) with [BigQuery](https://cloud.google.com/bigquery/docs/overview). The enrichment transform is an Apache Beam turnkey transform that lets you enrich data by using a key-value lookup. This transform has the following features:\n",
         "\n",
@@ -79,38 +67,40 @@
         "\n",
         "### Install Apache Beam\n",
         "To use the enrichment transform with the built-in BigQuery handler, install the Apache Beam SDK version 2.57.0 or later."
-      ],
-      "metadata": {
-        "id": "pf2bL-PmJScZ"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "!pip install torch\n",
-        "!pip install apache_beam[interactive,gcp]==2.57.0 --quiet"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "oVbWf73FJSzf"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "!pip install torch\n",
+        "!pip install apache_beam[interactive,gcp]==2.57.0 --quiet"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "siSUsfR5tKX9"
+      },
       "source": [
         "Import the following modules:\n",
         "- Pub/Sub for streaming data\n",
         "- BigQuery for enrichment\n",
         "- Apache Beam for running the streaming pipeline\n",
         "- PyTorch to predict customer churn"
-      ],
-      "metadata": {
-        "id": "siSUsfR5tKX9"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "p6bruDqFJkXE"
+      },
+      "outputs": [],
       "source": [
         "import datetime\n",
         "import json\n",
@@ -137,49 +127,47 @@
         "import pandas as pd\n",
         "\n",
         "from sklearn.preprocessing import LabelEncoder"
-      ],
-      "metadata": {
-        "id": "p6bruDqFJkXE"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "t0QfhuUlJozO"
+      },
       "source": [
         "### Authenticate with Google Cloud\n",
         "This notebook reads data from Pub/Sub and BigQuery. To use your Google Cloud account, authenticate this notebook.\n",
         "To prepare for this step, replace `<PROJECT_ID>` with your Google Cloud project ID."
-      ],
-      "metadata": {
-        "id": "t0QfhuUlJozO"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "PROJECT_ID = \"<PROJECT_ID>\"\n"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "RwoBZjD1JwnD"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "PROJECT_ID = \"<PROJECT_ID>\" # @param {type:'string'}\n"
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "from google.colab import auth\n",
-        "auth.authenticate_user(project_id=PROJECT_ID)"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "rVAyQxoeKflB"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "from google.colab import auth\n",
+        "auth.authenticate_user(project_id=PROJECT_ID)"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "1vDwknoHKoa-"
+      },
       "source": [
         "### Set up the BigQuery tables\n",
         "\n",
@@ -187,36 +175,38 @@
         "\n",
         "- Replace `<DATASET_ID>` with the name of your BigQuery dataset. Only letters (uppercase or lowercase), numbers, and underscores are allowed.\n",
         "- If the dataset does not exist, a new dataset with this ID is created."
-      ],
-      "metadata": {
-        "id": "1vDwknoHKoa-"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "UxeGFqSJu-G6"
+      },
+      "outputs": [],
       "source": [
-        "DATASET_ID = \"<DATASET_ID>\"\n",
+        "DATASET_ID = \"<DATASET_ID>\" # @param {type:'string'}\n",
         "\n",
         "CUSTOMERS_TABLE_ID = f'{PROJECT_ID}.{DATASET_ID}.customers'\n",
         "USAGE_TABLE_ID = f'{PROJECT_ID}.{DATASET_ID}.usage'"
-      ],
-      "metadata": {
-        "id": "UxeGFqSJu-G6"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Create customer and usage tables, and insert fake data."
-      ],
       "metadata": {
         "id": "Gw4RfZavyfpo"
-      }
+      },
+      "source": [
+        "Create customer and usage tables, and insert fake data."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "-QRZC4v0KipK"
+      },
+      "outputs": [],
       "source": [
         "client = bigquery.Client(project=PROJECT_ID)\n",
         "\n",
@@ -276,33 +266,33 @@
         "job.result()  # Wait for the job to complete.\n",
         "\n",
         "print(f\"Usage table created and populated: {USAGE_TABLE_ID}\")"
-      ],
-      "metadata": {
-        "id": "-QRZC4v0KipK"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "### Train the model"
-      ],
       "metadata": {
         "id": "PZCjCzxaLOJt"
-      }
+      },
+      "source": [
+        "### Train the model"
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Create sample data and train a simple model for churn prediction."
-      ],
       "metadata": {
         "id": "R4dIHclDLfIj"
-      }
+      },
+      "source": [
+        "Create sample data and train a simple model for churn prediction."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "YoMjdqJ1KxOM"
+      },
+      "outputs": [],
       "source": [
         "# Create fake training data\n",
         "data = {\n",
@@ -319,51 +309,51 @@
         "df = pd.DataFrame(data)\n",
         "df['plan'] = plan_encoder.transform(data['plan'])\n",
         "\n"
-      ],
-      "metadata": {
-        "id": "YoMjdqJ1KxOM"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "EgIFJx76MF3v"
+      },
       "source": [
         "Preprocess the data:\n",
         "\n",
         "1.   Convert the lists to tensors.\n",
         "2.   Separate the features from the expected prediction."
-      ],
-      "metadata": {
-        "id": "EgIFJx76MF3v"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "P-8lKzdzLnGo"
+      },
+      "outputs": [],
       "source": [
         "features = ['age', 'plan', 'contract_length', 'avg_monthly_calls', 'avg_monthly_data_usage_gb']\n",
         "target = 'churned'\n",
         "\n",
         "X = torch.tensor(df[features].values, dtype=torch.float)\n",
         "Y = torch.tensor(df[target], dtype=torch.float)"
-      ],
-      "metadata": {
-        "id": "P-8lKzdzLnGo"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Define a model that has five input features and predicts a single value."
-      ],
       "metadata": {
         "id": "4mcNOez1MQZP"
-      }
+      },
+      "source": [
+        "Define a model that has five input features and predicts a single value."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "YvdPNlzoMTtl"
+      },
+      "outputs": [],
       "source": [
         "def build_model(n_inputs, n_outputs):\n",
         "  \"\"\"build_model builds and returns a model that takes\n",
@@ -375,24 +365,24 @@
         "      torch.nn.ReLU(),\n",
         "      torch.nn.Linear(16, n_outputs),\n",
         "      torch.nn.Sigmoid())"
-      ],
-      "metadata": {
-        "id": "YvdPNlzoMTtl"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Train the model."
-      ],
       "metadata": {
         "id": "GaLBmcvrMOWy"
-      }
+      },
+      "source": [
+        "Train the model."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "0XqctMiPMaim"
+      },
+      "outputs": [],
       "source": [
         "model = build_model(n_inputs=5, n_outputs=1)\n",
         "\n",
@@ -407,61 +397,61 @@
         "    loss = loss_fn(pred, Y[i].unsqueeze(0))\n",
         "    loss.backward()\n",
         "  optimizer.step()"
-      ],
-      "metadata": {
-        "id": "0XqctMiPMaim"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Save the model to the `STATE_DICT_PATH` variable."
-      ],
       "metadata": {
         "id": "m7MD6RwGMdyU"
-      }
+      },
+      "source": [
+        "Save the model to the `STATE_DICT_PATH` variable."
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "STATE_DICT_PATH = './model.pth'\n",
-        "torch.save(model.state_dict(), STATE_DICT_PATH)"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "Q9WIjw53MgcR"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "STATE_DICT_PATH = './model.pth'\n",
+        "torch.save(model.state_dict(), STATE_DICT_PATH)"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "CJVYA0N0MnZS"
+      },
       "source": [
         "### Publish messages to Pub/Sub\n",
         "Create the Pub/Sub topic and subscription to use for data streaming."
-      ],
-      "metadata": {
-        "id": "CJVYA0N0MnZS"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "0uwZz_ijyzL8"
+      },
+      "outputs": [],
       "source": [
         "# Replace <TOPIC_NAME> with the name of your Pub/Sub topic.\n",
-        "TOPIC = \"<TOPIC_NAME>\"\n",
+        "TOPIC = \"<TOPIC_NAME>\" # @param {type:'string'}\n",
         "\n",
         "# Replace <SUBSCRIPTION_PATH> with the subscription for your topic.\n",
-        "SUBSCRIPTION = \"<SUBSCRIPTION_PATH>\""
-      ],
-      "metadata": {
-        "id": "0uwZz_ijyzL8"
-      },
-      "execution_count": null,
-      "outputs": []
+        "SUBSCRIPTION = \"<SUBSCRIPTION_PATH>\" # @param {type:'string'}"
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "hIgsCWIozdDu"
+      },
+      "outputs": [],
       "source": [
         "from google.api_core.exceptions import AlreadyExists\n",
         "\n",
@@ -482,25 +472,25 @@
         "    print(f\"Created subscription: {subscription.name}\")\n",
         "except AlreadyExists:\n",
         "  print(f\"Subscription {subscription_path} already exists.\")"
-      ],
-      "metadata": {
-        "id": "hIgsCWIozdDu"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "VqUaFm_yywjU"
+      },
       "source": [
         "\n",
         "Use the Pub/Sub Python client to publish messages."
-      ],
-      "metadata": {
-        "id": "VqUaFm_yywjU"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "fOq1uNXvMku-"
+      },
+      "outputs": [],
       "source": [
         "messages = [\n",
         "    {'customer_id': i}\n",
@@ -510,15 +500,13 @@
         "for message in messages:\n",
         "  data = json.dumps(message).encode('utf-8')\n",
         "  publish_future = publisher.publish(topic_path, data)"
-      ],
-      "metadata": {
-        "id": "fOq1uNXvMku-"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "giXOGruKM8ZL"
+      },
       "source": [
         "## Use the BigQuery enrichment handler\n",
         "\n",
@@ -566,13 +554,15 @@
         "* One for usage data that uses a custom aggregation query by using the `query_fn` function\n",
         "\n",
         "These handlers are used in the Enrichment transforms in this pipeline to fetch and join data from BigQuery with the streaming data."
-      ],
-      "metadata": {
-        "id": "giXOGruKM8ZL"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "C8XLmBDeMyrB"
+      },
+      "outputs": [],
       "source": [
         "user_data_handler = BigQueryEnrichmentHandler(\n",
         "    project=PROJECT_ID,\n",
@@ -613,37 +603,37 @@
         "    project=PROJECT_ID,\n",
         "    query_fn=usage_data_query_fn\n",
         ")"
-      ],
-      "metadata": {
-        "id": "C8XLmBDeMyrB"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "3oPYypvmPiyg"
+      },
       "source": [
         "In this example:\n",
         "1. The `user_data_handler` handler uses the `table_name`, `row_restriction_template`, and `fields` parameter combination to fetch customer data.\n",
         "2. The `usage_data_handler` handler uses the `query_fn` parameter to execute a more complex query that aggregates usage data."
-      ],
-      "metadata": {
-        "id": "3oPYypvmPiyg"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "ksON9uOBQbZm"
+      },
       "source": [
         "## Use the `PytorchModelHandlerTensor` interface to run inference\n",
         "\n",
         "Define functions to convert enriched data to the tensor format for the model."
-      ],
-      "metadata": {
-        "id": "ksON9uOBQbZm"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "XgPontIVP0Cv"
+      },
+      "outputs": [],
       "source": [
         "def convert_row_to_tensor(customer_data):\n",
         "    import pandas as pd\n",
@@ -656,69 +646,69 @@
         "    model_class=build_model,\n",
         "    model_params={'n_inputs':5, 'n_outputs':1}\n",
         ")).with_preprocess_fn(convert_row_to_tensor)"
-      ],
-      "metadata": {
-        "id": "XgPontIVP0Cv"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Define a `DoFn` to format the output."
-      ],
       "metadata": {
         "id": "O9e7ddgGQxh2"
-      }
+      },
+      "source": [
+        "Define a `DoFn` to format the output."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "NMj0V5VyQukk"
+      },
+      "outputs": [],
       "source": [
         "class PostProcessor(beam.DoFn):\n",
         "  def process(self, element, *args, **kwargs):\n",
         "    print('Customer %d churn risk: %s' % (element[0], \"High\" if element[1].inference[0].item() > 0.5 else \"Low\"))"
-      ],
-      "metadata": {
-        "id": "NMj0V5VyQukk"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "-N3a1s2FQ66z"
+      },
       "source": [
         "## Run the pipeline\n",
         "\n",
         "Configure the pipeline to run in streaming mode."
-      ],
-      "metadata": {
-        "id": "-N3a1s2FQ66z"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "options = pipeline_options.PipelineOptions()\n",
-        "options.view_as(pipeline_options.StandardOptions).streaming = True # Streaming mode is set True"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "rgJeV-jWQ4wo"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "options = pipeline_options.PipelineOptions()\n",
+        "options.view_as(pipeline_options.StandardOptions).streaming = True # Streaming mode is set True"
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Pub/Sub sends the data in bytes. Convert the data to `beam.Row` objects by using a `DoFn`."
-      ],
       "metadata": {
         "id": "NRljYVR5RCMi"
-      }
+      },
+      "source": [
+        "Pub/Sub sends the data in bytes. Convert the data to `beam.Row` objects by using a `DoFn`."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "Bb-e3yjtQ2iU"
+      },
+      "outputs": [],
       "source": [
         "class DecodeBytes(beam.DoFn):\n",
         "  \"\"\"\n",
@@ -729,26 +719,26 @@
         "  def process(self, element, *args, **kwargs):\n",
         "    element_dict = json.loads(element.decode('utf-8'))\n",
         "    yield beam.Row(**element_dict)"
-      ],
-      "metadata": {
-        "id": "Bb-e3yjtQ2iU"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "Q1HV8wH-RIbj"
+      },
       "source": [
         "Use the following code to run the pipeline.\n",
         "\n",
         "**Note:** Because this pipeline is a streaming pipeline, you need to manually stop the cell. If you don't stop the cell, the pipeline continues to run."
-      ],
-      "metadata": {
-        "id": "Q1HV8wH-RIbj"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "y6HBH8yoRFp2"
+      },
+      "outputs": [],
       "source": [
         "with beam.Pipeline(options=options) as p:\n",
         "  _ = (p\n",
@@ -760,12 +750,22 @@
         "       | \"RunInference\" >> RunInference(keyed_model_handler)\n",
         "       | \"Format Output\" >> beam.ParDo(PostProcessor())\n",
         "       )"
-      ],
-      "metadata": {
-        "id": "y6HBH8yoRFp2"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     }
-  ]
+  ],
+  "metadata": {
+    "colab": {
+      "include_colab_link": true,
+      "provenance": []
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
 }
diff --git a/examples/notebooks/beam-ml/bigtable_enrichment_transform.ipynb b/examples/notebooks/beam-ml/bigtable_enrichment_transform.ipynb
index 95be8b1d957c..f2e63d2e4f06 100644
--- a/examples/notebooks/beam-ml/bigtable_enrichment_transform.ipynb
+++ b/examples/notebooks/beam-ml/bigtable_enrichment_transform.ipynb
@@ -151,9 +151,9 @@
       },
       "outputs": [],
       "source": [
-        "PROJECT_ID = \"<PROJECT_ID>\"\n",
-        "INSTANCE_ID = \"<INSTANCE_ID>\"\n",
-        "TABLE_ID = \"<TABLE_ID>\""
+        "PROJECT_ID = \"<PROJECT_ID>\" # @param {type:'string'}\n",
+        "INSTANCE_ID = \"<INSTANCE_ID>\" # @param {type:'string'}\n",
+        "TABLE_ID = \"<TABLE_ID>\" # @param {type:'string'}"
       ]
     },
     {
@@ -457,10 +457,10 @@
       "outputs": [],
       "source": [
         "# Replace <TOPIC_NAME> with the name of your Pub/Sub topic.\n",
-        "TOPIC = \"<TOPIC_NAME>\"\n",
+        "TOPIC = \"<TOPIC_NAME>\" # @param {type:'string'}\n",
         "\n",
         "# Replace <SUBSCRIPTION_PATH> with the subscription for your topic.\n",
-        "SUBSCRIPTION = \"<SUBSCRIPTION_PATH>\"\n"
+        "SUBSCRIPTION = \"<SUBSCRIPTION_PATH>\" # @param {type:'string'}\n"
       ]
     },
     {
@@ -532,16 +532,16 @@
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "UEpjy_IsW4P4"
+      },
       "source": [
         "The `row_key` parameter represents the field in input schema (`beam.Row`) that contains the row key for a row in the table.\n",
         "\n",
         "Starting with Apache Beam version 2.54.0, you can perform either of the following tasks when a table uses composite row keys:\n",
         "* Modify the input schema to contain the row key in the format required by Bigtable.\n",
         "* Use a custom enrichment handler. For more information, see the [example handler with composite row key support](https://www.toptal.com/developers/paste-gd/BYFGUL08#)."
-      ],
-      "metadata": {
-        "id": "UEpjy_IsW4P4"
-      }
+      ]
     },
     {
       "cell_type": "code",
@@ -636,6 +636,9 @@
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "fe3bIclV1jZ5"
+      },
       "source": [
         "To provide a `lambda` function for using a custom join with the enrichment transform, see the following example.\n",
         "\n",
@@ -648,13 +651,13 @@
         "            ...\n",
         "            )\n",
         "```"
-      ],
-      "metadata": {
-        "id": "fe3bIclV1jZ5"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "uilxdknE3ihO"
+      },
       "source": [
         "Because the enrichment transform makes API calls to the remote service, use the `timeout` parameter to specify a timeout duration of 10 seconds:\n",
         "\n",
@@ -667,10 +670,7 @@
         "            ...\n",
         "            )\n",
         "```"
-      ],
-      "metadata": {
-        "id": "uilxdknE3ihO"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
@@ -855,11 +855,11 @@
   ],
   "metadata": {
     "colab": {
-      "provenance": [],
-      "toc_visible": true,
       "collapsed_sections": [
         "RpqZFfFfA_Dt"
-      ]
+      ],
+      "provenance": [],
+      "toc_visible": true
     },
     "kernelspec": {
       "display_name": "Python 3",
diff --git a/examples/notebooks/beam-ml/data_preprocessing/vertex_ai_text_embeddings.ipynb b/examples/notebooks/beam-ml/data_preprocessing/vertex_ai_text_embeddings.ipynb
index 49e2f35b13be..4d816ef97fb0 100644
--- a/examples/notebooks/beam-ml/data_preprocessing/vertex_ai_text_embeddings.ipynb
+++ b/examples/notebooks/beam-ml/data_preprocessing/vertex_ai_text_embeddings.ipynb
@@ -1,18 +1,4 @@
 {
-  "nbformat": 4,
-  "nbformat_minor": 0,
-  "metadata": {
-    "colab": {
-      "provenance": []
-    },
-    "kernelspec": {
-      "name": "python3",
-      "display_name": "Python 3"
-    },
-    "language_info": {
-      "name": "python"
-    }
-  },
   "cells": [
     {
       "cell_type": "code",
@@ -44,6 +30,9 @@
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "ZUSiAR62SgO8"
+      },
       "source": [
         "# Generate text embeddings by using the Vertex AI API\n",
         "\n",
@@ -55,13 +44,13 @@
         "    <a target=\"_blank\" href=\"https://github.com/apache/beam/blob/master/examples/notebooks/beam-ml/data_preprocessing/vertex_ai_text_embeddings.ipynb\"><img src=\"https://raw.githubusercontent.com/google/or-tools/main/tools/github_32px.png\" />View source on GitHub</a>\n",
         "  </td>\n",
         "</table>\n"
-      ],
-      "metadata": {
-        "id": "ZUSiAR62SgO8"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "bkpSCGCWlqAf"
+      },
       "source": [
         "Text embeddings are a way to represent text as numerical vectors. This process lets computers understand and process text data, which is essential for many natural language processing (NLP) tasks.\n",
         "\n",
@@ -84,71 +73,72 @@
         "* Do one of the following tasks:\n",
         "  * Configure credentials for your Google Cloud project. For more information, see [Google Auth Library for Python](https://googleapis.dev/python/google-auth/latest/reference/google.auth.html#module-google.auth).\n",
         "  * Store the path to a service account JSON file by using the [GOOGLE_APPLICATION_CREDENTIALS](https://cloud.google.com/docs/authentication/application-default-credentials#GAC) environment variable."
-      ],
-      "metadata": {
-        "id": "bkpSCGCWlqAf"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "To use your Google Cloud account, authenticate this notebook."
-      ],
       "metadata": {
         "id": "W29FgO5Qv2ew"
-      }
+      },
+      "source": [
+        "To use your Google Cloud account, authenticate this notebook."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "nYyyGYt3licq"
+      },
+      "outputs": [],
       "source": [
         "from google.colab import auth\n",
         "auth.authenticate_user()\n",
         "\n",
-        "project = '<PROJECT_ID>' # Replace <PROJECT_ID> with a valid Google Cloud project ID."
-      ],
-      "metadata": {
-        "id": "nYyyGYt3licq"
-      },
-      "execution_count": null,
-      "outputs": []
+        "# Replace <PROJECT_ID> with a valid Google Cloud project ID.\n",
+        "project = '<PROJECT_ID>' # @param {type:'string'}"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "UQROd16ZDN5y"
+      },
       "source": [
         "## Install dependencies\n",
         " Install Apache Beam and the dependencies required for the Vertex AI text-embeddings API."
-      ],
-      "metadata": {
-        "id": "UQROd16ZDN5y"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "! pip install apache_beam[gcp]>=2.53.0 --quiet"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "BTxob7d5DLBM"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "! pip install apache_beam[gcp]>=2.53.0 --quiet"
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "SkMhR7H6n1P0"
+      },
+      "outputs": [],
       "source": [
         "import tempfile\n",
         "import apache_beam as beam\n",
         "from apache_beam.ml.transforms.base import MLTransform\n",
         "from apache_beam.ml.transforms.embeddings.vertex_ai import VertexAITextEmbeddings"
-      ],
-      "metadata": {
-        "id": "SkMhR7H6n1P0"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "cokOaX2kzyke"
+      },
       "source": [
         "## Transform the data\n",
         "\n",
@@ -156,25 +146,27 @@
         "\n",
         "### Use MLTransform in write mode\n",
         "\n",
-         "In `write` mode, `MLTransform` saves the transforms and their attributes to an artifact location. Then, when you run `MLTransform` in `read` mode, these transforms are used. This process ensures that you're applying the same preprocessing steps when you train your model and when you serve the model in production or test its accuracy."
-      ],
-      "metadata": {
-        "id": "cokOaX2kzyke"
-      }
+        "In `write` mode, `MLTransform` saves the transforms and their attributes to an artifact location. Then, when you run `MLTransform` in `read` mode, these transforms are used. This process ensures that you're applying the same preprocessing steps when you train your model and when you serve the model in production or test its accuracy."
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "-x7fVvuy-aDs"
+      },
       "source": [
         "### Get the data\n",
         "\n",
         "`MLTransform` processes dictionaries that include column names and their associated text data. To generate embeddings for specific columns, specify these column names in the `columns` argument of `VertexAITextEmbeddings`. This transform uses the the Vertex AI text-embeddings API for online predictions to generate an embeddings vector for each sentence."
-      ],
-      "metadata": {
-        "id": "-x7fVvuy-aDs"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "be-vR159pylF"
+      },
+      "outputs": [],
       "source": [
         "artifact_location = tempfile.mkdtemp(prefix='vertex_ai')\n",
         "\n",
@@ -201,32 +193,11 @@
         "  for key in d.keys():\n",
         "    d[key] = d[key][:10]\n",
         "  return d"
-      ],
-      "metadata": {
-        "id": "be-vR159pylF"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "embedding_transform = VertexAITextEmbeddings(\n",
-        "        model_name=text_embedding_model_name, columns=['x'], project=project)\n",
-        "\n",
-        "with beam.Pipeline() as pipeline:\n",
-        "  data_pcoll = (\n",
-        "      pipeline\n",
-        "      | \"CreateData\" >> beam.Create(content))\n",
-        "  transformed_pcoll = (\n",
-        "      data_pcoll\n",
-        "      | \"MLTransform\" >> MLTransform(write_artifact_location=artifact_location).with_transform(embedding_transform))\n",
-        "\n",
-        "  # Show only the first ten elements of the embeddings to prevent clutter in the output.\n",
-        "  transformed_pcoll | beam.Map(truncate_embeddings) | 'LogOutput' >> beam.Map(print)\n",
-        "\n",
-        "  transformed_pcoll | \"PrintEmbeddingShape\" >> beam.Map(lambda x: print(f\"Embedding shape: {len(x['x'])}\"))"
-      ],
+      "execution_count": null,
       "metadata": {
         "colab": {
           "base_uri": "https://localhost:8080/"
@@ -234,11 +205,10 @@
         "id": "UQGm1be3p7lM",
         "outputId": "b41172ca-1c73-4952-ca87-bfe45ca88a6c"
       },
-      "execution_count": null,
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "{'x': [0.041293490678071976, -0.010302993468940258, -0.048611514270305634, -0.01360565796494484, 0.06441926211118698, 0.022573700174689293, 0.016446372494101524, -0.033894773572683334, 0.004581860266625881, 0.060710687190294266]}\n",
             "Embedding shape: 10\n",
@@ -248,23 +218,58 @@
             "Embedding shape: 10\n"
           ]
         }
+      ],
+      "source": [
+        "embedding_transform = VertexAITextEmbeddings(\n",
+        "        model_name=text_embedding_model_name, columns=['x'], project=project)\n",
+        "\n",
+        "with beam.Pipeline() as pipeline:\n",
+        "  data_pcoll = (\n",
+        "      pipeline\n",
+        "      | \"CreateData\" >> beam.Create(content))\n",
+        "  transformed_pcoll = (\n",
+        "      data_pcoll\n",
+        "      | \"MLTransform\" >> MLTransform(write_artifact_location=artifact_location).with_transform(embedding_transform))\n",
+        "\n",
+        "  # Show only the first ten elements of the embeddings to prevent clutter in the output.\n",
+        "  transformed_pcoll | beam.Map(truncate_embeddings) | 'LogOutput' >> beam.Map(print)\n",
+        "\n",
+        "  transformed_pcoll | \"PrintEmbeddingShape\" >> beam.Map(lambda x: print(f\"Embedding shape: {len(x['x'])}\"))"
       ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "JLkmQkiLx_6h"
+      },
       "source": [
         "### Use MLTransform in read mode\n",
         "\n",
         "In `read` mode, `MLTransform` uses the artifacts saved during `write` mode. In this example, the transform and its attributes are loaded from the saved artifacts. You don't need to specify artifacts again during `read` mode.\n",
         "\n",
         "In this way, `MLTransform` provides consistent preprocessing steps for training and inference workloads."
-      ],
-      "metadata": {
-        "id": "JLkmQkiLx_6h"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/"
+        },
+        "id": "r8Y5vgfLx_Xu",
+        "outputId": "e7cbf6b7-5c31-4efa-90cf-7a8a108ecc77"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "{'x': [0.04782044142484665, -0.010078949853777885, -0.05793016776442528, -0.026060665026307106, 0.05756739526987076, 0.02292264811694622, 0.014818413183093071, -0.03718176111578941, -0.005486017093062401, 0.04709304869174957]}\n",
+            "{'x': [0.042911216616630554, -0.007554919924587011, -0.08996245265007019, -0.02607591263949871, 0.0008614308317191899, -0.023671219125390053, 0.03999944031238556, -0.02983051724731922, -0.015057179145514965, 0.022963201627135277]}\n"
+          ]
+        }
+      ],
       "source": [
         "test_content = [\n",
         "    {\n",
@@ -284,25 +289,21 @@
         "      | \"MLTransform\" >> MLTransform(read_artifact_location=artifact_location))\n",
         "\n",
         "  transformed_pcoll | beam.Map(truncate_embeddings) | 'LogOutput' >> beam.Map(print)\n"
-      ],
-      "metadata": {
-        "id": "r8Y5vgfLx_Xu",
-        "colab": {
-          "base_uri": "https://localhost:8080/"
-        },
-        "outputId": "e7cbf6b7-5c31-4efa-90cf-7a8a108ecc77"
-      },
-      "execution_count": null,
-      "outputs": [
-        {
-          "output_type": "stream",
-          "name": "stdout",
-          "text": [
-            "{'x': [0.04782044142484665, -0.010078949853777885, -0.05793016776442528, -0.026060665026307106, 0.05756739526987076, 0.02292264811694622, 0.014818413183093071, -0.03718176111578941, -0.005486017093062401, 0.04709304869174957]}\n",
-            "{'x': [0.042911216616630554, -0.007554919924587011, -0.08996245265007019, -0.02607591263949871, 0.0008614308317191899, -0.023671219125390053, 0.03999944031238556, -0.02983051724731922, -0.015057179145514965, 0.022963201627135277]}\n"
-          ]
-        }
       ]
     }
-  ]
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
 }
diff --git a/examples/notebooks/beam-ml/dataframe_api_preprocessing.ipynb b/examples/notebooks/beam-ml/dataframe_api_preprocessing.ipynb
index a488caf7d3ac..3af7455222a9 100644
--- a/examples/notebooks/beam-ml/dataframe_api_preprocessing.ipynb
+++ b/examples/notebooks/beam-ml/dataframe_api_preprocessing.ipynb
@@ -2,6 +2,12 @@
   "cells": [
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "cellView": "form",
+        "id": "sARMhsXz8yR1"
+      },
+      "outputs": [],
       "source": [
         "# @title ###### Licensed to the Apache Software Foundation (ASF), Version 2.0 (the \"License\")\n",
         "\n",
@@ -21,16 +27,13 @@
         "# KIND, either express or implied. See the License for the\n",
         "# specific language governing permissions and limitations\n",
         "# under the License"
-      ],
-      "metadata": {
-        "cellView": "form",
-        "id": "sARMhsXz8yR1"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "A8xNRyZMW1yK"
+      },
       "source": [
         "# Preprocessing with the Apache Beam DataFrames API\n",
         "\n",
@@ -44,13 +47,13 @@
         "    <a target=\"_blank\" href=\"https://github.com/apache/beam/blob/master/examples/notebooks/beam-ml/dataframe_api_preprocessing.ipynb\"><img src=\"https://raw.githubusercontent.com/google/or-tools/main/tools/github_32px.png\" />View source on GitHub</a>\n",
         "  </td>\n",
         "</table>\n"
-      ],
-      "metadata": {
-        "id": "A8xNRyZMW1yK"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "iFZC1inKuUCy"
+      },
       "source": [
         "For rapid execution, Pandas loads all of the data into memory on a single machine (one node). This configuration works well when dealing with small-scale datasets. However, many projects involve datasets that are too big to fit in memory. These use cases generally require parallel data processing frameworks, such as Apache Beam.\n",
         "\n",
@@ -71,21 +74,18 @@
         "\n",
         "In this example, the first section demonstrates how to build and execute a pipeline locally using the interactive runner.\n",
         "The second section uses a distributed runner to demonstrate how to run the pipeline on the full dataset.\n"
-      ],
-      "metadata": {
-        "id": "iFZC1inKuUCy"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "A0f2HJ22D4lt"
+      },
       "source": [
         "## Install Apache Beam\n",
         "\n",
         "To explore the elements within a `PCollection`, install Apache Beam with the `interactive` component to use the Interactive runner. The DataFrames API methods invoked in this example are available in Apache Beam SDK versions 2.43 and later.\n"
-      ],
-      "metadata": {
-        "id": "A0f2HJ22D4lt"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
@@ -100,8 +100,8 @@
       "cell_type": "code",
       "execution_count": null,
       "metadata": {
-        "id": "-OJC0Xn5Um-C",
-        "beam:comment": "TODO(https://github.com/apache/issues/23961): Just install 2.43.0 once it's released, [`issue 23276`](https://github.com/apache/beam/issues/23276)  is currently not implemented for Beam 2.42 (required fix for implementing `str.get_dummies()`"
+        "beam:comment": "TODO(https://github.com/apache/issues/23961): Just install 2.43.0 once it's released, [`issue 23276`](https://github.com/apache/beam/issues/23276)  is currently not implemented for Beam 2.42 (required fix for implementing `str.get_dummies()`",
+        "id": "-OJC0Xn5Um-C"
       },
       "outputs": [],
       "source": [
@@ -114,6 +114,9 @@
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "3NO6RgB7GkkE"
+      },
       "source": [
         "## Local exploration with the Interactive Beam runner\n",
         "Use the [Interactive Beam](https://beam.apache.org/releases/pydoc/2.20.0/apache_beam.runners.interactive.interactive_beam.html) runner to explore and develop your pipeline.\n",
@@ -121,10 +124,7 @@
         "\n",
         "\n",
         "This section uses a subset of the original dataset, because the notebook instance has limited compute resources.\n"
-      ],
-      "metadata": {
-        "id": "3NO6RgB7GkkE"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
@@ -186,13 +186,13 @@
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "cvAu5T0ENjuQ"
+      },
       "source": [
         "\n",
         "Inspect the dataset columns and their types."
-      ],
-      "metadata": {
-        "id": "cvAu5T0ENjuQ"
-      }
+      ]
     },
     {
       "cell_type": "code",
@@ -206,7 +206,6 @@
       },
       "outputs": [
         {
-          "output_type": "execute_result",
           "data": {
             "text/plain": [
               "spk_id                       int64\n",
@@ -225,8 +224,9 @@
               "dtype: object"
             ]
           },
+          "execution_count": 27,
           "metadata": {},
-          "execution_count": 27
+          "output_type": "execute_result"
         }
       ],
       "source": [
@@ -235,12 +235,12 @@
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "When using Interactive Beam, to bring a Beam DataFrame into local memory as a Pandas DataFrame, use `ib.collect()`."
-      ],
       "metadata": {
         "id": "1Wa6fpbyQige"
-      }
+      },
+      "source": [
+        "When using Interactive Beam, to bring a Beam DataFrame into local memory as a Pandas DataFrame, use `ib.collect()`."
+      ]
     },
     {
       "cell_type": "code",
@@ -255,11 +255,7 @@
       },
       "outputs": [
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -268,101 +264,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_79206f341d7de09f6cacdd05be309575\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_79206f341d7de09f6cacdd05be309575\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_79206f341d7de09f6cacdd05be309575\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_79206f341d7de09f6cacdd05be309575\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "execute_result",
           "data": {
-            "text/plain": [
-              "       spk_id                   full_name near_earth_object  \\\n",
-              "0     2000001                     1 Ceres                 N   \n",
-              "1     2000002                    2 Pallas                 N   \n",
-              "2     2000003                      3 Juno                 N   \n",
-              "3     2000004                     4 Vesta                 N   \n",
-              "4     2000005                   5 Astraea                 N   \n",
-              "...       ...                         ...               ...   \n",
-              "9994  2009995    9995 Alouette (4805 P-L)                 N   \n",
-              "9995  2009996         9996 ANS (9070 P-L)                 N   \n",
-              "9996  2009997        9997 COBE (1217 T-1)                 N   \n",
-              "9997  2009998         9998 ISO (1293 T-1)                 N   \n",
-              "9998  2009999       9999 Wiles (4196 T-2)                 N   \n",
-              "\n",
-              "      absolute_magnitude  diameter  albedo  diameter_sigma  eccentricity  \\\n",
-              "0                   3.40   939.400  0.0900           0.200      0.076009   \n",
-              "1                   4.20   545.000  0.1010          18.000      0.229972   \n",
-              "2                   5.33   246.596  0.2140          10.594      0.256936   \n",
-              "3                   3.00   525.400  0.4228           0.200      0.088721   \n",
-              "4                   6.90   106.699  0.2740           3.140      0.190913   \n",
-              "...                  ...       ...     ...             ...           ...   \n",
-              "9994               15.10     2.564  0.2450           0.550      0.160610   \n",
-              "9995               13.60     8.978  0.1130           0.376      0.235174   \n",
-              "9996               14.30       NaN     NaN             NaN      0.113059   \n",
-              "9997               15.10     2.235  0.3880           0.373      0.093852   \n",
-              "9998               13.00     7.148  0.2620           0.065      0.071351   \n",
-              "\n",
-              "      inclination     moid_ld object_class  semi_major_axis_au_unit  \\\n",
-              "0       10.594067  620.640533          MBA                 2.769165   \n",
-              "1       34.832932  480.348639          MBA                 2.773841   \n",
-              "2       12.991043  402.514639          MBA                 2.668285   \n",
-              "3        7.141771  443.451432          MBA                 2.361418   \n",
-              "4        5.367427  426.433027          MBA                 2.574037   \n",
-              "...           ...         ...          ...                      ...   \n",
-              "9994     2.311731  388.723233          MBA                 2.390249   \n",
-              "9995     7.657713  444.194746          MBA                 2.796605   \n",
-              "9996     2.459643  495.460110          MBA                 2.545674   \n",
-              "9997     3.912263  373.848377          MBA                 2.160961   \n",
-              "9998     3.198839  632.144398          MBA                 2.839917   \n",
-              "\n",
-              "     hazardous_flag  \n",
-              "0                 N  \n",
-              "1                 N  \n",
-              "2                 N  \n",
-              "3                 N  \n",
-              "4                 N  \n",
-              "...             ...  \n",
-              "9994              N  \n",
-              "9995              N  \n",
-              "9996              N  \n",
-              "9997              N  \n",
-              "9998              N  \n",
-              "\n",
-              "[9999 rows x 13 columns]"
-            ],
             "text/html": [
               "\n",
               "  <div id=\"df-064477d9-d4b6-44a6-a8fd-31f0cad2dcb5\">\n",
@@ -657,10 +575,66 @@
               "    </div>\n",
               "  </div>\n",
               "  "
+            ],
+            "text/plain": [
+              "       spk_id                   full_name near_earth_object  \\\n",
+              "0     2000001                     1 Ceres                 N   \n",
+              "1     2000002                    2 Pallas                 N   \n",
+              "2     2000003                      3 Juno                 N   \n",
+              "3     2000004                     4 Vesta                 N   \n",
+              "4     2000005                   5 Astraea                 N   \n",
+              "...       ...                         ...               ...   \n",
+              "9994  2009995    9995 Alouette (4805 P-L)                 N   \n",
+              "9995  2009996         9996 ANS (9070 P-L)                 N   \n",
+              "9996  2009997        9997 COBE (1217 T-1)                 N   \n",
+              "9997  2009998         9998 ISO (1293 T-1)                 N   \n",
+              "9998  2009999       9999 Wiles (4196 T-2)                 N   \n",
+              "\n",
+              "      absolute_magnitude  diameter  albedo  diameter_sigma  eccentricity  \\\n",
+              "0                   3.40   939.400  0.0900           0.200      0.076009   \n",
+              "1                   4.20   545.000  0.1010          18.000      0.229972   \n",
+              "2                   5.33   246.596  0.2140          10.594      0.256936   \n",
+              "3                   3.00   525.400  0.4228           0.200      0.088721   \n",
+              "4                   6.90   106.699  0.2740           3.140      0.190913   \n",
+              "...                  ...       ...     ...             ...           ...   \n",
+              "9994               15.10     2.564  0.2450           0.550      0.160610   \n",
+              "9995               13.60     8.978  0.1130           0.376      0.235174   \n",
+              "9996               14.30       NaN     NaN             NaN      0.113059   \n",
+              "9997               15.10     2.235  0.3880           0.373      0.093852   \n",
+              "9998               13.00     7.148  0.2620           0.065      0.071351   \n",
+              "\n",
+              "      inclination     moid_ld object_class  semi_major_axis_au_unit  \\\n",
+              "0       10.594067  620.640533          MBA                 2.769165   \n",
+              "1       34.832932  480.348639          MBA                 2.773841   \n",
+              "2       12.991043  402.514639          MBA                 2.668285   \n",
+              "3        7.141771  443.451432          MBA                 2.361418   \n",
+              "4        5.367427  426.433027          MBA                 2.574037   \n",
+              "...           ...         ...          ...                      ...   \n",
+              "9994     2.311731  388.723233          MBA                 2.390249   \n",
+              "9995     7.657713  444.194746          MBA                 2.796605   \n",
+              "9996     2.459643  495.460110          MBA                 2.545674   \n",
+              "9997     3.912263  373.848377          MBA                 2.160961   \n",
+              "9998     3.198839  632.144398          MBA                 2.839917   \n",
+              "\n",
+              "     hazardous_flag  \n",
+              "0                 N  \n",
+              "1                 N  \n",
+              "2                 N  \n",
+              "3                 N  \n",
+              "4                 N  \n",
+              "...             ...  \n",
+              "9994              N  \n",
+              "9995              N  \n",
+              "9996              N  \n",
+              "9997              N  \n",
+              "9998              N  \n",
+              "\n",
+              "[9999 rows x 13 columns]"
             ]
           },
+          "execution_count": 28,
           "metadata": {},
-          "execution_count": 28
+          "output_type": "execute_result"
         }
       ],
       "source": [
@@ -669,34 +643,29 @@
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "8jV9odKhNyF2"
+      },
       "source": [
         "The datasets contain the following two types of columns:\n",
         "\n",
         "* **Numerical columns:** Use [normalization](https://developers.google.com/machine-learning/data-prep/transform/normalization) to transform these columns so that they can be used to train a machine learning model.\n",
         "\n",
         "* **Categorical columns:** Transform those columns with [one-hot encoding](https://developers.google.com/machine-learning/data-prep/transform/transform-categorical) to use them during training. \n"
-      ],
-      "metadata": {
-        "id": "8jV9odKhNyF2"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Use the standard pandas command `DataFrame.describe()` to generate descriptive statistics for the numerical columns, such as percentile, mean, std, and so on. "
-      ],
       "metadata": {
         "id": "MGAErO0lAYws"
-      }
+      },
+      "source": [
+        "Use the standard pandas command `DataFrame.describe()` to generate descriptive statistics for the numerical columns, such as percentile, mean, std, and so on. "
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "with dataframe.allow_non_parallel_operations():\n",
-        "  beam_df_description = ib.collect(beam_df.describe())\n",
-        "\n",
-        "beam_df_description"
-      ],
+      "execution_count": null,
       "metadata": {
         "colab": {
           "base_uri": "https://localhost:8080/",
@@ -705,14 +674,9 @@
         "id": "Befv697VBGM7",
         "outputId": "bb465020-94e4-4b3c-fda6-6e43da199be1"
       },
-      "execution_count": null,
       "outputs": [
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -721,77 +685,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_98687cb0060a8077a8abab6e464e4a75\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_98687cb0060a8077a8abab6e464e4a75\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_98687cb0060a8077a8abab6e464e4a75\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_98687cb0060a8077a8abab6e464e4a75\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "execute_result",
           "data": {
-            "text/plain": [
-              "             spk_id  absolute_magnitude     diameter       albedo  \\\n",
-              "count  9.999000e+03         9999.000000  8688.000000  8672.000000   \n",
-              "mean   2.005000e+06           12.675380    19.245446     0.197723   \n",
-              "std    2.886607e+03            1.639609    30.190191     0.138819   \n",
-              "min    2.000001e+06            3.000000     0.300000     0.008000   \n",
-              "25%    2.002500e+06           11.900000     5.614000     0.074000   \n",
-              "50%    2.005000e+06           12.900000     9.814000     0.187000   \n",
-              "75%    2.007500e+06           13.700000    19.156750     0.283000   \n",
-              "max    2.009999e+06           20.700000   939.400000     1.000000   \n",
-              "\n",
-              "       diameter_sigma  eccentricity  inclination      moid_ld  \\\n",
-              "count     8591.000000   9999.000000  9999.000000  9999.000000   \n",
-              "mean         0.454072      0.148716     7.890742   509.805237   \n",
-              "std          1.093676      0.083803     6.336244   205.046582   \n",
-              "min          0.006000      0.001003     0.042716     0.131028   \n",
-              "25%          0.120000      0.093780     3.220137   377.829197   \n",
-              "50%          0.201000      0.140335     6.018836   470.650523   \n",
-              "75%          0.375000      0.187092    10.918176   636.010802   \n",
-              "max         39.297000      0.889831    68.018875  4241.524913   \n",
-              "\n",
-              "       semi_major_axis_au_unit  \n",
-              "count              9999.000000  \n",
-              "mean                  2.689836  \n",
-              "std                   0.607190  \n",
-              "min                   0.832048  \n",
-              "25%                   2.340816  \n",
-              "50%                   2.614468  \n",
-              "75%                   3.005449  \n",
-              "max                  24.667968  "
-            ],
             "text/html": [
               "\n",
               "  <div id=\"df-238f6456-dbfb-4707-a725-c607c847f522\">\n",
@@ -1001,27 +911,65 @@
               "    </div>\n",
               "  </div>\n",
               "  "
-            ]
-          },
-          "metadata": {},
-          "execution_count": 21
-        }
-      ]
-    },
-    {
-      "cell_type": "markdown",
-      "metadata": {
-        "id": "D9uJtHLSSAMC"
-      },
-      "source": [
-        "Before running any transformations, verify that all of the columns need to be used for model training. Start by looking at the column description provided by the [JPL website](https://ssd.jpl.nasa.gov/sbdb_query.cgi):\n",
-        "\n",
-        "* **spk_id:** Object primary SPK-ID.\n",
-        "* **full_name:** Asteroid name.\n",
-        "* **near_earth_object:** Near-earth object flag.\n",
-        "* **absolute_magnitude:** The apparent magnitude an object would have if it were located at a distance of 10 parsecs.\n",
-        "* **diameter:** Object diameter (from equivalent sphere) km unit.\n",
-        "* **albedo:** A measure of the diffuse reflection of solar radiation out of the total solar radiation, measured on a scale from 0 to 1.\n",
+            ],
+            "text/plain": [
+              "             spk_id  absolute_magnitude     diameter       albedo  \\\n",
+              "count  9.999000e+03         9999.000000  8688.000000  8672.000000   \n",
+              "mean   2.005000e+06           12.675380    19.245446     0.197723   \n",
+              "std    2.886607e+03            1.639609    30.190191     0.138819   \n",
+              "min    2.000001e+06            3.000000     0.300000     0.008000   \n",
+              "25%    2.002500e+06           11.900000     5.614000     0.074000   \n",
+              "50%    2.005000e+06           12.900000     9.814000     0.187000   \n",
+              "75%    2.007500e+06           13.700000    19.156750     0.283000   \n",
+              "max    2.009999e+06           20.700000   939.400000     1.000000   \n",
+              "\n",
+              "       diameter_sigma  eccentricity  inclination      moid_ld  \\\n",
+              "count     8591.000000   9999.000000  9999.000000  9999.000000   \n",
+              "mean         0.454072      0.148716     7.890742   509.805237   \n",
+              "std          1.093676      0.083803     6.336244   205.046582   \n",
+              "min          0.006000      0.001003     0.042716     0.131028   \n",
+              "25%          0.120000      0.093780     3.220137   377.829197   \n",
+              "50%          0.201000      0.140335     6.018836   470.650523   \n",
+              "75%          0.375000      0.187092    10.918176   636.010802   \n",
+              "max         39.297000      0.889831    68.018875  4241.524913   \n",
+              "\n",
+              "       semi_major_axis_au_unit  \n",
+              "count              9999.000000  \n",
+              "mean                  2.689836  \n",
+              "std                   0.607190  \n",
+              "min                   0.832048  \n",
+              "25%                   2.340816  \n",
+              "50%                   2.614468  \n",
+              "75%                   3.005449  \n",
+              "max                  24.667968  "
+            ]
+          },
+          "execution_count": 21,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
+      "source": [
+        "with dataframe.allow_non_parallel_operations():\n",
+        "  beam_df_description = ib.collect(beam_df.describe())\n",
+        "\n",
+        "beam_df_description"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "D9uJtHLSSAMC"
+      },
+      "source": [
+        "Before running any transformations, verify that all of the columns need to be used for model training. Start by looking at the column description provided by the [JPL website](https://ssd.jpl.nasa.gov/sbdb_query.cgi):\n",
+        "\n",
+        "* **spk_id:** Object primary SPK-ID.\n",
+        "* **full_name:** Asteroid name.\n",
+        "* **near_earth_object:** Near-earth object flag.\n",
+        "* **absolute_magnitude:** The apparent magnitude an object would have if it were located at a distance of 10 parsecs.\n",
+        "* **diameter:** Object diameter (from equivalent sphere) km unit.\n",
+        "* **albedo:** A measure of the diffuse reflection of solar radiation out of the total solar radiation, measured on a scale from 0 to 1.\n",
         "* **diameter_sigma:** 1-sigma uncertainty in object diameter km unit.\n",
         "* **eccentricity:** A value between 0 and 1 that refers to how flat or round the asteroid is.\n",
         "* **inclination:** The angle with respect to the x-y ecliptic plane.\n",
@@ -1073,19 +1021,15 @@
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stderr",
+          "output_type": "stream",
           "text": [
             "/content/beam/sdks/python/apache_beam/dataframe/frame_base.py:145: RuntimeWarning: invalid value encountered in long_scalars\n",
             "  lambda left, right: getattr(left, op)(right), name=op, args=[other])\n"
           ]
         },
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -1094,45 +1038,22 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_868f8ad001ab00c7013b65472a513917\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_868f8ad001ab00c7013b65472a513917\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_868f8ad001ab00c7013b65472a513917\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_868f8ad001ab00c7013b65472a513917\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "execute_result",
           "data": {
             "text/plain": [
               "near_earth_object           0.000000\n",
@@ -1149,8 +1070,9 @@
               "dtype: float64"
             ]
           },
+          "execution_count": 30,
           "metadata": {},
-          "execution_count": 30
+          "output_type": "execute_result"
         }
       ],
       "source": [
@@ -1170,20 +1092,16 @@
       "cell_type": "code",
       "execution_count": null,
       "metadata": {
-        "id": "tHYeCHREwvyB",
         "colab": {
           "base_uri": "https://localhost:8080/",
           "height": 538
         },
+        "id": "tHYeCHREwvyB",
         "outputId": "3be686d0-f56a-4054-a71a-d3019bf379e8"
       },
       "outputs": [
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -1192,75 +1110,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_f88b77f183371d1a45fa87bed4a545f6\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_f88b77f183371d1a45fa87bed4a545f6\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_f88b77f183371d1a45fa87bed4a545f6\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_f88b77f183371d1a45fa87bed4a545f6\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "execute_result",
           "data": {
-            "text/plain": [
-              "     near_earth_object  absolute_magnitude  eccentricity  inclination  \\\n",
-              "0                    N                3.40      0.076009    10.594067   \n",
-              "1                    N                4.20      0.229972    34.832932   \n",
-              "2                    N                5.33      0.256936    12.991043   \n",
-              "3                    N                3.00      0.088721     7.141771   \n",
-              "4                    N                6.90      0.190913     5.367427   \n",
-              "...                ...                 ...           ...          ...   \n",
-              "9994                 N               15.10      0.160610     2.311731   \n",
-              "9995                 N               13.60      0.235174     7.657713   \n",
-              "9996                 N               14.30      0.113059     2.459643   \n",
-              "9997                 N               15.10      0.093852     3.912263   \n",
-              "9998                 N               13.00      0.071351     3.198839   \n",
-              "\n",
-              "         moid_ld object_class  semi_major_axis_au_unit hazardous_flag  \n",
-              "0     620.640533          MBA                 2.769165              N  \n",
-              "1     480.348639          MBA                 2.773841              N  \n",
-              "2     402.514639          MBA                 2.668285              N  \n",
-              "3     443.451432          MBA                 2.361418              N  \n",
-              "4     426.433027          MBA                 2.574037              N  \n",
-              "...          ...          ...                      ...            ...  \n",
-              "9994  388.723233          MBA                 2.390249              N  \n",
-              "9995  444.194746          MBA                 2.796605              N  \n",
-              "9996  495.460110          MBA                 2.545674              N  \n",
-              "9997  373.848377          MBA                 2.160961              N  \n",
-              "9998  632.144398          MBA                 2.839917              N  \n",
-              "\n",
-              "[9999 rows x 8 columns]"
-            ],
             "text/html": [
               "\n",
               "  <div id=\"df-4e05872f-1261-4bd8-9251-a967afaa1b32\">\n",
@@ -1495,10 +1361,40 @@
               "    </div>\n",
               "  </div>\n",
               "  "
+            ],
+            "text/plain": [
+              "     near_earth_object  absolute_magnitude  eccentricity  inclination  \\\n",
+              "0                    N                3.40      0.076009    10.594067   \n",
+              "1                    N                4.20      0.229972    34.832932   \n",
+              "2                    N                5.33      0.256936    12.991043   \n",
+              "3                    N                3.00      0.088721     7.141771   \n",
+              "4                    N                6.90      0.190913     5.367427   \n",
+              "...                ...                 ...           ...          ...   \n",
+              "9994                 N               15.10      0.160610     2.311731   \n",
+              "9995                 N               13.60      0.235174     7.657713   \n",
+              "9996                 N               14.30      0.113059     2.459643   \n",
+              "9997                 N               15.10      0.093852     3.912263   \n",
+              "9998                 N               13.00      0.071351     3.198839   \n",
+              "\n",
+              "         moid_ld object_class  semi_major_axis_au_unit hazardous_flag  \n",
+              "0     620.640533          MBA                 2.769165              N  \n",
+              "1     480.348639          MBA                 2.773841              N  \n",
+              "2     402.514639          MBA                 2.668285              N  \n",
+              "3     443.451432          MBA                 2.361418              N  \n",
+              "4     426.433027          MBA                 2.574037              N  \n",
+              "...          ...          ...                      ...            ...  \n",
+              "9994  388.723233          MBA                 2.390249              N  \n",
+              "9995  444.194746          MBA                 2.796605              N  \n",
+              "9996  495.460110          MBA                 2.545674              N  \n",
+              "9997  373.848377          MBA                 2.160961              N  \n",
+              "9998  632.144398          MBA                 2.839917              N  \n",
+              "\n",
+              "[9999 rows x 8 columns]"
             ]
           },
+          "execution_count": 31,
           "metadata": {},
-          "execution_count": 31
+          "output_type": "execute_result"
         }
       ],
       "source": [
@@ -1559,19 +1455,15 @@
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stderr",
+          "output_type": "stream",
           "text": [
             "/content/beam/sdks/python/apache_beam/dataframe/frame_base.py:145: RuntimeWarning: invalid value encountered in double_scalars\n",
             "  lambda left, right: getattr(left, op)(right), name=op, args=[other])\n"
           ]
         },
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -1580,75 +1472,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_55302fa5950ce6ceb9f99ff9a168097a\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_55302fa5950ce6ceb9f99ff9a168097a\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_55302fa5950ce6ceb9f99ff9a168097a\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_55302fa5950ce6ceb9f99ff9a168097a\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "execute_result",
           "data": {
-            "text/plain": [
-              "      absolute_magnitude  eccentricity  inclination   moid_ld  \\\n",
-              "306            -1.570727     -0.062543    -0.278518  0.373194   \n",
-              "310            -1.631718     -1.724526    -0.736389  1.087833   \n",
-              "546            -1.753698      1.028793     1.415303 -0.339489   \n",
-              "635            -1.875678      0.244869     0.005905  0.214107   \n",
-              "701            -3.278451     -1.570523     2.006145  1.542754   \n",
-              "...                  ...           ...          ...       ...   \n",
-              "9697            0.807888     -1.151809    -0.082944 -0.129556   \n",
-              "9813            1.722740      0.844551    -0.583247 -1.006447   \n",
-              "9868            0.807888     -0.207399    -0.784665 -0.462136   \n",
-              "9903            0.868878      0.460086     0.092258 -0.107597   \n",
-              "9956            0.746898     -0.234132    -0.161116 -0.601379   \n",
-              "\n",
-              "      semi_major_axis_au_unit  \n",
-              "306                  0.357201  \n",
-              "310                  0.344233  \n",
-              "546                  0.139080  \n",
-              "635                  0.367559  \n",
-              "701                  0.829337  \n",
-              "...                       ...  \n",
-              "9697                -0.533538  \n",
-              "9813                -0.677961  \n",
-              "9868                -0.539794  \n",
-              "9903                 0.071794  \n",
-              "9956                -0.664887  \n",
-              "\n",
-              "[9999 rows x 5 columns]"
-            ],
             "text/html": [
               "\n",
               "  <div id=\"df-f727aadc-8e99-4a1b-b999-93e65a3d6d02\">\n",
@@ -1847,10 +1687,40 @@
               "    </div>\n",
               "  </div>\n",
               "  "
+            ],
+            "text/plain": [
+              "      absolute_magnitude  eccentricity  inclination   moid_ld  \\\n",
+              "306            -1.570727     -0.062543    -0.278518  0.373194   \n",
+              "310            -1.631718     -1.724526    -0.736389  1.087833   \n",
+              "546            -1.753698      1.028793     1.415303 -0.339489   \n",
+              "635            -1.875678      0.244869     0.005905  0.214107   \n",
+              "701            -3.278451     -1.570523     2.006145  1.542754   \n",
+              "...                  ...           ...          ...       ...   \n",
+              "9697            0.807888     -1.151809    -0.082944 -0.129556   \n",
+              "9813            1.722740      0.844551    -0.583247 -1.006447   \n",
+              "9868            0.807888     -0.207399    -0.784665 -0.462136   \n",
+              "9903            0.868878      0.460086     0.092258 -0.107597   \n",
+              "9956            0.746898     -0.234132    -0.161116 -0.601379   \n",
+              "\n",
+              "      semi_major_axis_au_unit  \n",
+              "306                  0.357201  \n",
+              "310                  0.344233  \n",
+              "546                  0.139080  \n",
+              "635                  0.367559  \n",
+              "701                  0.829337  \n",
+              "...                       ...  \n",
+              "9697                -0.533538  \n",
+              "9813                -0.677961  \n",
+              "9868                -0.539794  \n",
+              "9903                 0.071794  \n",
+              "9956                -0.664887  \n",
+              "\n",
+              "[9999 rows x 5 columns]"
             ]
           },
+          "execution_count": 33,
           "metadata": {},
-          "execution_count": 33
+          "output_type": "execute_result"
         }
       ],
       "source": [
@@ -1895,12 +1765,7 @@
     },
     {
       "cell_type": "code",
-      "source": [
-        "for categorical_col in categorical_cols:\n",
-        "  beam_df_categorical = get_one_hot_encoding(df=beam_df, categorical_col=categorical_col)\n",
-        "  beam_df_numericals = beam_df_numericals.merge(beam_df_categorical, left_index = True, right_index = True)\n",
-        "ib.collect(beam_df_numericals)"
-      ],
+      "execution_count": null,
       "metadata": {
         "colab": {
           "base_uri": "https://localhost:8080/",
@@ -1909,14 +1774,9 @@
         "id": "k9rvtWqHf6Qw",
         "outputId": "b8d8ae57-6dba-45b4-e7ae-e4b14084eede"
       },
-      "execution_count": null,
       "outputs": [
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -1925,49 +1785,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_6b2563c7f661bc0fc5729c2577d6f232\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_6b2563c7f661bc0fc5729c2577d6f232\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_6b2563c7f661bc0fc5729c2577d6f232\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_6b2563c7f661bc0fc5729c2577d6f232\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -1976,49 +1810,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_6fa896083b128ad99059af69a3d7fc7e\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_6fa896083b128ad99059af69a3d7fc7e\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_6fa896083b128ad99059af69a3d7fc7e\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_6fa896083b128ad99059af69a3d7fc7e\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -2027,49 +1835,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_6339347de9805da541eba53abaee2d5e\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_6339347de9805da541eba53abaee2d5e\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_6339347de9805da541eba53abaee2d5e\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_6339347de9805da541eba53abaee2d5e\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -2078,127 +1860,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_1af5b908898a1e5949dcc20549f650eb\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_1af5b908898a1e5949dcc20549f650eb\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_1af5b908898a1e5949dcc20549f650eb\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_1af5b908898a1e5949dcc20549f650eb\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "execute_result",
           "data": {
-            "text/plain": [
-              "      absolute_magnitude  eccentricity  inclination   moid_ld  \\\n",
-              "0              -5.657067     -0.867596     0.426645  0.540537   \n",
-              "12             -3.583402     -0.756931     1.364340  0.238610   \n",
-              "47             -3.400432     -0.912290    -0.211925  1.136060   \n",
-              "381            -2.363599      0.271412    -0.078826  0.535299   \n",
-              "515            -2.729540      1.469775     0.799915 -0.602881   \n",
-              "...                  ...           ...          ...       ...   \n",
-              "9146            0.563927     -0.508757    -0.327512 -0.637391   \n",
-              "9657            1.478779      0.487849    -0.637779 -0.648240   \n",
-              "9704            0.380957     -0.238383     0.443053  0.670490   \n",
-              "9879            1.295809     -0.442966    -0.698505 -0.494818   \n",
-              "9980            0.746898     -1.455992    -0.849144  0.592902   \n",
-              "\n",
-              "      semi_major_axis_au_unit  near_earth_object_N  near_earth_object_Y  \\\n",
-              "0                    0.130649                    1                    0   \n",
-              "12                  -0.187375                    1                    0   \n",
-              "47                   0.691182                    1                    0   \n",
-              "381                  0.712755                    1                    0   \n",
-              "515                 -0.014654                    1                    0   \n",
-              "...                       ...                  ...                  ...   \n",
-              "9146                -0.820638                    1                    0   \n",
-              "9657                -0.468778                    1                    0   \n",
-              "9704                 0.587128                    1                    0   \n",
-              "9879                -0.662602                    1                    0   \n",
-              "9980                -0.022726                    1                    0   \n",
-              "\n",
-              "      near_earth_object_nan  object_class_AMO  object_class_APO  ...  \\\n",
-              "0                         0                 0                 0  ...   \n",
-              "12                        0                 0                 0  ...   \n",
-              "47                        0                 0                 0  ...   \n",
-              "381                       0                 0                 0  ...   \n",
-              "515                       0                 0                 0  ...   \n",
-              "...                     ...               ...               ...  ...   \n",
-              "9146                      0                 0                 0  ...   \n",
-              "9657                      0                 0                 0  ...   \n",
-              "9704                      0                 0                 0  ...   \n",
-              "9879                      0                 0                 0  ...   \n",
-              "9980                      0                 0                 0  ...   \n",
-              "\n",
-              "      object_class_CEN  object_class_IMB  object_class_MBA  object_class_MCA  \\\n",
-              "0                    0                 0                 1                 0   \n",
-              "12                   0                 0                 1                 0   \n",
-              "47                   0                 0                 1                 0   \n",
-              "381                  0                 0                 1                 0   \n",
-              "515                  0                 0                 1                 0   \n",
-              "...                ...               ...               ...               ...   \n",
-              "9146                 0                 0                 1                 0   \n",
-              "9657                 0                 0                 1                 0   \n",
-              "9704                 0                 0                 1                 0   \n",
-              "9879                 0                 0                 1                 0   \n",
-              "9980                 0                 0                 1                 0   \n",
-              "\n",
-              "      object_class_OMB  object_class_TJN  object_class_nan  hazardous_flag_N  \\\n",
-              "0                    0                 0                 0                 1   \n",
-              "12                   0                 0                 0                 1   \n",
-              "47                   0                 0                 0                 1   \n",
-              "381                  0                 0                 0                 1   \n",
-              "515                  0                 0                 0                 1   \n",
-              "...                ...               ...               ...               ...   \n",
-              "9146                 0                 0                 0                 1   \n",
-              "9657                 0                 0                 0                 1   \n",
-              "9704                 0                 0                 0                 1   \n",
-              "9879                 0                 0                 0                 1   \n",
-              "9980                 0                 0                 0                 1   \n",
-              "\n",
-              "      hazardous_flag_Y  hazardous_flag_nan  \n",
-              "0                    0                   0  \n",
-              "12                   0                   0  \n",
-              "47                   0                   0  \n",
-              "381                  0                   0  \n",
-              "515                  0                   0  \n",
-              "...                ...                 ...  \n",
-              "9146                 0                   0  \n",
-              "9657                 0                   0  \n",
-              "9704                 0                   0  \n",
-              "9879                 0                   0  \n",
-              "9980                 0                   0  \n",
-              "\n",
-              "[9999 rows x 22 columns]"
-            ],
             "text/html": [
               "\n",
               "  <div id=\"df-14de458f-3e4b-4c07-92f0-da47fc6c0334\">\n",
@@ -2589,11 +2267,99 @@
               "    </div>\n",
               "  </div>\n",
               "  "
+            ],
+            "text/plain": [
+              "      absolute_magnitude  eccentricity  inclination   moid_ld  \\\n",
+              "0              -5.657067     -0.867596     0.426645  0.540537   \n",
+              "12             -3.583402     -0.756931     1.364340  0.238610   \n",
+              "47             -3.400432     -0.912290    -0.211925  1.136060   \n",
+              "381            -2.363599      0.271412    -0.078826  0.535299   \n",
+              "515            -2.729540      1.469775     0.799915 -0.602881   \n",
+              "...                  ...           ...          ...       ...   \n",
+              "9146            0.563927     -0.508757    -0.327512 -0.637391   \n",
+              "9657            1.478779      0.487849    -0.637779 -0.648240   \n",
+              "9704            0.380957     -0.238383     0.443053  0.670490   \n",
+              "9879            1.295809     -0.442966    -0.698505 -0.494818   \n",
+              "9980            0.746898     -1.455992    -0.849144  0.592902   \n",
+              "\n",
+              "      semi_major_axis_au_unit  near_earth_object_N  near_earth_object_Y  \\\n",
+              "0                    0.130649                    1                    0   \n",
+              "12                  -0.187375                    1                    0   \n",
+              "47                   0.691182                    1                    0   \n",
+              "381                  0.712755                    1                    0   \n",
+              "515                 -0.014654                    1                    0   \n",
+              "...                       ...                  ...                  ...   \n",
+              "9146                -0.820638                    1                    0   \n",
+              "9657                -0.468778                    1                    0   \n",
+              "9704                 0.587128                    1                    0   \n",
+              "9879                -0.662602                    1                    0   \n",
+              "9980                -0.022726                    1                    0   \n",
+              "\n",
+              "      near_earth_object_nan  object_class_AMO  object_class_APO  ...  \\\n",
+              "0                         0                 0                 0  ...   \n",
+              "12                        0                 0                 0  ...   \n",
+              "47                        0                 0                 0  ...   \n",
+              "381                       0                 0                 0  ...   \n",
+              "515                       0                 0                 0  ...   \n",
+              "...                     ...               ...               ...  ...   \n",
+              "9146                      0                 0                 0  ...   \n",
+              "9657                      0                 0                 0  ...   \n",
+              "9704                      0                 0                 0  ...   \n",
+              "9879                      0                 0                 0  ...   \n",
+              "9980                      0                 0                 0  ...   \n",
+              "\n",
+              "      object_class_CEN  object_class_IMB  object_class_MBA  object_class_MCA  \\\n",
+              "0                    0                 0                 1                 0   \n",
+              "12                   0                 0                 1                 0   \n",
+              "47                   0                 0                 1                 0   \n",
+              "381                  0                 0                 1                 0   \n",
+              "515                  0                 0                 1                 0   \n",
+              "...                ...               ...               ...               ...   \n",
+              "9146                 0                 0                 1                 0   \n",
+              "9657                 0                 0                 1                 0   \n",
+              "9704                 0                 0                 1                 0   \n",
+              "9879                 0                 0                 1                 0   \n",
+              "9980                 0                 0                 1                 0   \n",
+              "\n",
+              "      object_class_OMB  object_class_TJN  object_class_nan  hazardous_flag_N  \\\n",
+              "0                    0                 0                 0                 1   \n",
+              "12                   0                 0                 0                 1   \n",
+              "47                   0                 0                 0                 1   \n",
+              "381                  0                 0                 0                 1   \n",
+              "515                  0                 0                 0                 1   \n",
+              "...                ...               ...               ...               ...   \n",
+              "9146                 0                 0                 0                 1   \n",
+              "9657                 0                 0                 0                 1   \n",
+              "9704                 0                 0                 0                 1   \n",
+              "9879                 0                 0                 0                 1   \n",
+              "9980                 0                 0                 0                 1   \n",
+              "\n",
+              "      hazardous_flag_Y  hazardous_flag_nan  \n",
+              "0                    0                   0  \n",
+              "12                   0                   0  \n",
+              "47                   0                   0  \n",
+              "381                  0                   0  \n",
+              "515                  0                   0  \n",
+              "...                ...                 ...  \n",
+              "9146                 0                   0  \n",
+              "9657                 0                   0  \n",
+              "9704                 0                   0  \n",
+              "9879                 0                   0  \n",
+              "9980                 0                   0  \n",
+              "\n",
+              "[9999 rows x 22 columns]"
             ]
           },
+          "execution_count": 35,
           "metadata": {},
-          "execution_count": 35
+          "output_type": "execute_result"
         }
+      ],
+      "source": [
+        "for categorical_col in categorical_cols:\n",
+        "  beam_df_categorical = get_one_hot_encoding(df=beam_df, categorical_col=categorical_col)\n",
+        "  beam_df_numericals = beam_df_numericals.merge(beam_df_categorical, left_index = True, right_index = True)\n",
+        "ib.collect(beam_df_numericals)"
       ]
     },
     {
@@ -2613,28 +2379,24 @@
       "cell_type": "code",
       "execution_count": null,
       "metadata": {
-        "id": "ndaSNond0v8Q",
         "colab": {
           "base_uri": "https://localhost:8080/",
           "height": 651
         },
+        "id": "ndaSNond0v8Q",
         "outputId": "b265e915-e649-44e4-a31a-95ac85c0ebf6"
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stderr",
+          "output_type": "stream",
           "text": [
             "/content/beam/sdks/python/apache_beam/dataframe/frame_base.py:145: RuntimeWarning: invalid value encountered in double_scalars\n",
             "  lambda left, right: getattr(left, op)(right), name=op, args=[other])\n"
           ]
         },
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -2643,49 +2405,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_cb06c945824aa1bb68aa31ad7e601b74\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_cb06c945824aa1bb68aa31ad7e601b74\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_cb06c945824aa1bb68aa31ad7e601b74\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_cb06c945824aa1bb68aa31ad7e601b74\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -2694,49 +2430,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_fb923f80fecb72b4fa55e5cfdba16d23\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_fb923f80fecb72b4fa55e5cfdba16d23\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_fb923f80fecb72b4fa55e5cfdba16d23\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_fb923f80fecb72b4fa55e5cfdba16d23\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -2745,49 +2455,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_3f4b1a0f483cd017e004e11816a91d3b\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_3f4b1a0f483cd017e004e11816a91d3b\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_3f4b1a0f483cd017e004e11816a91d3b\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_3f4b1a0f483cd017e004e11816a91d3b\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -2796,127 +2480,23 @@
               "              <span class=\"text-info\">Processing... collect</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_fce8902eccbfaa17e32ba0c7c242ccec\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_fce8902eccbfaa17e32ba0c7c242ccec\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_fce8902eccbfaa17e32ba0c7c242ccec\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_fce8902eccbfaa17e32ba0c7c242ccec\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "execute_result",
           "data": {
-            "text/plain": [
-              "      absolute_magnitude  eccentricity  inclination   moid_ld  \\\n",
-              "0              -5.657067     -0.867596     0.426645  0.540537   \n",
-              "12             -3.583402     -0.756931     1.364340  0.238610   \n",
-              "47             -3.400432     -0.912290    -0.211925  1.136060   \n",
-              "381            -2.363599      0.271412    -0.078826  0.535299   \n",
-              "515            -2.729540      1.469775     0.799915 -0.602881   \n",
-              "...                  ...           ...          ...       ...   \n",
-              "9146            0.563927     -0.508757    -0.327512 -0.637391   \n",
-              "9657            1.478779      0.487849    -0.637779 -0.648240   \n",
-              "9704            0.380957     -0.238383     0.443053  0.670490   \n",
-              "9879            1.295809     -0.442966    -0.698505 -0.494818   \n",
-              "9980            0.746898     -1.455992    -0.849144  0.592902   \n",
-              "\n",
-              "      semi_major_axis_au_unit  near_earth_object_N  near_earth_object_Y  \\\n",
-              "0                    0.130649                    1                    0   \n",
-              "12                  -0.187375                    1                    0   \n",
-              "47                   0.691182                    1                    0   \n",
-              "381                  0.712755                    1                    0   \n",
-              "515                 -0.014654                    1                    0   \n",
-              "...                       ...                  ...                  ...   \n",
-              "9146                -0.820638                    1                    0   \n",
-              "9657                -0.468778                    1                    0   \n",
-              "9704                 0.587128                    1                    0   \n",
-              "9879                -0.662602                    1                    0   \n",
-              "9980                -0.022726                    1                    0   \n",
-              "\n",
-              "      near_earth_object_nan  object_class_AMO  object_class_APO  ...  \\\n",
-              "0                         0                 0                 0  ...   \n",
-              "12                        0                 0                 0  ...   \n",
-              "47                        0                 0                 0  ...   \n",
-              "381                       0                 0                 0  ...   \n",
-              "515                       0                 0                 0  ...   \n",
-              "...                     ...               ...               ...  ...   \n",
-              "9146                      0                 0                 0  ...   \n",
-              "9657                      0                 0                 0  ...   \n",
-              "9704                      0                 0                 0  ...   \n",
-              "9879                      0                 0                 0  ...   \n",
-              "9980                      0                 0                 0  ...   \n",
-              "\n",
-              "      object_class_CEN  object_class_IMB  object_class_MBA  object_class_MCA  \\\n",
-              "0                    0                 0                 1                 0   \n",
-              "12                   0                 0                 1                 0   \n",
-              "47                   0                 0                 1                 0   \n",
-              "381                  0                 0                 1                 0   \n",
-              "515                  0                 0                 1                 0   \n",
-              "...                ...               ...               ...               ...   \n",
-              "9146                 0                 0                 1                 0   \n",
-              "9657                 0                 0                 1                 0   \n",
-              "9704                 0                 0                 1                 0   \n",
-              "9879                 0                 0                 1                 0   \n",
-              "9980                 0                 0                 1                 0   \n",
-              "\n",
-              "      object_class_OMB  object_class_TJN  object_class_nan  hazardous_flag_N  \\\n",
-              "0                    0                 0                 0                 1   \n",
-              "12                   0                 0                 0                 1   \n",
-              "47                   0                 0                 0                 1   \n",
-              "381                  0                 0                 0                 1   \n",
-              "515                  0                 0                 0                 1   \n",
-              "...                ...               ...               ...               ...   \n",
-              "9146                 0                 0                 0                 1   \n",
-              "9657                 0                 0                 0                 1   \n",
-              "9704                 0                 0                 0                 1   \n",
-              "9879                 0                 0                 0                 1   \n",
-              "9980                 0                 0                 0                 1   \n",
-              "\n",
-              "      hazardous_flag_Y  hazardous_flag_nan  \n",
-              "0                    0                   0  \n",
-              "12                   0                   0  \n",
-              "47                   0                   0  \n",
-              "381                  0                   0  \n",
-              "515                  0                   0  \n",
-              "...                ...                 ...  \n",
-              "9146                 0                   0  \n",
-              "9657                 0                   0  \n",
-              "9704                 0                   0  \n",
-              "9879                 0                   0  \n",
-              "9980                 0                   0  \n",
-              "\n",
-              "[9999 rows x 22 columns]"
-            ],
             "text/html": [
               "\n",
               "  <div id=\"df-43e93125-8ade-4324-bff6-6c06d8f90ea1\">\n",
@@ -3307,10 +2887,92 @@
               "    </div>\n",
               "  </div>\n",
               "  "
+            ],
+            "text/plain": [
+              "      absolute_magnitude  eccentricity  inclination   moid_ld  \\\n",
+              "0              -5.657067     -0.867596     0.426645  0.540537   \n",
+              "12             -3.583402     -0.756931     1.364340  0.238610   \n",
+              "47             -3.400432     -0.912290    -0.211925  1.136060   \n",
+              "381            -2.363599      0.271412    -0.078826  0.535299   \n",
+              "515            -2.729540      1.469775     0.799915 -0.602881   \n",
+              "...                  ...           ...          ...       ...   \n",
+              "9146            0.563927     -0.508757    -0.327512 -0.637391   \n",
+              "9657            1.478779      0.487849    -0.637779 -0.648240   \n",
+              "9704            0.380957     -0.238383     0.443053  0.670490   \n",
+              "9879            1.295809     -0.442966    -0.698505 -0.494818   \n",
+              "9980            0.746898     -1.455992    -0.849144  0.592902   \n",
+              "\n",
+              "      semi_major_axis_au_unit  near_earth_object_N  near_earth_object_Y  \\\n",
+              "0                    0.130649                    1                    0   \n",
+              "12                  -0.187375                    1                    0   \n",
+              "47                   0.691182                    1                    0   \n",
+              "381                  0.712755                    1                    0   \n",
+              "515                 -0.014654                    1                    0   \n",
+              "...                       ...                  ...                  ...   \n",
+              "9146                -0.820638                    1                    0   \n",
+              "9657                -0.468778                    1                    0   \n",
+              "9704                 0.587128                    1                    0   \n",
+              "9879                -0.662602                    1                    0   \n",
+              "9980                -0.022726                    1                    0   \n",
+              "\n",
+              "      near_earth_object_nan  object_class_AMO  object_class_APO  ...  \\\n",
+              "0                         0                 0                 0  ...   \n",
+              "12                        0                 0                 0  ...   \n",
+              "47                        0                 0                 0  ...   \n",
+              "381                       0                 0                 0  ...   \n",
+              "515                       0                 0                 0  ...   \n",
+              "...                     ...               ...               ...  ...   \n",
+              "9146                      0                 0                 0  ...   \n",
+              "9657                      0                 0                 0  ...   \n",
+              "9704                      0                 0                 0  ...   \n",
+              "9879                      0                 0                 0  ...   \n",
+              "9980                      0                 0                 0  ...   \n",
+              "\n",
+              "      object_class_CEN  object_class_IMB  object_class_MBA  object_class_MCA  \\\n",
+              "0                    0                 0                 1                 0   \n",
+              "12                   0                 0                 1                 0   \n",
+              "47                   0                 0                 1                 0   \n",
+              "381                  0                 0                 1                 0   \n",
+              "515                  0                 0                 1                 0   \n",
+              "...                ...               ...               ...               ...   \n",
+              "9146                 0                 0                 1                 0   \n",
+              "9657                 0                 0                 1                 0   \n",
+              "9704                 0                 0                 1                 0   \n",
+              "9879                 0                 0                 1                 0   \n",
+              "9980                 0                 0                 1                 0   \n",
+              "\n",
+              "      object_class_OMB  object_class_TJN  object_class_nan  hazardous_flag_N  \\\n",
+              "0                    0                 0                 0                 1   \n",
+              "12                   0                 0                 0                 1   \n",
+              "47                   0                 0                 0                 1   \n",
+              "381                  0                 0                 0                 1   \n",
+              "515                  0                 0                 0                 1   \n",
+              "...                ...               ...               ...               ...   \n",
+              "9146                 0                 0                 0                 1   \n",
+              "9657                 0                 0                 0                 1   \n",
+              "9704                 0                 0                 0                 1   \n",
+              "9879                 0                 0                 0                 1   \n",
+              "9980                 0                 0                 0                 1   \n",
+              "\n",
+              "      hazardous_flag_Y  hazardous_flag_nan  \n",
+              "0                    0                   0  \n",
+              "12                   0                   0  \n",
+              "47                   0                   0  \n",
+              "381                  0                   0  \n",
+              "515                  0                   0  \n",
+              "...                ...                 ...  \n",
+              "9146                 0                   0  \n",
+              "9657                 0                   0  \n",
+              "9704                 0                   0  \n",
+              "9879                 0                   0  \n",
+              "9980                 0                   0  \n",
+              "\n",
+              "[9999 rows x 22 columns]"
             ]
           },
+          "execution_count": 36,
           "metadata": {},
-          "execution_count": 36
+          "output_type": "execute_result"
         }
       ],
       "source": [
@@ -3356,31 +3018,36 @@
     },
     {
       "cell_type": "code",
-      "source": [
-        "PROJECT_ID = \"<my-gcp-project>\"\n",
-        "REGION = \"us-central1\"\n",
-        "TEMP_DIR = \"gs://<my-bucket>/tmp\"\n",
-        "OUTPUT_DIR = \"gs://<my-bucket>/dataframe-result\""
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "dDBYbMEWbL4t"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "PROJECT_ID = \"<my-gcp-project>\" # @param {type:'string'}\n",
+        "REGION = \"us-central1\"\n",
+        "TEMP_DIR = \"gs://<my-bucket>/tmp\" # @param {type:'string'}\n",
+        "OUTPUT_DIR = \"gs://<my-bucket>/dataframe-result\" # @param {type:'string'}"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "Qk1GaYoSc9-1"
+      },
       "source": [
         "These steps process the full dataset, `full.csv`, which contains approximately one million rows. To materialize the deferred DataFrame, these steps also write the results to a CSV file instead of using `ib.collect()`.\n",
         "\n",
         "To switch from an interactive runner to a distributed runner, update the pipeline options. The rest of the pipeline steps don't change."
-      ],
-      "metadata": {
-        "id": "Qk1GaYoSc9-1"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "1XovR0gKbMlK"
+      },
+      "outputs": [],
       "source": [
         "# Specify the location of the source CSV file (the full dataset).\n",
         "source_csv_file = 'gs://apache-beam-samples/nasa_jpl_asteroid/full.csv'\n",
@@ -3417,44 +3084,42 @@
         "\n",
         "# Write the preprocessed dataset to a CSV file.\n",
         "beam_df_numericals.to_csv(os.path.join(OUTPUT_DIR, \"preprocessed_data.csv\"))"
-      ],
-      "metadata": {
-        "id": "1XovR0gKbMlK"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Submit and run the pipeline."
-      ],
       "metadata": {
         "id": "a789u4Yecs_g"
-      }
+      },
+      "source": [
+        "Submit and run the pipeline."
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "p.run().wait_until_finish()"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "pbUlC102bPaZ"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "p.run().wait_until_finish()"
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Wait while the pipeline job runs."
-      ],
       "metadata": {
         "id": "dzdqmzKzTOng"
-      }
+      },
+      "source": [
+        "Wait while the pipeline job runs."
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "UOLr6YgOOSVQ"
+      },
       "source": [
         "## What's next \n",
         "\n",
@@ -3464,13 +3129,13 @@
         "[Structured data classification from scratch](https://keras.io/examples/structured_data/structured_data_classification_from_scratch/).\n",
         "\n",
         "To continue learning, find another dataset to use with the Apache Beam DataFrames API processing. Think carefully about which features to include in your model and how to represent them.\n"
-      ],
-      "metadata": {
-        "id": "UOLr6YgOOSVQ"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "nG9WXXVcMCe_"
+      },
       "source": [
         "## Resources\n",
         "\n",
@@ -3479,10 +3144,7 @@
         "* [10 minutes to Pandas](https://pandas.pydata.org/pandas-docs/stable/user_guide/10min.html) - A quickstart guide to the Pandas DataFrames.\n",
         "* [Pandas DataFrame API](https://pandas.pydata.org/pandas-docs/stable/reference/frame.html) - The API reference for the Pandas DataFrames.\n",
         "* [Data preparation and feature training in ML](https://developers.google.com/machine-learning/data-prep) - A guideline about data transformation for ML training."
-      ],
-      "metadata": {
-        "id": "nG9WXXVcMCe_"
-      }
+      ]
     }
   ],
   "metadata": {
diff --git a/examples/notebooks/beam-ml/gemma_2_sentiment_and_summarization.ipynb b/examples/notebooks/beam-ml/gemma_2_sentiment_and_summarization.ipynb
index 686c19da7f66..1b20270f327a 100644
--- a/examples/notebooks/beam-ml/gemma_2_sentiment_and_summarization.ipynb
+++ b/examples/notebooks/beam-ml/gemma_2_sentiment_and_summarization.ipynb
@@ -367,7 +367,7 @@
         "# options.view_as(WorkerOptions).disk_size_gb=200\n",
         "# options.view_as(GoogleCloudOptions).dataflow_service_options=[\"worker_accelerator=type:nvidia-l4;count:1;install-nvidia-driver\"]\n",
         "\n",
-        "topic_reviews=\"<PubSub Topic>\""
+        "topic_reviews=\"<PubSub Topic>\" # @param {type:'string'}"
       ]
     },
     {
diff --git a/examples/notebooks/beam-ml/nlp_tensorflow_streaming.ipynb b/examples/notebooks/beam-ml/nlp_tensorflow_streaming.ipynb
index f9a263e39030..6f5048e7e8ee 100644
--- a/examples/notebooks/beam-ml/nlp_tensorflow_streaming.ipynb
+++ b/examples/notebooks/beam-ml/nlp_tensorflow_streaming.ipynb
@@ -496,23 +496,23 @@
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "Epoch 1/10\n",
             "25/25 [==============================] - ETA: 0s - loss: 0.5931 - accuracy: 0.7650"
           ]
         },
         {
-          "output_type": "stream",
           "name": "stderr",
+          "output_type": "stream",
           "text": [
             "WARNING:absl:Found untraced functions such as _update_step_xla, lstm_cell_7_layer_call_fn, lstm_cell_7_layer_call_and_return_conditional_losses, lstm_cell_8_layer_call_fn, lstm_cell_8_layer_call_and_return_conditional_losses while saving (showing 5 of 9). These functions will not be directly callable after loading.\n"
           ]
         },
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\r25/25 [==============================] - 60s 2s/step - loss: 0.5931 - accuracy: 0.7650 - val_loss: 0.3625 - val_accuracy: 0.8900\n",
             "Epoch 2/10\n",
@@ -536,14 +536,14 @@
           ]
         },
         {
-          "output_type": "execute_result",
           "data": {
             "text/plain": [
               "<keras.callbacks.History at 0x7eda55b3a4d0>"
             ]
           },
+          "execution_count": 57,
           "metadata": {},
-          "execution_count": 57
+          "output_type": "execute_result"
         }
       ],
       "source": [
@@ -604,14 +604,14 @@
       },
       "outputs": [
         {
-          "output_type": "execute_result",
           "data": {
             "text/plain": [
               "<tensorflow.python.checkpoint.checkpoint.CheckpointLoadStatus at 0x7eda3c5c42b0>"
             ]
           },
+          "execution_count": 59,
           "metadata": {},
-          "execution_count": 59
+          "output_type": "execute_result"
         }
       ],
       "source": [
@@ -641,8 +641,8 @@
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stderr",
+          "output_type": "stream",
           "text": [
             "WARNING:absl:Found untraced functions such as _update_step_xla, lstm_cell_7_layer_call_fn, lstm_cell_7_layer_call_and_return_conditional_losses, lstm_cell_8_layer_call_fn, lstm_cell_8_layer_call_and_return_conditional_losses while saving (showing 5 of 9). These functions will not be directly callable after loading.\n"
           ]
@@ -706,8 +706,10 @@
       "source": [
         "import os\n",
         "from google.cloud import pubsub_v1\n",
-        "PROJECT_ID = '' # Add your project ID here\n",
-        "TOPIC = '' # Add your topic name here\n",
+        "# Add your project ID here\n",
+        "PROJECT_ID = '<PROJECT_ID>' # @param {type:'string'}\n",
+        "# Add your topic name here\n",
+        "TOPIC = '<TOPIC>' # @param {type:'string'}\n",
         "publisher = pubsub_v1.PublisherClient()\n",
         "topic_name = 'projects/{project_id}/topics/{topic}'.format(\n",
         "    project_id = PROJECT_ID,\n",
@@ -739,8 +741,8 @@
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "Can’t wait to watch you guys grow . Harmonies are on point and the oversized early 90’s blazers are a great touch.\n",
             "Amazing performance! Such an inspiring group ❤\n",
@@ -908,8 +910,8 @@
       },
       "outputs": [],
       "source": [
-        "# path to the topic\n",
-        "TOPIC_PATH = '' # Add the path to your topic here"
+        "# Add the path to your topic here\n",
+        "TOPIC_PATH = '<TOPIC_PATH>' # @param {type:'string'}"
       ]
     },
     {
@@ -920,18 +922,18 @@
       },
       "outputs": [],
       "source": [
-        "# path to the subscription\n",
-        "SUBS_PATH = '' # Add the path to your subscription here"
+        "# Add the path to your subscription here\n",
+        "SUBS_PATH = '<SUB_PATH>' # @param {type:'string'}"
       ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Importing InteractiveRunner"
-      ],
       "metadata": {
         "id": "UliBhojEfxhq"
-      }
+      },
+      "source": [
+        "Importing InteractiveRunner"
+      ]
     },
     {
       "cell_type": "code",
@@ -986,8 +988,8 @@
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "Can’t wait to watch you guys grow . Harmonies are on point and the oversized early 90’s blazers are a great touch.\n",
             "Amazing performance! Such an inspiring group ❤\n",
@@ -1048,7 +1050,6 @@
       },
       "outputs": [
         {
-          "output_type": "execute_result",
           "data": {
             "text/plain": [
               "[[[0.852806806564331, 0.14719319343566895], 'positive'],\n",
@@ -1059,8 +1060,9 @@
               " [[0.8648154735565186, 0.13518451154232025], 'positive']]"
             ]
           },
+          "execution_count": 38,
           "metadata": {},
-          "execution_count": 38
+          "output_type": "execute_result"
         }
       ],
       "source": [
diff --git a/examples/notebooks/beam-ml/run_inference_pytorch.ipynb b/examples/notebooks/beam-ml/run_inference_pytorch.ipynb
index eaf46be16bbd..93dd12dd20ab 100644
--- a/examples/notebooks/beam-ml/run_inference_pytorch.ipynb
+++ b/examples/notebooks/beam-ml/run_inference_pytorch.ipynb
@@ -1,22 +1,13 @@
 {
-  "nbformat": 4,
-  "nbformat_minor": 0,
-  "metadata": {
-    "colab": {
-      "provenance": [],
-      "collapsed_sections": []
-    },
-    "kernelspec": {
-      "name": "python3",
-      "display_name": "Python 3"
-    },
-    "language_info": {
-      "name": "python"
-    }
-  },
   "cells": [
     {
       "cell_type": "code",
+      "execution_count": 3,
+      "metadata": {
+        "cellView": "form",
+        "id": "C1rAsD2L-hSO"
+      },
+      "outputs": [],
       "source": [
         "# @title ###### Licensed to the Apache Software Foundation (ASF), Version 2.0 (the \"License\")\n",
         "\n",
@@ -36,13 +27,7 @@
         "# KIND, either express or implied. See the License for the\n",
         "# specific language governing permissions and limitations\n",
         "# under the License"
-      ],
-      "metadata": {
-        "cellView": "form",
-        "id": "C1rAsD2L-hSO"
-      },
-      "execution_count": 3,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
@@ -95,23 +80,23 @@
     },
     {
       "cell_type": "code",
-      "source": [
-        "!pip install apache_beam[gcp,dataframe] --quiet"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "loxD-rOVchRn"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "!pip install apache_beam[gcp,dataframe] --quiet"
+      ]
     },
     {
       "cell_type": "code",
       "execution_count": 39,
       "metadata": {
-        "id": "7f841596-f217-46d2-b64e-1952db4de4cb",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "7f841596-f217-46d2-b64e-1952db4de4cb",
         "outputId": "09e0026a-cf8e-455c-9580-bfaef44683ce"
       },
       "outputs": [],
@@ -151,15 +136,15 @@
     },
     {
       "cell_type": "code",
-      "source": [
-        "from google.colab import auth\n",
-        "auth.authenticate_user()"
-      ],
+      "execution_count": 41,
       "metadata": {
         "id": "V0E35R5Ka2cE"
       },
-      "execution_count": 41,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "from google.colab import auth\n",
+        "auth.authenticate_user()"
+      ]
     },
     {
       "cell_type": "code",
@@ -170,8 +155,8 @@
       "outputs": [],
       "source": [
         "# Constants\n",
-        "project = \"<your GCP project>\"\n",
-        "bucket = \"<your GCP bucket>\"\n",
+        "project = \"<your GCP project>\" # @param {type:'string'}\n",
+        "bucket = \"<your GCP bucket>\" # @param {type:'string'}\n",
         "\n",
         "# To avoid warnings, set the project.\n",
         "os.environ['GOOGLE_CLOUD_PROJECT'] = project\n",
@@ -183,8 +168,8 @@
     {
       "cell_type": "markdown",
       "metadata": {
-        "tags": [],
-        "id": "b2b7cedc-79f5-4599-8178-e5da35dba032"
+        "id": "b2b7cedc-79f5-4599-8178-e5da35dba032",
+        "tags": []
       },
       "source": [
         "## Create data and PyTorch models for the RunInference transform\n",
@@ -294,16 +279,16 @@
       "cell_type": "code",
       "execution_count": 46,
       "metadata": {
-        "id": "882bbada-4f6d-4370-a047-c5961e564ee8",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "882bbada-4f6d-4370-a047-c5961e564ee8",
         "outputId": "ab7242a9-76eb-4760-d74e-c725261e2a34"
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "True\n"
           ]
@@ -384,16 +369,16 @@
       "cell_type": "code",
       "execution_count": 49,
       "metadata": {
-        "id": "42b2ca0f-5d44-4d15-a313-f3d56ae7f675",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "42b2ca0f-5d44-4d15-a313-f3d56ae7f675",
         "outputId": "9cb2f268-a500-4ad5-a075-856c87b8e3be"
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "True\n"
           ]
@@ -430,16 +415,16 @@
       "cell_type": "code",
       "execution_count": 50,
       "metadata": {
-        "id": "e488a821-3b70-4284-96f3-ddee4dcb9d71",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "e488a821-3b70-4284-96f3-ddee4dcb9d71",
         "outputId": "add9af31-1cc6-496f-a6e4-3fb185c0de25"
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "PredictionResult(example=tensor([20.]), inference=tensor([102.0095], grad_fn=<UnbindBackward0>))\n",
             "PredictionResult(example=tensor([40.]), inference=tensor([201.2056], grad_fn=<UnbindBackward0>))\n",
@@ -483,16 +468,16 @@
       "cell_type": "code",
       "execution_count": 51,
       "metadata": {
-        "id": "96f38a5a-4db0-4c39-8ce7-80d9f9911b48",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "96f38a5a-4db0-4c39-8ce7-80d9f9911b48",
         "outputId": "b1d689a2-9336-40b2-a984-538bec888cc9"
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "input is 20.0 output is 102.00947570800781\n",
             "input is 40.0 output is 201.20559692382812\n",
@@ -576,7 +561,7 @@
         "        yield (f\"key: {key}, input: {input_value.item()} output: {output_value.item()}\" )"
       ]
     },
-        {
+    {
       "cell_type": "markdown",
       "metadata": {
         "id": "f22da313-5bf8-4334-865b-bbfafc374e63"
@@ -592,7 +577,7 @@
         "id": "c9b0fb49-d605-4f26-931a-57f42b0ad253"
       },
       "source": [
-        "#### Use BigQuery as the source",
+        "#### Use BigQuery as the source\n",
         "Follow these steps to use BigQuery as your source."
       ]
     },
@@ -627,47 +612,47 @@
     },
     {
       "cell_type": "code",
-      "source": [
-        "!gcloud config set project $project"
-      ],
+      "execution_count": 54,
       "metadata": {
-        "id": "7mgnryX-Zlfs",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "7mgnryX-Zlfs",
         "outputId": "6e608e98-8369-45aa-c983-e62296202c52"
       },
-      "execution_count": 54,
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "Updated property [core/project].\n"
           ]
         }
+      ],
+      "source": [
+        "!gcloud config set project $project"
       ]
     },
     {
       "cell_type": "code",
       "execution_count": 55,
       "metadata": {
-        "id": "a6a984cd-2e92-4c44-821b-9bf1dd52fb7d",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "a6a984cd-2e92-4c44-821b-9bf1dd52fb7d",
         "outputId": "a50ab0fd-4f4e-4493-b506-41d3f7f08966"
       },
       "outputs": [
         {
-          "output_type": "execute_result",
           "data": {
             "text/plain": [
               "<google.cloud.bigquery.table._EmptyRowIterator at 0x7f5694206650>"
             ]
           },
+          "execution_count": 55,
           "metadata": {},
-          "execution_count": 55
+          "output_type": "execute_result"
         }
       ],
       "source": [
@@ -715,16 +700,16 @@
       "cell_type": "code",
       "execution_count": 56,
       "metadata": {
-        "id": "34331897-23f5-4850-8974-67e522e956dc",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "34331897-23f5-4850-8974-67e522e956dc",
         "outputId": "9d2b0ba5-97a2-46bf-c9d3-e023afbd3122"
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "key: third_question, input: 1000.0 output: 4962.61962890625\n",
             "key: second_question, input: 108.0 output: 538.472412109375\n",
@@ -761,7 +746,7 @@
         "id": "53ee7f24-5625-475a-b8cc-9c031591f304"
       },
       "source": [
-        "#### Use a CSV file as the source",
+        "#### Use a CSV file as the source\n",
         "Follow these steps to use a CSV file as your source."
       ]
     },
@@ -776,6 +761,11 @@
     },
     {
       "cell_type": "code",
+      "execution_count": 62,
+      "metadata": {
+        "id": "exAZjP7cYAFv"
+      },
+      "outputs": [],
       "source": [
         "# creates a CSV file with the values.\n",
         "csv_values = [(\"first_question\", 105.00),\n",
@@ -791,27 +781,22 @@
         "    writer.writerow(row)\n",
         "\n",
         "assert os.path.exists(input_csv_file) == True"
-      ],
-      "metadata": {
-        "id": "exAZjP7cYAFv"
-      },
-      "execution_count": 62,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "code",
       "execution_count": 66,
       "metadata": {
-        "id": "9a054c2d-4d84-4b37-b067-1dda5347e776",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "9a054c2d-4d84-4b37-b067-1dda5347e776",
         "outputId": "2f2ea8b7-b425-48ae-e857-fe214c7eced2"
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "key: first_question, input: 105.0 output: 523.5929565429688\n",
             "key: second_question, input: 108.0 output: 538.472412109375\n",
@@ -890,16 +875,16 @@
       "cell_type": "code",
       "execution_count": 68,
       "metadata": {
-        "id": "629d070e-9902-42c9-a1e7-56c3d1864f13",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "629d070e-9902-42c9-a1e7-56c3d1864f13",
         "outputId": "0b4d7f3c-4696-422f-b031-ee5a03e90e03"
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "key: third_question * 10, input: 1000.0 output: 9889.59765625\n",
             "key: second_question * 10, input: 108.0 output: 1075.4891357421875\n",
@@ -966,16 +951,16 @@
       "cell_type": "code",
       "execution_count": 69,
       "metadata": {
-        "id": "8db9d649-5549-4b58-a9ad-7b8592c2bcbf",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "8db9d649-5549-4b58-a9ad-7b8592c2bcbf",
         "outputId": "328ba32b-40d4-445b-8b4e-5568258b8a26"
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "key: original input is `third_question tensor([1000.])`, input: 4962.61962890625 output: 49045.37890625\n",
             "key: original input is `second_question tensor([108.])`, input: 538.472412109375 output: 5329.11083984375\n",
@@ -1015,5 +1000,20 @@
         "  inference_result | beam.Map(print)"
       ]
     }
-  ]
+  ],
+  "metadata": {
+    "colab": {
+      "collapsed_sections": [],
+      "provenance": []
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
 }
diff --git a/examples/notebooks/beam-ml/run_inference_sklearn.ipynb b/examples/notebooks/beam-ml/run_inference_sklearn.ipynb
index cf896a18981a..1b76f76df292 100644
--- a/examples/notebooks/beam-ml/run_inference_sklearn.ipynb
+++ b/examples/notebooks/beam-ml/run_inference_sklearn.ipynb
@@ -1,22 +1,13 @@
 {
-  "nbformat": 4,
-  "nbformat_minor": 0,
-  "metadata": {
-    "colab": {
-      "provenance": [],
-      "collapsed_sections": []
-    },
-    "kernelspec": {
-      "name": "python3",
-      "display_name": "Python 3"
-    },
-    "language_info": {
-      "name": "python"
-    }
-  },
   "cells": [
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "cellView": "form",
+        "id": "C1rAsD2L-hSO"
+      },
+      "outputs": [],
       "source": [
         "# @title ###### Licensed to the Apache Software Foundation (ASF), Version 2.0 (the \"License\")\n",
         "\n",
@@ -36,13 +27,7 @@
         "# KIND, either express or implied. See the License for the\n",
         "# specific language governing permissions and limitations\n",
         "# under the License"
-      ],
-      "metadata": {
-        "cellView": "form",
-        "id": "C1rAsD2L-hSO"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
@@ -87,24 +72,20 @@
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "zzwnMzzgdyPB"
+      },
       "source": [
         "## Before you begin\n",
         "Complete the following setup steps:\n",
         "1. Install dependencies for Apache Beam.\n",
         "1. Authenticate with Google Cloud.\n",
         "1. Specify your project and bucket. You use the project and bucket to save and load models."
-      ],
-      "metadata": {
-        "id": "zzwnMzzgdyPB"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "!pip install google-api-core --quiet\n",
-        "!pip install google-cloud-pubsub google-cloud-bigquery-storage --quiet\n",
-        "!pip install apache-beam[gcp,dataframe] --quiet"
-      ],
+      "execution_count": 1,
       "metadata": {
         "colab": {
           "base_uri": "https://localhost:8080/"
@@ -112,8 +93,12 @@
         "id": "6vlKcT-Wev20",
         "outputId": "336e8afc-6716-41dd-a438-500353189c62"
       },
-      "execution_count": 1,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "!pip install google-api-core --quiet\n",
+        "!pip install google-cloud-pubsub google-cloud-bigquery-storage --quiet\n",
+        "!pip install apache-beam[gcp,dataframe] --quiet"
+      ]
     },
     {
       "cell_type": "markdown",
@@ -128,15 +113,15 @@
     },
     {
       "cell_type": "code",
-      "source": [
-        "from google.colab import auth\n",
-        "auth.authenticate_user()"
-      ],
+      "execution_count": 2,
       "metadata": {
         "id": "V0E35R5Ka2cE"
       },
-      "execution_count": 2,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "from google.colab import auth\n",
+        "auth.authenticate_user()"
+      ]
     },
     {
       "cell_type": "code",
@@ -174,8 +159,8 @@
         "import os\n",
         "\n",
         "# Constants\n",
-        "project = \"<PROJECT_ID>\"\n",
-        "bucket = \"<BUCKET_NAME>\" \n",
+        "project = \"<PROJECT_ID>\" # @param {type:'string'}\n",
+        "bucket = \"<BUCKET_NAME>\" # @param {type:'string'}\n",
         "\n",
         "# To avoid warnings, set the project.\n",
         "os.environ['GOOGLE_CLOUD_PROJECT'] = project\n"
@@ -240,20 +225,18 @@
     },
     {
       "cell_type": "code",
-      "source": [
-        "%pip install --upgrade google-cloud-bigquery --quiet"
-      ],
+      "execution_count": 9,
       "metadata": {
         "id": "AEGaqpMVqgRP"
       },
-      "execution_count": 9,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "%pip install --upgrade google-cloud-bigquery --quiet"
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "!gcloud config set project $project"
-      ],
+      "execution_count": 10,
       "metadata": {
         "colab": {
           "base_uri": "https://localhost:8080/"
@@ -261,19 +244,41 @@
         "id": "xq5AKtRrqlUx",
         "outputId": "fba8fb42-4958-451a-8aaa-9a838052a2f8"
       },
-      "execution_count": 10,
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "Updated property [core/project].\n"
           ]
         }
+      ],
+      "source": [
+        "!gcloud config set project $project"
       ]
     },
     {
       "cell_type": "code",
+      "execution_count": 22,
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/"
+        },
+        "id": "QCIjN__rpoVF",
+        "outputId": "0ded224f-2272-482e-80f5-bb2d21b6f5d8"
+      },
+      "outputs": [
+        {
+          "data": {
+            "text/plain": [
+              "<google.cloud.bigquery.table._EmptyRowIterator at 0x7f97abb4e850>"
+            ]
+          },
+          "execution_count": 22,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
       "source": [
         "# Populated BigQuery table\n",
         "\n",
@@ -306,42 +311,22 @@
         "\n",
         "create_job = client.query(query)\n",
         "create_job.result()"
-      ],
-      "metadata": {
-        "colab": {
-          "base_uri": "https://localhost:8080/"
-        },
-        "id": "QCIjN__rpoVF",
-        "outputId": "0ded224f-2272-482e-80f5-bb2d21b6f5d8"
-      },
-      "execution_count": 22,
-      "outputs": [
-        {
-          "output_type": "execute_result",
-          "data": {
-            "text/plain": [
-              "<google.cloud.bigquery.table._EmptyRowIterator at 0x7f97abb4e850>"
-            ]
-          },
-          "metadata": {},
-          "execution_count": 22
-        }
       ]
     },
     {
       "cell_type": "code",
       "execution_count": 23,
       "metadata": {
-        "id": "50a648a3-794a-4286-ab2b-fc0458db04ca",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "50a648a3-794a-4286-ab2b-fc0458db04ca",
         "outputId": "8eab34b4-dcc7-4df1-ec0e-8c86a34d31c6"
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "PredictionResult(example=[1000.0], inference=array([5000.]))\n",
             "PredictionResult(example=[1013.0], inference=array([5065.]))\n",
@@ -388,16 +373,16 @@
       "cell_type": "code",
       "execution_count": 25,
       "metadata": {
-        "id": "c212916d-b517-4589-ad15-a3a1df926fb3",
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
+        "id": "c212916d-b517-4589-ad15-a3a1df926fb3",
         "outputId": "61db2d76-4dfa-4b38-cf9a-645790b4c5aa"
       },
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "('third_example', PredictionResult(example=[1000.0], inference=array([5000.])))\n",
             "('fourth_example', PredictionResult(example=[1013.0], inference=array([5065.])))\n",
@@ -424,17 +409,41 @@
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "JQ4zvlwsRK1W"
+      },
       "source": [
         "## Run multiple models\n",
         "\n",
         "This code creates a pipeline that takes two RunInference transforms with different models and then combines the output."
-      ],
-      "metadata": {
-        "id": "JQ4zvlwsRK1W"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": 86,
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/"
+        },
+        "id": "0qMlX6SeR68D",
+        "outputId": "5e4a0852-3761-47da-aa08-0386fd524a78"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "key = third_example * 10, example = 1000.0 -> predictions 10000.0\n",
+            "key = fourth_example * 10, example = 1013.0 -> predictions 10130.0\n",
+            "key = second_example * 10, example = 108.0 -> predictions 1080.0\n",
+            "key = first_example * 10, example = 105.0 -> predictions 1050.0\n",
+            "key = third_example * 5, example = 1000.0 -> predictions 5000.0\n",
+            "key = fourth_example * 5, example = 1013.0 -> predictions 5065.0\n",
+            "key = second_example * 5, example = 108.0 -> predictions 540.0\n",
+            "key = first_example * 5, example = 105.0 -> predictions 525.0\n"
+          ]
+        }
+      ],
       "source": [
         "from typing import Tuple\n",
         "\n",
@@ -464,31 +473,22 @@
         "  _ = ((five_times, ten_times) | \"Flattened\" >> beam.Flatten()\n",
         "    | \"format output\" >> beam.Map(format_output)\n",
         "    | \"Print\" >> beam.Map(print))\n"
-      ],
-      "metadata": {
-        "colab": {
-          "base_uri": "https://localhost:8080/"
-        },
-        "id": "0qMlX6SeR68D",
-        "outputId": "5e4a0852-3761-47da-aa08-0386fd524a78"
-      },
-      "execution_count": 86,
-      "outputs": [
-        {
-          "output_type": "stream",
-          "name": "stdout",
-          "text": [
-            "key = third_example * 10, example = 1000.0 -> predictions 10000.0\n",
-            "key = fourth_example * 10, example = 1013.0 -> predictions 10130.0\n",
-            "key = second_example * 10, example = 108.0 -> predictions 1080.0\n",
-            "key = first_example * 10, example = 105.0 -> predictions 1050.0\n",
-            "key = third_example * 5, example = 1000.0 -> predictions 5000.0\n",
-            "key = fourth_example * 5, example = 1013.0 -> predictions 5065.0\n",
-            "key = second_example * 5, example = 108.0 -> predictions 540.0\n",
-            "key = first_example * 5, example = 105.0 -> predictions 525.0\n"
-          ]
-        }
       ]
     }
-  ]
+  ],
+  "metadata": {
+    "colab": {
+      "collapsed_sections": [],
+      "provenance": []
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
 }
diff --git a/examples/notebooks/beam-ml/run_inference_tensorflow.ipynb b/examples/notebooks/beam-ml/run_inference_tensorflow.ipynb
index ad5bb671cce2..c15e9b21ecf9 100644
--- a/examples/notebooks/beam-ml/run_inference_tensorflow.ipynb
+++ b/examples/notebooks/beam-ml/run_inference_tensorflow.ipynb
@@ -168,8 +168,8 @@
         "from apache_beam.ml.inference.tensorflow_inference import TFModelHandlerTensor\n",
         "from apache_beam.options.pipeline_options import PipelineOptions\n",
         "\n",
-        "project = \"PROJECT_ID\"\n",
-        "bucket = \"BUCKET_NAME\"\n",
+        "project = \"PROJECT_ID\" # @param {type:'string'}\n",
+        "bucket = \"BUCKET_NAME\" # @param {type:'string'}\n",
         "\n",
         "save_model_dir_multiply = f'gs://{bucket}/tf-inference/model/multiply_five/v1/'\n",
         "save_weights_dir_multiply = f'gs://{bucket}/tf-inference/weights/multiply_five/v1/'\n"
diff --git a/examples/notebooks/beam-ml/run_inference_tensorflow_with_tfx.ipynb b/examples/notebooks/beam-ml/run_inference_tensorflow_with_tfx.ipynb
index 9a9c6f5d6e92..2c2f6460651b 100644
--- a/examples/notebooks/beam-ml/run_inference_tensorflow_with_tfx.ipynb
+++ b/examples/notebooks/beam-ml/run_inference_tensorflow_with_tfx.ipynb
@@ -1,32 +1,13 @@
 {
-  "nbformat": 4,
-  "nbformat_minor": 0,
-  "metadata": {
-    "colab": {
-      "provenance": [],
-      "collapsed_sections": [
-        "X80jy3FqHjK4",
-        "40qtP6zJuMXm",
-        "YzvZWEv-1oiK",
-        "rIwD_qEpX7Gu",
-        "O_a0-4Gb19cy",
-        "G-sAu3cf31f3",
-        "r4dpR6dQ4JwX",
-        "P2UMmbNW4YQV"
-      ]
-    },
-    "kernelspec": {
-      "name": "python3",
-      "display_name": "Python 3"
-    },
-    "language_info": {
-      "name": "python"
-    },
-    "accelerator": "GPU"
-  },
   "cells": [
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "cellView": "form",
+        "id": "fFjof1NgAJwu"
+      },
+      "outputs": [],
       "source": [
         "# @title ###### Licensed to the Apache Software Foundation (ASF), Version 2.0 (the \"License\")\n",
         "\n",
@@ -46,13 +27,7 @@
         "# KIND, either express or implied. See the License for the\n",
         "# specific language governing permissions and limitations\n",
         "# under the License"
-      ],
-      "metadata": {
-        "cellView": "form",
-        "id": "fFjof1NgAJwu"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
@@ -74,6 +49,9 @@
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "HrCtxslBGK8Z"
+      },
       "source": [
         "This notebook demonstrates how to use the Apache Beam [RunInference](https://beam.apache.org/releases/pydoc/current/apache_beam.ml.inference.base.html#apache_beam.ml.inference.base.RunInference) transform with TensorFlow and [TFX Basic Shared Libraries](https://github.com/tensorflow/tfx-bsl) (`tfx-bsl`).\n",
         "\n",
@@ -89,69 +67,69 @@
         "- Use the `tfx-bsl` model handler with the example data, and get a prediction inside an Apache Beam pipeline.\n",
         "\n",
         "For more information about using RunInference, see [Get started with AI/ML pipelines](https://beam.apache.org/documentation/ml/overview/) in the Apache Beam documentation."
-      ],
-      "metadata": {
-        "id": "HrCtxslBGK8Z"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "HrCtxslBGK8A"
+      },
       "source": [
         "## Before you begin\n",
         "Set up your environment and download dependencies."
-      ],
-      "metadata": {
-        "id": "HrCtxslBGK8A"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "HrCtxslBGK8A"
+      },
       "source": [
         "### Import `tfx-bsl`\n",
         "First, import `tfx-bsl`.\n",
         "Creating a model handler is supported in `tfx-bsl` versions 1.10 and later."
-      ],
-      "metadata": {
-        "id": "HrCtxslBGK8A"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
       "metadata": {
         "id": "jBakpNZnAhqk"
       },
+      "outputs": [],
       "source": [
         "!pip install tfx_bsl==1.10.0 --quiet\n",
         "!pip install protobuf --quiet\n",
         "!pip install apache_beam --quiet"
-      ],
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "X80jy3FqHjK4"
+      },
       "source": [
         "### Authenticate with Google Cloud\n",
         "This notebook relies on saving your model to Google Cloud. To use your Google Cloud account, authenticate this notebook."
-      ],
-      "metadata": {
-        "id": "X80jy3FqHjK4"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": 2,
       "metadata": {
         "id": "Kz9sccyGBqz3"
       },
+      "outputs": [],
       "source": [
         "from google.colab import auth\n",
         "auth.authenticate_user()"
-      ],
-      "execution_count": 2,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "40qtP6zJuMXm"
+      },
       "source": [
         "### Import dependencies and set up your bucket\n",
         "Use the following code to import dependencies and to set up your Google Cloud Storage bucket.\n",
@@ -159,16 +137,15 @@
         "Replace `PROJECT_ID` and `BUCKET_NAME` with the ID of your project and the name of your bucket.\n",
         "\n",
         "**Important**: If an error occurs, restart your runtime."
-      ],
-      "metadata": {
-        "id": "40qtP6zJuMXm"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": 12,
       "metadata": {
         "id": "eEle839_Akqx"
       },
+      "outputs": [],
       "source": [
         "import argparse\n",
         "\n",
@@ -190,24 +167,22 @@
         "\n",
         "from apache_beam.options.pipeline_options import PipelineOptions\n",
         "\n",
-        "project = \"PROJECT_ID\"\n",
-        "bucket = \"BUCKET_NAME\"\n",
+        "project = \"PROJECT_ID\" # @param {type:'string'}\n",
+        "bucket = \"BUCKET_NAME\" # @param {type:'string'}\n",
         "\n",
         "save_model_dir_multiply = f'gs://{bucket}/tfx-inference/model/multiply_five/v1/'\n"
-      ],
-      "execution_count": 12,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "YzvZWEv-1oiK"
+      },
       "source": [
         "## Create and test a simple model\n",
         "\n",
         "This section creates and tests a model that predicts the 5 times multiplication table."
-      ],
-      "metadata": {
-        "id": "YzvZWEv-1oiK"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
@@ -221,6 +196,7 @@
     },
     {
       "cell_type": "code",
+      "execution_count": 4,
       "metadata": {
         "colab": {
           "base_uri": "https://localhost:8080/"
@@ -228,26 +204,10 @@
         "id": "SH7iq3zeBBJ-",
         "outputId": "c5adb7ec-285b-401e-f9be-1e9b83c6d0ba"
       },
-      "source": [
-        "# Create training data that represents the 5 times multiplication table for the numbers 0 to 99.\n",
-        "# x is the data and y is the labels.\n",
-        "x = numpy.arange(0, 100)   # Examples\n",
-        "y = x * 5                  # Labels\n",
-        "\n",
-        "# Build a simple linear regression model.\n",
-        "# Note that the model has a shape of (1) for its input layer and expects a single int64 value.\n",
-        "input_layer = keras.layers.Input(shape=(1), dtype=tf.float32, name='x')\n",
-        "output_layer= keras.layers.Dense(1)(input_layer)\n",
-        "\n",
-        "model = keras.Model(input_layer, output_layer)\n",
-        "model.compile(optimizer=tf.optimizers.Adam(), loss='mean_absolute_error')\n",
-        "model.summary()"
-      ],
-      "execution_count": 4,
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "Model: \"model\"\n",
             "_________________________________________________________________\n",
@@ -264,21 +224,37 @@
             "_________________________________________________________________\n"
           ]
         }
+      ],
+      "source": [
+        "# Create training data that represents the 5 times multiplication table for the numbers 0 to 99.\n",
+        "# x is the data and y is the labels.\n",
+        "x = numpy.arange(0, 100)   # Examples\n",
+        "y = x * 5                  # Labels\n",
+        "\n",
+        "# Build a simple linear regression model.\n",
+        "# Note that the model has a shape of (1) for its input layer and expects a single int64 value.\n",
+        "input_layer = keras.layers.Input(shape=(1), dtype=tf.float32, name='x')\n",
+        "output_layer= keras.layers.Dense(1)(input_layer)\n",
+        "\n",
+        "model = keras.Model(input_layer, output_layer)\n",
+        "model.compile(optimizer=tf.optimizers.Adam(), loss='mean_absolute_error')\n",
+        "model.summary()"
       ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "O_a0-4Gb19cy"
+      },
       "source": [
         "### Test the model\n",
         "\n",
         "This step tests the model that you created."
-      ],
-      "metadata": {
-        "id": "O_a0-4Gb19cy"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": 6,
       "metadata": {
         "colab": {
           "base_uri": "https://localhost:8080/"
@@ -286,20 +262,10 @@
         "id": "5XkIYXhJBFmS",
         "outputId": "e3bb5079-5cb8-4fe4-eb8d-d3d13d5f9f0c"
       },
-      "source": [
-        "model.fit(x, y, epochs=500, verbose=0)\n",
-        "test_examples =[20, 40, 60, 90]\n",
-        "value_to_predict = numpy.array(test_examples, dtype=numpy.float32)\n",
-        "predictions = model.predict(value_to_predict)\n",
-        "\n",
-        "print('Test Examples ' + str(test_examples))\n",
-        "print('Predictions ' + str(predictions))"
-      ],
-      "execution_count": 6,
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "1/1 [==============================] - 0s 94ms/step\n",
             "Test Examples [20, 40, 60, 90]\n",
@@ -309,10 +275,22 @@
             " [34.41496 ]]\n"
           ]
         }
+      ],
+      "source": [
+        "model.fit(x, y, epochs=500, verbose=0)\n",
+        "test_examples =[20, 40, 60, 90]\n",
+        "value_to_predict = numpy.array(test_examples, dtype=numpy.float32)\n",
+        "predictions = model.predict(value_to_predict)\n",
+        "\n",
+        "print('Test Examples ' + str(test_examples))\n",
+        "print('Predictions ' + str(predictions))"
       ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "dEmleqiH3t71"
+      },
       "source": [
         "## RunInference with Tensorflow using `tfx-bsl`\n",
         "In versions 1.10.0 and later of `tfx-bsl`, you can\n",
@@ -321,16 +299,15 @@
         "### Populate the data in a TensorFlow proto\n",
         "\n",
         "Tensorflow data uses protos. If you are loading from a file, helpers exist for this step. Because this example uses generated data, this code populates a proto."
-      ],
-      "metadata": {
-        "id": "dEmleqiH3t71"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": 7,
       "metadata": {
         "id": "XvKc9kQilPjx"
       },
+      "outputs": [],
       "source": [
         "# This example shows a proto that converts the samples and labels into\n",
         "# tensors usable by TensorFlow.\n",
@@ -371,23 +348,22 @@
         "  for i in value_to_predict:\n",
         "    example = ExampleProcessor().create_example(feature=i)\n",
         "    writer.write(example.SerializeToString())"
-      ],
-      "execution_count": 7,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "G-sAu3cf31f3"
+      },
       "source": [
         "### Fit the model\n",
         "\n",
         "This step builds a model. Because RunInference requires pretrained models, this segment builds a usable model."
-      ],
-      "metadata": {
-        "id": "G-sAu3cf31f3"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": 8,
       "metadata": {
         "colab": {
           "base_uri": "https://localhost:8080/"
@@ -395,6 +371,18 @@
         "id": "AnbrxXPKeAOQ",
         "outputId": "42439aac-3a10-4e86-829f-44332aad6173"
       },
+      "outputs": [
+        {
+          "data": {
+            "text/plain": [
+              "<keras.callbacks.History at 0x7f6960074c70>"
+            ]
+          },
+          "execution_count": 8,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
       "source": [
         "RAW_DATA_TRAIN_SPEC = {\n",
         "'x': tf.io.FixedLenFeature([], tf.float32),\n",
@@ -408,37 +396,26 @@
         "dataset = dataset.repeat()\n",
         "\n",
         "model.fit(dataset, epochs=5000, steps_per_epoch=1, verbose=0)"
-      ],
-      "execution_count": 8,
-      "outputs": [
-        {
-          "output_type": "execute_result",
-          "data": {
-            "text/plain": [
-              "<keras.callbacks.History at 0x7f6960074c70>"
-            ]
-          },
-          "metadata": {},
-          "execution_count": 8
-        }
       ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "r4dpR6dQ4JwX"
+      },
       "source": [
         "### Save the model\n",
         "\n",
         "This step shows how to save your model."
-      ],
-      "metadata": {
-        "id": "r4dpR6dQ4JwX"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": 9,
       "metadata": {
         "id": "fYvrIYO3qiJx"
       },
+      "outputs": [],
       "source": [
         "RAW_DATA_PREDICT_SPEC = {\n",
         "'x': tf.io.FixedLenFeature([], tf.float32),\n",
@@ -461,25 +438,24 @@
         "# programs that consume SavedModels, such as serving APIs.\n",
         "# See https://www.tensorflow.org/api_docs/python/tf/saved_model/save\n",
         "tf.keras.models.save_model(model, save_model_dir_multiply, signatures=signature)"
-      ],
-      "execution_count": 9,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "P2UMmbNW4YQV"
+      },
       "source": [
         "## Run the pipeline\n",
         "Use the following code to run the pipeline.\n",
         "\n",
         "* `FormatOutput` demonstrates how to extract values from the output protos.\n",
         "* `CreateModelHandler` demonstrates the model handler that needs to be passed into the Apache Beam RunInference API."
-      ],
-      "metadata": {
-        "id": "P2UMmbNW4YQV"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": 10,
       "metadata": {
         "colab": {
           "base_uri": "https://localhost:8080/",
@@ -488,72 +464,24 @@
         "id": "PzjmXM_KvqHY",
         "outputId": "0aa60bef-52a0-4ce2-d228-3fac977d59e0"
       },
-      "source": [
-        "from tfx_bsl.public.beam.run_inference import CreateModelHandler\n",
-        "\n",
-        "class FormatOutput(beam.DoFn):\n",
-        "    def process(self, element: prediction_log_pb2.PredictionLog):\n",
-        "        predict_log = element.predict_log\n",
-        "        input_value = tf.train.Example.FromString(predict_log.request.inputs['examples'].string_val[0])\n",
-        "        input_float_value = input_value.features.feature['x'].float_list.value[0]\n",
-        "        output_value = predict_log.response.outputs\n",
-        "        output_float_value = output_value['output_0'].float_val[0]\n",
-        "        yield (f\"example is {input_float_value:.2f} prediction is {output_float_value:.2f}\")\n",
-        "\n",
-        "tfexample_beam_record = tfx_bsl.public.tfxio.TFExampleRecord(file_pattern=predict_values_five_times_table)\n",
-        "saved_model_spec = model_spec_pb2.SavedModelSpec(model_path=save_model_dir_multiply)\n",
-        "inference_spec_type = model_spec_pb2.InferenceSpecType(saved_model_spec=saved_model_spec)\n",
-        "model_handler = CreateModelHandler(inference_spec_type)\n",
-        "with beam.Pipeline() as p:\n",
-        "    _ = (p | tfexample_beam_record.RawRecordBeamSource()\n",
-        "           | RunInference(model_handler)\n",
-        "           | beam.ParDo(FormatOutput())\n",
-        "           | beam.Map(print)\n",
-        "        )"
-      ],
-      "execution_count": 10,
       "outputs": [
         {
-          "output_type": "stream",
           "name": "stderr",
+          "output_type": "stream",
           "text": [
             "WARNING:apache_beam.runners.interactive.interactive_environment:Dependencies required for Interactive Beam PCollection visualization are not available, please use: `pip install apache-beam[interactive]` to install necessary dependencies to enable all data visualization features.\n"
           ]
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "stream",
           "name": "stderr",
+          "output_type": "stream",
           "text": [
             "WARNING:tensorflow:From /usr/local/lib/python3.9/dist-packages/tfx_bsl/beam/run_inference.py:615: load (from tensorflow.python.saved_model.loader_impl) is deprecated and will be removed in a future version.\n",
             "Instructions for updating:\n",
@@ -562,8 +490,8 @@
           ]
         },
         {
-          "output_type": "stream",
           "name": "stdout",
+          "output_type": "stream",
           "text": [
             "example is 20.00 prediction is 104.36\n",
             "example is 40.00 prediction is 202.62\n",
@@ -571,10 +499,36 @@
             "example is 90.00 prediction is 448.26\n"
           ]
         }
+      ],
+      "source": [
+        "from tfx_bsl.public.beam.run_inference import CreateModelHandler\n",
+        "\n",
+        "class FormatOutput(beam.DoFn):\n",
+        "    def process(self, element: prediction_log_pb2.PredictionLog):\n",
+        "        predict_log = element.predict_log\n",
+        "        input_value = tf.train.Example.FromString(predict_log.request.inputs['examples'].string_val[0])\n",
+        "        input_float_value = input_value.features.feature['x'].float_list.value[0]\n",
+        "        output_value = predict_log.response.outputs\n",
+        "        output_float_value = output_value['output_0'].float_val[0]\n",
+        "        yield (f\"example is {input_float_value:.2f} prediction is {output_float_value:.2f}\")\n",
+        "\n",
+        "tfexample_beam_record = tfx_bsl.public.tfxio.TFExampleRecord(file_pattern=predict_values_five_times_table)\n",
+        "saved_model_spec = model_spec_pb2.SavedModelSpec(model_path=save_model_dir_multiply)\n",
+        "inference_spec_type = model_spec_pb2.InferenceSpecType(saved_model_spec=saved_model_spec)\n",
+        "model_handler = CreateModelHandler(inference_spec_type)\n",
+        "with beam.Pipeline() as p:\n",
+        "    _ = (p | tfexample_beam_record.RawRecordBeamSource()\n",
+        "           | RunInference(model_handler)\n",
+        "           | beam.ParDo(FormatOutput())\n",
+        "           | beam.Map(print)\n",
+        "        )"
       ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "IXikjkGdHm9n"
+      },
       "source": [
         "## Use `KeyedModelHandler` with `tfx-bsl`\n",
         "\n",
@@ -584,13 +538,30 @@
         "* If you don't know whether keys are associated with your examples, use `beam.MaybeKeyedModelHandler`.\n",
         "\n",
         "In addition to demonstrating how to use a keyed model handler, this step demonstrates how to use `tfx-bsl` examples."
-      ],
-      "metadata": {
-        "id": "IXikjkGdHm9n"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": 11,
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/"
+        },
+        "id": "KPtE3fmdJQry",
+        "outputId": "c33558fc-fb12-4c20-b828-b5520721f279"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "key 5.0 : example is 5.00 prediction is 30.67\n",
+            "key 50.0 : example is 50.00 prediction is 251.75\n",
+            "key 40.0 : example is 40.00 prediction is 202.62\n",
+            "key 100.0 : example is 100.00 prediction is 497.38\n"
+          ]
+        }
+      ],
       "source": [
         "from apache_beam.ml.inference.base import KeyedModelHandler\n",
         "from google.protobuf import text_format\n",
@@ -632,27 +603,32 @@
         "           | beam.ParDo(FormatOutputKeyed())\n",
         "           | beam.Map(print)\n",
         "        )"
-      ],
-      "metadata": {
-        "colab": {
-          "base_uri": "https://localhost:8080/"
-        },
-        "id": "KPtE3fmdJQry",
-        "outputId": "c33558fc-fb12-4c20-b828-b5520721f279"
-      },
-      "execution_count": 11,
-      "outputs": [
-        {
-          "output_type": "stream",
-          "name": "stdout",
-          "text": [
-            "key 5.0 : example is 5.00 prediction is 30.67\n",
-            "key 50.0 : example is 50.00 prediction is 251.75\n",
-            "key 40.0 : example is 40.00 prediction is 202.62\n",
-            "key 100.0 : example is 100.00 prediction is 497.38\n"
-          ]
-        }
       ]
     }
-  ]
-}
\ No newline at end of file
+  ],
+  "metadata": {
+    "accelerator": "GPU",
+    "colab": {
+      "collapsed_sections": [
+        "X80jy3FqHjK4",
+        "40qtP6zJuMXm",
+        "YzvZWEv-1oiK",
+        "rIwD_qEpX7Gu",
+        "O_a0-4Gb19cy",
+        "G-sAu3cf31f3",
+        "r4dpR6dQ4JwX",
+        "P2UMmbNW4YQV"
+      ],
+      "provenance": []
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
+}
diff --git a/examples/notebooks/beam-ml/run_inference_vertex_ai.ipynb b/examples/notebooks/beam-ml/run_inference_vertex_ai.ipynb
index 46bfc0f2fc00..2ab45e0491a7 100644
--- a/examples/notebooks/beam-ml/run_inference_vertex_ai.ipynb
+++ b/examples/notebooks/beam-ml/run_inference_vertex_ai.ipynb
@@ -151,6 +151,17 @@
         "Replace `PROJECT_ID`, `LOCATION_NAME`, and `ENDPOINT_ID` with the ID of your project, the GCP region where your model is deployed, and the ID of your Vertex AI endpoint."
       ]
     },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "PROJECT_ID = \"<PROJECT_ID>\" # @param {type:'string'}\n",
+        "LOCATION_NAME = \"<LOCATION_NAME>\" # @param {type:'string'}\n",
+        "ENDPOINT_ID = \"<ENDPOINT_ID\" # @param {type:'string'}"
+      ]
+    },
     {
       "cell_type": "markdown",
       "metadata": {
@@ -189,8 +200,8 @@
         }
       ],
       "source": [
-        "aiplatform.init(project=project, location=location)\n",
-        "endpoint = aiplatform.Endpoint(endpoint_name=endpoint_id)\n",
+        "aiplatform.init(project=PROJECT_ID_ID, location=LOCATION_NAME_NAME)\n",
+        "endpoint = aiplatform.Endpoint(endpoint_name=ENDPOINT_ID)\n",
         "# To get more metadata, remove [0].display_name\n",
         "endpoint.list_models()[0].display_name"
       ]
@@ -313,7 +324,7 @@
         "    index = prediction_vals.index(max(prediction_vals))\n",
         "    yield str(COLUMNS[index]) + \" (\" + str(max(prediction_vals)) + \")\"\n",
         "\n",
-        "model_handler = VertexAIModelHandlerJSON(endpoint_id=endpoint_id, project=project, location=location).with_preprocess_fn(preprocess_image).with_preprocess_fn(download_image)\n",
+        "model_handler = VertexAIModelHandlerJSON(endpoint_id=ENDPOINT_ID, project=PROJECT_ID_ID, location=LOCATION_NAME).with_preprocess_fn(preprocess_image).with_preprocess_fn(download_image)\n",
         "\n",
         "with beam.Pipeline() as p:\n",
         "    _ = (p | beam.Create([IMG_URL])\n",
@@ -366,7 +377,7 @@
         "    yield img_name + \": \" + str(COLUMNS[index]) + \" (\" + str(\n",
         "        max(prediction_vals)) + \")\"\n",
         "\n",
-        "keyed_model_handler = KeyedModelHandler(VertexAIModelHandlerJSON(endpoint_id=endpoint_id, project=project, location=location))\n",
+        "keyed_model_handler = KeyedModelHandler(VertexAIModelHandlerJSON(endpoint_id=ENDPOINT_ID, project=PROJECT_ID, location=LOCATION_NAME))\n",
         "with beam.Pipeline() as p:\n",
         "    _ = (p | 'CreateExamples' >> beam.Create([IMG_URL])\n",
         "           | beam.Map(lambda img_name: (img_name, download_image(img_name)))\n",
diff --git a/examples/notebooks/beam-ml/run_inference_vllm.ipynb b/examples/notebooks/beam-ml/run_inference_vllm.ipynb
index 13b4a915c087..c4803eccebff 100644
--- a/examples/notebooks/beam-ml/run_inference_vllm.ipynb
+++ b/examples/notebooks/beam-ml/run_inference_vllm.ipynb
@@ -1,24 +1,12 @@
 {
-  "nbformat": 4,
-  "nbformat_minor": 0,
-  "metadata": {
-    "colab": {
-      "provenance": [],
-      "gpuType": "T4",
-      "toc_visible": true
-    },
-    "kernelspec": {
-      "name": "python3",
-      "display_name": "Python 3"
-    },
-    "language_info": {
-      "name": "python"
-    },
-    "accelerator": "GPU"
-  },
   "cells": [
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "OsFaZscKSPvo"
+      },
+      "outputs": [],
       "source": [
         "# @title ###### Licensed to the Apache Software Foundation (ASF), Version 2.0 (the \"License\")\n",
         "\n",
@@ -38,15 +26,13 @@
         "# KIND, either express or implied. See the License for the\n",
         "# specific language governing permissions and limitations\n",
         "# under the License"
-      ],
-      "metadata": {
-        "id": "OsFaZscKSPvo"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "NrHRIznKp3nS"
+      },
       "source": [
         "# Run ML inference by using vLLM on GPUs\n",
         "\n",
@@ -58,13 +44,13 @@
         "    <a target=\"_blank\" href=\"https://github.com/apache/beam/blob/master/examples/notebooks/beam-ml/run_inference_vllm.ipynb\"><img src=\"https://raw.githubusercontent.com/google/or-tools/main/tools/github_32px.png\" />View source on GitHub</a>\n",
         "  </td>\n",
         "</table>"
-      ],
-      "metadata": {
-        "id": "NrHRIznKp3nS"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "H0ZFs9rDvtJm"
+      },
       "source": [
         "[vLLM](https://github.com/vllm-project/vllm) is a fast and user-friendly library for LLM inference and serving. vLLM optimizes LLM inference with mechanisms like PagedAttention for memory management and continuous batching for increasing throughput. For popular models, vLLM has been shown to increase throughput by a multiple of 2 to 4. With Apache Beam, you can serve models with vLLM and scale that serving with just a few lines of code.\n",
         "\n",
@@ -75,13 +61,13 @@
         "* remotely with the Dataflow runner\n",
         "\n",
         "It also shows how to swap in a different model without modifying your pipeline structure by changing the configuration."
-      ],
-      "metadata": {
-        "id": "H0ZFs9rDvtJm"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "6x41tnbTvQM1"
+      },
       "source": [
         "## Requirements\n",
         "\n",
@@ -91,21 +77,18 @@
         "\n",
         "- a computer with Docker installed\n",
         "- a [Google Cloud](https://cloud.google.com/) account"
-      ],
-      "metadata": {
-        "id": "6x41tnbTvQM1"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "8PSjyDIavRcn"
+      },
       "source": [
         "## Install dependencies\n",
         "\n",
         "Before creating your pipeline, download and install the dependencies required to develop with Apache Beam and vLLM. vLLM is supported in Apache Beam versions 2.60.0 and later."
-      ],
-      "metadata": {
-        "id": "8PSjyDIavRcn"
-      }
+      ]
     },
     {
       "cell_type": "code",
@@ -123,30 +106,33 @@
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "3xz8zuA7vcS4"
+      },
       "source": [
         "## Run locally without Apache Beam\n",
         "\n",
         "In this section, you run a vLLM server without using Apache Beam. Use the `facebook/opt-125m` model. This model is small enough to fit in Colab memory and doesn't require any extra authentication.\n",
         "\n",
         "First, start the vLLM server. This step might take a minute or two, because the model needs to download before vLLM starts running inference."
-      ],
-      "metadata": {
-        "id": "3xz8zuA7vcS4"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "! python -m vllm.entrypoints.openai.api_server --model facebook/opt-125m"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "GbJGzINNt5sG"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "! python -m vllm.entrypoints.openai.api_server --model facebook/opt-125m"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "n35LXTS3uzIC"
+      },
       "source": [
         "Next, while the vLLM server is running, open a separate terminal to communicate with the vLLM serving process. To open a terminal in Colab, in the sidebar, click **Terminal**. In the terminal, run the following commands.\n",
         "\n",
@@ -169,26 +155,28 @@
         "```\n",
         "\n",
         "This code runs against the server running in the cell. You can experiment with different prompts."
-      ],
-      "metadata": {
-        "id": "n35LXTS3uzIC"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "Hbxi83BfwbBa"
+      },
       "source": [
         "## Run locally with Apache Beam\n",
         "\n",
         "In this section, you set up an Apache Beam pipeline to run a job with an embedded vLLM instance.\n",
         "\n",
         "First, define the `VllmCompletionsModelHandler` object. This configuration object gives Apache Beam the information that it needs to create a dedicated vLLM process in the middle of the pipeline. Apache Beam then provides examples to the pipeline. No additional code is needed."
-      ],
-      "metadata": {
-        "id": "Hbxi83BfwbBa"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "sUqjOzw3wpI4"
+      },
+      "outputs": [],
       "source": [
         "from apache_beam.ml.inference.base import RunInference\n",
         "from apache_beam.ml.inference.vllm_inference import VLLMCompletionsModelHandler\n",
@@ -196,24 +184,24 @@
         "import apache_beam as beam\n",
         "\n",
         "model_handler = VLLMCompletionsModelHandler('facebook/opt-125m')"
-      ],
-      "metadata": {
-        "id": "sUqjOzw3wpI4"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Next, define examples to run inference against, and define a helper function to print out the inference results."
-      ],
       "metadata": {
         "id": "N06lXRKRxCz5"
-      }
+      },
+      "source": [
+        "Next, define examples to run inference against, and define a helper function to print out the inference results."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "3a1PznmtxNR_"
+      },
+      "outputs": [],
       "source": [
         "class FormatOutput(beam.DoFn):\n",
         "  def process(self, element, *args, **kwargs):\n",
@@ -226,26 +214,26 @@
         "    \"The future of AI is\",\n",
         "    \"Emperor penguins are\",\n",
         "]"
-      ],
-      "metadata": {
-        "id": "3a1PznmtxNR_"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "Njl0QfrLxQ0m"
+      },
       "source": [
         "Finally, run the pipeline.\n",
         "\n",
         "This step might take a minute or two, because the model needs to download before Apache Beam can start running inference."
-      ],
-      "metadata": {
-        "id": "Njl0QfrLxQ0m"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "9yXbzV0ZmZcJ"
+      },
+      "outputs": [],
       "source": [
         "with beam.Pipeline() as p:\n",
         "  _ = (p | beam.Create(prompts) # Create a PCollection of the prompts.\n",
@@ -253,26 +241,24 @@
         "         | beam.ParDo(FormatOutput()) # Format the output.\n",
         "         | beam.Map(print) # Print the formatted output.\n",
         "  )"
-      ],
-      "metadata": {
-        "id": "9yXbzV0ZmZcJ"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "Jv7be6Pk9Hlx"
+      },
       "source": [
         "## Run remotely on Dataflow\n",
         "\n",
         "After you validate that the pipeline can run against a vLLM locally, you can productionalize the workflow on a remote runner. This notebook runs the pipeline on the Dataflow runner."
-      ],
-      "metadata": {
-        "id": "Jv7be6Pk9Hlx"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "J1LMrl1Yy6QB"
+      },
       "source": [
         "### Build a Docker image\n",
         "\n",
@@ -284,24 +270,26 @@
         "\n",
         "- The Python version in the following cell matches the Python version defined in the Dockerfile.\n",
         "- The Apache Beam version defined in your dependencies matches the Apache Beam version defined in the Dockerfile."
-      ],
-      "metadata": {
-        "id": "J1LMrl1Yy6QB"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "!python --version"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "jCQ6-D55gqfl"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "!python --version"
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "7QyNq_gygHLO"
+      },
+      "outputs": [],
       "source": [
         "cell_str='''\n",
         "FROM nvidia/cuda:12.4.1-devel-ubuntu22.04\n",
@@ -338,15 +326,13 @@
         "\n",
         "with open('VllmDockerfile', 'w') as f:\n",
         "  f.write(cell_str)"
-      ],
-      "metadata": {
-        "id": "7QyNq_gygHLO"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "zWma0YetiEn5"
+      },
       "source": [
         "After you save the Dockerfile, build and push your Docker image. Because Docker is not accessible from Colab, you need to complete this step in a separate environment.\n",
         "\n",
@@ -358,13 +344,13 @@
         "  docker build -t \"<REPOSITORY_NAME>:<TAG>\" -f VllmDockerfile ./\n",
         "  docker image push \"<REPOSITORY_NAME>:<TAG>\"\n",
         "  ```"
-      ],
-      "metadata": {
-        "id": "zWma0YetiEn5"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "NjZyRjte0g0Q"
+      },
       "source": [
         "### Define and run the pipeline\n",
         "\n",
@@ -378,13 +364,15 @@
         "- `<PROJECT_ID>`: the name of the Google Cloud project that you created your bucket and Artifact Registry repository in.\n",
         "\n",
         "This workflow uses the following Dataflow service option: `worker_accelerator=type:nvidia-tesla-t4;count:1;install-nvidia-driver:5xx`. When you use this service option, Dataflow to installs a T4 GPU that uses a `5xx` series Nvidia driver on each worker machine. The 5xx driver is required to run vLLM jobs."
-      ],
-      "metadata": {
-        "id": "NjZyRjte0g0Q"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "kXy9FRYVCSjq"
+      },
+      "outputs": [],
       "source": [
         "\n",
         "from apache_beam.options.pipeline_options import GoogleCloudOptions\n",
@@ -396,9 +384,12 @@
         "\n",
         "options = PipelineOptions()\n",
         "\n",
-        "BUCKET_NAME = '<BUCKET_NAME>' # Replace with your bucket name.\n",
-        "CONTAINER_IMAGE = '<REPOSITORY_NAME>:<TAG>'  # Replace with the image repository and tag from the previous step.\n",
-        "PROJECT_NAME = '<PROJECT_ID>' # Replace with your GCP project\n",
+        "# Replace with your bucket name.\n",
+        "BUCKET_NAME = '<BUCKET_NAME>' # @param {type:'string'}\n",
+        "# Replace with the image repository and tag from the previous step.\n",
+        "CONTAINER_IMAGE = '<REPOSITORY_NAME>:<TAG>'  # @param {type:'string'}\n",
+        "# Replace with your GCP project\n",
+        "PROJECT_NAME = '<PROJECT_ID>' # @param {type:'string'}\n",
         "\n",
         "options.view_as(GoogleCloudOptions).project = PROJECT_NAME\n",
         "\n",
@@ -430,50 +421,50 @@
         "options.view_as(WorkerOptions).machine_type = \"n1-standard-4\"\n",
         "\n",
         "options.view_as(WorkerOptions).sdk_container_image = CONTAINER_IMAGE"
-      ],
-      "metadata": {
-        "id": "kXy9FRYVCSjq"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Next, authenticate Colab so that it can to submit a job on your behalf."
-      ],
       "metadata": {
         "id": "xPhe597P1-QJ"
-      }
+      },
+      "source": [
+        "Next, authenticate Colab so that it can to submit a job on your behalf."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "Xkf6yIVlFB8-"
+      },
+      "outputs": [],
       "source": [
         "def auth_to_colab():\n",
         "  from google.colab import auth\n",
         "  auth.authenticate_user()\n",
         "\n",
         "auth_to_colab()"
-      ],
-      "metadata": {
-        "id": "Xkf6yIVlFB8-"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "MJtEI6Ux2eza"
+      },
       "source": [
         "Finally, run the pipeline on Dataflow. The pipeline definition is almost exactly the same as the definition used for local execution. The pipeline options are the only change to the pipeline.\n",
         "\n",
         "The following code creates a Dataflow job in your project. You can view the results in Colab or in the Google Cloud console. Creating a Dataflow job and downloading the model might take a few minutes. After the job starts performing inference, it quickly runs through the inputs."
-      ],
-      "metadata": {
-        "id": "MJtEI6Ux2eza"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "8gjDdru_9Dii"
+      },
+      "outputs": [],
       "source": [
         "import logging\n",
         "from apache_beam.ml.inference.base import RunInference\n",
@@ -503,15 +494,13 @@
         "         | beam.ParDo(FormatOutput()) # Format the output.\n",
         "         | beam.Map(logging.info) # Print the formatted output.\n",
         "  )"
-      ],
-      "metadata": {
-        "id": "8gjDdru_9Dii"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "22cEHPCc28fH"
+      },
       "source": [
         "## Run vLLM with a Gemma model\n",
         "\n",
@@ -526,55 +515,57 @@
         "When you complete these steps, the following message appears on the model card page: `You have been granted access to this model`.\n",
         "\n",
         "Next, sign in to your account from this notebook by running the following code and then following the prompts."
-      ],
-      "metadata": {
-        "id": "22cEHPCc28fH"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "! huggingface-cli login"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "JHwIsFI9kd9j"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "! huggingface-cli login"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "IjX2If8rnCol"
+      },
       "source": [
         "Verify that the notebook can now access the Gemma model. Run the following code, which starts a vLLM server to serve the Gemma 2b model. Because the default T4 Colab runtime doesn't support the full data type precision needed to run Gemma models, the `--dtype=half` parameter is required.\n",
         "\n",
         "When successful, the following cell runs indefinitely. After it starts the server process, you can shut it down. When the server process starts, the Gemma 2b model is successfully downloaded, and the server is ready to serve traffic."
-      ],
-      "metadata": {
-        "id": "IjX2If8rnCol"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "! python -m vllm.entrypoints.openai.api_server --model google/gemma-2b --dtype=half"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "LH_oCFWMiwFs"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "! python -m vllm.entrypoints.openai.api_server --model google/gemma-2b --dtype=half"
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "To run the pipeline in Apache Beam, run the following code. Update the `VLLMCompletionsModelHandler` object with the new parameters, which match the command from the previous cell. Reuse all of the pipeline logic from the previous pipelines."
-      ],
       "metadata": {
         "id": "31BmdDUAn-SW"
-      }
+      },
+      "source": [
+        "To run the pipeline in Apache Beam, run the following code. Update the `VLLMCompletionsModelHandler` object with the new parameters, which match the command from the previous cell. Reuse all of the pipeline logic from the previous pipelines."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "DyC2ikXg237p"
+      },
+      "outputs": [],
       "source": [
         "model_handler = VLLMCompletionsModelHandler('google/gemma-2b', vllm_server_kwargs={'dtype': 'half'})\n",
         "\n",
@@ -584,15 +575,13 @@
         "         | beam.ParDo(FormatOutput()) # Format the output.\n",
         "         | beam.Map(print) # Print the formatted output.\n",
         "  )"
-      ],
-      "metadata": {
-        "id": "DyC2ikXg237p"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "C6OYfub6ovFK"
+      },
       "source": [
         "### Run Gemma on Dataflow\n",
         "\n",
@@ -607,10 +596,24 @@
         "2.   Set pipeline options. You can reuse the options defined in this notebook. Replace the Docker image location with your new Docker image.\n",
         "3.   Run the pipeline. Copy the pipeline that you ran on Dataflow, and replace the pipeline options with the pipeline options that you just defined.\n",
         "\n"
-      ],
-      "metadata": {
-        "id": "C6OYfub6ovFK"
-      }
+      ]
+    }
+  ],
+  "metadata": {
+    "accelerator": "GPU",
+    "colab": {
+      "gpuType": "T4",
+      "provenance": [],
+      "toc_visible": true
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python"
     }
-  ]
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
 }
diff --git a/examples/notebooks/beam-ml/vertex_ai_feature_store_enrichment.ipynb b/examples/notebooks/beam-ml/vertex_ai_feature_store_enrichment.ipynb
index ebfcca34b94c..03feb96cbf68 100644
--- a/examples/notebooks/beam-ml/vertex_ai_feature_store_enrichment.ipynb
+++ b/examples/notebooks/beam-ml/vertex_ai_feature_store_enrichment.ipynb
@@ -197,8 +197,8 @@
       },
       "outputs": [],
       "source": [
-        "PROJECT_ID = \"<PROJECT_ID>\"\n",
-        "LOCATION = \"<LOCATION>\""
+        "PROJECT_ID = \"<PROJECT_ID>\" # @param {type:'string'}\n",
+        "LOCATION = \"<LOCATION>\" # @param {type:'string'}"
       ]
     },
     {
@@ -1790,10 +1790,10 @@
       "outputs": [],
       "source": [
         "# Replace <TOPIC_NAME> with the name of your Pub/Sub topic.\n",
-        "TOPIC = \"<TOPIC_NAME> \"\n",
+        "TOPIC = \"<TOPIC_NAME>\" # @param {type:'string'}\n",
         "\n",
         "# Replace <SUBSCRIPTION_NAME> with the subscription path for your topic.\n",
-        "SUBSCRIPTION = \"<SUBSCRIPTION_NAME>\""
+        "SUBSCRIPTION = \"<SUBSCRIPTION_NAME>\" # @param {type:'string'}"
       ]
     },
     {
diff --git a/examples/notebooks/healthcare/beam_nlp.ipynb b/examples/notebooks/healthcare/beam_nlp.ipynb
index c2061bc4d75f..bbcbb6254024 100644
--- a/examples/notebooks/healthcare/beam_nlp.ipynb
+++ b/examples/notebooks/healthcare/beam_nlp.ipynb
@@ -1,25 +1,10 @@
 {
-  "nbformat": 4,
-  "nbformat_minor": 0,
-  "metadata": {
-    "colab": {
-      "provenance": [],
-      "include_colab_link": true
-    },
-    "kernelspec": {
-      "name": "python3",
-      "display_name": "Python 3"
-    },
-    "language_info": {
-      "name": "python"
-    }
-  },
   "cells": [
     {
       "cell_type": "markdown",
       "metadata": {
-        "id": "view-in-github",
-        "colab_type": "text"
+        "colab_type": "text",
+        "id": "view-in-github"
       },
       "source": [
         "<a href=\"https://colab.research.google.com/github/apache/beam/blob/master/examples/notebooks/healthcare/beam_nlp.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>"
@@ -27,6 +12,12 @@
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "cellView": "form",
+        "id": "lBuUTzxD2mvJ"
+      },
+      "outputs": [],
       "source": [
         "# @title ###### Licensed to the Apache Software Foundation (ASF), Version 2.0 (the \"License\")\n",
         "\n",
@@ -46,16 +37,13 @@
         "# KIND, either express or implied. See the License for the\n",
         "# specific language governing permissions and limitations\n",
         "# under the License"
-      ],
-      "metadata": {
-        "id": "lBuUTzxD2mvJ",
-        "cellView": "form"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "nEUAYCTx4Ijj"
+      },
       "source": [
         "# **Natural Language Processing Pipeline**\n",
         "\n",
@@ -70,101 +58,103 @@
         "For details about Apache Beam pipelines, including PTransforms and PCollections, visit the [Beam Programming Guide](https://beam.apache.org/documentation/programming-guide/).\n",
         "\n",
         "You'll be able to use this notebook to explore the data in each PCollection."
-      ],
-      "metadata": {
-        "id": "nEUAYCTx4Ijj"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "First, lets install the necessary packages."
-      ],
       "metadata": {
         "id": "ZLBB0PTG5CHw"
-      }
+      },
+      "source": [
+        "First, lets install the necessary packages."
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "!pip install apache-beam[gcp]"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "O7hq2sse8K4u"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "!pip install apache-beam[gcp]"
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        " **GCP Setup**"
-      ],
       "metadata": {
         "id": "5vQDhIv0E-LR"
-      }
+      },
+      "source": [
+        " **GCP Setup**"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "DGYiBYfxsSCw"
+      },
       "source": [
         "1. Authenticate your notebook by `gcloud auth application-default login` in the Colab terminal.\n",
         "\n",
         "2. Run `gcloud config set project <YOUR-PROJECT>`"
-      ],
-      "metadata": {
-        "id": "DGYiBYfxsSCw"
-      }
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "D7lJqW2PRFcN"
+      },
       "source": [
         "Set the variables in the next cell based upon your project and preferences. The files referred to in this notebook nlpsample*.csv are in the format with one\n",
         "blurb of clinical note.\n",
         "\n",
         "Note that below, **us-central1** is hardcoded as the location. This is because of the limited number of [locations](https://cloud.google.com/healthcare-api/docs/how-tos/nlp) the API currently supports."
-      ],
-      "metadata": {
-        "id": "D7lJqW2PRFcN"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "s9lhe5CZ5F3o"
+      },
+      "outputs": [],
       "source": [
-        "DATASET=\"<YOUR-BQ-DATASEST>\"\n",
-        "TEMP_LOCATION=\"<YOUR-TEMP-LOCATION>\"\n",
-        "PROJECT='<YOUR-PROJECT>'\n",
+        "DATASET=\"<YOUR-BQ-DATASEST>\" # @param {type:'string'}\n",
+        "TEMP_LOCATION=\"<YOUR-TEMP-LOCATION>\" # @param {type:'string'}\n",
+        "PROJECT='<YOUR-PROJECT>'# @param {type:'string'}\n",
         "LOCATION='us-central1'\n",
         "URL=f'https://healthcare.googleapis.com/v1/projects/{PROJECT}/locations/{LOCATION}/services/nlp:analyzeEntities'\n",
         "NLP_SERVICE=f'projects/{PROJECT}/locations/{LOCATION}/services/nlp'"
-      ],
-      "metadata": {
-        "id": "s9lhe5CZ5F3o"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "Then, download [this raw CSV file](https://github.com/socd06/medical-nlp/blob/master/data/test.csv), and then upload it into Colab. You should be able to view this file (*test.csv*) in the \"Files\" tab in Colab after uploading."
-      ],
       "metadata": {
         "id": "1IArtEm8QuCR"
-      }
+      },
+      "source": [
+        "Then, download [this raw CSV file](https://github.com/socd06/medical-nlp/blob/master/data/test.csv), and then upload it into Colab. You should be able to view this file (*test.csv*) in the \"Files\" tab in Colab after uploading."
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "DI_Qkyn75LO-"
+      },
       "source": [
         "**BigQuery Setup**\n",
         "\n",
         "We will be using BigQuery to warehouse the structured data revealed in the output of the Healthcare NLP API. For this purpose, we create 3 tables to organize the data. Specifically, these will be table entities, table relations, and table entity mentions, which are all outputs of interest from the Healthcare NLP API."
-      ],
-      "metadata": {
-        "id": "DI_Qkyn75LO-"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "bZDqtFVE5Wd_"
+      },
+      "outputs": [],
       "source": [
         "from google.cloud import bigquery\n",
         "\n",
@@ -198,15 +188,15 @@
         "print(\n",
         "    \"Created table {}.{}.{}\".format(table.project, table.dataset_id, table.table_id)\n",
         ")"
-      ],
-      "metadata": {
-        "id": "bZDqtFVE5Wd_"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "YK-G7uV5APuP"
+      },
+      "outputs": [],
       "source": [
         "from google.cloud import bigquery\n",
         "\n",
@@ -240,15 +230,15 @@
         ")\n",
         "\n",
         "\n"
-      ],
-      "metadata": {
-        "id": "YK-G7uV5APuP"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "R9IHgZKoAQWj"
+      },
+      "outputs": [],
       "source": [
         "from google.cloud import bigquery\n",
         "\n",
@@ -324,26 +314,26 @@
         "print(\n",
         "    \"Created table {}.{}.{}\".format(table.project, table.dataset_id, table.table_id)\n",
         ")"
-      ],
-      "metadata": {
-        "id": "R9IHgZKoAQWj"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "jc_iS_BP5aS4"
+      },
       "source": [
         "**Pipeline Setup**\n",
         "\n",
         "We will use InteractiveRunner in this notebook."
-      ],
-      "metadata": {
-        "id": "jc_iS_BP5aS4"
-      }
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "07ct6kf55ihP"
+      },
+      "outputs": [],
       "source": [
         "# Python's regular expression library\n",
         "import re\n",
@@ -365,24 +355,24 @@
         "    job_name=\"my-healthcare-nlp-job\",\n",
         "    temp_location=TEMP_LOCATION,\n",
         "    region=LOCATION)"
-      ],
-      "metadata": {
-        "id": "07ct6kf55ihP"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "The following defines a `PTransform` named `ReadLinesFromText`, that extracts lines from a file."
-      ],
       "metadata": {
         "id": "dO1A9_WK5lb4"
-      }
+      },
+      "source": [
+        "The following defines a `PTransform` named `ReadLinesFromText`, that extracts lines from a file."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "t5iDRKMK5n_B"
+      },
+      "outputs": [],
       "source": [
         "class ReadLinesFromText(beam.PTransform):\n",
         "\n",
@@ -392,74 +382,73 @@
         "    def expand(self, pcoll):\n",
         "        return (pcoll.pipeline\n",
         "                | beam.io.ReadFromText(self._file_pattern))"
-      ],
-      "metadata": {
-        "id": "t5iDRKMK5n_B"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "The following sets up an Apache Beam pipeline with the *Interactive Runner*. The *Interactive Runner* is the runner suitable for running in notebooks. A runner is an execution engine for Apache Beam pipelines."
-      ],
       "metadata": {
         "id": "HI_HVB185sMQ"
-      }
+      },
+      "source": [
+        "The following sets up an Apache Beam pipeline with the *Interactive Runner*. The *Interactive Runner* is the runner suitable for running in notebooks. A runner is an execution engine for Apache Beam pipelines."
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "p = beam.Pipeline(options = options)"
-      ],
+      "execution_count": null,
       "metadata": {
         "id": "7osCZ1om5ql0"
       },
-      "execution_count": null,
-      "outputs": []
+      "outputs": [],
+      "source": [
+        "p = beam.Pipeline(options = options)"
+      ]
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "EaF8NfC_521y"
+      },
       "source": [
         "The following sets up a PTransform that extracts words from a Google Cloud Storage file that contains lines with each line containing a In our example, each line is a medical notes excerpt that will be passed through the Healthcare NLP API\n",
         "\n",
         "**\"|\"** is an overloaded operator that applies a PTransform to a PCollection to produce a new PCollection. Together with |, >> allows you to optionally name a PTransform.\n",
         "\n",
         "Usage:[PCollection] | [PTransform], **or** [PCollection] | [name] >> [PTransform]"
-      ],
-      "metadata": {
-        "id": "EaF8NfC_521y"
-      }
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "lines = p | 'read' >> ReadLinesFromText(\"test.csv\")"
-      ],
+      "execution_count": null,
       "metadata": {
-        "id": "2APAh6XQ6NYd",
         "colab": {
           "base_uri": "https://localhost:8080/",
           "height": 72
         },
+        "id": "2APAh6XQ6NYd",
         "outputId": "033c5110-fd5a-4da0-b59b-801a1ce9d3b1"
       },
-      "execution_count": null,
-      "outputs": [
+      "outputs": [],
+      "source": [
+        "lines = p | 'read' >> ReadLinesFromText(\"test.csv\")"
       ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "We then write a **DoFn** that will invoke the [NLP API](https://cloud.google.com/healthcare-api/docs/how-tos/nlp)."
-      ],
       "metadata": {
         "id": "vM_FbhkbGI-E"
-      }
+      },
+      "source": [
+        "We then write a **DoFn** that will invoke the [NLP API](https://cloud.google.com/healthcare-api/docs/how-tos/nlp)."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "3ZJ-0dex9WE5"
+      },
+      "outputs": [],
       "source": [
         "class InvokeNLP(beam.DoFn):\n",
         "\n",
@@ -486,24 +475,24 @@
         "            pcoll\n",
         "            | \"Invoke NLP API\" >> beam.ParDo(InvokeNLP())\n",
         "        )"
-      ],
-      "metadata": {
-        "id": "3ZJ-0dex9WE5"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "From our elements, being processed, we will get the entity mentions, relationships, and entities respectively."
-      ],
       "metadata": {
         "id": "TeYxIlNgGdK0"
-      }
+      },
+      "source": [
+        "From our elements, being processed, we will get the entity mentions, relationships, and entities respectively."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "3KZgUv3d6haf"
+      },
+      "outputs": [],
       "source": [
         "import json\n",
         "from apache_beam import pvalue\n",
@@ -529,15 +518,15 @@
         "        for e in element['entityMentions']:\n",
         "            e['id'] = element['id']\n",
         "            yield e\n"
-      ],
-      "metadata": {
-        "id": "3KZgUv3d6haf"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "OkxgB2a-6iYN"
+      },
+      "outputs": [],
       "source": [
         "from apache_beam.io.gcp.internal.clients import bigquery\n",
         "\n",
@@ -550,24 +539,24 @@
         "nlp_annotations = (lines\n",
         "                | \"Analyze\" >> AnalyzeLines()\n",
         "                  )\n"
-      ],
-      "metadata": {
-        "id": "OkxgB2a-6iYN"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "We then write these results to [BigQuery](https://cloud.google.com/bigquery), a cloud data warehouse."
-      ],
       "metadata": {
         "id": "iTh65CXIGoQn"
-      }
+      },
+      "source": [
+        "We then write these results to [BigQuery](https://cloud.google.com/bigquery), a cloud data warehouse."
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "Q9GIyLeS6oAe"
+      },
+      "outputs": [],
       "source": [
         "resultsEntities = ( nlp_annotations\n",
         "                | \"Break\" >> beam.ParDo(breakUpEntities())\n",
@@ -576,15 +565,15 @@
         "                    write_disposition=beam.io.BigQueryDisposition.WRITE_APPEND,\n",
         "                    create_disposition=beam.io.BigQueryDisposition.CREATE_NEVER)\n",
         "                  )"
-      ],
-      "metadata": {
-        "id": "Q9GIyLeS6oAe"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "yOlHfkcT6s4y"
+      },
+      "outputs": [],
       "source": [
         "table_spec = bigquery.TableReference(\n",
         "    projectId=PROJECT,\n",
@@ -598,15 +587,15 @@
         "                    write_disposition=beam.io.BigQueryDisposition.WRITE_APPEND,\n",
         "                    create_disposition=beam.io.BigQueryDisposition.CREATE_NEVER)\n",
         "                  )"
-      ],
-      "metadata": {
-        "id": "yOlHfkcT6s4y"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "a6QxxnY890Za"
+      },
+      "outputs": [],
       "source": [
         "table_spec = bigquery.TableReference(\n",
         "    projectId=PROJECT,\n",
@@ -620,43 +609,31 @@
         "                    write_disposition=beam.io.BigQueryDisposition.WRITE_APPEND,\n",
         "                    create_disposition=beam.io.BigQueryDisposition.CREATE_NEVER)\n",
         "                  )"
-      ],
-      "metadata": {
-        "id": "a6QxxnY890Za"
-      },
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",
-      "source": [
-        "You can see the job graph for the pipeline by doing:"
-      ],
       "metadata": {
         "id": "6rP2nO6Z60bt"
-      }
+      },
+      "source": [
+        "You can see the job graph for the pipeline by doing:"
+      ]
     },
     {
       "cell_type": "code",
-      "source": [
-        "ib.show_graph(p)"
-      ],
+      "execution_count": null,
       "metadata": {
-        "id": "zQB5h1Zq6x8d",
         "colab": {
           "base_uri": "https://localhost:8080/",
           "height": 806
         },
+        "id": "zQB5h1Zq6x8d",
         "outputId": "7885e493-fee8-402e-baf2-cbbf406a3eb9"
       },
-      "execution_count": null,
       "outputs": [
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "\n",
               "            <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">\n",
@@ -665,16 +642,16 @@
               "              <span class=\"text-info\">Processing... show_graph</span>\n",
               "            </div>\n",
               "            "
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "text/plain": [
-              "<IPython.core.display.HTML object>"
-            ],
             "text/html": [
               "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?>\n",
               "<!DOCTYPE svg PUBLIC \"-//W3C//DTD SVG 1.1//EN\"\n",
@@ -836,44 +813,40 @@
               "</g>\n",
               "</g>\n",
               "</svg>\n"
+            ],
+            "text/plain": [
+              "<IPython.core.display.HTML object>"
             ]
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         },
         {
-          "output_type": "display_data",
           "data": {
-            "application/javascript": [
-              "\n",
-              "        if (typeof window.interactive_beam_jquery == 'undefined') {\n",
-              "          var jqueryScript = document.createElement('script');\n",
-              "          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n",
-              "          jqueryScript.type = 'text/javascript';\n",
-              "          jqueryScript.onload = function() {\n",
-              "            var datatableScript = document.createElement('script');\n",
-              "            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n",
-              "            datatableScript.type = 'text/javascript';\n",
-              "            datatableScript.onload = function() {\n",
-              "              window.interactive_beam_jquery = jQuery.noConflict(true);\n",
-              "              window.interactive_beam_jquery(document).ready(function($){\n",
-              "                \n",
-              "            $(\"#progress_indicator_fa6997b180fa86966dd888a7d59a34f7\").remove();\n",
-              "              });\n",
-              "            }\n",
-              "            document.head.appendChild(datatableScript);\n",
-              "          };\n",
-              "          document.head.appendChild(jqueryScript);\n",
-              "        } else {\n",
-              "          window.interactive_beam_jquery(document).ready(function($){\n",
-              "            \n",
-              "            $(\"#progress_indicator_fa6997b180fa86966dd888a7d59a34f7\").remove();\n",
-              "          });\n",
-              "        }"
-            ]
+            "application/javascript": "\n        if (typeof window.interactive_beam_jquery == 'undefined') {\n          var jqueryScript = document.createElement('script');\n          jqueryScript.src = 'https://code.jquery.com/jquery-3.4.1.slim.min.js';\n          jqueryScript.type = 'text/javascript';\n          jqueryScript.onload = function() {\n            var datatableScript = document.createElement('script');\n            datatableScript.src = 'https://cdn.datatables.net/1.10.20/js/jquery.dataTables.min.js';\n            datatableScript.type = 'text/javascript';\n            datatableScript.onload = function() {\n              window.interactive_beam_jquery = jQuery.noConflict(true);\n              window.interactive_beam_jquery(document).ready(function($){\n                \n            $(\"#progress_indicator_fa6997b180fa86966dd888a7d59a34f7\").remove();\n              });\n            }\n            document.head.appendChild(datatableScript);\n          };\n          document.head.appendChild(jqueryScript);\n        } else {\n          window.interactive_beam_jquery(document).ready(function($){\n            \n            $(\"#progress_indicator_fa6997b180fa86966dd888a7d59a34f7\").remove();\n          });\n        }"
           },
-          "metadata": {}
+          "metadata": {},
+          "output_type": "display_data"
         }
+      ],
+      "source": [
+        "ib.show_graph(p)"
       ]
     }
-  ]
+  ],
+  "metadata": {
+    "colab": {
+      "include_colab_link": true,
+      "provenance": []
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
 }

From 4073aba0ca8237441041dd910190c08d3f617c88 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 22 Nov 2024 12:57:27 -0500
Subject: [PATCH 002/135] Bump org.sonarqube from 3.0 to 6.0.0.5145 (#33174)

Bumps org.sonarqube from 3.0 to 6.0.0.5145.

---
updated-dependencies:
- dependency-name: org.sonarqube
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 build.gradle.kts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build.gradle.kts b/build.gradle.kts
index d96e77a4c78c..cd2309c73bb4 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -23,7 +23,7 @@ plugins {
   // Enable gradle-based release management
   id("net.researchgate.release") version "2.8.1"
   id("org.apache.beam.module")
-  id("org.sonarqube") version "3.0"
+  id("org.sonarqube") version "6.0.0.5145"
 }
 
 /*************************************************************************************************/

From b70375db84a7ff04a6be3aea8d5ae30f4d7cdbe1 Mon Sep 17 00:00:00 2001
From: Danny McCormick <dannymccormick@google.com>
Date: Fri, 22 Nov 2024 13:09:58 -0500
Subject: [PATCH 003/135] Revert "Bump org.sonarqube from 3.0 to 6.0.0.5145
 (#33174)" (#33193)

This reverts commit 4073aba0ca8237441041dd910190c08d3f617c88.
---
 build.gradle.kts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build.gradle.kts b/build.gradle.kts
index cd2309c73bb4..d96e77a4c78c 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -23,7 +23,7 @@ plugins {
   // Enable gradle-based release management
   id("net.researchgate.release") version "2.8.1"
   id("org.apache.beam.module")
-  id("org.sonarqube") version "6.0.0.5145"
+  id("org.sonarqube") version "3.0"
 }
 
 /*************************************************************************************************/

From d342dd3755c5a55d697bb9fa05b70f5c426bb000 Mon Sep 17 00:00:00 2001
From: liferoad <huxiangqian@gmail.com>
Date: Fri, 22 Nov 2024 14:55:38 -0500
Subject: [PATCH 004/135] Remove the default machine types (#33191)

From https://github.com/apache/beam/issues/30507#issuecomment-2494385957, try to use the default machine types for Flink with more memory.
---
 .test-infra/dataproc/flink_cluster.sh | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/.test-infra/dataproc/flink_cluster.sh b/.test-infra/dataproc/flink_cluster.sh
index 759d7a6fcc38..aeb5ec19441f 100755
--- a/.test-infra/dataproc/flink_cluster.sh
+++ b/.test-infra/dataproc/flink_cluster.sh
@@ -131,10 +131,8 @@ function create_cluster() {
 
   # Docker init action restarts yarn so we need to start yarn session after this restart happens.
   # This is why flink init action is invoked last.
-  # TODO(11/11/2022) remove --worker-machine-type and --master-machine-type once N2 CPUs quota relaxed
-  # Dataproc 2.1 uses n2-standard-2 by default but there is N2 CPUs=24 quota limit
   gcloud dataproc clusters create $CLUSTER_NAME --region=$GCLOUD_REGION --num-workers=$FLINK_NUM_WORKERS --public-ip-address \
-  --master-machine-type=n1-standard-2 --worker-machine-type=n1-standard-2 --metadata "${metadata}", \
+  --metadata "${metadata}", \
   --image-version=$image_version --zone=$GCLOUD_ZONE  --optional-components=FLINK,DOCKER  --quiet
 }
 

From 09c1c9e9f23ed39b75885b68955960e44bee23de Mon Sep 17 00:00:00 2001
From: Damon <damondouglas@users.noreply.github.com>
Date: Fri, 22 Nov 2024 16:19:19 -0800
Subject: [PATCH 005/135] Enable Java SDK Distroless container image variants.
 (#33173)

* Enable Java SDK Distroless container image variant

* Add LANG environment and /usr/lib/locale

* Use examples tests instead
---
 .../trigger_files/beam_PostCommit_Java.json   |  5 +-
 .../beam_PostCommit_Java_DataflowV2.json      |  2 +-
 .../google-cloud-dataflow-java/build.gradle   | 63 +++++++++++++++++++
 sdks/java/container/Dockerfile-distroless     | 42 +++++++++++++
 4 files changed, 110 insertions(+), 2 deletions(-)
 create mode 100644 sdks/java/container/Dockerfile-distroless

diff --git a/.github/trigger_files/beam_PostCommit_Java.json b/.github/trigger_files/beam_PostCommit_Java.json
index 9e26dfeeb6e6..920c8d132e4a 100644
--- a/.github/trigger_files/beam_PostCommit_Java.json
+++ b/.github/trigger_files/beam_PostCommit_Java.json
@@ -1 +1,4 @@
-{}
\ No newline at end of file
+{
+  "comment": "Modify this file in a trivial way to cause this test suite to run",
+  "modification": 1
+}
\ No newline at end of file
diff --git a/.github/trigger_files/beam_PostCommit_Java_DataflowV2.json b/.github/trigger_files/beam_PostCommit_Java_DataflowV2.json
index 1efc8e9e4405..3f63c0c9975f 100644
--- a/.github/trigger_files/beam_PostCommit_Java_DataflowV2.json
+++ b/.github/trigger_files/beam_PostCommit_Java_DataflowV2.json
@@ -1,4 +1,4 @@
 {
     "comment": "Modify this file in a trivial way to cause this test suite to run",
-    "modification": 1
+    "modification": 2
 }
diff --git a/runners/google-cloud-dataflow-java/build.gradle b/runners/google-cloud-dataflow-java/build.gradle
index 4906d9cf9cb8..3a337684bf18 100644
--- a/runners/google-cloud-dataflow-java/build.gradle
+++ b/runners/google-cloud-dataflow-java/build.gradle
@@ -273,6 +273,69 @@ def createRunnerV2ValidatesRunnerTest = { Map args ->
   }
 }
 
+tasks.register('examplesJavaRunnerV2IntegrationTestDistroless', Test.class) {
+  group = "verification"
+  dependsOn 'buildAndPushDistrolessContainerImage'
+  def javaVer = project.findProperty('testJavaVersion')
+  def repository = "us.gcr.io/apache-beam-testing/${System.getenv('USER')}"
+  def tag = project.findProperty('dockerTag')
+  def imageURL = "${repository}/beam_${javaVer}_sdk_distroless:${tag}"
+  def pipelineOptions = [
+          "--runner=TestDataflowRunner",
+          "--project=${gcpProject}",
+          "--region=${gcpRegion}",
+          "--tempRoot=${dataflowValidatesTempRoot}",
+          "--sdkContainerImage=${imageURL}",
+          "--experiments=use_unified_worker,use_runner_v2",
+          "--firestoreDb=${firestoreDb}",
+  ]
+  systemProperty "beamTestPipelineOptions", JsonOutput.toJson(pipelineOptions)
+
+  include '**/*IT.class'
+
+  maxParallelForks 4
+  classpath = configurations.examplesJavaIntegrationTest
+  testClassesDirs = files(project(":examples:java").sourceSets.test.output.classesDirs)
+  useJUnit { }
+}
+
+tasks.register('buildAndPushDistrolessContainerImage', Task.class) {
+  // Only Java 17 and 21 are supported.
+  // See https://github.com/GoogleContainerTools/distroless/tree/main/java#image-contents.
+  def allowed = ["java17", "java21"]
+  doLast {
+    def javaVer = project.findProperty('testJavaVersion')
+    if (!allowed.contains(javaVer)) {
+      throw new GradleException("testJavaVersion must be one of ${allowed}, got: ${javaVer}")
+    }
+    if (!project.hasProperty('dockerTag')) {
+      throw new GradleException("dockerTag is missing but required")
+    }
+    def repository = "us.gcr.io/apache-beam-testing/${System.getenv('USER')}"
+    def tag = project.findProperty('dockerTag')
+    def imageURL = "${repository}/beam_${javaVer}_sdk_distroless:${tag}"
+    exec {
+      executable 'docker'
+      workingDir rootDir
+      args = [
+              'buildx',
+              'build',
+              '-t',
+              imageURL,
+              '-f',
+              'sdks/java/container/Dockerfile-distroless',
+              "--build-arg=BEAM_BASE=gcr.io/apache-beam-testing/beam-sdk/beam_${javaVer}_sdk",
+              "--build-arg=DISTROLESS_BASE=gcr.io/distroless/${javaVer}-debian12",
+              '.'
+      ]
+    }
+    exec {
+      executable 'docker'
+      args = ['push', imageURL]
+    }
+  }
+}
+
 // Push docker images to a container registry for use within tests.
 // NB: Tasks which consume docker images from the registry should depend on this
 // task directly ('dependsOn buildAndPushDockerJavaContainer'). This ensures the correct
diff --git a/sdks/java/container/Dockerfile-distroless b/sdks/java/container/Dockerfile-distroless
new file mode 100644
index 000000000000..328c4dc6a7b3
--- /dev/null
+++ b/sdks/java/container/Dockerfile-distroless
@@ -0,0 +1,42 @@
+###############################################################################
+#  Licensed to the Apache Software Foundation (ASF) under one
+#  or more contributor license agreements.  See the NOTICE file
+#  distributed with this work for additional information
+#  regarding copyright ownership.  The ASF licenses this file
+#  to you under the Apache License, Version 2.0 (the
+#  "License"); you may not use this file except in compliance
+#  with the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+# limitations under the License.
+###############################################################################
+
+# ARG BEAM_BASE is the Beam SDK container image built using sdks/python/container/Dockerfile.
+ARG BEAM_BASE
+
+# ARG DISTROLESS_BASE is the distroless container image URL. For available distroless Java images,
+#   see https://github.com/GoogleContainerTools/distroless/tree/main?tab=readme-ov-file#what-images-are-available.
+#   Only Java versions 17 and 21 are supported.
+ARG DISTROLESS_BASE
+FROM ${BEAM_BASE} AS base
+ARG TARGETARCH
+ENV LANG C.UTF-8
+
+LABEL Author="Apache Beam <dev@beam.apache.org>"
+
+RUN if [ -z "${TARGETARCH}" ]; then echo "fatal: TARGETARCH not set; run as docker buildx build or use --build-arg=TARGETARCH=amd64|arm64" >&2; exit 1; fi
+
+FROM ${DISTROLESS_BASE}:latest-${TARGETARCH} AS distroless
+
+COPY --from=base /opt /opt
+
+# Along with the LANG environment variable above, prevents internally discovered failing bugs related to Dataflow Flex
+# template character encodings.
+COPY --from=base /usr/lib/locale /usr/lib/locale
+
+ENTRYPOINT ["/opt/apache/beam/boot"]

From e5bd69db5bf9258021bb6c7a80e84441f0159c2c Mon Sep 17 00:00:00 2001
From: Yi Hu <yathu@google.com>
Date: Sat, 23 Nov 2024 21:32:32 -0500
Subject: [PATCH 006/135] Remove leftover print statement in SpannerIO (#33200)

---
 .../java/org/apache/beam/sdk/io/gcp/spanner/ReadOperation.java   | 1 -
 1 file changed, 1 deletion(-)

diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/spanner/ReadOperation.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/spanner/ReadOperation.java
index 2b9f24f09541..933394982e30 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/spanner/ReadOperation.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/spanner/ReadOperation.java
@@ -135,7 +135,6 @@ String tryGetTableName() {
       return getTable();
     } else if (getQuery() != null) {
       String query = getQuery().getSql();
-      System.err.println(query);
       Matcher matcher = queryPattern.matcher(query);
       if (matcher.find()) {
         return matcher.group("table");

From 60f87930a70b50f4978dc8abe7dd4724ad9d383e Mon Sep 17 00:00:00 2001
From: liferoad <huxiangqian@gmail.com>
Date: Mon, 25 Nov 2024 09:43:44 -0500
Subject: [PATCH 007/135] Use --enable-component-gateway when creating the
 flink cluster (#33198)

* Use --enable-component-gateway when creating the flink cluster

* Update flink_cluster.sh
---
 .test-infra/dataproc/flink_cluster.sh | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/.test-infra/dataproc/flink_cluster.sh b/.test-infra/dataproc/flink_cluster.sh
index aeb5ec19441f..24d51ac13bde 100755
--- a/.test-infra/dataproc/flink_cluster.sh
+++ b/.test-infra/dataproc/flink_cluster.sh
@@ -131,8 +131,10 @@ function create_cluster() {
 
   # Docker init action restarts yarn so we need to start yarn session after this restart happens.
   # This is why flink init action is invoked last.
-  gcloud dataproc clusters create $CLUSTER_NAME --region=$GCLOUD_REGION --num-workers=$FLINK_NUM_WORKERS --public-ip-address \
-  --metadata "${metadata}", \
+  # TODO(11/22/2024) remove --worker-machine-type and --master-machine-type once N2 CPUs quota relaxed
+  # Dataproc 2.1 uses n2-standard-2 by default but there is N2 CPUs=24 quota limit for this project
+  gcloud dataproc clusters create $CLUSTER_NAME --enable-component-gateway --region=$GCLOUD_REGION --num-workers=$FLINK_NUM_WORKERS --public-ip-address \
+  --master-machine-type=n1-standard-2 --worker-machine-type=n1-standard-2 --metadata "${metadata}", \
   --image-version=$image_version --zone=$GCLOUD_ZONE  --optional-components=FLINK,DOCKER  --quiet
 }
 

From 78630d15445fdf54935d6ba99c2fd9d0930b6af8 Mon Sep 17 00:00:00 2001
From: liferoad <huxiangqian@gmail.com>
Date: Mon, 25 Nov 2024 09:45:14 -0500
Subject: [PATCH 008/135] Add a new precommit workflow to test flink container
 (#33206)

* Add a new precommit to test finl container

* Changed trigger file for Flink container workflow

* updated the timeout

* only allow maual trigger to test

* fixed the PR check

* fixed the workflow checks
---
 .../beam_PreCommit_Flink_Container.json       |   4 +
 .../beam_PreCommit_Flink_Container.yml        | 155 ++++++++++++++++++
 2 files changed, 159 insertions(+)
 create mode 100644 .github/trigger_files/beam_PreCommit_Flink_Container.json
 create mode 100644 .github/workflows/beam_PreCommit_Flink_Container.yml

diff --git a/.github/trigger_files/beam_PreCommit_Flink_Container.json b/.github/trigger_files/beam_PreCommit_Flink_Container.json
new file mode 100644
index 000000000000..b75e2800330d
--- /dev/null
+++ b/.github/trigger_files/beam_PreCommit_Flink_Container.json
@@ -0,0 +1,4 @@
+{
+    "https://github.com/apache/beam/pull/33206": "testing the new flink container workflow"
+}
+  
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Flink_Container.yml b/.github/workflows/beam_PreCommit_Flink_Container.yml
new file mode 100644
index 000000000000..7b82469d2b81
--- /dev/null
+++ b/.github/workflows/beam_PreCommit_Flink_Container.yml
@@ -0,0 +1,155 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: PreCommit Flink Container
+
+on:
+  pull_request_target:
+    paths:
+      - '.github/trigger_files/beam_PreCommit_Flink_Container.json'
+      - 'release/trigger_all_tests.json'
+  workflow_dispatch:
+
+# Setting explicit permissions for the action to avoid the default permissions which are `write-all`
+permissions:
+  actions: write
+  pull-requests: read
+  checks: read
+  contents: read
+  deployments: read
+  id-token: none
+  issues: read
+  discussions: read
+  packages: read
+  pages: read
+  repository-projects: read
+  security-events: read
+  statuses: read
+
+# This allows a subsequently queued workflow run to interrupt previous runs
+concurrency:
+  group: '${{ github.workflow }} @ ${{ github.event.issue.number || github.sha || github.head_ref || github.ref }}'
+  cancel-in-progress: true
+
+env:
+  DEVELOCITY_ACCESS_KEY: ${{ secrets.GE_ACCESS_TOKEN }}
+  GRADLE_ENTERPRISE_CACHE_USERNAME: ${{ secrets.GE_CACHE_USERNAME }}
+  GRADLE_ENTERPRISE_CACHE_PASSWORD: ${{ secrets.GE_CACHE_PASSWORD }}
+  INFLUXDB_USER: ${{ secrets.INFLUXDB_USER }}
+  INFLUXDB_USER_PASSWORD: ${{ secrets.INFLUXDB_USER_PASSWORD }}
+  GCLOUD_ZONE: us-central1-a
+  CLUSTER_NAME: beam-precommit-flink-container-${{ github.run_id }}
+  GCS_BUCKET: gs://beam-flink-cluster
+  FLINK_DOWNLOAD_URL: https://archive.apache.org/dist/flink/flink-1.17.0/flink-1.17.0-bin-scala_2.12.tgz
+  HADOOP_DOWNLOAD_URL: https://repo.maven.apache.org/maven2/org/apache/flink/flink-shaded-hadoop-2-uber/2.8.3-10.0/flink-shaded-hadoop-2-uber-2.8.3-10.0.jar
+  FLINK_TASKMANAGER_SLOTS: 1
+  DETACHED_MODE: true
+  HARNESS_IMAGES_TO_PULL: gcr.io/apache-beam-testing/beam-sdk/beam_go_sdk:latest
+  JOB_SERVER_IMAGE: gcr.io/apache-beam-testing/beam_portability/beam_flink1.17_job_server:latest
+  ARTIFACTS_DIR: gs://beam-flink-cluster/beam-precommit-flink-container-${{ github.run_id }}
+
+jobs:
+  beam_PreCommit_Flink_Container:
+    if: |
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'push' ||
+      github.event_name == 'schedule' ||
+      (github.event_name == 'pull_request_target' && 
+       github.base_ref == 'master' && 
+       github.event.pull_request.draft == false) ||
+      github.event.comment.body == 'Run Flink Container PreCommit'
+    runs-on: [self-hosted, ubuntu-20.04, main]
+    timeout-minutes: 45
+    name: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
+    strategy:
+      matrix:
+        job_name: ["beam_PreCommit_Flink_Container"]
+        job_phrase: ["Run Flink Container PreCommit"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup repository
+        uses: ./.github/actions/setup-action
+        with:
+          comment_phrase: ${{ matrix.job_phrase }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          github_job: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
+      - name: Start Flink with parallelism 1
+        env:
+          FLINK_NUM_WORKERS: 1
+        run: |
+          cd ${{ github.workspace }}/.test-infra/dataproc; ./flink_cluster.sh create
+      # Run a simple Go Combine load test to verify the Flink container
+      - name: Run Flink Container Test with Go Combine
+        timeout-minutes: 10
+        uses: ./.github/actions/gradle-command-self-hosted-action
+        with:
+          gradle-command: :sdks:go:test:load:run
+          arguments: |
+            -PloadTest.mainClass=combine \
+            -Prunner=PortableRunner \
+            -PloadTest.args="
+              --runner=FlinkRunner \
+              --job_endpoint=localhost:8099 \
+              --environment_type=DOCKER \
+              --environment_config=gcr.io/apache-beam-testing/beam-sdk/beam_go_sdk:latest \
+              --parallelism=1 \
+              --input_options=\"{\"num_records\":200,\"key_size\":1,\"value_size\":9}\"
+              --fanout=1 \
+              --top_count=10 \
+              --iterations=1"
+      
+      # Run a Python Combine load test to verify the Flink container
+      - name: Run Flink Container Test with Python Combine
+        timeout-minutes: 10
+        uses: ./.github/actions/gradle-command-self-hosted-action
+        with:
+          gradle-command: :sdks:python:test:load:run
+          arguments: |
+            -PloadTest.mainClass=apache_beam.testing.load_tests.combine_test \
+            -Prunner=FlinkRunner \
+            -PloadTest.args="
+              --runner=PortableRunner \
+              --job_endpoint=localhost:8099 \
+              --environment_type=DOCKER \
+              --environment_config=gcr.io/apache-beam-testing/beam-sdk/beam_python3.9_sdk:latest \
+              --parallelism=1 \
+              --input_options=\"{\"num_records\":200,\"key_size\":1,\"value_size\":9,\"algorithm\":\"lcg\"}\" \
+              --fanout=1 \
+              --top_count=10 \
+              --iterations=1"
+
+      # Run a Java Combine load test to verify the Flink container
+      - name: Run Flink Container Test with Java Combine
+        timeout-minutes: 10
+        uses: ./.github/actions/gradle-command-self-hosted-action
+        with:
+          gradle-command: :sdks:java:testing:load-tests:run
+          arguments: |
+            -PloadTest.mainClass=org.apache.beam.sdk.loadtests.CombineLoadTest \
+            -Prunner=:runners:flink:1.17 \
+            -PloadTest.args="
+              --runner=FlinkRunner \
+              --environment_type=DOCKER \
+              --environment_config=gcr.io/apache-beam-testing/beam-sdk/beam_java11_sdk:latest \
+              --parallelism=1 \
+              --sourceOptions={\"numRecords\":200,\"keySizeBytes\":1,\"valueSizeBytes\":9} \
+              --fanout=1 \
+              --iterations=1 \
+              --topCount=10"
+
+      - name: Teardown Flink
+        if: always()
+        run: |
+          ${{ github.workspace }}/.test-infra/dataproc/flink_cluster.sh delete
\ No newline at end of file

From 9bdc9a5a0bff4adc711e3eee91e0063606024ed3 Mon Sep 17 00:00:00 2001
From: Kenn Knowles <kenn@apache.org>
Date: Mon, 25 Nov 2024 13:27:42 -0500
Subject: [PATCH 009/135] Remove sickbay GitHub Actions (#33214)

---
 .github/workflows/README.md                   |   2 -
 .../beam_PostCommit_Java_Sickbay.yml          |  93 ----------------
 .../beam_PostCommit_Sickbay_Python.yml        | 105 ------------------
 3 files changed, 200 deletions(-)
 delete mode 100644 .github/workflows/beam_PostCommit_Java_Sickbay.yml
 delete mode 100644 .github/workflows/beam_PostCommit_Sickbay_Python.yml

diff --git a/.github/workflows/README.md b/.github/workflows/README.md
index 971bfd857b27..206364f416f7 100644
--- a/.github/workflows/README.md
+++ b/.github/workflows/README.md
@@ -331,7 +331,6 @@ PostCommit Jobs run in a schedule against master branch and generally do not get
 | [ PostCommit Java SingleStoreIO IT ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_SingleStoreIO_IT.yml) | N/A |`beam_PostCommit_Java_SingleStoreIO_IT.json`| [![.github/workflows/beam_PostCommit_Java_SingleStoreIO_IT.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_SingleStoreIO_IT.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_SingleStoreIO_IT.yml?query=event%3Aschedule) |
 | [ PostCommit Java PVR Spark3 Streaming ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_PVR_Spark3_Streaming.yml) | N/A |`beam_PostCommit_Java_PVR_Spark3_Streaming.json`| [![.github/workflows/beam_PostCommit_Java_PVR_Spark3_Streaming.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_PVR_Spark3_Streaming.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_PVR_Spark3_Streaming.yml?query=event%3Aschedule) |
 | [ PostCommit Java PVR Spark Batch ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_PVR_Spark_Batch.yml) | N/A |`beam_PostCommit_Java_PVR_Spark_Batch.json`| [![.github/workflows/beam_PostCommit_Java_PVR_Spark_Batch.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_PVR_Spark_Batch.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_PVR_Spark_Batch.yml?query=event%3Aschedule) |
-| [ PostCommit Java Sickbay ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Sickbay.yml) | N/A |`beam_PostCommit_Java_Sickbay.json`| [![.github/workflows/beam_PostCommit_Java_Sickbay.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Sickbay.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Sickbay.yml?query=event%3Aschedule) |
 | [ PostCommit Java Tpcds Dataflow ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Tpcds_Dataflow.yml) | N/A |`beam_PostCommit_Java_Tpcds_Dataflow.json`| [![.github/workflows/beam_PostCommit_Java_Tpcds_Dataflow.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Tpcds_Dataflow.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Tpcds_Dataflow.yml?query=event%3Aschedule) |
 | [ PostCommit Java Tpcds Flink ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Tpcds_Flink.yml) | N/A |`beam_PostCommit_Java_Tpcds_Flink.json`| [![.github/workflows/beam_PostCommit_Java_Tpcds_Flink.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Tpcds_Flink.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Tpcds_Flink.yml?query=event%3Aschedule) |
 | [ PostCommit Java Tpcds Spark ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Tpcds_Spark.yml) | N/A |`beam_PostCommit_Java_Tpcds_Spark.json`| [![.github/workflows/beam_PostCommit_Java_Tpcds_Spark.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Tpcds_Spark.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Java_Tpcds_Spark.yml?query=event%3Aschedule) |
@@ -372,7 +371,6 @@ PostCommit Jobs run in a schedule against master branch and generally do not get
 | [ PostCommit Python Xlang Gcp Dataflow ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Python_Xlang_Gcp_Dataflow.yml) | N/A |`beam_PostCommit_Python_Xlang_Gcp_Dataflow.json`| [![.github/workflows/beam_PostCommit_Python_Xlang_Gcp_Dataflow.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Python_Xlang_Gcp_Dataflow.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Python_Xlang_Gcp_Dataflow.yml?query=event%3Aschedule) |
 | [ PostCommit Python Xlang Gcp Direct ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Python_Xlang_Gcp_Direct.yml) | N/A |`beam_PostCommit_Python_Xlang_Gcp_Direct.json`| [![.github/workflows/beam_PostCommit_Python_Xlang_Gcp_Direct.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Python_Xlang_Gcp_Direct.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Python_Xlang_Gcp_Direct.yml?query=event%3Aschedule) |
 | [ PostCommit Python Xlang IO Dataflow ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Python_Xlang_IO_Dataflow.yml) | N/A |`beam_PostCommit_Python_Xlang_IO_Dataflow.json`| [![.github/workflows/beam_PostCommit_Python_Xlang_IO_Dataflow.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Python_Xlang_IO_Dataflow.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Python_Xlang_IO_Dataflow.yml?query=event%3Aschedule) |
-| [ PostCommit Sickbay Python ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Sickbay_Python.yml) | ['3.8','3.9','3.10','3.11']  |`beam_PostCommit_Sickbay_Python.json`| [![.github/workflows/beam_PostCommit_Sickbay_Python.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Sickbay_Python.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Sickbay_Python.yml?query=event%3Aschedule) |
 | [ PostCommit SQL ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_SQL.yml) | N/A |`beam_PostCommit_SQL.json`| [![.github/workflows/beam_PostCommit_SQL.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_SQL.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_SQL.yml?query=event%3Aschedule) |
 | [ PostCommit TransformService Direct ](https://github.com/apache/beam/actions/workflows/beam_PostCommit_TransformService_Direct.yml) | N/A |`beam_PostCommit_TransformService_Direct.json`| [![.github/workflows/beam_PostCommit_TransformService_Direct.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_TransformService_Direct.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_TransformService_Direct.yml?query=event%3Aschedule)
 | [ PostCommit Website Test](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Website_Test.yml) | N/A |`beam_PostCommit_Website_Test.json`| [![.github/workflows/beam_PostCommit_Website_Test.yml](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Website_Test.yml/badge.svg?event=schedule)](https://github.com/apache/beam/actions/workflows/beam_PostCommit_Website_Test.yml?query=event%3Aschedule) |
diff --git a/.github/workflows/beam_PostCommit_Java_Sickbay.yml b/.github/workflows/beam_PostCommit_Java_Sickbay.yml
deleted file mode 100644
index 95c36fc863cf..000000000000
--- a/.github/workflows/beam_PostCommit_Java_Sickbay.yml
+++ /dev/null
@@ -1,93 +0,0 @@
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-name: PostCommit Java Sickbay
-
-on:
-  schedule:
-    - cron: '30 4/6 * * *'
-  pull_request_target:
-    paths: ['.github/trigger_files/beam_PostCommit_Java_Sickbay.json']
-  workflow_dispatch:
-
-# This allows a subsequently queued workflow run to interrupt previous runs
-concurrency:
-  group: '${{ github.workflow }} @ ${{ github.event.issue.number || github.sha || github.head_ref || github.ref }}-${{ github.event.schedule || github.event.comment.id || github.event.sender.login }}'
-  cancel-in-progress: true
-
-#Setting explicit permissions for the action to avoid the default permissions which are `write-all` in case of pull_request_target event
-permissions:
-  actions: write
-  pull-requests: write
-  checks: write
-  contents: read
-  deployments: read
-  id-token: none
-  issues: write
-  discussions: read
-  packages: read
-  pages: read
-  repository-projects: read
-  security-events: read
-  statuses: read
-
-env:
-  DEVELOCITY_ACCESS_KEY: ${{ secrets.GE_ACCESS_TOKEN }}
-  GRADLE_ENTERPRISE_CACHE_USERNAME: ${{ secrets.GE_CACHE_USERNAME }}
-  GRADLE_ENTERPRISE_CACHE_PASSWORD: ${{ secrets.GE_CACHE_PASSWORD }}
-
-jobs:
-  beam_PostCommit_Java_Sickbay:
-    name: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
-    runs-on: [self-hosted, ubuntu-20.04, main]
-    timeout-minutes: 120
-    strategy:
-      matrix: 
-        job_name: [beam_PostCommit_Java_Sickbay]
-        job_phrase: [Run Java Sickbay]
-    if: |
-      github.event_name == 'workflow_dispatch' ||
-      github.event_name == 'pull_request_target' ||
-      (github.event_name == 'schedule' && github.repository == 'apache/beam') ||
-      github.event.comment.body == 'Run Java Sickbay'
-    steps:
-      - uses: actions/checkout@v4
-      - name: Setup repository
-        uses: ./.github/actions/setup-action
-        with:
-          comment_phrase: ${{ matrix.job_phrase }}
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          github_job: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
-      - name: Setup environment
-        uses: ./.github/actions/setup-environment-action
-      - name: run PostCommit Java Sickbay script
-        uses: ./.github/actions/gradle-command-self-hosted-action
-        with:
-            gradle-command: :javaPostCommitSickbay
-      - name: Archive JUnit Test Results
-        uses: actions/upload-artifact@v4
-        if: ${{ !success() }}
-        with:
-          name: JUnit Test Results
-          path: "**/build/reports/tests/"
-      - name: Publish JUnit Test Results
-        uses: EnricoMi/publish-unit-test-result-action@v2
-        if: always()
-        with:
-          commit: '${{ env.prsha || env.GITHUB_SHA }}'
-          comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Sickbay_Python.yml b/.github/workflows/beam_PostCommit_Sickbay_Python.yml
deleted file mode 100644
index 6d253e03723d..000000000000
--- a/.github/workflows/beam_PostCommit_Sickbay_Python.yml
+++ /dev/null
@@ -1,105 +0,0 @@
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-name: PostCommit Sickbay Python
-
-on:
-  pull_request_target:
-    paths: ['.github/trigger_files/beam_PostCommit_Sickbay_Python.json']
-  workflow_dispatch:
-
-# This allows a subsequently queued workflow run to interrupt previous runs
-concurrency:
-  group: '${{ github.workflow }} @ ${{ github.event.issue.number || github.sha || github.head_ref || github.ref }}-${{ github.event.schedule || github.event.comment.id || github.event.sender.login }}'
-  cancel-in-progress: true
-
-#Setting explicit permissions for the action to avoid the default permissions which are `write-all` in case of pull_request_target event
-permissions:
-  actions: write
-  pull-requests: write
-  checks: write
-  contents: read
-  deployments: read
-  id-token: none
-  issues: write
-  discussions: read
-  packages: read
-  pages: read
-  repository-projects: read
-  security-events: read
-  statuses: read
-
-env:
-  DEVELOCITY_ACCESS_KEY: ${{ secrets.GE_ACCESS_TOKEN }}
-  GRADLE_ENTERPRISE_CACHE_USERNAME: ${{ secrets.GE_CACHE_USERNAME }}
-  GRADLE_ENTERPRISE_CACHE_PASSWORD: ${{ secrets.GE_CACHE_PASSWORD }}
-
-jobs:
-  beam_PostCommit_Sickbay_Python:
-    name: ${{ matrix.job_name }} (${{ matrix.job_phrase_1 }} ${{ matrix.python_version }} ${{ matrix.job_phrase_2 }})
-    runs-on: [self-hosted, ubuntu-20.04, main]
-    timeout-minutes: 180
-    strategy:
-      fail-fast: false
-      matrix:
-        job_name: [beam_PostCommit_Sickbay_Python]
-        job_phrase_1: [Run Python]
-        job_phrase_2: [PostCommit Sickbay]
-        python_version: ['3.9', '3.10', '3.11', '3.12']
-    if: |
-      github.event_name == 'workflow_dispatch' ||
-      github.event_name == 'pull_request_target' ||
-      (github.event_name == 'schedule' && github.repository == 'apache/beam') ||
-      (startswith(github.event.comment.body, 'Run Python') &&
-         endswith(github.event.comment.body, 'PostCommit Sickbay'))
-    steps:
-      - uses: actions/checkout@v4
-      - name: Setup repository
-        uses: ./.github/actions/setup-action
-        with:
-          comment_phrase: ${{ matrix.job_phrase_1 }} ${{ matrix.python_version }} ${{ matrix.job_phrase_2 }}
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          github_job: ${{ matrix.job_name }} (${{ matrix.job_phrase_1 }} ${{ matrix.python_version }} ${{ matrix.job_phrase_2 }})
-      - name: Setup environment
-        uses: ./.github/actions/setup-environment-action
-        with:
-          python-version: ${{ matrix.python_version }}
-      - name: Set PY_VER_CLEAN
-        id: set_py_ver_clean
-        run: |
-          PY_VER=${{ matrix.python_version }}
-          PY_VER_CLEAN=${PY_VER//.}
-          echo "py_ver_clean=$PY_VER_CLEAN" >> $GITHUB_OUTPUT
-      - name: run PostCommit Python ${{ matrix.python_version }} script
-        uses: ./.github/actions/gradle-command-self-hosted-action
-        with:
-          gradle-command: :sdks:python:test-suites:dataflow:py${{steps.set_py_ver_clean.outputs.py_ver_clean}}:postCommitSickbay
-          arguments: |
-            -PpythonVersion=${{ matrix.python_version }} \
-      - name: Archive Python Test Results
-        uses: actions/upload-artifact@v4
-        if: failure()
-        with:
-          name: Python Test Results
-          path: '**/pytest*.xml'
-      - name: Publish Python Test Results
-        uses: EnricoMi/publish-unit-test-result-action@v2
-        if: always()
-        with:
-          commit: '${{ env.prsha || env.GITHUB_SHA }}'
-          comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'

From 8f75c61cfd9809d105cd865037b2ae3f076d503d Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Mon, 25 Nov 2024 11:54:12 -0800
Subject: [PATCH 010/135] More complete error message for StripErrorMetadata.
 (#33110)

* More complete error message for StripErrorMetadata.

* Update sdks/python/apache_beam/yaml/yaml_mapping.py

Co-authored-by: Danny McCormick <dannymccormick@google.com>

* fix formatting, paren

---------

Co-authored-by: Danny McCormick <dannymccormick@google.com>
---
 sdks/python/apache_beam/yaml/yaml_mapping.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/sdks/python/apache_beam/yaml/yaml_mapping.py b/sdks/python/apache_beam/yaml/yaml_mapping.py
index 3bef1a0a1101..9f92f59f42b6 100644
--- a/sdks/python/apache_beam/yaml/yaml_mapping.py
+++ b/sdks/python/apache_beam/yaml/yaml_mapping.py
@@ -467,7 +467,9 @@ def expand(self, pcoll):
           break
       else:
         raise ValueError(
-            f"No field name matches one of {self._ERROR_FIELD_NAMES}")
+            'The input to this transform does not appear to be an error ' +
+            "output.  Expected a schema'd input with a field named " +
+            ' or '.join(repr(fld) for fld in self._ERROR_FIELD_NAMES))
 
     if fld is None:
       # This handles with_exception_handling() that returns bare tuples.

From 2e4417f89c3d0bb7b349880233cf525715e95792 Mon Sep 17 00:00:00 2001
From: Danny McCormick <dannymccormick@google.com>
Date: Mon, 25 Nov 2024 15:01:50 -0500
Subject: [PATCH 011/135] Update website for 2.61.0 release (#33117)

* Update website for 2.61.0 release

* Update CHANGES.md

* Update beam-2.61.0.md

* Update downloads.md

* Update CHANGES.md

* Update beam-2.61.0.md
---
 CHANGES.md                                    | 18 +----
 website/www/site/config.toml                  |  2 +-
 .../www/site/content/en/blog/beam-2.61.0.md   | 73 +++++++++++++++++++
 .../site/content/en/get-started/downloads.md  | 14 +++-
 4 files changed, 86 insertions(+), 21 deletions(-)
 create mode 100644 website/www/site/content/en/blog/beam-2.61.0.md

diff --git a/CHANGES.md b/CHANGES.md
index 979cbbd67329..7a5e89425650 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -88,12 +88,10 @@
 
 * ([#X](https://github.com/apache/beam/issues/X)).
 
-# [2.61.0] - Unreleased
+# [2.61.0] - 2024-11-25
 
 ## Highlights
 
-* New highly anticipated feature X added to Python SDK ([#X](https://github.com/apache/beam/issues/X)).
-* New highly anticipated feature Y added to Java SDK ([#Y](https://github.com/apache/beam/issues/Y)).
 * [Python] Introduce Managed Transforms API ([#31495](https://github.com/apache/beam/pull/31495))
 * Flink 1.19 support added ([#32648](https://github.com/apache/beam/pull/32648))
 
@@ -111,36 +109,22 @@
 ## New Features / Improvements
 
 * Added support for read with metadata in MqttIO (Java) ([#32195](https://github.com/apache/beam/issues/32195))
-* X feature added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
 * Added support for processing events which use a global sequence to "ordered" extension (Java) [#32540](https://github.com/apache/beam/pull/32540)
 * Add new meta-transform FlattenWith and Tee that allow one to introduce branching
   without breaking the linear/chaining style of pipeline construction.
 
-## Breaking Changes
-
-* X behavior was changed ([#X](https://github.com/apache/beam/issues/X)).
-
 ## Deprecations
 
 * Removed support for Flink 1.15 and 1.16
 * Removed support for Python 3.8
-* X behavior is deprecated and will be removed in X versions ([#X](https://github.com/apache/beam/issues/X)).
 
 ## Bugfixes
 
-* Fixed X (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
 * (Java) Fixed tearDown not invoked when DoFn throws on Portable Runners ([#18592](https://github.com/apache/beam/issues/18592), [#31381](https://github.com/apache/beam/issues/31381)).
 * (Java) Fixed protobuf error with MapState.remove() in Dataflow Streaming Java Legacy Runner without Streaming Engine ([#32892](https://github.com/apache/beam/issues/32892)).
 * Adding flag to support conditionally disabling auto-commit in JdbcIO ReadFn ([#31111](https://github.com/apache/beam/issues/31111))
 * (Python) Fixed BigQuery Enrichment bug that can lead to multiple conditions returning duplicate rows, batching returning incorrect results and conditions not scoped by row during batching ([#32780](https://github.com/apache/beam/pull/32780)).
 
-## Security Fixes
-* Fixed (CVE-YYYY-NNNN)[https://www.cve.org/CVERecord?id=CVE-YYYY-NNNN] (Java/Python/Go) ([#X](https://github.com/apache/beam/issues/X)).
-
-## Known Issues
-
-* ([#X](https://github.com/apache/beam/issues/X)).
-
 # [2.60.0] - 2024-10-17
 
 ## Highlights
diff --git a/website/www/site/config.toml b/website/www/site/config.toml
index d769f8434a7f..0ed8aef2a906 100644
--- a/website/www/site/config.toml
+++ b/website/www/site/config.toml
@@ -104,7 +104,7 @@ github_project_repo = "https://github.com/apache/beam"
 
 [params]
 description = "Apache Beam is an open source, unified model and set of language-specific SDKs for defining and executing data processing workflows, and also data ingestion and integration flows, supporting Enterprise Integration Patterns (EIPs) and Domain Specific Languages (DSLs). Dataflow pipelines simplify the mechanics of large-scale batch and streaming data processing and can run on a number of runtimes like Apache Flink, Apache Spark, and Google Cloud Dataflow (a cloud service). Beam also brings DSL in different languages, allowing users to easily implement their data integration processes."
-release_latest = "2.60.0"
+release_latest = "2.61.0"
 # The repository and branch where the files live in Github or Colab. This is used
 # to serve and stage from your local branch, but publish to the master branch.
 #   e.g. https://github.com/{{< param branch_repo >}}/path/to/notebook.ipynb
diff --git a/website/www/site/content/en/blog/beam-2.61.0.md b/website/www/site/content/en/blog/beam-2.61.0.md
new file mode 100644
index 000000000000..6f0404af7846
--- /dev/null
+++ b/website/www/site/content/en/blog/beam-2.61.0.md
@@ -0,0 +1,73 @@
+---
+title:  "Apache Beam 2.61.0"
+date:   2024-11-25 15:00:00 -0500
+categories:
+  - blog
+  - release
+authors:
+  - damccorm
+---
+<!--
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+We are happy to present the new 2.61.0 release of Beam.
+This release includes both improvements and new functionality.
+See the [download page](/get-started/downloads/#2610-2024-11-25) for this release.
+
+<!--more-->
+
+For more information on changes in 2.61.0, check out the [detailed release notes](https://github.com/apache/beam/milestone/25).
+
+## Highlights
+
+* [Python] Introduce Managed Transforms API ([#31495](https://github.com/apache/beam/pull/31495))
+* Flink 1.19 support added ([#32648](https://github.com/apache/beam/pull/32648))
+
+## I/Os
+
+* [Managed Iceberg] Support creating tables if needed ([#32686](https://github.com/apache/beam/pull/32686))
+* [Managed Iceberg] Now available in Python SDK ([#31495](https://github.com/apache/beam/pull/31495))
+* [Managed Iceberg] Add support for TIMESTAMP, TIME, and DATE types ([#32688](https://github.com/apache/beam/pull/32688))
+* BigQuery CDC writes are now available in Python SDK, only supported when using StorageWrite API at least once mode ([#32527](https://github.com/apache/beam/issues/32527))
+* [Managed Iceberg] Allow updating table partition specs during pipeline runtime ([#32879](https://github.com/apache/beam/pull/32879))
+* Added BigQueryIO as a Managed IO ([#31486](https://github.com/apache/beam/pull/31486))
+* Support for writing to [Solace messages queues](https://solace.com/) (`SolaceIO.Write`) added (Java) ([#31905](https://github.com/apache/beam/issues/31905)).
+
+## New Features / Improvements
+
+* Added support for read with metadata in MqttIO (Java) ([#32195](https://github.com/apache/beam/issues/32195))
+* Added support for processing events which use a global sequence to "ordered" extension (Java) [#32540](https://github.com/apache/beam/pull/32540)
+* Add new meta-transform FlattenWith and Tee that allow one to introduce branching
+  without breaking the linear/chaining style of pipeline construction.
+
+## Deprecations
+
+* Removed support for Flink 1.15 and 1.16
+* Removed support for Python 3.8
+
+## Bugfixes
+
+* (Java) Fixed tearDown not invoked when DoFn throws on Portable Runners ([#18592](https://github.com/apache/beam/issues/18592), [#31381](https://github.com/apache/beam/issues/31381)).
+* (Java) Fixed protobuf error with MapState.remove() in Dataflow Streaming Java Legacy Runner without Streaming Engine ([#32892](https://github.com/apache/beam/issues/32892)).
+* Adding flag to support conditionally disabling auto-commit in JdbcIO ReadFn ([#31111](https://github.com/apache/beam/issues/31111))
+
+## Known Issues
+
+N/A
+
+For the most up to date list of known issues, see https://github.com/apache/beam/blob/master/CHANGES.md
+
+## List of Contributors
+
+According to git shortlog, the following people contributed to the 2.60.0 release. Thank you to all contributors!
+
+Ahmed Abualsaud, Ahmet Altay, Arun Pandian, Ayush Pandey, Chamikara Jayalath, Chris Ashcraft, Christoph Grotz, DKPHUONG, Damon, Danny Mccormick, Dmitry Ulyumdzhiev, Ferran Fernández Garrido, Hai Joey Tran, Hyeonho Kim, Idan Attias, Israel Herraiz, Jack McCluskey, Jan Lukavský, Jeff Kinard, Jeremy Edwards, Joey Tran, Kenneth Knowles, Maciej Szwaja, Manit Gupta, Mattie Fu, Michel Davit, Minbo Bae, Mohamed Awnallah, Naireen Hussain, Rebecca Szper, Reeba Qureshi, Reuven Lax, Robert Bradshaw, Robert Burke, S. Veyrié, Sam Whittle, Sergei Lilichenko, Shunping Huang, Steven van Rossum, Tan Le, Thiago Nunes, Vitaly Terentyev, Vlado Djerek, Yi Hu, claudevdm, fozzie15, johnjcasey, kushmiD, liferoad, martin trieu, pablo rodriguez defino, razvanculea, s21lee, tvalentyn, twosom
diff --git a/website/www/site/content/en/get-started/downloads.md b/website/www/site/content/en/get-started/downloads.md
index ff432996578d..dea5dc314b17 100644
--- a/website/www/site/content/en/get-started/downloads.md
+++ b/website/www/site/content/en/get-started/downloads.md
@@ -96,11 +96,19 @@ versions denoted `0.x.y`.
 
 ## Releases
 
+### 2.61.0 (2024-11-25)
+
+Official [source code download](https://downloads.apache.org/beam/2.61.0/apache-beam-2.61.0-source-release.zip).
+[SHA-512](https://downloads.apache.org/beam/2.61.0/apache-beam-2.61.0-source-release.zip.sha512).
+[signature](https://downloads.apache.org/beam/2.61.0/apache-beam-2.61.0-source-release.zip.asc).
+
+[Release notes](https://github.com/apache/beam/releases/tag/v2.61.0)
+
 ### 2.60.0 (2024-10-17)
 
-Official [source code download](https://downloads.apache.org/beam/2.60.0/apache-beam-2.60.0-source-release.zip).
-[SHA-512](https://downloads.apache.org/beam/2.60.0/apache-beam-2.60.0-source-release.zip.sha512).
-[signature](https://downloads.apache.org/beam/2.60.0/apache-beam-2.60.0-source-release.zip.asc).
+Official [source code download](https://archive.apache.org/dist/beam/2.60.0/apache-beam-2.60.0-source-release.zip).
+[SHA-512](https://archive.apache.org/dist/beam/2.60.0/apache-beam-2.60.0-source-release.zip.sha512).
+[signature](https://archive.apache.org/dist/beam/2.60.0/apache-beam-2.60.0-source-release.zip.asc).
 
 [Release notes](https://github.com/apache/beam/releases/tag/v2.60.0)
 

From c2f56866e636e2b7da554b9c5d1e25982d7a39c1 Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Fri, 22 Nov 2024 10:12:31 -0800
Subject: [PATCH 012/135] Move MetricAggregator to its only use in
 BundleBasedDirectRunner.

---
 .../apache_beam/internal/metrics/cells.py     |  27 +--
 sdks/python/apache_beam/metrics/cells.py      | 160 +++++-------------
 .../runners/direct/direct_metrics.py          |  73 +++++++-
 3 files changed, 109 insertions(+), 151 deletions(-)

diff --git a/sdks/python/apache_beam/internal/metrics/cells.py b/sdks/python/apache_beam/internal/metrics/cells.py
index c7b546258a70..9a28ba46447a 100644
--- a/sdks/python/apache_beam/internal/metrics/cells.py
+++ b/sdks/python/apache_beam/internal/metrics/cells.py
@@ -28,7 +28,6 @@
 from typing import TYPE_CHECKING
 from typing import Optional
 
-from apache_beam.metrics.cells import MetricAggregator
 from apache_beam.metrics.cells import MetricCell
 from apache_beam.metrics.cells import MetricCellFactory
 from apache_beam.utils.histogram import Histogram
@@ -50,10 +49,10 @@ class HistogramCell(MetricCell):
   """
   def __init__(self, bucket_type):
     self._bucket_type = bucket_type
-    self.data = HistogramAggregator(bucket_type).identity_element()
+    self.data = HistogramData.identity_element(bucket_type)
 
   def reset(self):
-    self.data = HistogramAggregator(self._bucket_type).identity_element()
+    self.data = HistogramData.identity_element(self._bucket_type)
 
   def combine(self, other: 'HistogramCell') -> 'HistogramCell':
     result = HistogramCell(self._bucket_type)
@@ -148,22 +147,6 @@ def combine(self, other: Optional['HistogramData']) -> 'HistogramData':
 
     return HistogramData(self.histogram.combine(other.histogram))
 
-
-class HistogramAggregator(MetricAggregator):
-  """For internal use only; no backwards-compatibility guarantees.
-
-  Aggregator for Histogram metric data during pipeline execution.
-
-  Values aggregated should be ``HistogramData`` objects.
-  """
-  def __init__(self, bucket_type: 'BucketType') -> None:
-    self._bucket_type = bucket_type
-
-  def identity_element(self) -> HistogramData:
-    return HistogramData(Histogram(self._bucket_type))
-
-  def combine(self, x: HistogramData, y: HistogramData) -> HistogramData:
-    return x.combine(y)
-
-  def result(self, x: HistogramData) -> HistogramResult:
-    return HistogramResult(x.get_cumulative())
+  @staticmethod
+  def identity_element(bucket_type) -> HistogramData:
+    return HistogramData(Histogram(bucket_type))
diff --git a/sdks/python/apache_beam/metrics/cells.py b/sdks/python/apache_beam/metrics/cells.py
index 63fc9f3f7cc9..2d4aba50f972 100644
--- a/sdks/python/apache_beam/metrics/cells.py
+++ b/sdks/python/apache_beam/metrics/cells.py
@@ -43,11 +43,7 @@ class fake_cython:
   globals()['cython'] = fake_cython
 
 __all__ = [
-    'MetricAggregator',
-    'MetricCell',
-    'MetricCellFactory',
-    'DistributionResult',
-    'GaugeResult'
+    'MetricCell', 'MetricCellFactory', 'DistributionResult', 'GaugeResult'
 ]
 
 _LOGGER = logging.getLogger(__name__)
@@ -110,11 +106,11 @@ class CounterCell(MetricCell):
   """
   def __init__(self, *args):
     super().__init__(*args)
-    self.value = CounterAggregator.identity_element()
+    self.value = 0
 
   def reset(self):
     # type: () -> None
-    self.value = CounterAggregator.identity_element()
+    self.value = 0
 
   def combine(self, other):
     # type: (CounterCell) -> CounterCell
@@ -175,11 +171,11 @@ class DistributionCell(MetricCell):
   """
   def __init__(self, *args):
     super().__init__(*args)
-    self.data = DistributionAggregator.identity_element()
+    self.data = DistributionData.identity_element()
 
   def reset(self):
     # type: () -> None
-    self.data = DistributionAggregator.identity_element()
+    self.data = DistributionData.identity_element()
 
   def combine(self, other):
     # type: (DistributionCell) -> DistributionCell
@@ -234,10 +230,10 @@ class GaugeCell(MetricCell):
   """
   def __init__(self, *args):
     super().__init__(*args)
-    self.data = GaugeAggregator.identity_element()
+    self.data = GaugeData.identity_element()
 
   def reset(self):
-    self.data = GaugeAggregator.identity_element()
+    self.data = GaugeData.identity_element()
 
   def combine(self, other):
     # type: (GaugeCell) -> GaugeCell
@@ -284,7 +280,7 @@ class StringSetCell(MetricCell):
   """
   def __init__(self, *args):
     super().__init__(*args)
-    self.data = StringSetAggregator.identity_element()
+    self.data = StringSetData.identity_element()
 
   def add(self, value):
     self.update(value)
@@ -308,9 +304,8 @@ def get_cumulative(self):
 
   def combine(self, other):
     # type: (StringSetCell) -> StringSetCell
-    combined = StringSetAggregator().combine(self.data, other.data)
     result = StringSetCell()
-    result.data = combined
+    result.data = self.data.combine(other.data)
     return result
 
   def to_runner_api_monitoring_info_impl(self, name, transform_id):
@@ -324,7 +319,7 @@ def to_runner_api_monitoring_info_impl(self, name, transform_id):
 
   def reset(self):
     # type: () -> None
-    self.data = StringSetAggregator.identity_element()
+    self.data = StringSetData.identity_element()
 
 
 class DistributionResult(object):
@@ -449,6 +444,10 @@ def get_cumulative(self):
     # type: () -> GaugeData
     return GaugeData(self.value, timestamp=self.timestamp)
 
+  def get_result(self):
+    # type: () -> GaugeResult
+    return GaugeResult(self.get_cumulative())
+
   def combine(self, other):
     # type: (Optional[GaugeData]) -> GaugeData
     if other is None:
@@ -464,6 +463,11 @@ def singleton(value, timestamp=None):
     # type: (Optional[int], Optional[int]) -> GaugeData
     return GaugeData(value, timestamp=timestamp)
 
+  @staticmethod
+  def identity_element():
+    # type: () -> GaugeData
+    return GaugeData(0, timestamp=0)
+
 
 class DistributionData(object):
   """For internal use only; no backwards-compatibility guarantees.
@@ -510,6 +514,9 @@ def get_cumulative(self):
     # type: () -> DistributionData
     return DistributionData(self.sum, self.count, self.min, self.max)
 
+  def get_result(self):
+    return DistributionResult(self.get_cumulative())
+
   def combine(self, other):
     # type: (Optional[DistributionData]) -> DistributionData
     if other is None:
@@ -526,6 +533,11 @@ def singleton(value):
     # type: (int) -> DistributionData
     return DistributionData(value, 1, value, value)
 
+  @staticmethod
+  def identity_element():
+    # type: () -> DistributionData
+    return DistributionData(0, 0, 2**63 - 1, -2**63)
+
 
 class StringSetData(object):
   """For internal use only; no backwards-compatibility guarantees.
@@ -568,6 +580,9 @@ def __repr__(self) -> str:
   def get_cumulative(self) -> "StringSetData":
     return StringSetData(set(self.string_set), self.string_size)
 
+  def get_result(self) -> set[str]:
+    return set(self.string_set)
+
   def add(self, *strings):
     """
     Add strings into this StringSetData and return the result StringSetData.
@@ -585,6 +600,11 @@ def combine(self, other: "StringSetData") -> "StringSetData":
     if other is None:
       return self
 
+    if not other.string_set:
+      return self
+    elif not self.string_set:
+      return other
+
     combined = set(self.string_set)
     string_size = self.add_until_capacity(
         combined, self.string_size, other.string_set)
@@ -614,113 +634,9 @@ def add_until_capacity(
     return current_size
 
   @staticmethod
-  def singleton(value):
-    # type: (int) -> DistributionData
-    return DistributionData(value, 1, value, value)
-
-
-class MetricAggregator(object):
-  """For internal use only; no backwards-compatibility guarantees.
-
-  Base interface for aggregating metric data during pipeline execution."""
-  def identity_element(self):
-    # type: () -> Any
-
-    """Returns the identical element of an Aggregation.
-
-    For the identity element, it must hold that
-     Aggregator.combine(any_element, identity_element) == any_element.
-    """
-    raise NotImplementedError
-
-  def combine(self, x, y):
-    # type: (Any, Any) -> Any
-    raise NotImplementedError
-
-  def result(self, x):
-    # type: (Any) -> Any
-    raise NotImplementedError
-
-
-class CounterAggregator(MetricAggregator):
-  """For internal use only; no backwards-compatibility guarantees.
-
-  Aggregator for Counter metric data during pipeline execution.
-
-  Values aggregated should be ``int`` objects.
-  """
-  @staticmethod
-  def identity_element():
-    # type: () -> int
-    return 0
-
-  def combine(self, x, y):
-    # type: (SupportsInt, SupportsInt) -> int
-    return int(x) + int(y)
-
-  def result(self, x):
-    # type: (SupportsInt) -> int
-    return int(x)
-
-
-class DistributionAggregator(MetricAggregator):
-  """For internal use only; no backwards-compatibility guarantees.
-
-  Aggregator for Distribution metric data during pipeline execution.
+  def singleton(value: str) -> "StringSetData":
+    return StringSetData({value})
 
-  Values aggregated should be ``DistributionData`` objects.
-  """
   @staticmethod
-  def identity_element():
-    # type: () -> DistributionData
-    return DistributionData(0, 0, 2**63 - 1, -2**63)
-
-  def combine(self, x, y):
-    # type: (DistributionData, DistributionData) -> DistributionData
-    return x.combine(y)
-
-  def result(self, x):
-    # type: (DistributionData) -> DistributionResult
-    return DistributionResult(x.get_cumulative())
-
-
-class GaugeAggregator(MetricAggregator):
-  """For internal use only; no backwards-compatibility guarantees.
-
-  Aggregator for Gauge metric data during pipeline execution.
-
-  Values aggregated should be ``GaugeData`` objects.
-  """
-  @staticmethod
-  def identity_element():
-    # type: () -> GaugeData
-    return GaugeData(0, timestamp=0)
-
-  def combine(self, x, y):
-    # type: (GaugeData, GaugeData) -> GaugeData
-    result = x.combine(y)
-    return result
-
-  def result(self, x):
-    # type: (GaugeData) -> GaugeResult
-    return GaugeResult(x.get_cumulative())
-
-
-class StringSetAggregator(MetricAggregator):
-  @staticmethod
-  def identity_element():
-    # type: () -> StringSetData
+  def identity_element() -> "StringSetData":
     return StringSetData()
-
-  def combine(self, x, y):
-    # type: (StringSetData, StringSetData) -> StringSetData
-    if len(x.string_set) == 0:
-      return y
-    elif len(y.string_set) == 0:
-      return x
-    else:
-      return x.combine(y)
-
-  def result(self, x):
-    # type: (StringSetData) -> set
-    return set(x.string_set)
diff --git a/sdks/python/apache_beam/runners/direct/direct_metrics.py b/sdks/python/apache_beam/runners/direct/direct_metrics.py
index f715ce3bf521..693c0a64538e 100644
--- a/sdks/python/apache_beam/runners/direct/direct_metrics.py
+++ b/sdks/python/apache_beam/runners/direct/direct_metrics.py
@@ -25,22 +25,81 @@
 import threading
 from collections import defaultdict
 
-from apache_beam.metrics.cells import CounterAggregator
-from apache_beam.metrics.cells import DistributionAggregator
-from apache_beam.metrics.cells import GaugeAggregator
-from apache_beam.metrics.cells import StringSetAggregator
+from apache_beam.metrics.cells import DistributionData
+from apache_beam.metrics.cells import GaugeData
+from apache_beam.metrics.cells import StringSetData
 from apache_beam.metrics.execution import MetricKey
 from apache_beam.metrics.execution import MetricResult
 from apache_beam.metrics.metric import MetricResults
 
 
+class MetricAggregator(object):
+  """For internal use only; no backwards-compatibility guarantees.
+
+  Base interface for aggregating metric data during pipeline execution."""
+  def identity_element(self):
+    # type: () -> Any
+
+    """Returns the identical element of an Aggregation.
+
+    For the identity element, it must hold that
+     Aggregator.combine(any_element, identity_element) == any_element.
+    """
+    raise NotImplementedError
+
+  def combine(self, x, y):
+    # type: (Any, Any) -> Any
+    raise NotImplementedError
+
+  def result(self, x):
+    # type: (Any) -> Any
+    raise NotImplementedError
+
+
+class CounterAggregator(MetricAggregator):
+  """For internal use only; no backwards-compatibility guarantees.
+
+  Aggregator for Counter metric data during pipeline execution.
+
+  Values aggregated should be ``int`` objects.
+  """
+  @staticmethod
+  def identity_element():
+    # type: () -> int
+    return 0
+
+  def combine(self, x, y):
+    # type: (SupportsInt, SupportsInt) -> int
+    return int(x) + int(y)
+
+  def result(self, x):
+    # type: (SupportsInt) -> int
+    return int(x)
+
+
+class GenericAggregator(MetricAggregator):
+  def __init__(self, data_class):
+    self._data_class = data_class
+
+  def identity_element(self):
+    return self._data_class.identity_element()
+
+  def combine(self, x, y):
+    return x.combine(y)
+
+  def result(self, x):
+    return x.get_result()
+
+
 class DirectMetrics(MetricResults):
   def __init__(self):
     self._counters = defaultdict(lambda: DirectMetric(CounterAggregator()))
     self._distributions = defaultdict(
-        lambda: DirectMetric(DistributionAggregator()))
-    self._gauges = defaultdict(lambda: DirectMetric(GaugeAggregator()))
-    self._string_sets = defaultdict(lambda: DirectMetric(StringSetAggregator()))
+        lambda: DirectMetric(GenericAggregator(DistributionData)))
+    self._gauges = defaultdict(
+        lambda: DirectMetric(GenericAggregator(GuageData)))
+    self._string_sets = defaultdict(
+        lambda: DirectMetric(GenericAggregator(StringSetData)))
 
   def _apply_operation(self, bundle, updates, op):
     for k, v in updates.counters.items():

From aa939c17616d3f596a7374952bccad00d4620caf Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Fri, 22 Nov 2024 10:12:53 -0800
Subject: [PATCH 013/135] Consolidate implementation of metric cells.

---
 sdks/python/apache_beam/metrics/cells.pxd | 13 +++-
 sdks/python/apache_beam/metrics/cells.py  | 94 +++++++++++------------
 2 files changed, 52 insertions(+), 55 deletions(-)

diff --git a/sdks/python/apache_beam/metrics/cells.pxd b/sdks/python/apache_beam/metrics/cells.pxd
index 98bb5eff0977..807aff7fe76a 100644
--- a/sdks/python/apache_beam/metrics/cells.pxd
+++ b/sdks/python/apache_beam/metrics/cells.pxd
@@ -33,6 +33,7 @@ cdef class CounterCell(MetricCell):
   cpdef bint update(self, value) except -1
 
 
+# Not using AbstractMetricCell so that data can be typed.
 cdef class DistributionCell(MetricCell):
   cdef readonly DistributionData data
 
@@ -40,14 +41,18 @@ cdef class DistributionCell(MetricCell):
   cdef inline bint _update(self, value) except -1
 
 
-cdef class GaugeCell(MetricCell):
+cdef class AbstractMetricCell(MetricCell):
+  cdef readonly object data_class
   cdef readonly object data
+  cdef bint _update_locked(self, value) except -1
 
 
-cdef class StringSetCell(MetricCell):
-  cdef readonly object data
+cdef class GaugeCell(AbstractMetricCell):
+  pass
 
-  cdef inline bint _update(self, value) except -1
+
+cdef class StringSetCell(AbstractMetricCell):
+  pass
 
 
 cdef class DistributionData(object):
diff --git a/sdks/python/apache_beam/metrics/cells.py b/sdks/python/apache_beam/metrics/cells.py
index 2d4aba50f972..ca74d50d1c85 100644
--- a/sdks/python/apache_beam/metrics/cells.py
+++ b/sdks/python/apache_beam/metrics/cells.py
@@ -217,47 +217,65 @@ def to_runner_api_monitoring_info_impl(self, name, transform_id):
         ptransform=transform_id)
 
 
-class GaugeCell(MetricCell):
+class AbstractMetricCell(MetricCell):
   """For internal use only; no backwards-compatibility guarantees.
 
-  Tracks the current value and delta for a gauge metric.
-
-  Each cell tracks the state of a metric independently per context per bundle.
-  Therefore, each metric has a different cell in each bundle, that is later
-  aggregated.
+  Tracks the current value and delta for a metric with a data class.
 
   This class is thread safe.
   """
-  def __init__(self, *args):
-    super().__init__(*args)
-    self.data = GaugeData.identity_element()
+  def __init__(self, data_class):
+    super().__init__()
+    self.data_class = data_class
+    self.data = self.data_class.identity_element()
 
   def reset(self):
-    self.data = GaugeData.identity_element()
+    self.data = self.data_class.identity_element()
 
-  def combine(self, other):
-    # type: (GaugeCell) -> GaugeCell
-    result = GaugeCell()
+  def combine(self, other: 'AbstractMetricCell') -> 'AbstractMetricCell':
+    result = type(self)()
     result.data = self.data.combine(other.data)
     return result
 
   def set(self, value):
-    self.update(value)
+    with self._lock:
+      self._update_locked(value)
 
   def update(self, value):
-    # type: (SupportsInt) -> None
-    value = int(value)
     with self._lock:
-      # Set the value directly without checking timestamp, because
-      # this value is naturally the latest value.
-      self.data.value = value
-      self.data.timestamp = time.time()
+      self._update_locked(value)
+
+  def _update_locked(self, value):
+    raise NotImplementedError(type(self))
 
   def get_cumulative(self):
-    # type: () -> GaugeData
     with self._lock:
       return self.data.get_cumulative()
 
+  def to_runner_api_monitoring_info_impl(self, name, transform_id):
+    raise NotImplementedError(type(self))
+
+
+class GaugeCell(AbstractMetricCell):
+  """For internal use only; no backwards-compatibility guarantees.
+
+  Tracks the current value and delta for a gauge metric.
+
+  Each cell tracks the state of a metric independently per context per bundle.
+  Therefore, each metric has a different cell in each bundle, that is later
+  aggregated.
+
+  This class is thread safe.
+  """
+  def __init__(self):
+    super().__init__(GaugeData)
+
+  def _update_locked(self, value):
+    # Set the value directly without checking timestamp, because
+    # this value is naturally the latest value.
+    self.data.value = int(value)
+    self.data.timestamp = time.time()
+
   def to_runner_api_monitoring_info_impl(self, name, transform_id):
     from apache_beam.metrics import monitoring_infos
     return monitoring_infos.int64_user_gauge(
@@ -267,7 +285,7 @@ def to_runner_api_monitoring_info_impl(self, name, transform_id):
         ptransform=transform_id)
 
 
-class StringSetCell(MetricCell):
+class StringSetCell(AbstractMetricCell):
   """For internal use only; no backwards-compatibility guarantees.
 
   Tracks the current value for a StringSet metric.
@@ -278,49 +296,23 @@ class StringSetCell(MetricCell):
 
   This class is thread safe.
   """
-  def __init__(self, *args):
-    super().__init__(*args)
-    self.data = StringSetData.identity_element()
+  def __init__(self):
+    super().__init__(StringSetData)
 
   def add(self, value):
     self.update(value)
 
-  def update(self, value):
-    # type: (str) -> None
-    if cython.compiled:
-      # We will hold the GIL throughout the entire _update.
-      self._update(value)
-    else:
-      with self._lock:
-        self._update(value)
-
-  def _update(self, value):
+  def _update_locked(self, value):
     self.data.add(value)
 
-  def get_cumulative(self):
-    # type: () -> StringSetData
-    with self._lock:
-      return self.data.get_cumulative()
-
-  def combine(self, other):
-    # type: (StringSetCell) -> StringSetCell
-    result = StringSetCell()
-    result.data = self.data.combine(other.data)
-    return result
-
   def to_runner_api_monitoring_info_impl(self, name, transform_id):
     from apache_beam.metrics import monitoring_infos
-
     return monitoring_infos.user_set_string(
         name.namespace,
         name.name,
         self.get_cumulative(),
         ptransform=transform_id)
 
-  def reset(self):
-    # type: () -> None
-    self.data = StringSetData.identity_element()
-
 
 class DistributionResult(object):
   """The result of a Distribution metric."""

From ea93ce51c781b8e03e937daa7f12ed9741f34c97 Mon Sep 17 00:00:00 2001
From: liferoad <huxiangqian@gmail.com>
Date: Mon, 25 Nov 2024 16:04:41 -0500
Subject: [PATCH 014/135] Fixed the new flink container precommit (#33217)

* Fixed the new flink container precommit

* trigger it

* tried to trigger the workflow

* at least 2 workers

* trigger it
---
 .../beam_PreCommit_Flink_Container.json       |  4 +--
 .../beam_PreCommit_Flink_Container.yml        | 25 ++++++++++++++-----
 2 files changed, 21 insertions(+), 8 deletions(-)

diff --git a/.github/trigger_files/beam_PreCommit_Flink_Container.json b/.github/trigger_files/beam_PreCommit_Flink_Container.json
index b75e2800330d..3f63c0c9975f 100644
--- a/.github/trigger_files/beam_PreCommit_Flink_Container.json
+++ b/.github/trigger_files/beam_PreCommit_Flink_Container.json
@@ -1,4 +1,4 @@
 {
-    "https://github.com/apache/beam/pull/33206": "testing the new flink container workflow"
+    "comment": "Modify this file in a trivial way to cause this test suite to run",
+    "modification": 2
 }
-  
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Flink_Container.yml b/.github/workflows/beam_PreCommit_Flink_Container.yml
index 7b82469d2b81..42a402add966 100644
--- a/.github/workflows/beam_PreCommit_Flink_Container.yml
+++ b/.github/workflows/beam_PreCommit_Flink_Container.yml
@@ -18,8 +18,23 @@ name: PreCommit Flink Container
 on:
   pull_request_target:
     paths:
+      - 'model/**'
+      - 'sdks/python/**'
+      - 'release/**'
+      - 'sdks/java/io/kafka/**'
+      - 'runners/core-construction-java/**'
+      - 'runners/core-java/**'
+      - 'runners/extensions-java/**'
+      - 'runners/flink/**'
+      - 'runners/java-fn-execution/**'
+      - 'runners/reference/**'
       - '.github/trigger_files/beam_PreCommit_Flink_Container.json'
       - 'release/trigger_all_tests.json'
+  push:
+    branches: ['master', 'release-*']
+    tags: 'v*'
+  schedule:
+    - cron: '0 */6 * * *'
   workflow_dispatch:
 
 # Setting explicit permissions for the action to avoid the default permissions which are `write-all`
@@ -66,9 +81,7 @@ jobs:
       github.event_name == 'workflow_dispatch' ||
       github.event_name == 'push' ||
       github.event_name == 'schedule' ||
-      (github.event_name == 'pull_request_target' && 
-       github.base_ref == 'master' && 
-       github.event.pull_request.draft == false) ||
+      github.event_name == 'pull_request_target' ||
       github.event.comment.body == 'Run Flink Container PreCommit'
     runs-on: [self-hosted, ubuntu-20.04, main]
     timeout-minutes: 45
@@ -85,9 +98,9 @@ jobs:
           comment_phrase: ${{ matrix.job_phrase }}
           github_token: ${{ secrets.GITHUB_TOKEN }}
           github_job: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
-      - name: Start Flink with parallelism 1
+      - name: Start Flink with 2 workers
         env:
-          FLINK_NUM_WORKERS: 1
+          FLINK_NUM_WORKERS: 2
         run: |
           cd ${{ github.workspace }}/.test-infra/dataproc; ./flink_cluster.sh create
       # Run a simple Go Combine load test to verify the Flink container
@@ -109,7 +122,7 @@ jobs:
               --fanout=1 \
               --top_count=10 \
               --iterations=1"
-      
+
       # Run a Python Combine load test to verify the Flink container
       - name: Run Flink Container Test with Python Combine
         timeout-minutes: 10

From c0ab7e5ac303575dbc7a79b92c87282183ef6f69 Mon Sep 17 00:00:00 2001
From: Yi Hu <yathu@google.com>
Date: Mon, 25 Nov 2024 17:04:23 -0500
Subject: [PATCH 015/135] ZetaSQL test Java version fixes (#33213)

* Align SDK container version with pipeline submission env

* Disable ZetaSQL test on Java8
---
 ...ommit_XVR_PythonUsingJavaSQL_Dataflow.json |  1 +
 .../beam_PostCommit_XVR_Samza.json            |  1 +
 CHANGES.md                                    |  1 +
 .../google-cloud-dataflow-java/build.gradle   |  4 +++-
 .../python/apache_beam/transforms/sql_test.py | 20 +++++++++++++++++++
 5 files changed, 26 insertions(+), 1 deletion(-)
 create mode 100644 .github/trigger_files/beam_PostCommit_XVR_PythonUsingJavaSQL_Dataflow.json
 create mode 100644 .github/trigger_files/beam_PostCommit_XVR_Samza.json

diff --git a/.github/trigger_files/beam_PostCommit_XVR_PythonUsingJavaSQL_Dataflow.json b/.github/trigger_files/beam_PostCommit_XVR_PythonUsingJavaSQL_Dataflow.json
new file mode 100644
index 000000000000..9e26dfeeb6e6
--- /dev/null
+++ b/.github/trigger_files/beam_PostCommit_XVR_PythonUsingJavaSQL_Dataflow.json
@@ -0,0 +1 @@
+{}
\ No newline at end of file
diff --git a/.github/trigger_files/beam_PostCommit_XVR_Samza.json b/.github/trigger_files/beam_PostCommit_XVR_Samza.json
new file mode 100644
index 000000000000..9e26dfeeb6e6
--- /dev/null
+++ b/.github/trigger_files/beam_PostCommit_XVR_Samza.json
@@ -0,0 +1 @@
+{}
\ No newline at end of file
diff --git a/CHANGES.md b/CHANGES.md
index 7a5e89425650..654512c3a4e2 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -70,6 +70,7 @@
 
 ## Breaking Changes
 
+* Upgraded ZetaSQL to 2024.11.1 ([#32902](https://github.com/apache/beam/pull/32902)). Java11+ is now needed if Beam's ZetaSQL component is used.
 * X behavior was changed ([#X](https://github.com/apache/beam/issues/X)).
 
 ## Deprecations
diff --git a/runners/google-cloud-dataflow-java/build.gradle b/runners/google-cloud-dataflow-java/build.gradle
index 3a337684bf18..811a3c15f836 100644
--- a/runners/google-cloud-dataflow-java/build.gradle
+++ b/runners/google-cloud-dataflow-java/build.gradle
@@ -16,6 +16,8 @@
  * limitations under the License.
  */
 
+import static org.apache.beam.gradle.BeamModulePlugin.getSupportedJavaVersion
+
 import groovy.json.JsonOutput
 
 plugins { id 'org.apache.beam.module' }
@@ -341,7 +343,7 @@ tasks.register('buildAndPushDistrolessContainerImage', Task.class) {
 // task directly ('dependsOn buildAndPushDockerJavaContainer'). This ensures the correct
 // task ordering such that the registry doesn't get cleaned up prior to task completion.
 def buildAndPushDockerJavaContainer = tasks.register("buildAndPushDockerJavaContainer") {
-  def javaVer = "java8"
+  def javaVer = getSupportedJavaVersion()
   if(project.hasProperty('testJavaVersion')) {
     javaVer = "java${project.getProperty('testJavaVersion')}"
   }
diff --git a/sdks/python/apache_beam/transforms/sql_test.py b/sdks/python/apache_beam/transforms/sql_test.py
index 854aec078ce5..a7da253c4617 100644
--- a/sdks/python/apache_beam/transforms/sql_test.py
+++ b/sdks/python/apache_beam/transforms/sql_test.py
@@ -20,6 +20,7 @@
 # pytype: skip-file
 
 import logging
+import subprocess
 import typing
 import unittest
 
@@ -69,6 +70,22 @@ class SqlTransformTest(unittest.TestCase):
   """
   _multiprocess_can_split_ = True
 
+  @staticmethod
+  def _disable_zetasql_test():
+    # disable if run on Java8 which is no longer supported by ZetaSQL
+    try:
+      result = subprocess.run(['java', '-version'],
+                              check=True,
+                              capture_output=True,
+                              text=True)
+      version_line = result.stderr.splitlines()[0]
+      version = version_line.split()[2].strip('\"')
+      if version.startswith("1."):
+        return True
+      return False
+    except:  # pylint: disable=bare-except
+      return False
+
   def test_generate_data(self):
     with TestPipeline() as p:
       out = p | SqlTransform(
@@ -150,6 +167,9 @@ def test_row(self):
       assert_that(out, equal_to([(1, 1), (4, 1), (100, 2)]))
 
   def test_zetasql_generate_data(self):
+    if self._disable_zetasql_test():
+      raise unittest.SkipTest("ZetaSQL tests need Java11+")
+
     with TestPipeline() as p:
       out = p | SqlTransform(
           """SELECT

From 3c9a60bb3bed74af81f9cf0c0922e7c7eebe3f61 Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Mon, 25 Nov 2024 12:05:33 -0800
Subject: [PATCH 016/135] Type hints.

---
 sdks/python/apache_beam/internal/metrics/cells.py        | 2 +-
 sdks/python/apache_beam/metrics/cells.pxd                | 2 +-
 sdks/python/apache_beam/metrics/cells.py                 | 6 ++----
 sdks/python/apache_beam/runners/direct/direct_metrics.py | 4 +++-
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/sdks/python/apache_beam/internal/metrics/cells.py b/sdks/python/apache_beam/internal/metrics/cells.py
index 9a28ba46447a..989dc7183045 100644
--- a/sdks/python/apache_beam/internal/metrics/cells.py
+++ b/sdks/python/apache_beam/internal/metrics/cells.py
@@ -148,5 +148,5 @@ def combine(self, other: Optional['HistogramData']) -> 'HistogramData':
     return HistogramData(self.histogram.combine(other.histogram))
 
   @staticmethod
-  def identity_element(bucket_type) -> HistogramData:
+  def identity_element(bucket_type) -> 'HistogramData':
     return HistogramData(Histogram(bucket_type))
diff --git a/sdks/python/apache_beam/metrics/cells.pxd b/sdks/python/apache_beam/metrics/cells.pxd
index 807aff7fe76a..c583dabeb0c0 100644
--- a/sdks/python/apache_beam/metrics/cells.pxd
+++ b/sdks/python/apache_beam/metrics/cells.pxd
@@ -43,7 +43,7 @@ cdef class DistributionCell(MetricCell):
 
 cdef class AbstractMetricCell(MetricCell):
   cdef readonly object data_class
-  cdef readonly object data
+  cdef public object data
   cdef bint _update_locked(self, value) except -1
 
 
diff --git a/sdks/python/apache_beam/metrics/cells.py b/sdks/python/apache_beam/metrics/cells.py
index ca74d50d1c85..10ac7b3a1e69 100644
--- a/sdks/python/apache_beam/metrics/cells.py
+++ b/sdks/python/apache_beam/metrics/cells.py
@@ -27,11 +27,9 @@
 import threading
 import time
 from datetime import datetime
-from typing import Any
 from typing import Iterable
 from typing import Optional
 from typing import Set
-from typing import SupportsInt
 
 try:
   import cython
@@ -233,7 +231,7 @@ def reset(self):
     self.data = self.data_class.identity_element()
 
   def combine(self, other: 'AbstractMetricCell') -> 'AbstractMetricCell':
-    result = type(self)()
+    result = type(self)()  # type: ignore[call-arg]
     result.data = self.data.combine(other.data)
     return result
 
@@ -506,7 +504,7 @@ def get_cumulative(self):
     # type: () -> DistributionData
     return DistributionData(self.sum, self.count, self.min, self.max)
 
-  def get_result(self):
+  def get_result(self) -> DistributionResult:
     return DistributionResult(self.get_cumulative())
 
   def combine(self, other):
diff --git a/sdks/python/apache_beam/runners/direct/direct_metrics.py b/sdks/python/apache_beam/runners/direct/direct_metrics.py
index 693c0a64538e..d20849d769af 100644
--- a/sdks/python/apache_beam/runners/direct/direct_metrics.py
+++ b/sdks/python/apache_beam/runners/direct/direct_metrics.py
@@ -24,6 +24,8 @@
 
 import threading
 from collections import defaultdict
+from typing import Any
+from typing import SupportsInt
 
 from apache_beam.metrics.cells import DistributionData
 from apache_beam.metrics.cells import GaugeData
@@ -97,7 +99,7 @@ def __init__(self):
     self._distributions = defaultdict(
         lambda: DirectMetric(GenericAggregator(DistributionData)))
     self._gauges = defaultdict(
-        lambda: DirectMetric(GenericAggregator(GuageData)))
+        lambda: DirectMetric(GenericAggregator(GaugeData)))
     self._string_sets = defaultdict(
         lambda: DirectMetric(GenericAggregator(StringSetData)))
 

From ad8545cbb33e10e6ed48aae24358e30b6ffe3fa7 Mon Sep 17 00:00:00 2001
From: liferoad <huxiangqian@gmail.com>
Date: Mon, 25 Nov 2024 21:41:12 -0500
Subject: [PATCH 017/135] [Accenture Baltics] Case Study (#33215)

* [Accenture Baltics] Case Study

* changed the date

* changed the date

* Fixed the captions

* Removed the captions

* removed the link
---
 .../en/case-studies/accenture_baltics.md      | 105 ++++++++++++++++++
 website/www/site/data/en/quotes.yaml          |   5 +
 .../accenture/Jana_Polianskaja_sm.jpg         | Bin 0 -> 284152 bytes
 .../case-study/accenture/dataflow_grafana.jpg | Bin 0 -> 153028 bytes
 .../accenture/dataflow_pipelines.png          | Bin 0 -> 105348 bytes
 5 files changed, 110 insertions(+)
 create mode 100644 website/www/site/content/en/case-studies/accenture_baltics.md
 create mode 100644 website/www/site/static/images/case-study/accenture/Jana_Polianskaja_sm.jpg
 create mode 100644 website/www/site/static/images/case-study/accenture/dataflow_grafana.jpg
 create mode 100644 website/www/site/static/images/case-study/accenture/dataflow_pipelines.png

diff --git a/website/www/site/content/en/case-studies/accenture_baltics.md b/website/www/site/content/en/case-studies/accenture_baltics.md
new file mode 100644
index 000000000000..98f9d9a8a687
--- /dev/null
+++ b/website/www/site/content/en/case-studies/accenture_baltics.md
@@ -0,0 +1,105 @@
+---
+title: "Accenture Baltics' Journey with Apache Beam to Streamlined Data Workflows for a Sustainable Energy Leader"
+name: "Accenture Baltics"
+icon: /images/logos/powered-by/accenture.png
+hasNav: true
+category: study
+cardTitle: "Accenture Baltics' Journey with Apache Beam"
+cardDescription: "Accenture Baltics uses Apache Beam on Google Cloud to build a robust data processing infrastructure for a sustainable energy leader.They use Beam to democratize data access, process data in real-time, and handle complex ETL tasks."
+authorName: "Jana Polianskaja"
+authorPosition: "Data Engineer @ Accenture Baltics"
+authorImg: /images/case-study/accenture/Jana_Polianskaja_sm.jpg
+publishDate: 2024-11-25T00:12:00+00:00
+---
+<!--
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!-- div with class case-study-opinion is displayed at the top left area of the case study page -->
+<div class="case-study-opinion">
+    <div class="case-study-opinion-img">
+        <img src="/images/logos/powered-by/accenture.png"/>
+    </div>
+    <blockquote class="case-study-quote-block">
+      <p class="case-study-quote-text">
+        “Apache Beam empowers team members who don’t have data engineering backgrounds to directly access and analyze BigQuery data by using SQL. The data scientists, the finance department, and production optimization teams all benefit from improved data accessibility, which gives them immediate access to critical information for faster analysis and decision-making.”
+      </p>
+      <div class="case-study-quote-author">
+        <div class="case-study-quote-author-img">
+            <img src="/images/case-study/accenture/Jana_Polianskaja_sm.jpg">
+        </div>
+        <div class="case-study-quote-author-info">
+            <div class="case-study-quote-author-name">
+              Jana Polianskaja
+            </div>
+            <div class="case-study-quote-author-position">
+              Data Engineer @ Accenture Baltics
+            </div>
+        </div>
+      </div>
+    </blockquote>
+</div>
+
+<!-- div with class case-study-post is the case study page main content -->
+<div class="case-study-post">
+
+# Accenture Baltics' Journey with Apache Beam to Streamlined Data Workflows for a Sustainable Energy Leader
+
+## Background
+
+Accenture Baltics, a branch of the global professional services company Accenture, leverages its expertise across various industries to provide consulting, technology, and outsourcing solutions to clients worldwide. A specific project at Accenture Baltics highlights the effective implementation of Apache Beam to support a client who is a global leader in sustainable energy and uses Google Cloud.
+
+## Journey to Apache Beam
+
+The team responsible for transforming, curating, and preparing data, including transactional, analytics, and sensor data, for data scientists and other teams has been using Dataflow with Apache Beam for about five years. Dataflow with Beam is a natural choice for both streaming and batch data processing. For our workloads, we typically use the following configurations: worker machine types are `n1-standard-2` or `n1-standard-4`, and the maximum number of workers varies up to five, using the Dataflow runner.
+
+As an example, a streaming pipeline ingests transaction data from Pub/Sub, performs basic ETL and data cleaning, and outputs the results to BigQuery. A separate batch Dataflow pipeline evaluates a binary classification model, reading input and writing results to Google Cloud Storage. The following diagram shows a workflow that uses Pub/Sub to feed Dataflow pipelines across three Google Cloud projects. It also shows how Dataflow, Composer, Cloud Storage, BigQuery, and Grafana integrate into the architecture.
+
+<div class="post-scheme">
+    <a href="/images/case-study/accenture/dataflow_pipelines.png" target="_blank" title="Click to enlarge">
+        <img src="/images/case-study/accenture/dataflow_pipelines.png" alt="Diagram of Accenture Baltics' Dataflow pipeline architecture">
+    </a>
+</div>
+
+## Use Cases
+
+Apache Beam is an invaluable tool for our use cases, particularly in the following areas:
+
+* **Democratizing data access:** Beam empowers team members without data engineering backgrounds to directly access and analyze BigQuery data using their SQL skills. The data scientists, the finance department, and production optimization teams all benefit from improved data accessibility, gaining immediate access to critical information for faster analysis and decision-making.
+* **Real-time data processing:** Beam excels at ingesting and processing data in real time from sources like Pub/Sub.
+* **ETL (extract, transform, load):** Beam effectively manages the full spectrum of data transformation and cleaning tasks, even when dealing with complex data structures.
+* **Data routing and partitioning:** Beam enables sophisticated data routing and partitioning strategies. For example, it can automatically route failed transactions to a separate BigQuery table for further analysis.
+* **Data deduplication and error handling:** Beam has been instrumental in tackling challenging tasks like deduplicating Pub/Sub messages and implementing robust error handling, such as for JSON parsing, that are crucial for maintaining data integrity and pipeline reliability.
+
+We also utilize Grafana (shown in below) with custom notification emails and tickets for comprehensive monitoring of our Beam pipelines. Notifications are generated from Google’s Cloud Logging and Cloud Monitoring services to ensure we stay informed about the performance and health of our pipelines. The seamless integration of Airflow with Dataflow and Beam further enhances our workflow, allowing us to effortlessly use operators such as `DataflowCreatePythonJobOperator` and `BeamRunPythonPipelineOperator` in [Airflow 2](https://airflow.apache.org/docs/apache-airflow-providers-google/stable/_api/airflow/providers/google/cloud/operators/dataflow/index.html).
+
+<div class="post-scheme">
+    <a href="/images/case-study/accenture/dataflow_grafana.jpg" target="_blank" title="Click to enlarge">
+        <img src="/images/case-study/accenture/dataflow_grafana.jpg" alt="scheme">
+    </a>
+</div>
+
+## Results
+
+Our data processing infrastructure uses 12 distinct pipelines to manage and transform data across various projects within the organization. These pipelines are divided into two primary categories:
+
+* **Streaming pipelines:** These pipelines are designed to handle real-time or near real-time data streams. In our current setup, these pipelines process an average of 10,000 messages per second from Pub/Sub and about 200,000 rows per hour to BigQuery, ensuring that time-sensitive data is ingested and processed with minimal latency.
+* **Batch pipelines:** These pipelines are optimized for processing large volumes of data in scheduled batches. Our current batch pipelines handle approximately two gigabytes of data per month, transforming and loading this data into our data warehouse for further analysis and reporting.
+
+Apache Beam has proven to be a highly effective solution for orchestrating and managing the complex data pipelines required by the client. By leveraging the capabilities of Dataflow, a fully managed service for executing Beam pipelines, we have successfully addressed and fulfilled the client's specific data processing needs. This powerful combination has enabled us to achieve scalability, reliability, and efficiency in handling large volumes of data, ensuring timely and accurate delivery of insights to the client.
+
+*Check out [my Medium blog](https://medium.com/@jana_om)\! I usually post about using Beam/Dataflow as an ETL tool with Python and how it works with other data engineering tools. My focus is on building projects that are easy to understand and learn from, especially if you want to get some hands-on experience with Beam.*
+
+<!-- case_study_feedback adds feedback buttons -->
+{{< case_study_feedback "AccentureBalticsStreaming" >}}
+</div>
+<div class="clear-nav"></div>
diff --git a/website/www/site/data/en/quotes.yaml b/website/www/site/data/en/quotes.yaml
index 4139d855fff5..db45c4344346 100644
--- a/website/www/site/data/en/quotes.yaml
+++ b/website/www/site/data/en/quotes.yaml
@@ -76,6 +76,11 @@
   logoUrl: /images/logos/powered-by/yelp.png
   linkUrl: case-studies/yelp_streaming/index.html
   linkText: Learn more
+- text: Accenture Baltics uses Apache Beam on Google Cloud to build a robust data processing infrastructure for a sustainable energy leader.They use Beam to democratize data access, process data in real-time, and handle complex ETL tasks.
+  icon: icons/quote-icon.svg
+  logoUrl: /images/logos/powered-by/accenture.png
+  linkUrl: case-studies/accenture_baltics/index.html
+  linkText: Learn more
 - text: Have a story to share? Your logo could be here.
   icon: icons/quote-icon.svg
   logoUrl: images/logos/powered-by/blank.jpg
diff --git a/website/www/site/static/images/case-study/accenture/Jana_Polianskaja_sm.jpg b/website/www/site/static/images/case-study/accenture/Jana_Polianskaja_sm.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..1fb63edd227fd2831cda1fb83dc3dab873a49ac0
GIT binary patch
literal 284152
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%0DBXQkGB@y)Vo;W<>
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

literal 0
HcmV?d00001

diff --git a/website/www/site/static/images/case-study/accenture/dataflow_grafana.jpg b/website/www/site/static/images/case-study/accenture/dataflow_grafana.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..8a7471c1798fc177edb19e4a0c7e78f7adcf9652
GIT binary patch
literal 153028
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

literal 0
HcmV?d00001

diff --git a/website/www/site/static/images/case-study/accenture/dataflow_pipelines.png b/website/www/site/static/images/case-study/accenture/dataflow_pipelines.png
new file mode 100644
index 0000000000000000000000000000000000000000..423044910e36ebd67f58545c3e2634e08838ed68
GIT binary patch
literal 105348
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%0DeCDsri%m9)0AD_1#-
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
Jk~Dqze*jMoSLpx%

literal 0
HcmV?d00001


From aa21e4a84b3594e9ddd6ddb436c9628cb6660552 Mon Sep 17 00:00:00 2001
From: martin trieu <martinkt@google.com>
Date: Tue, 26 Nov 2024 02:51:57 -0600
Subject: [PATCH 018/135] Integrate direct path with StreamingDataflowWorker
 code path (#32778)

---
 .../DataflowStreamingPipelineOptions.java     |  15 +-
 .../worker/StreamingDataflowWorker.java       | 594 +++++++++++-------
 .../FanOutStreamingEngineWorkerHarness.java   |   1 +
 .../harness/SingleSourceWorkerHarness.java    |  13 +-
 .../harness/StreamingWorkerHarness.java       |   3 +-
 .../harness/StreamingWorkerStatusPages.java   |   2 +-
 .../StreamingWorkerStatusReporter.java        | 131 ++--
 .../client/throttling/ThrottleTimer.java      |   3 +-
 .../throttling/ThrottledTimeTracker.java      |  32 +
 .../refresh/StreamPoolHeartbeatSender.java    |   4 +-
 .../worker/StreamingDataflowWorkerTest.java   |  42 +-
 .../SingleSourceWorkerHarnessTest.java        |   2 +
 .../StreamingWorkerStatusReporterTest.java    |  53 +-
 .../StreamPoolHeartbeatSenderTest.java        |   6 +-
 14 files changed, 561 insertions(+), 340 deletions(-)
 create mode 100644 runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/throttling/ThrottledTimeTracker.java

diff --git a/runners/google-cloud-dataflow-java/src/main/java/org/apache/beam/runners/dataflow/options/DataflowStreamingPipelineOptions.java b/runners/google-cloud-dataflow-java/src/main/java/org/apache/beam/runners/dataflow/options/DataflowStreamingPipelineOptions.java
index 6a0208f1447f..61c38dde2b42 100644
--- a/runners/google-cloud-dataflow-java/src/main/java/org/apache/beam/runners/dataflow/options/DataflowStreamingPipelineOptions.java
+++ b/runners/google-cloud-dataflow-java/src/main/java/org/apache/beam/runners/dataflow/options/DataflowStreamingPipelineOptions.java
@@ -20,6 +20,7 @@
 import org.apache.beam.sdk.options.Default;
 import org.apache.beam.sdk.options.DefaultValueFactory;
 import org.apache.beam.sdk.options.Description;
+import org.apache.beam.sdk.options.ExperimentalOptions;
 import org.apache.beam.sdk.options.Hidden;
 import org.apache.beam.sdk.options.PipelineOptions;
 import org.joda.time.Duration;
@@ -219,10 +220,8 @@ public interface DataflowStreamingPipelineOptions extends PipelineOptions {
 
   void setWindmillServiceStreamMaxBackoffMillis(int value);
 
-  @Description(
-      "If true, Dataflow streaming pipeline will be running in direct path mode."
-          + " VMs must have IPv6 enabled for this to work.")
-  @Default.Boolean(false)
+  @Description("Enables direct path mode for streaming engine.")
+  @Default.InstanceFactory(EnableWindmillServiceDirectPathFactory.class)
   boolean getIsWindmillServiceDirectPathEnabled();
 
   void setIsWindmillServiceDirectPathEnabled(boolean isWindmillServiceDirectPathEnabled);
@@ -300,4 +299,12 @@ public Integer create(PipelineOptions options) {
       return streamingOptions.isEnableStreamingEngine() ? Integer.MAX_VALUE : 1;
     }
   }
+
+  /** EnableStreamingEngine defaults to false unless one of the experiment is set. */
+  class EnableWindmillServiceDirectPathFactory implements DefaultValueFactory<Boolean> {
+    @Override
+    public Boolean create(PipelineOptions options) {
+      return ExperimentalOptions.hasExperiment(options, "enable_windmill_service_direct_path");
+    }
+  }
 }
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorker.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorker.java
index 6ce60283735f..088a28e9b2db 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorker.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorker.java
@@ -17,11 +17,11 @@
  */
 package org.apache.beam.runners.dataflow.worker;
 
-import static org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.base.Preconditions.checkArgument;
+import static org.apache.beam.runners.dataflow.worker.windmill.client.grpc.stubs.WindmillChannelFactory.remoteChannel;
 
-import com.google.api.services.dataflow.model.CounterUpdate;
 import com.google.api.services.dataflow.model.MapTask;
 import com.google.auto.value.AutoValue;
+import java.io.PrintWriter;
 import java.util.List;
 import java.util.Map;
 import java.util.Optional;
@@ -33,24 +33,28 @@
 import java.util.concurrent.ScheduledExecutorService;
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.function.Consumer;
 import java.util.function.Function;
 import java.util.function.Supplier;
+import javax.annotation.Nullable;
 import org.apache.beam.runners.core.metrics.MetricsLogger;
 import org.apache.beam.runners.dataflow.DataflowRunner;
 import org.apache.beam.runners.dataflow.options.DataflowWorkerHarnessOptions;
-import org.apache.beam.runners.dataflow.worker.counters.DataflowCounterUpdateExtractor;
 import org.apache.beam.runners.dataflow.worker.status.DebugCapture;
 import org.apache.beam.runners.dataflow.worker.status.WorkerStatusPages;
 import org.apache.beam.runners.dataflow.worker.streaming.ComputationState;
 import org.apache.beam.runners.dataflow.worker.streaming.ComputationStateCache;
 import org.apache.beam.runners.dataflow.worker.streaming.StageInfo;
+import org.apache.beam.runners.dataflow.worker.streaming.WeightedSemaphore;
 import org.apache.beam.runners.dataflow.worker.streaming.WorkHeartbeatResponseProcessor;
 import org.apache.beam.runners.dataflow.worker.streaming.config.ComputationConfig;
 import org.apache.beam.runners.dataflow.worker.streaming.config.FixedGlobalConfigHandle;
 import org.apache.beam.runners.dataflow.worker.streaming.config.StreamingApplianceComputationConfigFetcher;
 import org.apache.beam.runners.dataflow.worker.streaming.config.StreamingEngineComputationConfigFetcher;
 import org.apache.beam.runners.dataflow.worker.streaming.config.StreamingGlobalConfig;
+import org.apache.beam.runners.dataflow.worker.streaming.config.StreamingGlobalConfigHandle;
 import org.apache.beam.runners.dataflow.worker.streaming.config.StreamingGlobalConfigHandleImpl;
+import org.apache.beam.runners.dataflow.worker.streaming.harness.FanOutStreamingEngineWorkerHarness;
 import org.apache.beam.runners.dataflow.worker.streaming.harness.SingleSourceWorkerHarness;
 import org.apache.beam.runners.dataflow.worker.streaming.harness.SingleSourceWorkerHarness.GetWorkSender;
 import org.apache.beam.runners.dataflow.worker.streaming.harness.StreamingCounters;
@@ -59,12 +63,15 @@
 import org.apache.beam.runners.dataflow.worker.streaming.harness.StreamingWorkerStatusReporter;
 import org.apache.beam.runners.dataflow.worker.util.BoundedQueueExecutor;
 import org.apache.beam.runners.dataflow.worker.util.MemoryMonitor;
+import org.apache.beam.runners.dataflow.worker.windmill.ApplianceWindmillClient;
 import org.apache.beam.runners.dataflow.worker.windmill.Windmill;
 import org.apache.beam.runners.dataflow.worker.windmill.Windmill.JobHeader;
 import org.apache.beam.runners.dataflow.worker.windmill.WindmillServerStub;
 import org.apache.beam.runners.dataflow.worker.windmill.appliance.JniWindmillApplianceServer;
+import org.apache.beam.runners.dataflow.worker.windmill.client.CloseableStream;
 import org.apache.beam.runners.dataflow.worker.windmill.client.WindmillStream.GetDataStream;
 import org.apache.beam.runners.dataflow.worker.windmill.client.WindmillStreamPool;
+import org.apache.beam.runners.dataflow.worker.windmill.client.commits.Commit;
 import org.apache.beam.runners.dataflow.worker.windmill.client.commits.Commits;
 import org.apache.beam.runners.dataflow.worker.windmill.client.commits.CompleteCommit;
 import org.apache.beam.runners.dataflow.worker.windmill.client.commits.StreamingApplianceWorkCommitter;
@@ -78,8 +85,16 @@
 import org.apache.beam.runners.dataflow.worker.windmill.client.grpc.GrpcDispatcherClient;
 import org.apache.beam.runners.dataflow.worker.windmill.client.grpc.GrpcWindmillServer;
 import org.apache.beam.runners.dataflow.worker.windmill.client.grpc.GrpcWindmillStreamFactory;
+import org.apache.beam.runners.dataflow.worker.windmill.client.grpc.stubs.ChannelCache;
+import org.apache.beam.runners.dataflow.worker.windmill.client.grpc.stubs.ChannelCachingRemoteStubFactory;
+import org.apache.beam.runners.dataflow.worker.windmill.client.grpc.stubs.ChannelCachingStubFactory;
+import org.apache.beam.runners.dataflow.worker.windmill.client.grpc.stubs.IsolationChannel;
+import org.apache.beam.runners.dataflow.worker.windmill.client.grpc.stubs.WindmillStubFactoryFactory;
 import org.apache.beam.runners.dataflow.worker.windmill.client.grpc.stubs.WindmillStubFactoryFactoryImpl;
+import org.apache.beam.runners.dataflow.worker.windmill.client.throttling.ThrottledTimeTracker;
 import org.apache.beam.runners.dataflow.worker.windmill.state.WindmillStateCache;
+import org.apache.beam.runners.dataflow.worker.windmill.work.budget.GetWorkBudget;
+import org.apache.beam.runners.dataflow.worker.windmill.work.budget.GetWorkBudgetDistributors;
 import org.apache.beam.runners.dataflow.worker.windmill.work.processing.StreamingWorkScheduler;
 import org.apache.beam.runners.dataflow.worker.windmill.work.processing.failures.FailureTracker;
 import org.apache.beam.runners.dataflow.worker.windmill.work.processing.failures.StreamingApplianceFailureTracker;
@@ -89,6 +104,7 @@
 import org.apache.beam.runners.dataflow.worker.windmill.work.refresh.ApplianceHeartbeatSender;
 import org.apache.beam.runners.dataflow.worker.windmill.work.refresh.HeartbeatSender;
 import org.apache.beam.runners.dataflow.worker.windmill.work.refresh.StreamPoolHeartbeatSender;
+import org.apache.beam.sdk.annotations.Internal;
 import org.apache.beam.sdk.fn.IdGenerator;
 import org.apache.beam.sdk.fn.IdGenerators;
 import org.apache.beam.sdk.fn.JvmInitializers;
@@ -98,18 +114,25 @@
 import org.apache.beam.sdk.metrics.MetricsEnvironment;
 import org.apache.beam.sdk.util.construction.CoderTranslation;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.annotations.VisibleForTesting;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.base.Preconditions;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.CacheStats;
-import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.Iterables;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableSet;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.net.HostAndPort;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.util.concurrent.ThreadFactoryBuilder;
 import org.joda.time.Duration;
 import org.joda.time.Instant;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-/** Implements a Streaming Dataflow worker. */
+/**
+ * <b>For internal use only.</b>
+ *
+ * <p>Implements a Streaming Dataflow worker.
+ */
 @SuppressWarnings({
   "nullness" // TODO(https://github.com/apache/beam/issues/20497)
 })
+@Internal
 public final class StreamingDataflowWorker {
 
   /**
@@ -142,6 +165,10 @@ public final class StreamingDataflowWorker {
   private static final int DEFAULT_STATUS_PORT = 8081;
   private static final Random CLIENT_ID_GENERATOR = new Random();
   private static final String CHANNELZ_PATH = "/channelz";
+  private static final String BEAM_FN_API_EXPERIMENT = "beam_fn_api";
+  private static final String ENABLE_IPV6_EXPERIMENT = "enable_private_ipv6_google_access";
+  private static final String STREAMING_ENGINE_USE_JOB_SETTINGS_FOR_HEARTBEAT_POOL_EXPERIMENT =
+      "streaming_engine_use_job_settings_for_heartbeat_pool";
 
   private final WindmillStateCache stateCache;
   private final StreamingWorkerStatusPages statusPages;
@@ -155,9 +182,8 @@ public final class StreamingDataflowWorker {
   private final ReaderCache readerCache;
   private final DataflowExecutionStateSampler sampler = DataflowExecutionStateSampler.instance();
   private final ActiveWorkRefresher activeWorkRefresher;
-  private final WorkCommitter workCommitter;
   private final StreamingWorkerStatusReporter workerStatusReporter;
-  private final StreamingCounters streamingCounters;
+  private final int numCommitThreads;
 
   private StreamingDataflowWorker(
       WindmillServerStub windmillServer,
@@ -170,17 +196,17 @@ private StreamingDataflowWorker(
       DataflowWorkerHarnessOptions options,
       HotKeyLogger hotKeyLogger,
       Supplier<Instant> clock,
-      StreamingWorkerStatusReporter workerStatusReporter,
+      StreamingWorkerStatusReporterFactory streamingWorkerStatusReporterFactory,
       FailureTracker failureTracker,
       WorkFailureProcessor workFailureProcessor,
       StreamingCounters streamingCounters,
       MemoryMonitor memoryMonitor,
       GrpcWindmillStreamFactory windmillStreamFactory,
       ScheduledExecutorService activeWorkRefreshExecutorFn,
-      ConcurrentMap<String, StageInfo> stageInfoMap) {
+      ConcurrentMap<String, StageInfo> stageInfoMap,
+      @Nullable GrpcDispatcherClient dispatcherClient) {
     // Register standard file systems.
     FileSystems.setDefaultPipelineOptions(options);
-
     this.configFetcher = configFetcher;
     this.computationStateCache = computationStateCache;
     this.stateCache = windmillStateCache;
@@ -189,35 +215,13 @@ private StreamingDataflowWorker(
             Duration.standardSeconds(options.getReaderCacheTimeoutSec()),
             Executors.newCachedThreadPool());
     this.options = options;
-
-    boolean windmillServiceEnabled = options.isEnableStreamingEngine();
-
-    int numCommitThreads = 1;
-    if (windmillServiceEnabled && options.getWindmillServiceCommitThreads() > 0) {
-      numCommitThreads = options.getWindmillServiceCommitThreads();
-    }
-
-    this.workCommitter =
-        windmillServiceEnabled
-            ? StreamingEngineWorkCommitter.builder()
-                .setCommitByteSemaphore(Commits.maxCommitByteSemaphore())
-                .setCommitWorkStreamFactory(
-                    WindmillStreamPool.create(
-                            numCommitThreads,
-                            COMMIT_STREAM_TIMEOUT,
-                            windmillServer::commitWorkStream)
-                        ::getCloseableStream)
-                .setNumCommitSenders(numCommitThreads)
-                .setOnCommitComplete(this::onCompleteCommit)
-                .build()
-            : StreamingApplianceWorkCommitter.create(
-                windmillServer::commitWork, this::onCompleteCommit);
-
     this.workUnitExecutor = workUnitExecutor;
-
-    this.workerStatusReporter = workerStatusReporter;
-    this.streamingCounters = streamingCounters;
     this.memoryMonitor = BackgroundMemoryMonitor.create(memoryMonitor);
+    this.numCommitThreads =
+        options.isEnableStreamingEngine()
+            ? Math.max(options.getWindmillServiceCommitThreads(), 1)
+            : 1;
+
     StreamingWorkScheduler streamingWorkScheduler =
         StreamingWorkScheduler.create(
             options,
@@ -234,107 +238,200 @@ private StreamingDataflowWorker(
             ID_GENERATOR,
             configFetcher.getGlobalConfigHandle(),
             stageInfoMap);
-
     ThrottlingGetDataMetricTracker getDataMetricTracker =
         new ThrottlingGetDataMetricTracker(memoryMonitor);
-    WorkerStatusPages workerStatusPages =
-        WorkerStatusPages.create(DEFAULT_STATUS_PORT, memoryMonitor);
-    StreamingWorkerStatusPages.Builder statusPagesBuilder = StreamingWorkerStatusPages.builder();
-    int stuckCommitDurationMillis;
-    GetDataClient getDataClient;
-    HeartbeatSender heartbeatSender;
-    if (windmillServiceEnabled) {
-      WindmillStreamPool<GetDataStream> getDataStreamPool =
-          WindmillStreamPool.create(
-              Math.max(1, options.getWindmillGetDataStreamCount()),
-              GET_DATA_STREAM_TIMEOUT,
-              windmillServer::getDataStream);
-      getDataClient = new StreamPoolGetDataClient(getDataMetricTracker, getDataStreamPool);
-      if (options.getUseSeparateWindmillHeartbeatStreams() != null) {
+    // Status page members. Different implementations on whether the harness is streaming engine
+    // direct path, streaming engine cloud path, or streaming appliance.
+    @Nullable ChannelzServlet channelzServlet = null;
+    Consumer<PrintWriter> getDataStatusProvider;
+    Supplier<Long> currentActiveCommitBytesProvider;
+    if (isDirectPathPipeline(options)) {
+      WeightedSemaphore<Commit> maxCommitByteSemaphore = Commits.maxCommitByteSemaphore();
+      FanOutStreamingEngineWorkerHarness fanOutStreamingEngineWorkerHarness =
+          FanOutStreamingEngineWorkerHarness.create(
+              createJobHeader(options, clientId),
+              GetWorkBudget.builder()
+                  .setItems(chooseMaxBundlesOutstanding(options))
+                  .setBytes(MAX_GET_WORK_FETCH_BYTES)
+                  .build(),
+              windmillStreamFactory,
+              (workItem, watermarks, processingContext, getWorkStreamLatencies) ->
+                  computationStateCache
+                      .get(processingContext.computationId())
+                      .ifPresent(
+                          computationState -> {
+                            memoryMonitor.waitForResources("GetWork");
+                            streamingWorkScheduler.scheduleWork(
+                                computationState,
+                                workItem,
+                                watermarks,
+                                processingContext,
+                                getWorkStreamLatencies);
+                          }),
+              createFanOutStubFactory(options),
+              GetWorkBudgetDistributors.distributeEvenly(),
+              Preconditions.checkNotNull(dispatcherClient),
+              commitWorkStream ->
+                  StreamingEngineWorkCommitter.builder()
+                      // Share the commitByteSemaphore across all created workCommitters.
+                      .setCommitByteSemaphore(maxCommitByteSemaphore)
+                      .setBackendWorkerToken(commitWorkStream.backendWorkerToken())
+                      .setOnCommitComplete(this::onCompleteCommit)
+                      .setNumCommitSenders(Math.max(options.getWindmillServiceCommitThreads(), 1))
+                      .setCommitWorkStreamFactory(
+                          () -> CloseableStream.create(commitWorkStream, () -> {}))
+                      .build(),
+              getDataMetricTracker);
+      getDataStatusProvider = getDataMetricTracker::printHtml;
+      currentActiveCommitBytesProvider =
+          fanOutStreamingEngineWorkerHarness::currentActiveCommitBytes;
+      channelzServlet =
+          createChannelzServlet(
+              options, fanOutStreamingEngineWorkerHarness::currentWindmillEndpoints);
+      this.streamingWorkerHarness = fanOutStreamingEngineWorkerHarness;
+    } else {
+      // Non-direct path pipelines.
+      Windmill.GetWorkRequest request =
+          Windmill.GetWorkRequest.newBuilder()
+              .setClientId(clientId)
+              .setMaxItems(chooseMaxBundlesOutstanding(options))
+              .setMaxBytes(MAX_GET_WORK_FETCH_BYTES)
+              .build();
+      GetDataClient getDataClient;
+      HeartbeatSender heartbeatSender;
+      WorkCommitter workCommitter;
+      GetWorkSender getWorkSender;
+      if (options.isEnableStreamingEngine()) {
+        WindmillStreamPool<GetDataStream> getDataStreamPool =
+            WindmillStreamPool.create(
+                Math.max(1, options.getWindmillGetDataStreamCount()),
+                GET_DATA_STREAM_TIMEOUT,
+                windmillServer::getDataStream);
+        getDataClient = new StreamPoolGetDataClient(getDataMetricTracker, getDataStreamPool);
         heartbeatSender =
-            StreamPoolHeartbeatSender.Create(
-                Boolean.TRUE.equals(options.getUseSeparateWindmillHeartbeatStreams())
-                    ? separateHeartbeatPool(windmillServer)
-                    : getDataStreamPool);
-
+            createStreamingEngineHeartbeatSender(
+                options, windmillServer, getDataStreamPool, configFetcher.getGlobalConfigHandle());
+        channelzServlet =
+            createChannelzServlet(options, windmillServer::getWindmillServiceEndpoints);
+        workCommitter =
+            StreamingEngineWorkCommitter.builder()
+                .setCommitWorkStreamFactory(
+                    WindmillStreamPool.create(
+                            numCommitThreads,
+                            COMMIT_STREAM_TIMEOUT,
+                            windmillServer::commitWorkStream)
+                        ::getCloseableStream)
+                .setCommitByteSemaphore(Commits.maxCommitByteSemaphore())
+                .setNumCommitSenders(numCommitThreads)
+                .setOnCommitComplete(this::onCompleteCommit)
+                .build();
+        getWorkSender =
+            GetWorkSender.forStreamingEngine(
+                receiver -> windmillServer.getWorkStream(request, receiver));
       } else {
-        heartbeatSender =
-            StreamPoolHeartbeatSender.Create(
-                separateHeartbeatPool(windmillServer),
-                getDataStreamPool,
-                configFetcher.getGlobalConfigHandle());
+        getDataClient = new ApplianceGetDataClient(windmillServer, getDataMetricTracker);
+        heartbeatSender = new ApplianceHeartbeatSender(windmillServer::getData);
+        workCommitter =
+            StreamingApplianceWorkCommitter.create(
+                windmillServer::commitWork, this::onCompleteCommit);
+        getWorkSender = GetWorkSender.forAppliance(() -> windmillServer.getWork(request));
       }
 
-      stuckCommitDurationMillis =
-          options.getStuckCommitDurationMillis() > 0 ? options.getStuckCommitDurationMillis() : 0;
-      statusPagesBuilder
-          .setDebugCapture(
-              new DebugCapture.Manager(options, workerStatusPages.getDebugCapturePages()))
-          .setChannelzServlet(
-              new ChannelzServlet(
-                  CHANNELZ_PATH, options, windmillServer::getWindmillServiceEndpoints))
-          .setWindmillStreamFactory(windmillStreamFactory);
-    } else {
-      getDataClient = new ApplianceGetDataClient(windmillServer, getDataMetricTracker);
-      heartbeatSender = new ApplianceHeartbeatSender(windmillServer::getData);
-      stuckCommitDurationMillis = 0;
+      getDataStatusProvider = getDataClient::printHtml;
+      currentActiveCommitBytesProvider = workCommitter::currentActiveCommitBytes;
+
+      this.streamingWorkerHarness =
+          SingleSourceWorkerHarness.builder()
+              .setStreamingWorkScheduler(streamingWorkScheduler)
+              .setWorkCommitter(workCommitter)
+              .setGetDataClient(getDataClient)
+              .setComputationStateFetcher(this.computationStateCache::get)
+              .setWaitForResources(() -> memoryMonitor.waitForResources("GetWork"))
+              .setHeartbeatSender(heartbeatSender)
+              .setThrottledTimeTracker(windmillServer::getAndResetThrottleTime)
+              .setGetWorkSender(getWorkSender)
+              .build();
     }
 
+    this.workerStatusReporter =
+        streamingWorkerStatusReporterFactory.createStatusReporter(streamingWorkerHarness);
     this.activeWorkRefresher =
         new ActiveWorkRefresher(
             clock,
             options.getActiveWorkRefreshPeriodMillis(),
-            stuckCommitDurationMillis,
+            options.isEnableStreamingEngine()
+                ? Math.max(options.getStuckCommitDurationMillis(), 0)
+                : 0,
             computationStateCache::getAllPresentComputations,
             sampler,
             activeWorkRefreshExecutorFn,
             getDataMetricTracker::trackHeartbeats);
 
     this.statusPages =
-        statusPagesBuilder
+        createStatusPageBuilder(options, windmillStreamFactory, memoryMonitor)
             .setClock(clock)
             .setClientId(clientId)
             .setIsRunning(running)
-            .setStatusPages(workerStatusPages)
             .setStateCache(stateCache)
             .setComputationStateCache(this.computationStateCache)
-            .setCurrentActiveCommitBytes(workCommitter::currentActiveCommitBytes)
-            .setGetDataStatusProvider(getDataClient::printHtml)
             .setWorkUnitExecutor(workUnitExecutor)
             .setGlobalConfigHandle(configFetcher.getGlobalConfigHandle())
+            .setChannelzServlet(channelzServlet)
+            .setGetDataStatusProvider(getDataStatusProvider)
+            .setCurrentActiveCommitBytes(currentActiveCommitBytesProvider)
             .build();
 
-    Windmill.GetWorkRequest request =
-        Windmill.GetWorkRequest.newBuilder()
-            .setClientId(clientId)
-            .setMaxItems(chooseMaximumBundlesOutstanding())
-            .setMaxBytes(MAX_GET_WORK_FETCH_BYTES)
-            .build();
-
-    this.streamingWorkerHarness =
-        SingleSourceWorkerHarness.builder()
-            .setStreamingWorkScheduler(streamingWorkScheduler)
-            .setWorkCommitter(workCommitter)
-            .setGetDataClient(getDataClient)
-            .setComputationStateFetcher(this.computationStateCache::get)
-            .setWaitForResources(() -> memoryMonitor.waitForResources("GetWork"))
-            .setHeartbeatSender(heartbeatSender)
-            .setGetWorkSender(
-                windmillServiceEnabled
-                    ? GetWorkSender.forStreamingEngine(
-                        receiver -> windmillServer.getWorkStream(request, receiver))
-                    : GetWorkSender.forAppliance(() -> windmillServer.getWork(request)))
-            .build();
-
-    LOG.debug("windmillServiceEnabled: {}", windmillServiceEnabled);
+    LOG.debug("isDirectPathEnabled: {}", options.getIsWindmillServiceDirectPathEnabled());
+    LOG.debug("windmillServiceEnabled: {}", options.isEnableStreamingEngine());
     LOG.debug("WindmillServiceEndpoint: {}", options.getWindmillServiceEndpoint());
     LOG.debug("WindmillServicePort: {}", options.getWindmillServicePort());
     LOG.debug("LocalWindmillHostport: {}", options.getLocalWindmillHostport());
   }
 
-  private static WindmillStreamPool<GetDataStream> separateHeartbeatPool(
-      WindmillServerStub windmillServer) {
-    return WindmillStreamPool.create(1, GET_DATA_STREAM_TIMEOUT, windmillServer::getDataStream);
+  private static StreamingWorkerStatusPages.Builder createStatusPageBuilder(
+      DataflowWorkerHarnessOptions options,
+      GrpcWindmillStreamFactory windmillStreamFactory,
+      MemoryMonitor memoryMonitor) {
+    WorkerStatusPages workerStatusPages =
+        WorkerStatusPages.create(DEFAULT_STATUS_PORT, memoryMonitor);
+
+    StreamingWorkerStatusPages.Builder streamingStatusPages =
+        StreamingWorkerStatusPages.builder().setStatusPages(workerStatusPages);
+
+    return options.isEnableStreamingEngine()
+        ? streamingStatusPages
+            .setDebugCapture(
+                new DebugCapture.Manager(options, workerStatusPages.getDebugCapturePages()))
+            .setWindmillStreamFactory(windmillStreamFactory)
+        : streamingStatusPages;
+  }
+
+  private static ChannelzServlet createChannelzServlet(
+      DataflowWorkerHarnessOptions options,
+      Supplier<ImmutableSet<HostAndPort>> windmillEndpointProvider) {
+    return new ChannelzServlet(CHANNELZ_PATH, options, windmillEndpointProvider);
+  }
+
+  private static HeartbeatSender createStreamingEngineHeartbeatSender(
+      DataflowWorkerHarnessOptions options,
+      WindmillServerStub windmillClient,
+      WindmillStreamPool<GetDataStream> getDataStreamPool,
+      StreamingGlobalConfigHandle globalConfigHandle) {
+    // Experiment gates the logic till backend changes are rollback safe
+    if (!DataflowRunner.hasExperiment(
+            options, STREAMING_ENGINE_USE_JOB_SETTINGS_FOR_HEARTBEAT_POOL_EXPERIMENT)
+        || options.getUseSeparateWindmillHeartbeatStreams() != null) {
+      return StreamPoolHeartbeatSender.create(
+          Boolean.TRUE.equals(options.getUseSeparateWindmillHeartbeatStreams())
+              ? WindmillStreamPool.create(1, GET_DATA_STREAM_TIMEOUT, windmillClient::getDataStream)
+              : getDataStreamPool);
+
+    } else {
+      return StreamPoolHeartbeatSender.create(
+          WindmillStreamPool.create(1, GET_DATA_STREAM_TIMEOUT, windmillClient::getDataStream),
+          getDataStreamPool,
+          globalConfigHandle);
+    }
   }
 
   public static StreamingDataflowWorker fromOptions(DataflowWorkerHarnessOptions options) {
@@ -387,17 +484,21 @@ public static StreamingDataflowWorker fromOptions(DataflowWorkerHarnessOptions o
             failureTracker,
             () -> Optional.ofNullable(memoryMonitor.tryToDumpHeap()),
             clock);
-    StreamingWorkerStatusReporter workerStatusReporter =
-        StreamingWorkerStatusReporter.create(
-            dataflowServiceClient,
-            windmillServer::getAndResetThrottleTime,
-            stageInfo::values,
-            failureTracker,
-            streamingCounters,
-            memoryMonitor,
-            workExecutor,
-            options.getWindmillHarnessUpdateReportingPeriod().getMillis(),
-            options.getPerWorkerMetricsUpdateReportingPeriodMillis());
+    StreamingWorkerStatusReporterFactory workerStatusReporterFactory =
+        throttleTimeSupplier ->
+            StreamingWorkerStatusReporter.builder()
+                .setDataflowServiceClient(dataflowServiceClient)
+                .setWindmillQuotaThrottleTime(throttleTimeSupplier)
+                .setAllStageInfo(stageInfo::values)
+                .setFailureTracker(failureTracker)
+                .setStreamingCounters(streamingCounters)
+                .setMemoryMonitor(memoryMonitor)
+                .setWorkExecutor(workExecutor)
+                .setWindmillHarnessUpdateReportingPeriodMillis(
+                    options.getWindmillHarnessUpdateReportingPeriod().getMillis())
+                .setPerWorkerMetricsUpdateReportingPeriodMillis(
+                    options.getPerWorkerMetricsUpdateReportingPeriodMillis())
+                .build();
 
     return new StreamingDataflowWorker(
         windmillServer,
@@ -410,7 +511,7 @@ public static StreamingDataflowWorker fromOptions(DataflowWorkerHarnessOptions o
         options,
         new HotKeyLogger(),
         clock,
-        workerStatusReporter,
+        workerStatusReporterFactory,
         failureTracker,
         workFailureProcessor,
         streamingCounters,
@@ -418,7 +519,8 @@ public static StreamingDataflowWorker fromOptions(DataflowWorkerHarnessOptions o
         configFetcherComputationStateCacheAndWindmillClient.windmillStreamFactory(),
         Executors.newSingleThreadScheduledExecutor(
             new ThreadFactoryBuilder().setNameFormat("RefreshWork").build()),
-        stageInfo);
+        stageInfo,
+        configFetcherComputationStateCacheAndWindmillClient.windmillDispatcherClient());
   }
 
   /**
@@ -433,53 +535,121 @@ public static StreamingDataflowWorker fromOptions(DataflowWorkerHarnessOptions o
           WorkUnitClient dataflowServiceClient,
           GrpcWindmillStreamFactory.Builder windmillStreamFactoryBuilder,
           Function<ComputationConfig.Fetcher, ComputationStateCache> computationStateCacheFactory) {
-    ComputationConfig.Fetcher configFetcher;
-    WindmillServerStub windmillServer;
-    ComputationStateCache computationStateCache;
-    GrpcWindmillStreamFactory windmillStreamFactory;
     if (options.isEnableStreamingEngine()) {
       GrpcDispatcherClient dispatcherClient =
           GrpcDispatcherClient.create(options, new WindmillStubFactoryFactoryImpl(options));
-      configFetcher =
+      ComputationConfig.Fetcher configFetcher =
           StreamingEngineComputationConfigFetcher.create(
               options.getGlobalConfigRefreshPeriod().getMillis(), dataflowServiceClient);
       configFetcher.getGlobalConfigHandle().registerConfigObserver(dispatcherClient::onJobConfig);
-      computationStateCache = computationStateCacheFactory.apply(configFetcher);
-      windmillStreamFactory =
+      ComputationStateCache computationStateCache =
+          computationStateCacheFactory.apply(configFetcher);
+      GrpcWindmillStreamFactory windmillStreamFactory =
           windmillStreamFactoryBuilder
               .setProcessHeartbeatResponses(
                   new WorkHeartbeatResponseProcessor(computationStateCache::get))
               .setHealthCheckIntervalMillis(
                   options.getWindmillServiceStreamingRpcHealthCheckPeriodMs())
               .build();
-      windmillServer = GrpcWindmillServer.create(options, windmillStreamFactory, dispatcherClient);
-    } else {
-      if (options.getWindmillServiceEndpoint() != null
-          || options.getLocalWindmillHostport().startsWith("grpc:")) {
-        windmillStreamFactory =
-            windmillStreamFactoryBuilder
-                .setHealthCheckIntervalMillis(
-                    options.getWindmillServiceStreamingRpcHealthCheckPeriodMs())
-                .build();
-        windmillServer =
-            GrpcWindmillServer.create(
-                options,
-                windmillStreamFactory,
-                GrpcDispatcherClient.create(options, new WindmillStubFactoryFactoryImpl(options)));
-      } else {
-        windmillStreamFactory = windmillStreamFactoryBuilder.build();
-        windmillServer = new JniWindmillApplianceServer(options.getLocalWindmillHostport());
+      return ConfigFetcherComputationStateCacheAndWindmillClient.builder()
+          .setWindmillDispatcherClient(dispatcherClient)
+          .setConfigFetcher(configFetcher)
+          .setComputationStateCache(computationStateCache)
+          .setWindmillStreamFactory(windmillStreamFactory)
+          .setWindmillServer(
+              GrpcWindmillServer.create(options, windmillStreamFactory, dispatcherClient))
+          .build();
+    }
+
+    // Build with local Windmill client.
+    if (options.getWindmillServiceEndpoint() != null
+        || options.getLocalWindmillHostport().startsWith("grpc:")) {
+      GrpcDispatcherClient dispatcherClient =
+          GrpcDispatcherClient.create(options, new WindmillStubFactoryFactoryImpl(options));
+      GrpcWindmillStreamFactory windmillStreamFactory =
+          windmillStreamFactoryBuilder
+              .setHealthCheckIntervalMillis(
+                  options.getWindmillServiceStreamingRpcHealthCheckPeriodMs())
+              .build();
+      GrpcWindmillServer windmillServer =
+          GrpcWindmillServer.create(options, windmillStreamFactory, dispatcherClient);
+      ComputationConfig.Fetcher configFetcher =
+          createApplianceComputationConfigFetcher(windmillServer);
+      return ConfigFetcherComputationStateCacheAndWindmillClient.builder()
+          .setWindmillDispatcherClient(dispatcherClient)
+          .setWindmillServer(windmillServer)
+          .setWindmillStreamFactory(windmillStreamFactory)
+          .setConfigFetcher(configFetcher)
+          .setComputationStateCache(computationStateCacheFactory.apply(configFetcher))
+          .build();
+    }
+
+    WindmillServerStub windmillServer =
+        new JniWindmillApplianceServer(options.getLocalWindmillHostport());
+    ComputationConfig.Fetcher configFetcher =
+        createApplianceComputationConfigFetcher(windmillServer);
+    return ConfigFetcherComputationStateCacheAndWindmillClient.builder()
+        .setWindmillStreamFactory(windmillStreamFactoryBuilder.build())
+        .setWindmillServer(windmillServer)
+        .setConfigFetcher(configFetcher)
+        .setComputationStateCache(computationStateCacheFactory.apply(configFetcher))
+        .build();
+  }
+
+  private static StreamingApplianceComputationConfigFetcher createApplianceComputationConfigFetcher(
+      ApplianceWindmillClient windmillClient) {
+    return new StreamingApplianceComputationConfigFetcher(
+        windmillClient::getConfig,
+        new FixedGlobalConfigHandle(StreamingGlobalConfig.builder().build()));
+  }
+
+  private static boolean isDirectPathPipeline(DataflowWorkerHarnessOptions options) {
+    if (options.isEnableStreamingEngine() && options.getIsWindmillServiceDirectPathEnabled()) {
+      boolean isIpV6Enabled =
+          Optional.ofNullable(options.getDataflowServiceOptions())
+              .map(serviceOptions -> serviceOptions.contains(ENABLE_IPV6_EXPERIMENT))
+              .orElse(false);
+
+      if (isIpV6Enabled) {
+        return true;
       }
 
-      configFetcher =
-          new StreamingApplianceComputationConfigFetcher(
-              windmillServer::getConfig,
-              new FixedGlobalConfigHandle(StreamingGlobalConfig.builder().build()));
-      computationStateCache = computationStateCacheFactory.apply(configFetcher);
+      LOG.warn(
+          "DirectPath is currently only supported with IPv6 networking stack. This requires setting "
+              + "\"enable_private_ipv6_google_access\" in experimental pipeline options. "
+              + "For information on how to set experimental pipeline options see "
+              + "https://cloud.google.com/dataflow/docs/guides/setting-pipeline-options#experimental. "
+              + "Defaulting to CloudPath.");
     }
 
-    return ConfigFetcherComputationStateCacheAndWindmillClient.create(
-        configFetcher, computationStateCache, windmillServer, windmillStreamFactory);
+    return false;
+  }
+
+  private static void validateWorkerOptions(DataflowWorkerHarnessOptions options) {
+    Preconditions.checkArgument(
+        options.isStreaming(),
+        "%s instantiated with options indicating batch use",
+        StreamingDataflowWorker.class.getName());
+
+    Preconditions.checkArgument(
+        !DataflowRunner.hasExperiment(options, BEAM_FN_API_EXPERIMENT),
+        "%s cannot be main() class with beam_fn_api enabled",
+        StreamingDataflowWorker.class.getSimpleName());
+  }
+
+  private static ChannelCachingStubFactory createFanOutStubFactory(
+      DataflowWorkerHarnessOptions workerOptions) {
+    return ChannelCachingRemoteStubFactory.create(
+        workerOptions.getGcpCredential(),
+        ChannelCache.create(
+            serviceAddress ->
+                // IsolationChannel will create and manage separate RPC channels to the same
+                // serviceAddress.
+                IsolationChannel.create(
+                    () ->
+                        remoteChannel(
+                            serviceAddress,
+                            workerOptions.getWindmillServiceRpcChannelAliveTimeoutSec()))));
   }
 
   @VisibleForTesting
@@ -495,7 +665,9 @@ static StreamingDataflowWorker forTesting(
       Supplier<Instant> clock,
       Function<String, ScheduledExecutorService> executorSupplier,
       StreamingGlobalConfigHandleImpl globalConfigHandle,
-      int localRetryTimeoutMs) {
+      int localRetryTimeoutMs,
+      StreamingCounters streamingCounters,
+      WindmillStubFactoryFactory stubFactory) {
     ConcurrentMap<String, StageInfo> stageInfo = new ConcurrentHashMap<>();
     BoundedQueueExecutor workExecutor = createWorkUnitExecutor(options);
     WindmillStateCache stateCache =
@@ -538,7 +710,6 @@ static StreamingDataflowWorker forTesting(
                 stateNameMap,
                 stateCache.forComputation(mapTask.getStageName())));
     MemoryMonitor memoryMonitor = MemoryMonitor.fromOptions(options);
-    StreamingCounters streamingCounters = StreamingCounters.create();
     FailureTracker failureTracker =
         options.isEnableStreamingEngine()
             ? StreamingEngineFailureTracker.create(
@@ -554,19 +725,23 @@ static StreamingDataflowWorker forTesting(
             () -> Optional.ofNullable(memoryMonitor.tryToDumpHeap()),
             clock,
             localRetryTimeoutMs);
-    StreamingWorkerStatusReporter workerStatusReporter =
-        StreamingWorkerStatusReporter.forTesting(
-            publishCounters,
-            workUnitClient,
-            windmillServer::getAndResetThrottleTime,
-            stageInfo::values,
-            failureTracker,
-            streamingCounters,
-            memoryMonitor,
-            workExecutor,
-            executorSupplier,
-            options.getWindmillHarnessUpdateReportingPeriod().getMillis(),
-            options.getPerWorkerMetricsUpdateReportingPeriodMillis());
+    StreamingWorkerStatusReporterFactory workerStatusReporterFactory =
+        throttleTimeSupplier ->
+            StreamingWorkerStatusReporter.builder()
+                .setPublishCounters(publishCounters)
+                .setDataflowServiceClient(workUnitClient)
+                .setWindmillQuotaThrottleTime(throttleTimeSupplier)
+                .setAllStageInfo(stageInfo::values)
+                .setFailureTracker(failureTracker)
+                .setStreamingCounters(streamingCounters)
+                .setMemoryMonitor(memoryMonitor)
+                .setWorkExecutor(workExecutor)
+                .setExecutorFactory(executorSupplier)
+                .setWindmillHarnessUpdateReportingPeriodMillis(
+                    options.getWindmillHarnessUpdateReportingPeriod().getMillis())
+                .setPerWorkerMetricsUpdateReportingPeriodMillis(
+                    options.getPerWorkerMetricsUpdateReportingPeriodMillis())
+                .build();
 
     GrpcWindmillStreamFactory.Builder windmillStreamFactory =
         createGrpcwindmillStreamFactoryBuilder(options, 1)
@@ -584,7 +759,7 @@ static StreamingDataflowWorker forTesting(
         options,
         hotKeyLogger,
         clock,
-        workerStatusReporter,
+        workerStatusReporterFactory,
         failureTracker,
         workFailureProcessor,
         streamingCounters,
@@ -596,7 +771,8 @@ static StreamingDataflowWorker forTesting(
                 .build()
             : windmillStreamFactory.build(),
         executorSupplier.apply("RefreshWork"),
-        stageInfo);
+        stageInfo,
+        GrpcDispatcherClient.create(options, stubFactory));
   }
 
   private static GrpcWindmillStreamFactory.Builder createGrpcwindmillStreamFactoryBuilder(
@@ -605,13 +781,7 @@ private static GrpcWindmillStreamFactory.Builder createGrpcwindmillStreamFactory
         !options.isEnableStreamingEngine() && options.getLocalWindmillHostport() != null
             ? GrpcWindmillServer.LOCALHOST_MAX_BACKOFF
             : Duration.millis(options.getWindmillServiceStreamMaxBackoffMillis());
-    return GrpcWindmillStreamFactory.of(
-            JobHeader.newBuilder()
-                .setJobId(options.getJobId())
-                .setProjectId(options.getProject())
-                .setWorkerId(options.getWorkerId())
-                .setClientId(clientId)
-                .build())
+    return GrpcWindmillStreamFactory.of(createJobHeader(options, clientId))
         .setWindmillMessagesBetweenIsReadyChecks(options.getWindmillMessagesBetweenIsReadyChecks())
         .setMaxBackOffSupplier(() -> maxBackoff)
         .setLogEveryNStreamFailures(options.getWindmillServiceStreamingLogEveryNStreamFailures())
@@ -622,6 +792,15 @@ private static GrpcWindmillStreamFactory.Builder createGrpcwindmillStreamFactory
                     options, "streaming_engine_disable_new_heartbeat_requests"));
   }
 
+  private static JobHeader createJobHeader(DataflowWorkerHarnessOptions options, long clientId) {
+    return JobHeader.newBuilder()
+        .setJobId(options.getJobId())
+        .setProjectId(options.getProject())
+        .setWorkerId(options.getWorkerId())
+        .setClientId(clientId)
+        .build();
+  }
+
   private static BoundedQueueExecutor createWorkUnitExecutor(DataflowWorkerHarnessOptions options) {
     return new BoundedQueueExecutor(
         chooseMaxThreads(options),
@@ -640,15 +819,7 @@ public static void main(String[] args) throws Exception {
         DataflowWorkerHarnessHelper.initializeGlobalStateAndPipelineOptions(
             StreamingDataflowWorker.class, DataflowWorkerHarnessOptions.class);
     DataflowWorkerHarnessHelper.configureLogging(options);
-    checkArgument(
-        options.isStreaming(),
-        "%s instantiated with options indicating batch use",
-        StreamingDataflowWorker.class.getName());
-
-    checkArgument(
-        !DataflowRunner.hasExperiment(options, "beam_fn_api"),
-        "%s cannot be main() class with beam_fn_api enabled",
-        StreamingDataflowWorker.class.getSimpleName());
+    validateWorkerOptions(options);
 
     CoderTranslation.verifyModelCodersRegistered();
 
@@ -705,21 +876,6 @@ void reportPeriodicWorkerUpdatesForTest() {
     workerStatusReporter.reportPeriodicWorkerUpdates();
   }
 
-  private int chooseMaximumNumberOfThreads() {
-    if (options.getNumberOfWorkerHarnessThreads() != 0) {
-      return options.getNumberOfWorkerHarnessThreads();
-    }
-    return MAX_PROCESSING_THREADS;
-  }
-
-  private int chooseMaximumBundlesOutstanding() {
-    int maxBundles = options.getMaxBundlesFromWindmillOutstanding();
-    if (maxBundles > 0) {
-      return maxBundles;
-    }
-    return chooseMaximumNumberOfThreads() + 100;
-  }
-
   @VisibleForTesting
   public boolean workExecutorIsEmpty() {
     return workUnitExecutor.executorQueueIsEmpty();
@@ -727,7 +883,7 @@ public boolean workExecutorIsEmpty() {
 
   @VisibleForTesting
   int numCommitThreads() {
-    return workCommitter.parallelism();
+    return numCommitThreads;
   }
 
   @VisibleForTesting
@@ -740,7 +896,6 @@ ComputationStateCache getComputationStateCache() {
     return computationStateCache;
   }
 
-  @SuppressWarnings("FutureReturnValueIgnored")
   public void start() {
     running.set(true);
     configFetcher.start();
@@ -791,27 +946,17 @@ private void onCompleteCommit(CompleteCommit completeCommit) {
                     completeCommit.shardedKey(), completeCommit.workId()));
   }
 
-  @VisibleForTesting
-  public Iterable<CounterUpdate> buildCounters() {
-    return Iterables.concat(
-        streamingCounters
-            .pendingDeltaCounters()
-            .extractModifiedDeltaUpdates(DataflowCounterUpdateExtractor.INSTANCE),
-        streamingCounters
-            .pendingCumulativeCounters()
-            .extractUpdates(false, DataflowCounterUpdateExtractor.INSTANCE));
+  @FunctionalInterface
+  private interface StreamingWorkerStatusReporterFactory {
+    StreamingWorkerStatusReporter createStatusReporter(ThrottledTimeTracker throttledTimeTracker);
   }
 
   @AutoValue
   abstract static class ConfigFetcherComputationStateCacheAndWindmillClient {
 
-    private static ConfigFetcherComputationStateCacheAndWindmillClient create(
-        ComputationConfig.Fetcher configFetcher,
-        ComputationStateCache computationStateCache,
-        WindmillServerStub windmillServer,
-        GrpcWindmillStreamFactory windmillStreamFactory) {
-      return new AutoValue_StreamingDataflowWorker_ConfigFetcherComputationStateCacheAndWindmillClient(
-          configFetcher, computationStateCache, windmillServer, windmillStreamFactory);
+    private static Builder builder() {
+      return new AutoValue_StreamingDataflowWorker_ConfigFetcherComputationStateCacheAndWindmillClient
+          .Builder();
     }
 
     abstract ComputationConfig.Fetcher configFetcher();
@@ -821,6 +966,23 @@ private static ConfigFetcherComputationStateCacheAndWindmillClient create(
     abstract WindmillServerStub windmillServer();
 
     abstract GrpcWindmillStreamFactory windmillStreamFactory();
+
+    abstract @Nullable GrpcDispatcherClient windmillDispatcherClient();
+
+    @AutoValue.Builder
+    abstract static class Builder {
+      abstract Builder setConfigFetcher(ComputationConfig.Fetcher value);
+
+      abstract Builder setComputationStateCache(ComputationStateCache value);
+
+      abstract Builder setWindmillServer(WindmillServerStub value);
+
+      abstract Builder setWindmillStreamFactory(GrpcWindmillStreamFactory value);
+
+      abstract Builder setWindmillDispatcherClient(GrpcDispatcherClient value);
+
+      abstract ConfigFetcherComputationStateCacheAndWindmillClient build();
+    }
   }
 
   /**
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarness.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarness.java
index 1ef1691b0817..4c73e8c7f61c 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarness.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarness.java
@@ -371,6 +371,7 @@ private void closeStreamSender(Endpoint endpoint, StreamSender sender) {
   }
 
   /** Add up all the throttle times of all streams including GetWorkerMetadataStream. */
+  @Override
   public long getAndResetThrottleTime() {
     return backends.get().windmillStreams().values().stream()
             .map(WindmillStreamSender::getAndResetThrottleTime)
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/SingleSourceWorkerHarness.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/SingleSourceWorkerHarness.java
index 9716b834cac4..65203288e169 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/SingleSourceWorkerHarness.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/SingleSourceWorkerHarness.java
@@ -37,6 +37,7 @@
 import org.apache.beam.runners.dataflow.worker.windmill.client.WindmillStream;
 import org.apache.beam.runners.dataflow.worker.windmill.client.commits.WorkCommitter;
 import org.apache.beam.runners.dataflow.worker.windmill.client.getdata.GetDataClient;
+import org.apache.beam.runners.dataflow.worker.windmill.client.throttling.ThrottledTimeTracker;
 import org.apache.beam.runners.dataflow.worker.windmill.work.WorkItemReceiver;
 import org.apache.beam.runners.dataflow.worker.windmill.work.processing.StreamingWorkScheduler;
 import org.apache.beam.runners.dataflow.worker.windmill.work.refresh.HeartbeatSender;
@@ -66,6 +67,7 @@ public final class SingleSourceWorkerHarness implements StreamingWorkerHarness {
   private final Function<String, Optional<ComputationState>> computationStateFetcher;
   private final ExecutorService workProviderExecutor;
   private final GetWorkSender getWorkSender;
+  private final ThrottledTimeTracker throttledTimeTracker;
 
   SingleSourceWorkerHarness(
       WorkCommitter workCommitter,
@@ -74,7 +76,8 @@ public final class SingleSourceWorkerHarness implements StreamingWorkerHarness {
       StreamingWorkScheduler streamingWorkScheduler,
       Runnable waitForResources,
       Function<String, Optional<ComputationState>> computationStateFetcher,
-      GetWorkSender getWorkSender) {
+      GetWorkSender getWorkSender,
+      ThrottledTimeTracker throttledTimeTracker) {
     this.workCommitter = workCommitter;
     this.getDataClient = getDataClient;
     this.heartbeatSender = heartbeatSender;
@@ -90,6 +93,7 @@ public final class SingleSourceWorkerHarness implements StreamingWorkerHarness {
                 .build());
     this.isRunning = new AtomicBoolean(false);
     this.getWorkSender = getWorkSender;
+    this.throttledTimeTracker = throttledTimeTracker;
   }
 
   public static SingleSourceWorkerHarness.Builder builder() {
@@ -144,6 +148,11 @@ public void shutdown() {
     workCommitter.stop();
   }
 
+  @Override
+  public long getAndResetThrottleTime() {
+    return throttledTimeTracker.getAndResetThrottleTime();
+  }
+
   private void streamingEngineDispatchLoop(
       Function<WorkItemReceiver, WindmillStream.GetWorkStream> getWorkStreamFactory) {
     while (isRunning.get()) {
@@ -254,6 +263,8 @@ Builder setComputationStateFetcher(
 
     Builder setGetWorkSender(GetWorkSender getWorkSender);
 
+    Builder setThrottledTimeTracker(ThrottledTimeTracker throttledTimeTracker);
+
     SingleSourceWorkerHarness build();
   }
 
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerHarness.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerHarness.java
index c1b4570e2260..731a5a4b1b51 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerHarness.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerHarness.java
@@ -17,11 +17,12 @@
  */
 package org.apache.beam.runners.dataflow.worker.streaming.harness;
 
+import org.apache.beam.runners.dataflow.worker.windmill.client.throttling.ThrottledTimeTracker;
 import org.apache.beam.sdk.annotations.Internal;
 
 /** Provides an interface to start streaming worker processing. */
 @Internal
-public interface StreamingWorkerHarness {
+public interface StreamingWorkerHarness extends ThrottledTimeTracker {
   void start();
 
   void shutdown();
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusPages.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusPages.java
index 6981312eff1d..ddfc6809231a 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusPages.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusPages.java
@@ -258,7 +258,7 @@ public interface Builder {
 
     Builder setDebugCapture(DebugCapture.Manager debugCapture);
 
-    Builder setChannelzServlet(ChannelzServlet channelzServlet);
+    Builder setChannelzServlet(@Nullable ChannelzServlet channelzServlet);
 
     Builder setStateCache(WindmillStateCache stateCache);
 
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusReporter.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusReporter.java
index ba77d8e1ce26..3557f0d193c5 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusReporter.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusReporter.java
@@ -27,6 +27,7 @@
 import com.google.api.services.dataflow.model.WorkItemStatus;
 import com.google.api.services.dataflow.model.WorkerMessage;
 import com.google.api.services.dataflow.model.WorkerMessageResponse;
+import com.google.auto.value.AutoBuilder;
 import java.io.IOException;
 import java.math.RoundingMode;
 import java.util.ArrayList;
@@ -51,6 +52,7 @@
 import org.apache.beam.runners.dataflow.worker.streaming.StageInfo;
 import org.apache.beam.runners.dataflow.worker.util.BoundedQueueExecutor;
 import org.apache.beam.runners.dataflow.worker.util.MemoryMonitor;
+import org.apache.beam.runners.dataflow.worker.windmill.client.throttling.ThrottledTimeTracker;
 import org.apache.beam.runners.dataflow.worker.windmill.work.processing.failures.FailureTracker;
 import org.apache.beam.sdk.annotations.Internal;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.annotations.VisibleForTesting;
@@ -78,7 +80,7 @@ public final class StreamingWorkerStatusReporter {
   private final int initialMaxThreadCount;
   private final int initialMaxBundlesOutstanding;
   private final WorkUnitClient dataflowServiceClient;
-  private final Supplier<Long> windmillQuotaThrottleTime;
+  private final ThrottledTimeTracker windmillQuotaThrottleTime;
   private final Supplier<Collection<StageInfo>> allStageInfo;
   private final FailureTracker failureTracker;
   private final StreamingCounters streamingCounters;
@@ -97,10 +99,10 @@ public final class StreamingWorkerStatusReporter {
   // Used to track the number of WorkerMessages that have been sent without PerWorkerMetrics.
   private final AtomicLong workerMessagesIndex;
 
-  private StreamingWorkerStatusReporter(
+  StreamingWorkerStatusReporter(
       boolean publishCounters,
       WorkUnitClient dataflowServiceClient,
-      Supplier<Long> windmillQuotaThrottleTime,
+      ThrottledTimeTracker windmillQuotaThrottleTime,
       Supplier<Collection<StageInfo>> allStageInfo,
       FailureTracker failureTracker,
       StreamingCounters streamingCounters,
@@ -131,57 +133,13 @@ private StreamingWorkerStatusReporter(
     this.workerMessagesIndex = new AtomicLong();
   }
 
-  public static StreamingWorkerStatusReporter create(
-      WorkUnitClient workUnitClient,
-      Supplier<Long> windmillQuotaThrottleTime,
-      Supplier<Collection<StageInfo>> allStageInfo,
-      FailureTracker failureTracker,
-      StreamingCounters streamingCounters,
-      MemoryMonitor memoryMonitor,
-      BoundedQueueExecutor workExecutor,
-      long windmillHarnessUpdateReportingPeriodMillis,
-      long perWorkerMetricsUpdateReportingPeriodMillis) {
-    return new StreamingWorkerStatusReporter(
-        /* publishCounters= */ true,
-        workUnitClient,
-        windmillQuotaThrottleTime,
-        allStageInfo,
-        failureTracker,
-        streamingCounters,
-        memoryMonitor,
-        workExecutor,
-        threadName ->
-            Executors.newSingleThreadScheduledExecutor(
-                new ThreadFactoryBuilder().setNameFormat(threadName).build()),
-        windmillHarnessUpdateReportingPeriodMillis,
-        perWorkerMetricsUpdateReportingPeriodMillis);
-  }
-
-  @VisibleForTesting
-  public static StreamingWorkerStatusReporter forTesting(
-      boolean publishCounters,
-      WorkUnitClient workUnitClient,
-      Supplier<Long> windmillQuotaThrottleTime,
-      Supplier<Collection<StageInfo>> allStageInfo,
-      FailureTracker failureTracker,
-      StreamingCounters streamingCounters,
-      MemoryMonitor memoryMonitor,
-      BoundedQueueExecutor workExecutor,
-      Function<String, ScheduledExecutorService> executorFactory,
-      long windmillHarnessUpdateReportingPeriodMillis,
-      long perWorkerMetricsUpdateReportingPeriodMillis) {
-    return new StreamingWorkerStatusReporter(
-        publishCounters,
-        workUnitClient,
-        windmillQuotaThrottleTime,
-        allStageInfo,
-        failureTracker,
-        streamingCounters,
-        memoryMonitor,
-        workExecutor,
-        executorFactory,
-        windmillHarnessUpdateReportingPeriodMillis,
-        perWorkerMetricsUpdateReportingPeriodMillis);
+  public static Builder builder() {
+    return new AutoBuilder_StreamingWorkerStatusReporter_Builder()
+        .setPublishCounters(true)
+        .setExecutorFactory(
+            threadName ->
+                Executors.newSingleThreadScheduledExecutor(
+                    new ThreadFactoryBuilder().setNameFormat(threadName).build()));
   }
 
   /**
@@ -228,6 +186,22 @@ private static void shutdownExecutor(ScheduledExecutorService executor) {
     }
   }
 
+  // Calculates the PerWorkerMetrics reporting frequency, ensuring alignment with the
+  // WorkerMessages RPC schedule. The desired reporting period
+  // (perWorkerMetricsUpdateReportingPeriodMillis) is adjusted to the nearest multiple
+  // of the RPC interval (windmillHarnessUpdateReportingPeriodMillis).
+  private static long getPerWorkerMetricsUpdateFrequency(
+      long windmillHarnessUpdateReportingPeriodMillis,
+      long perWorkerMetricsUpdateReportingPeriodMillis) {
+    if (windmillHarnessUpdateReportingPeriodMillis == 0) {
+      return 0;
+    }
+    return LongMath.divide(
+        perWorkerMetricsUpdateReportingPeriodMillis,
+        windmillHarnessUpdateReportingPeriodMillis,
+        RoundingMode.CEILING);
+  }
+
   @SuppressWarnings("FutureReturnValueIgnored")
   public void start() {
     reportHarnessStartup();
@@ -276,27 +250,13 @@ private void reportHarnessStartup() {
     }
   }
 
-  // Calculates the PerWorkerMetrics reporting frequency, ensuring alignment with the
-  // WorkerMessages RPC schedule. The desired reporting period
-  // (perWorkerMetricsUpdateReportingPeriodMillis) is adjusted to the nearest multiple
-  // of the RPC interval (windmillHarnessUpdateReportingPeriodMillis).
-  private static long getPerWorkerMetricsUpdateFrequency(
-      long windmillHarnessUpdateReportingPeriodMillis,
-      long perWorkerMetricsUpdateReportingPeriodMillis) {
-    if (windmillHarnessUpdateReportingPeriodMillis == 0) {
-      return 0;
-    }
-    return LongMath.divide(
-        perWorkerMetricsUpdateReportingPeriodMillis,
-        windmillHarnessUpdateReportingPeriodMillis,
-        RoundingMode.CEILING);
-  }
-
   /** Sends counter updates to Dataflow backend. */
   private void sendWorkerUpdatesToDataflowService(
       CounterSet deltaCounters, CounterSet cumulativeCounters) throws IOException {
     // Throttle time is tracked by the windmillServer but is reported to DFE here.
-    streamingCounters.windmillQuotaThrottling().addValue(windmillQuotaThrottleTime.get());
+    streamingCounters
+        .windmillQuotaThrottling()
+        .addValue(windmillQuotaThrottleTime.getAndResetThrottleTime());
     if (memoryMonitor.isThrashing()) {
       streamingCounters.memoryThrashing().addValue(1);
     }
@@ -496,4 +456,33 @@ private void updateThreadMetrics() {
         .maxOutstandingBundles()
         .addValue((long) workExecutor.maximumElementsOutstanding());
   }
+
+  @AutoBuilder
+  public interface Builder {
+    Builder setPublishCounters(boolean publishCounters);
+
+    Builder setDataflowServiceClient(WorkUnitClient dataflowServiceClient);
+
+    Builder setWindmillQuotaThrottleTime(ThrottledTimeTracker windmillQuotaThrottledTimeTracker);
+
+    Builder setAllStageInfo(Supplier<Collection<StageInfo>> allStageInfo);
+
+    Builder setFailureTracker(FailureTracker failureTracker);
+
+    Builder setStreamingCounters(StreamingCounters streamingCounters);
+
+    Builder setMemoryMonitor(MemoryMonitor memoryMonitor);
+
+    Builder setWorkExecutor(BoundedQueueExecutor workExecutor);
+
+    Builder setExecutorFactory(Function<String, ScheduledExecutorService> executorFactory);
+
+    Builder setWindmillHarnessUpdateReportingPeriodMillis(
+        long windmillHarnessUpdateReportingPeriodMillis);
+
+    Builder setPerWorkerMetricsUpdateReportingPeriodMillis(
+        long perWorkerMetricsUpdateReportingPeriodMillis);
+
+    StreamingWorkerStatusReporter build();
+  }
 }
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/throttling/ThrottleTimer.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/throttling/ThrottleTimer.java
index f660112721ba..fdcb0339d23d 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/throttling/ThrottleTimer.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/throttling/ThrottleTimer.java
@@ -25,7 +25,7 @@
  * CommitWork are both blocked for x, totalTime will be 2x. However, if 2 GetWork streams are both
  * blocked for x totalTime will be x. All methods are thread safe.
  */
-public final class ThrottleTimer {
+public final class ThrottleTimer implements ThrottledTimeTracker {
   // This is -1 if not currently being throttled or the time in
   // milliseconds when throttling for this type started.
   private long startTime = -1;
@@ -56,6 +56,7 @@ public synchronized boolean throttled() {
   }
 
   /** Returns the combined total of all throttle times and resets those times to 0. */
+  @Override
   public synchronized long getAndResetThrottleTime() {
     if (throttled()) {
       stop();
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/throttling/ThrottledTimeTracker.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/throttling/ThrottledTimeTracker.java
new file mode 100644
index 000000000000..9bb8fb0a7b5f
--- /dev/null
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/throttling/ThrottledTimeTracker.java
@@ -0,0 +1,32 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.beam.runners.dataflow.worker.windmill.client.throttling;
+
+import org.apache.beam.sdk.annotations.Internal;
+
+/**
+ * Tracks time spent in a throttled state due to {@code Status.RESOURCE_EXHAUSTED} errors returned
+ * from gRPC calls.
+ */
+@Internal
+@FunctionalInterface
+public interface ThrottledTimeTracker {
+
+  /** Returns the combined total of all throttle times and resets those times to 0. */
+  long getAndResetThrottleTime();
+}
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/work/refresh/StreamPoolHeartbeatSender.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/work/refresh/StreamPoolHeartbeatSender.java
index fa36b11ffe55..f54091dc2b95 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/work/refresh/StreamPoolHeartbeatSender.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/work/refresh/StreamPoolHeartbeatSender.java
@@ -42,7 +42,7 @@ private StreamPoolHeartbeatSender(
     this.heartbeatStreamPool.set(heartbeatStreamPool);
   }
 
-  public static StreamPoolHeartbeatSender Create(
+  public static StreamPoolHeartbeatSender create(
       @Nonnull WindmillStreamPool<WindmillStream.GetDataStream> heartbeatStreamPool) {
     return new StreamPoolHeartbeatSender(heartbeatStreamPool);
   }
@@ -55,7 +55,7 @@ public static StreamPoolHeartbeatSender Create(
    *     enabled.
    * @param getDataPool stream to use when using separate streams for heartbeat is disabled.
    */
-  public static StreamPoolHeartbeatSender Create(
+  public static StreamPoolHeartbeatSender create(
       @Nonnull WindmillStreamPool<WindmillStream.GetDataStream> dedicatedHeartbeatPool,
       @Nonnull WindmillStreamPool<WindmillStream.GetDataStream> getDataPool,
       @Nonnull StreamingGlobalConfigHandle configHandle) {
diff --git a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorkerTest.java b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorkerTest.java
index dadf02171235..6eeb7bd6bbfc 100644
--- a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorkerTest.java
+++ b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorkerTest.java
@@ -96,6 +96,7 @@
 import org.apache.beam.runners.dataflow.util.CloudObjects;
 import org.apache.beam.runners.dataflow.util.PropertyNames;
 import org.apache.beam.runners.dataflow.util.Structs;
+import org.apache.beam.runners.dataflow.worker.counters.DataflowCounterUpdateExtractor;
 import org.apache.beam.runners.dataflow.worker.streaming.ComputationState;
 import org.apache.beam.runners.dataflow.worker.streaming.ComputationStateCache;
 import org.apache.beam.runners.dataflow.worker.streaming.ExecutableWork;
@@ -104,6 +105,7 @@
 import org.apache.beam.runners.dataflow.worker.streaming.Work;
 import org.apache.beam.runners.dataflow.worker.streaming.config.StreamingGlobalConfig;
 import org.apache.beam.runners.dataflow.worker.streaming.config.StreamingGlobalConfigHandleImpl;
+import org.apache.beam.runners.dataflow.worker.streaming.harness.StreamingCounters;
 import org.apache.beam.runners.dataflow.worker.testing.RestoreDataflowLoggingMDC;
 import org.apache.beam.runners.dataflow.worker.testing.TestCountingSource;
 import org.apache.beam.runners.dataflow.worker.util.BoundedQueueExecutor;
@@ -129,6 +131,9 @@
 import org.apache.beam.runners.dataflow.worker.windmill.Windmill.WatermarkHold;
 import org.apache.beam.runners.dataflow.worker.windmill.Windmill.WorkItemCommitRequest;
 import org.apache.beam.runners.dataflow.worker.windmill.client.getdata.FakeGetDataClient;
+import org.apache.beam.runners.dataflow.worker.windmill.client.grpc.stubs.WindmillChannelFactory;
+import org.apache.beam.runners.dataflow.worker.windmill.testing.FakeWindmillStubFactory;
+import org.apache.beam.runners.dataflow.worker.windmill.testing.FakeWindmillStubFactoryFactory;
 import org.apache.beam.runners.dataflow.worker.windmill.work.refresh.HeartbeatSender;
 import org.apache.beam.sdk.coders.Coder;
 import org.apache.beam.sdk.coders.Coder.Context;
@@ -178,6 +183,7 @@
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.CacheStats;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableList;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableMap;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.Iterables;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.Lists;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.primitives.UnsignedLong;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.util.concurrent.ThreadFactoryBuilder;
@@ -285,6 +291,7 @@ public Long get() {
   private final FakeWindmillServer server =
       new FakeWindmillServer(
           errorCollector, computationId -> computationStateCache.get(computationId));
+  private StreamingCounters streamingCounters;
 
   public StreamingDataflowWorkerTest(Boolean streamingEngine) {
     this.streamingEngine = streamingEngine;
@@ -304,9 +311,20 @@ private static CounterUpdate getCounter(Iterable<CounterUpdate> counters, String
     return null;
   }
 
+  private Iterable<CounterUpdate> buildCounters() {
+    return Iterables.concat(
+        streamingCounters
+            .pendingDeltaCounters()
+            .extractModifiedDeltaUpdates(DataflowCounterUpdateExtractor.INSTANCE),
+        streamingCounters
+            .pendingCumulativeCounters()
+            .extractUpdates(false, DataflowCounterUpdateExtractor.INSTANCE));
+  }
+
   @Before
   public void setUp() {
     server.clearCommitsReceived();
+    streamingCounters = StreamingCounters.create();
   }
 
   @After
@@ -856,7 +874,13 @@ private StreamingDataflowWorker makeWorker(
             streamingDataflowWorkerTestParams.clock(),
             streamingDataflowWorkerTestParams.executorSupplier(),
             mockGlobalConfigHandle,
-            streamingDataflowWorkerTestParams.localRetryTimeoutMs());
+            streamingDataflowWorkerTestParams.localRetryTimeoutMs(),
+            streamingCounters,
+            new FakeWindmillStubFactoryFactory(
+                new FakeWindmillStubFactory(
+                    () ->
+                        WindmillChannelFactory.inProcessChannel(
+                            "StreamingDataflowWorkerTestChannel"))));
     this.computationStateCache = worker.getComputationStateCache();
     return worker;
   }
@@ -1715,7 +1739,7 @@ public void testMergeWindows() throws Exception {
                 intervalWindowBytes(WINDOW_AT_ZERO)));
 
     Map<Long, Windmill.WorkItemCommitRequest> result = server.waitForAndGetCommits(1);
-    Iterable<CounterUpdate> counters = worker.buildCounters();
+    Iterable<CounterUpdate> counters = buildCounters();
 
     // These tags and data are opaque strings and this is a change detector test.
     // The "/u" indicates the user's namespace, versus "/s" for system namespace
@@ -1836,7 +1860,7 @@ public void testMergeWindows() throws Exception {
     expectedBytesRead += dataBuilder.build().getSerializedSize();
 
     result = server.waitForAndGetCommits(1);
-    counters = worker.buildCounters();
+    counters = buildCounters();
     actualOutput = result.get(2L);
 
     assertEquals(1, actualOutput.getOutputMessagesCount());
@@ -2004,7 +2028,7 @@ public void testMergeWindowsCaching() throws Exception {
                 intervalWindowBytes(WINDOW_AT_ZERO)));
 
     Map<Long, Windmill.WorkItemCommitRequest> result = server.waitForAndGetCommits(1);
-    Iterable<CounterUpdate> counters = worker.buildCounters();
+    Iterable<CounterUpdate> counters = buildCounters();
 
     // These tags and data are opaque strings and this is a change detector test.
     // The "/u" indicates the user's namespace, versus "/s" for system namespace
@@ -2125,7 +2149,7 @@ public void testMergeWindowsCaching() throws Exception {
     expectedBytesRead += dataBuilder.build().getSerializedSize();
 
     result = server.waitForAndGetCommits(1);
-    counters = worker.buildCounters();
+    counters = buildCounters();
     actualOutput = result.get(2L);
 
     assertEquals(1, actualOutput.getOutputMessagesCount());
@@ -2430,7 +2454,7 @@ public void testUnboundedSources() throws Exception {
                 null));
 
     Map<Long, Windmill.WorkItemCommitRequest> result = server.waitForAndGetCommits(1);
-    Iterable<CounterUpdate> counters = worker.buildCounters();
+    Iterable<CounterUpdate> counters = buildCounters();
     Windmill.WorkItemCommitRequest commit = result.get(1L);
     UnsignedLong finalizeId =
         UnsignedLong.fromLongBits(commit.getSourceStateUpdates().getFinalizeIds(0));
@@ -2492,7 +2516,7 @@ public void testUnboundedSources() throws Exception {
                 null));
 
     result = server.waitForAndGetCommits(1);
-    counters = worker.buildCounters();
+    counters = buildCounters();
 
     commit = result.get(2L);
     finalizeId = UnsignedLong.fromLongBits(commit.getSourceStateUpdates().getFinalizeIds(0));
@@ -2540,7 +2564,7 @@ public void testUnboundedSources() throws Exception {
                 null));
 
     result = server.waitForAndGetCommits(1);
-    counters = worker.buildCounters();
+    counters = buildCounters();
 
     commit = result.get(3L);
     finalizeId = UnsignedLong.fromLongBits(commit.getSourceStateUpdates().getFinalizeIds(0));
@@ -2710,7 +2734,7 @@ public void testUnboundedSourceWorkRetry() throws Exception {
     server.whenGetWorkCalled().thenReturn(work);
 
     Map<Long, Windmill.WorkItemCommitRequest> result = server.waitForAndGetCommits(1);
-    Iterable<CounterUpdate> counters = worker.buildCounters();
+    Iterable<CounterUpdate> counters = buildCounters();
     Windmill.WorkItemCommitRequest commit = result.get(1L);
     UnsignedLong finalizeId =
         UnsignedLong.fromLongBits(commit.getSourceStateUpdates().getFinalizeIds(0));
diff --git a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/SingleSourceWorkerHarnessTest.java b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/SingleSourceWorkerHarnessTest.java
index 5a2df4baae61..4df3bf7cd823 100644
--- a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/SingleSourceWorkerHarnessTest.java
+++ b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/SingleSourceWorkerHarnessTest.java
@@ -60,6 +60,8 @@ private SingleSourceWorkerHarness createWorkerHarness(
         .setWaitForResources(waitForResources)
         .setStreamingWorkScheduler(streamingWorkScheduler)
         .setComputationStateFetcher(computationStateFetcher)
+        // no-op throttle time supplier.
+        .setThrottledTimeTracker(() -> 0L)
         .setGetWorkSender(getWorkSender)
         .build();
   }
diff --git a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusReporterTest.java b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusReporterTest.java
index 7e65a495638f..f348e4cf1bdb 100644
--- a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusReporterTest.java
+++ b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/StreamingWorkerStatusReporterTest.java
@@ -39,14 +39,15 @@
 
 @RunWith(JUnit4.class)
 public class StreamingWorkerStatusReporterTest {
-  private final long DEFAULT_WINDMILL_QUOTA_THROTTLE_TIME = 1000;
-  private final long DEFAULT_HARNESS_REPORTING_PERIOD = 10000;
-  private final long DEFAULT_PER_WORKER_METRICS_PERIOD = 30000;
+  private static final long DEFAULT_WINDMILL_QUOTA_THROTTLE_TIME = 1000;
+  private static final long DEFAULT_HARNESS_REPORTING_PERIOD = 10000;
+  private static final long DEFAULT_PER_WORKER_METRICS_PERIOD = 30000;
 
   private BoundedQueueExecutor mockExecutor;
   private WorkUnitClient mockWorkUnitClient;
   private FailureTracker mockFailureTracker;
   private MemoryMonitor mockMemoryMonitor;
+  private StreamingWorkerStatusReporter reporter;
 
   @Before
   public void setUp() {
@@ -54,23 +55,11 @@ public void setUp() {
     this.mockWorkUnitClient = mock(WorkUnitClient.class);
     this.mockFailureTracker = mock(FailureTracker.class);
     this.mockMemoryMonitor = mock(MemoryMonitor.class);
+    this.reporter = buildWorkerStatusReporterForTest();
   }
 
   @Test
   public void testOverrideMaximumThreadCount() throws Exception {
-    StreamingWorkerStatusReporter reporter =
-        StreamingWorkerStatusReporter.forTesting(
-            true,
-            mockWorkUnitClient,
-            () -> DEFAULT_WINDMILL_QUOTA_THROTTLE_TIME,
-            () -> Collections.emptyList(),
-            mockFailureTracker,
-            StreamingCounters.create(),
-            mockMemoryMonitor,
-            mockExecutor,
-            (threadName) -> Executors.newSingleThreadScheduledExecutor(),
-            DEFAULT_HARNESS_REPORTING_PERIOD,
-            DEFAULT_PER_WORKER_METRICS_PERIOD);
     StreamingScalingReportResponse streamingScalingReportResponse =
         new StreamingScalingReportResponse().setMaximumThreadCount(10);
     WorkerMessageResponse workerMessageResponse =
@@ -84,23 +73,25 @@ public void testOverrideMaximumThreadCount() throws Exception {
 
   @Test
   public void testHandleEmptyWorkerMessageResponse() throws Exception {
-    StreamingWorkerStatusReporter reporter =
-        StreamingWorkerStatusReporter.forTesting(
-            true,
-            mockWorkUnitClient,
-            () -> DEFAULT_WINDMILL_QUOTA_THROTTLE_TIME,
-            () -> Collections.emptyList(),
-            mockFailureTracker,
-            StreamingCounters.create(),
-            mockMemoryMonitor,
-            mockExecutor,
-            (threadName) -> Executors.newSingleThreadScheduledExecutor(),
-            DEFAULT_HARNESS_REPORTING_PERIOD,
-            DEFAULT_PER_WORKER_METRICS_PERIOD);
-    WorkerMessageResponse workerMessageResponse = new WorkerMessageResponse();
     when(mockWorkUnitClient.reportWorkerMessage(any()))
-        .thenReturn(Collections.singletonList(workerMessageResponse));
+        .thenReturn(Collections.singletonList(new WorkerMessageResponse()));
     reporter.reportPeriodicWorkerMessage();
     verify(mockExecutor, Mockito.times(0)).setMaximumPoolSize(anyInt(), anyInt());
   }
+
+  private StreamingWorkerStatusReporter buildWorkerStatusReporterForTest() {
+    return StreamingWorkerStatusReporter.builder()
+        .setPublishCounters(true)
+        .setDataflowServiceClient(mockWorkUnitClient)
+        .setWindmillQuotaThrottleTime(() -> DEFAULT_WINDMILL_QUOTA_THROTTLE_TIME)
+        .setAllStageInfo(Collections::emptyList)
+        .setFailureTracker(mockFailureTracker)
+        .setStreamingCounters(StreamingCounters.create())
+        .setMemoryMonitor(mockMemoryMonitor)
+        .setWorkExecutor(mockExecutor)
+        .setExecutorFactory((threadName) -> Executors.newSingleThreadScheduledExecutor())
+        .setWindmillHarnessUpdateReportingPeriodMillis(DEFAULT_HARNESS_REPORTING_PERIOD)
+        .setPerWorkerMetricsUpdateReportingPeriodMillis(DEFAULT_PER_WORKER_METRICS_PERIOD)
+        .build();
+  }
 }
diff --git a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/work/refresh/StreamPoolHeartbeatSenderTest.java b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/work/refresh/StreamPoolHeartbeatSenderTest.java
index ed915088d0a6..acbb3aebbcf5 100644
--- a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/work/refresh/StreamPoolHeartbeatSenderTest.java
+++ b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/work/refresh/StreamPoolHeartbeatSenderTest.java
@@ -39,7 +39,7 @@ public class StreamPoolHeartbeatSenderTest {
   public void sendsHeartbeatsOnStream() {
     FakeWindmillServer server = new FakeWindmillServer(new ErrorCollector(), c -> Optional.empty());
     StreamPoolHeartbeatSender heartbeatSender =
-        StreamPoolHeartbeatSender.Create(
+        StreamPoolHeartbeatSender.create(
             WindmillStreamPool.create(1, Duration.standardSeconds(10), server::getDataStream));
     Heartbeats.Builder heartbeatsBuilder = Heartbeats.builder();
     heartbeatsBuilder
@@ -59,7 +59,7 @@ public void sendsHeartbeatsOnDedicatedStream() {
     FakeGlobalConfigHandle configHandle =
         new FakeGlobalConfigHandle(getGlobalConfig(/*useSeparateHeartbeatStreams=*/ true));
     StreamPoolHeartbeatSender heartbeatSender =
-        StreamPoolHeartbeatSender.Create(
+        StreamPoolHeartbeatSender.create(
             WindmillStreamPool.create(
                 1, Duration.standardSeconds(10), dedicatedServer::getDataStream),
             WindmillStreamPool.create(
@@ -104,7 +104,7 @@ public void sendsHeartbeatsOnGetDataStream() {
     FakeGlobalConfigHandle configHandle =
         new FakeGlobalConfigHandle(getGlobalConfig(/*useSeparateHeartbeatStreams=*/ false));
     StreamPoolHeartbeatSender heartbeatSender =
-        StreamPoolHeartbeatSender.Create(
+        StreamPoolHeartbeatSender.create(
             WindmillStreamPool.create(
                 1, Duration.standardSeconds(10), dedicatedServer::getDataStream),
             WindmillStreamPool.create(

From d745198af5b84fd00b247e73a44605d41cc6ad57 Mon Sep 17 00:00:00 2001
From: scwhittle <scwhittle@users.noreply.github.com>
Date: Tue, 26 Nov 2024 13:07:22 +0100
Subject: [PATCH 019/135] Change the  Java sdk harness cache timeout for bundle
 processors to be an hour for streaming pipelines instead of 1 minute.
 (#33175)

* Change the cache timeout for bundle processors to be an hour for streaming pipelines instead of 1 minute.  Use a hidden option so that it can be controlled further if desired.
---
 .../beam/sdk/options/SdkHarnessOptions.java   | 18 +++++++++
 .../harness/control/ProcessBundleHandler.java | 38 ++++++++++---------
 .../control/ProcessBundleHandlerTest.java     | 37 ++++++++++--------
 3 files changed, 59 insertions(+), 34 deletions(-)

diff --git a/sdks/java/core/src/main/java/org/apache/beam/sdk/options/SdkHarnessOptions.java b/sdks/java/core/src/main/java/org/apache/beam/sdk/options/SdkHarnessOptions.java
index 6e5843f533db..78ea34503e54 100644
--- a/sdks/java/core/src/main/java/org/apache/beam/sdk/options/SdkHarnessOptions.java
+++ b/sdks/java/core/src/main/java/org/apache/beam/sdk/options/SdkHarnessOptions.java
@@ -20,6 +20,7 @@
 import static org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.base.Preconditions.checkNotNull;
 
 import com.fasterxml.jackson.annotation.JsonCreator;
+import java.time.Duration;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.HashMap;
@@ -386,4 +387,21 @@ static List<Logger> getConfiguredLoggerFromOptions(SdkHarnessOptions loggingOpti
     }
     return configuredLoggers;
   }
+
+  @Hidden
+  @Description(
+      "Timeout used for cache of bundle processors. Defaults to a minute for batch and an hour for streaming.")
+  @Default.InstanceFactory(BundleProcessorCacheTimeoutFactory.class)
+  Duration getBundleProcessorCacheTimeout();
+
+  void setBundleProcessorCacheTimeout(Duration duration);
+
+  class BundleProcessorCacheTimeoutFactory implements DefaultValueFactory<Duration> {
+    @Override
+    public Duration create(PipelineOptions options) {
+      return options.as(StreamingOptions.class).isStreaming()
+          ? Duration.ofHours(1)
+          : Duration.ofMinutes(1);
+    }
+  }
 }
diff --git a/sdks/java/harness/src/main/java/org/apache/beam/fn/harness/control/ProcessBundleHandler.java b/sdks/java/harness/src/main/java/org/apache/beam/fn/harness/control/ProcessBundleHandler.java
index 0d517503b12d..300796ac6f12 100644
--- a/sdks/java/harness/src/main/java/org/apache/beam/fn/harness/control/ProcessBundleHandler.java
+++ b/sdks/java/harness/src/main/java/org/apache/beam/fn/harness/control/ProcessBundleHandler.java
@@ -83,6 +83,7 @@
 import org.apache.beam.sdk.metrics.MetricsEnvironment;
 import org.apache.beam.sdk.metrics.MetricsEnvironment.MetricsEnvironmentState;
 import org.apache.beam.sdk.options.PipelineOptions;
+import org.apache.beam.sdk.options.SdkHarnessOptions;
 import org.apache.beam.sdk.transforms.DoFn.BundleFinalizer;
 import org.apache.beam.sdk.util.WindowedValue;
 import org.apache.beam.sdk.util.common.ReflectHelpers;
@@ -188,7 +189,8 @@ public ProcessBundleHandler(
         executionStateSampler,
         REGISTERED_RUNNER_FACTORIES,
         processWideCache,
-        new BundleProcessorCache(),
+        new BundleProcessorCache(
+            options.as(SdkHarnessOptions.class).getBundleProcessorCacheTimeout()),
         dataSampler);
   }
 
@@ -927,25 +929,25 @@ public int hashCode() {
       return super.hashCode();
     }
 
-    BundleProcessorCache() {
-      this.cachedBundleProcessors =
+    BundleProcessorCache(Duration timeout) {
+      CacheBuilder<String, ConcurrentLinkedQueue<ProcessBundleHandler.BundleProcessor>> builder =
           CacheBuilder.newBuilder()
-              .expireAfterAccess(Duration.ofMinutes(1L))
               .removalListener(
-                  removalNotification -> {
-                    ((ConcurrentLinkedQueue<BundleProcessor>) removalNotification.getValue())
-                        .forEach(
-                            bundleProcessor -> {
-                              bundleProcessor.shutdown();
-                            });
-                  })
-              .build(
-                  new CacheLoader<String, ConcurrentLinkedQueue<BundleProcessor>>() {
-                    @Override
-                    public ConcurrentLinkedQueue<BundleProcessor> load(String s) throws Exception {
-                      return new ConcurrentLinkedQueue<>();
-                    }
-                  });
+                  removalNotification ->
+                      removalNotification
+                          .getValue()
+                          .forEach(bundleProcessor -> bundleProcessor.shutdown()));
+      if (timeout.compareTo(Duration.ZERO) > 0) {
+        builder = builder.expireAfterAccess(timeout);
+      }
+      this.cachedBundleProcessors =
+          builder.build(
+              new CacheLoader<String, ConcurrentLinkedQueue<BundleProcessor>>() {
+                @Override
+                public ConcurrentLinkedQueue<BundleProcessor> load(String s) throws Exception {
+                  return new ConcurrentLinkedQueue<>();
+                }
+              });
       // We specifically use a weak hash map so that references will automatically go out of scope
       // and not need to be freed explicitly from the cache.
       this.activeBundleProcessors = Collections.synchronizedMap(new WeakHashMap<>());
diff --git a/sdks/java/harness/src/test/java/org/apache/beam/fn/harness/control/ProcessBundleHandlerTest.java b/sdks/java/harness/src/test/java/org/apache/beam/fn/harness/control/ProcessBundleHandlerTest.java
index 95b404aa6203..a69ea5338dc3 100644
--- a/sdks/java/harness/src/test/java/org/apache/beam/fn/harness/control/ProcessBundleHandlerTest.java
+++ b/sdks/java/harness/src/test/java/org/apache/beam/fn/harness/control/ProcessBundleHandlerTest.java
@@ -48,6 +48,7 @@
 import static org.mockito.Mockito.when;
 
 import java.io.IOException;
+import java.time.Duration;
 import java.util.ArrayList;
 import java.util.Collection;
 import java.util.Collections;
@@ -354,6 +355,10 @@ void reset() throws Exception {
 
   private static class TestBundleProcessorCache extends BundleProcessorCache {
 
+    TestBundleProcessorCache() {
+      super(Duration.ZERO);
+    }
+
     @Override
     BundleProcessor get(
         InstructionRequest processBundleRequest,
@@ -376,7 +381,7 @@ public void testTrySplitBeforeBundleDoesNotFail() {
             executionStateSampler,
             ImmutableMap.of(),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
 
     BeamFnApi.InstructionResponse response =
@@ -407,7 +412,7 @@ public void testProgressBeforeBundleDoesNotFail() throws Exception {
             executionStateSampler,
             ImmutableMap.of(),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
 
     handler.progress(
@@ -487,7 +492,7 @@ public void testOrderOfStartAndFinishCalls() throws Exception {
                 DATA_INPUT_URN, startFinishRecorder,
                 DATA_OUTPUT_URN, startFinishRecorder),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
 
     handler.processBundle(
@@ -592,7 +597,7 @@ public void testOrderOfSetupTeardownCalls() throws Exception {
             executionStateSampler,
             urnToPTransformRunnerFactoryMap,
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
 
     handler.processBundle(
@@ -699,7 +704,7 @@ private static InstructionRequest processBundleRequestFor(
   public void testBundleProcessorIsFoundWhenActive() {
     BundleProcessor bundleProcessor = mock(BundleProcessor.class);
     when(bundleProcessor.getInstructionId()).thenReturn("known");
-    BundleProcessorCache cache = new BundleProcessorCache();
+    BundleProcessorCache cache = new BundleProcessorCache(Duration.ZERO);
 
     // Check that an unknown bundle processor is not found
     assertNull(cache.find("unknown"));
@@ -811,7 +816,7 @@ public void testCreatingPTransformExceptionsArePropagated() throws Exception {
                   throw new IllegalStateException("TestException");
                 }),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
     assertThrows(
         "TestException",
@@ -862,7 +867,7 @@ public void testBundleFinalizationIsPropagated() throws Exception {
                       return null;
                     }),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
     BeamFnApi.InstructionResponse.Builder response =
         handler.processBundle(
@@ -916,7 +921,7 @@ public void testPTransformStartExceptionsArePropagated() {
                       return null;
                     }),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
     assertThrows(
         "TestException",
@@ -1094,7 +1099,7 @@ public void onCompleted() {}
         executionStateSampler,
         urnToPTransformRunnerFactoryMap,
         Caches.noop(),
-        new BundleProcessorCache(),
+        new BundleProcessorCache(Duration.ZERO),
         null /* dataSampler */);
   }
 
@@ -1427,7 +1432,7 @@ public void testInstructionIsUnregisteredFromBeamFnDataClientOnSuccess() throws
                       return null;
                     }),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
     handler.processBundle(
         BeamFnApi.InstructionRequest.newBuilder()
@@ -1500,7 +1505,7 @@ public void testDataProcessingExceptionsArePropagated() throws Exception {
                       return null;
                     }),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
     assertThrows(
         "TestException",
@@ -1551,7 +1556,7 @@ public void testPTransformFinishExceptionsArePropagated() throws Exception {
                       return null;
                     }),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
     assertThrows(
         "TestException",
@@ -1647,7 +1652,7 @@ private void doStateCalls(BeamFnStateClient beamFnStateClient) {
                   }
                 }),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
     handler.processBundle(
         BeamFnApi.InstructionRequest.newBuilder()
@@ -1698,7 +1703,7 @@ private void doStateCalls(BeamFnStateClient beamFnStateClient) {
                   }
                 }),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
     assertThrows(
         "State API calls are unsupported",
@@ -1787,7 +1792,7 @@ public void reset() {
           return null;
         };
 
-    BundleProcessorCache bundleProcessorCache = new BundleProcessorCache();
+    BundleProcessorCache bundleProcessorCache = new BundleProcessorCache(Duration.ZERO);
     ProcessBundleHandler handler =
         new ProcessBundleHandler(
             PipelineOptionsFactory.create(),
@@ -1930,7 +1935,7 @@ public Object createRunnerForPTransform(Context context) throws IOException {
                   }
                 }),
             Caches.noop(),
-            new BundleProcessorCache(),
+            new BundleProcessorCache(Duration.ZERO),
             null /* dataSampler */);
     assertThrows(
         "Timers are unsupported",

From ddfd1a2270f1801216cf7b5fa9d65b2125964a15 Mon Sep 17 00:00:00 2001
From: liferoad <huxiangqian@gmail.com>
Date: Tue, 26 Nov 2024 08:50:37 -0500
Subject: [PATCH 020/135] Fixed beam_PreCommit_Flink_Container.yml (#33219)

* Fixed beam_PreCommit_Flink_Container.yml

* Update beam_PreCommit_Flink_Container.yml

* Update beam_PreCommit_Flink_Container.yml

* refactored the options

* added test type

* fixed the python gradle

* Added the python version

* Fixed the java test

* fixed java options

* fixed options

* fixed the options

* fixed the job name
---
 .../beam_PreCommit_Flink_Container.yml        | 51 ++++++++-----------
 .../go_Combine_Flink_Batch_small.txt          | 24 +++++++++
 .../java_Combine_Flink_Batch_small.txt        | 25 +++++++++
 .../python_Combine_Flink_Batch_small.txt      | 23 +++++++++
 4 files changed, 92 insertions(+), 31 deletions(-)
 create mode 100644 .github/workflows/flink-tests-pipeline-options/go_Combine_Flink_Batch_small.txt
 create mode 100644 .github/workflows/flink-tests-pipeline-options/java_Combine_Flink_Batch_small.txt
 create mode 100644 .github/workflows/flink-tests-pipeline-options/python_Combine_Flink_Batch_small.txt

diff --git a/.github/workflows/beam_PreCommit_Flink_Container.yml b/.github/workflows/beam_PreCommit_Flink_Container.yml
index 42a402add966..77ddcdf18788 100644
--- a/.github/workflows/beam_PreCommit_Flink_Container.yml
+++ b/.github/workflows/beam_PreCommit_Flink_Container.yml
@@ -98,6 +98,21 @@ jobs:
           comment_phrase: ${{ matrix.job_phrase }}
           github_token: ${{ secrets.GITHUB_TOKEN }}
           github_job: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
+      - name: Setup environment
+        uses: ./.github/actions/setup-environment-action
+        with:
+          python-version: default
+      - name: Prepare test arguments
+        uses: ./.github/actions/test-arguments-action
+        with:
+          test-type: precommit
+          test-language: go,python,java
+          argument-file-paths: |
+            ${{ github.workspace }}/.github/workflows/flink-tests-pipeline-options/go_Combine_Flink_Batch_small.txt
+            ${{ github.workspace }}/.github/workflows/flink-tests-pipeline-options/python_Combine_Flink_Batch_small.txt
+            ${{ github.workspace }}/.github/workflows/flink-tests-pipeline-options/java_Combine_Flink_Batch_small.txt
+      - name: get current time
+        run: echo "NOW_UTC=$(date '+%m%d%H%M%S' --utc)" >> $GITHUB_ENV
       - name: Start Flink with 2 workers
         env:
           FLINK_NUM_WORKERS: 2
@@ -112,36 +127,18 @@ jobs:
           arguments: |
             -PloadTest.mainClass=combine \
             -Prunner=PortableRunner \
-            -PloadTest.args="
-              --runner=FlinkRunner \
-              --job_endpoint=localhost:8099 \
-              --environment_type=DOCKER \
-              --environment_config=gcr.io/apache-beam-testing/beam-sdk/beam_go_sdk:latest \
-              --parallelism=1 \
-              --input_options=\"{\"num_records\":200,\"key_size\":1,\"value_size\":9}\"
-              --fanout=1 \
-              --top_count=10 \
-              --iterations=1"
+            '-PloadTest.args=${{ env.beam_PreCommit_Flink_Container_test_arguments_1 }} --job_name=flink-tests-go-${{env.NOW_UTC}}'
 
       # Run a Python Combine load test to verify the Flink container
       - name: Run Flink Container Test with Python Combine
         timeout-minutes: 10
         uses: ./.github/actions/gradle-command-self-hosted-action
         with:
-          gradle-command: :sdks:python:test:load:run
+          gradle-command: :sdks:python:apache_beam:testing:load_tests:run
           arguments: |
             -PloadTest.mainClass=apache_beam.testing.load_tests.combine_test \
             -Prunner=FlinkRunner \
-            -PloadTest.args="
-              --runner=PortableRunner \
-              --job_endpoint=localhost:8099 \
-              --environment_type=DOCKER \
-              --environment_config=gcr.io/apache-beam-testing/beam-sdk/beam_python3.9_sdk:latest \
-              --parallelism=1 \
-              --input_options=\"{\"num_records\":200,\"key_size\":1,\"value_size\":9,\"algorithm\":\"lcg\"}\" \
-              --fanout=1 \
-              --top_count=10 \
-              --iterations=1"
+            '-PloadTest.args=${{ env.beam_PreCommit_Flink_Container_test_arguments_2 }} --job_name=flink-tests-python-${{env.NOW_UTC}}'
 
       # Run a Java Combine load test to verify the Flink container
       - name: Run Flink Container Test with Java Combine
@@ -152,17 +149,9 @@ jobs:
           arguments: |
             -PloadTest.mainClass=org.apache.beam.sdk.loadtests.CombineLoadTest \
             -Prunner=:runners:flink:1.17 \
-            -PloadTest.args="
-              --runner=FlinkRunner \
-              --environment_type=DOCKER \
-              --environment_config=gcr.io/apache-beam-testing/beam-sdk/beam_java11_sdk:latest \
-              --parallelism=1 \
-              --sourceOptions={\"numRecords\":200,\"keySizeBytes\":1,\"valueSizeBytes\":9} \
-              --fanout=1 \
-              --iterations=1 \
-              --topCount=10"
+            '-PloadTest.args=${{ env.beam_PreCommit_Flink_Container_test_arguments_3 }} --jobName=flink-tests-java11-${{env.NOW_UTC}}'
 
       - name: Teardown Flink
         if: always()
         run: |
-          ${{ github.workspace }}/.test-infra/dataproc/flink_cluster.sh delete
\ No newline at end of file
+          ${{ github.workspace }}/.test-infra/dataproc/flink_cluster.sh delete
diff --git a/.github/workflows/flink-tests-pipeline-options/go_Combine_Flink_Batch_small.txt b/.github/workflows/flink-tests-pipeline-options/go_Combine_Flink_Batch_small.txt
new file mode 100644
index 000000000000..6b44f53886b2
--- /dev/null
+++ b/.github/workflows/flink-tests-pipeline-options/go_Combine_Flink_Batch_small.txt
@@ -0,0 +1,24 @@
+#  Licensed to the Apache Software Foundation (ASF) under one
+#  or more contributor license agreements.  See the NOTICE file
+#  distributed with this work for additional information
+#  regarding copyright ownership.  The ASF licenses this file
+#  to you under the Apache License, Version 2.0 (the
+#  "License"); you may not use this file except in compliance
+#  with the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+--input_options=''{\"num_records\":200,\"key_size\":1,\"value_size\":9}''
+--fanout=1
+--top_count=10
+--parallelism=2
+--endpoint=localhost:8099
+--environment_type=DOCKER
+--environment_config=gcr.io/apache-beam-testing/beam-sdk/beam_go_sdk:latest
+--runner=FlinkRunner
\ No newline at end of file
diff --git a/.github/workflows/flink-tests-pipeline-options/java_Combine_Flink_Batch_small.txt b/.github/workflows/flink-tests-pipeline-options/java_Combine_Flink_Batch_small.txt
new file mode 100644
index 000000000000..e792682bfbc4
--- /dev/null
+++ b/.github/workflows/flink-tests-pipeline-options/java_Combine_Flink_Batch_small.txt
@@ -0,0 +1,25 @@
+#  Licensed to the Apache Software Foundation (ASF) under one
+#  or more contributor license agreements.  See the NOTICE file
+#  distributed with this work for additional information
+#  regarding copyright ownership.  The ASF licenses this file
+#  to you under the Apache License, Version 2.0 (the
+#  "License"); you may not use this file except in compliance
+#  with the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+# limitations under the License.
+
+--sourceOptions={"numRecords":200,"keySizeBytes":1,"valueSizeBytes":9}
+--fanout=1
+--iterations=1
+--topCount=10
+--parallelism=2
+--jobEndpoint=localhost:8099
+--defaultEnvironmentType=DOCKER
+--defaultEnvironmentConfig=gcr.io/apache-beam-testing/beam-sdk/beam_java11_sdk:latest
+--runner=FlinkRunner
\ No newline at end of file
diff --git a/.github/workflows/flink-tests-pipeline-options/python_Combine_Flink_Batch_small.txt b/.github/workflows/flink-tests-pipeline-options/python_Combine_Flink_Batch_small.txt
new file mode 100644
index 000000000000..5522a8f9b823
--- /dev/null
+++ b/.github/workflows/flink-tests-pipeline-options/python_Combine_Flink_Batch_small.txt
@@ -0,0 +1,23 @@
+#  Licensed to the Apache Software Foundation (ASF) under one
+#  or more contributor license agreements.  See the NOTICE file
+#  distributed with this work for additional information
+#  regarding copyright ownership.  The ASF licenses this file
+#  to you under the Apache License, Version 2.0 (the
+#  "License"); you may not use this file except in compliance
+#  with the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+--input_options=''{\\"num_records\\":200,\\"key_size\\":1,\\"value_size\\":9,\\"algorithm\\":\\"lcg\\"}''
+--parallelism=2
+--job_endpoint=localhost:8099
+--environment_type=DOCKER
+--environment_config=gcr.io/apache-beam-testing/beam-sdk/beam_python3.9_sdk:latest
+--top_count=10
+--runner=PortableRunner
\ No newline at end of file

From aeefa4f6433a84206cf45085c7476f36a96f611d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=2E=20Veyri=C3=A9?= <sveyrie@luminatedata.com>
Date: Tue, 26 Nov 2024 16:16:32 +0100
Subject: [PATCH 021/135] Make the warning about JSON BigQuery column type more
 precise (#33121)

---
 .../java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java
index 84bf90bd4121..9a7f3a05556c 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java
@@ -3747,7 +3747,7 @@ private <DestinationT> WriteResult continueExpandTyped(
             if (rowWriterFactory.getOutputType() == OutputType.JsonTableRow) {
               LOG.warn(
                   "Found JSON type in TableSchema for 'FILE_LOADS' write method. \n"
-                      + "Make sure the TableRow value is a parsed JSON to ensure the read as a "
+                      + "Make sure the TableRow value is a Jackson JsonNode to ensure the read as a "
                       + "JSON type. Otherwise it will read as a raw (escaped) string.\n"
                       + "See https://cloud.google.com/bigquery/docs/loading-data-cloud-storage-json#limitations "
                       + "for limitations.");

From 5f5978178d21065562964973b4a94a6c9578185e Mon Sep 17 00:00:00 2001
From: liferoad <huxiangqian@gmail.com>
Date: Tue, 26 Nov 2024 11:40:20 -0500
Subject: [PATCH 022/135] updated the pic (#33222)

---
 .../accenture/Jana_Polianskaja_sm.jpg         | Bin 284152 -> 244421 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/website/www/site/static/images/case-study/accenture/Jana_Polianskaja_sm.jpg b/website/www/site/static/images/case-study/accenture/Jana_Polianskaja_sm.jpg
index 1fb63edd227fd2831cda1fb83dc3dab873a49ac0..49ce23e5d7cdcc5632cee468e2b2f320a4bb830c 100644
GIT binary patch
literal 244421
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%0A|Z9*dd2BTYf=JB7uQ`el{BU2
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

literal 284152
zcmbTdd010d`!*VD6(^)x(Mkncl`2p`8AK3Bl_CNnNG1qFs>l??$Pgh6Nv#4ED^xHb
zAVfq6Nk}3>WD2AXNSUV$0s<8cO2Qz4BtS?wi@xvo`_A=U=Z|wvB(mM^?5wr+TF-Oe
z_j9k+H>>|ZzH&e9b{ev7-8#rG;16W=9VF8wAtDq4@$`h4Kp>D!kT2HlgscZg>%bpK
zdIaRle~%%MAHZ)2<jX(TL%smNcY$}npI`pZ@zw0R{~oVDas&d&&i>!WYag;aa@5NH
z$T9n)cHbR6YHxGI{;1{u<GHo=ta}h17kAa(!s1G-`Grfkiy`L0xG0N+3s)_Unjf)%
zI6xDwUI>m1iTmziNLa)b$3wG?yhGnbTyi{wvhh6PdDS^2JmO4ZOb9IT96UHNGT83Y
zA*hq~7Ka4;gs7`gA#oSJONhFBCDuN{asR(}w+F{-r!Dq7ImBEFwfFh?^nb4a|8m^_
z-?qfZ$D7Annd4%@ERNdQ*;yR1w6L@^16P>E60XEuNHDt+d*Ht}_&FptI40t1Tm<gQ
zcWXDia1n=(bKH-|M_jTGy%1`1@zNz5vx^t3E}0!Ydg+4Mg-cdP%`RD4U9z<~dfYPf
z=*9j2tASBh|L5!fABO^bALx?3b4<vExR9U0+i7i>&5j&1J8B32U&HKR@qb+7V6oPy
z|63!S{&NQO8yx-5D6I|I|BQ6V6)?Q<U>sM6A<kfatXuo}?`!>r^=q$<Uw*lMgVshZ
zt+n^2&09Bb+O%bpmev;SEnBv3123)3+jX?JZC^WHyUE(e*FFV)wr$edw06b+x7X@l
zkR6*gYJFL?e%*e^7dzIi-?47>6~qwC+6`cCuTAg&zSe!Q{>u#;L6f#@1s8C>0?l8)
z{tM994PSzZy)Fg(Kjh0D8+Lww^yJ2`&tK5mAHB=+`rVRE2ToNz*Y)Z9e9-D*%x{~w
z?B4UuUOl594jnc&v9>v8d)&_6`Dd5Yu4mlbVQ>Tz<?DwIz7!G~79N3(jl*AyPaq`T
zxS5)k{`;+r?3{b#+`Rkw1&>M}mz7g1X!NJmHJoR)b@dG|UcPF1-THT1d;b7mAQZhB
z9C|nY{)2ep<EKf<oNRtUu23#6EwA-!9c2A~y7fOj`#<`%1N7?)@C?4xTI<)kFXF*_
z{f;j;e1CM~&Xec0E<}I5-}3sVU8nArR6XB(z{=;d?!}nCExQj|zcZR!>)O9P`+wK5
z-~NB~?0-7;zxy==*|vTiczEk~K%kICtM+BsC)$_3D#6M?H{nur8;ro#-8~2IYn>1h
zd%GX{clhfi`(;)K-;xG<a0tPy02i;TA86hMUL$a5ND_T?VCA@M6{6B*7~bSH1v#F*
z^qp(<aod4Kdc5BHx2q8CM9j*8KU=(NKaUgcx!RmJFWOw}8vCxT3jX+stXVlD9X|M(
zYe|vg$@FBqG-stLJ(HkQv$N!Qu}gHMx0)<{GN*In@e>uzH#-8So3e3_?&ep2m*67B
zh`+~6|9;eT!2N=En^z_}?Vlx^zO$dKI0oc9(R*f1-DT*9s}O1Aqx`<JCDCfE)+Fq$
zi#ODL%AR(Yhi0iwu$lCH7m^&WKlT~kBc#9e@P~b2f4IEOEIbsMjmC9NyB(U1;FOdd
zU4__ke5>=6WVC%UsUiD@^TiV=nWXdDJ+-0o*(7Ru3i^iWct7bBhqu5=cje4ui#T`i
z&0G5q<o?V`yw{CRcl$?e@nKXj_9-Ui#*A=#dZgG@CT!s($S2dQPq1|sOI3ow@a6Un
zWe_)`8)NcpLG2Uit5FjWO)s)8_s`^XsN`ihe9-yQ#gcJVkH3(3xKJe*!)aDlz0D%j
z0p5J%uURcRsHv6HODx0iSd}xkmM7zlFmAxlFm7a_vVA2hiKXpCY>zY)zx|nKNTgN(
zSv-bl7W|y2xs30CjoD$pvCRvDlegtz8mWsnl!#l=q!rzds`X#-Eu>m-9wTp05OVny
z-<+P3-)fg%`!%6ZlG@qqN8@aLobd!_UP1NVh|LSSOfridy2)!~ET^tQ@^wQ3JOX$9
z)Wua#hXjz&g8Itg+n7-l^XKh3FJw!7!Ub~M;<b<MHvGrUQ65G4W%k#jcbgQw@?{<#
zSC3eFU~FfE*3u$$zNKsH+wxY_2M&EKgh}HYl){*2ij14R3X#DXHHsUX#;Lqzx<iJc
z8e!18DY=0GgSuyF{6sER?w4Xb#E8fawh1NLg6!Myx?1783K62tm3Vi~xvWCSxTken
zXL;!6?*s-C_g8g!ow}3n!es@pa#%f`gLO|k!{C>PyUZuSOx&|;zNjV3%RNRbgEjg5
zxV<Ys$DKcSjvP?wcz;Y@vpD{Kg1UqcJx(WdZ5a)8Q($ZNA*`>}L2ZJkA!Q2Oa@aEe
z?n~rjj_i(s7a2AUVWY3<@1!kZ(Dh+^$iDpCU#}VL;mIDmFIeb|sM}?;Ivs&M>2j}n
zj9mtG_WGpWJ|36Fb8Sdyp1$g2$kT}N=s;0nkgl_PSV?$dPhntMYKn#(MYu-6tA{47
zqe8|jL-CSCVIG};7+l2o%}2H_I1(Fio2ACGE0t>M5p2@2bkanNzfg(z7-T5S`@pI_
zC)n*PZMZ)ZN5N9dRw!eYj3l<=lgcx~`;#JVOhFaivT=W|3Os4F3eoME*48e(z1%9W
z@fs0C-tnojxxETeNYk2}bDK^@-U&0jR+0s;jIdZNS2x$CJm`i|YkBj*jH41FB8E2{
zgn+7&lz73phe^&Qe4AMl`YPl_U_dc#{H8`7;x-OFRz>sKFi?>g$jjJCA&gt+a{D+R
zHF_bhxtc(|!lZ~|TA9>1&^)Vhi8G!E%`h;L#6fpK+vbJ$qy_3<6kP_Z5Ou?wS{~c7
zcg6oB%9AQ}x{Q!`R~Y)9(5XF?hhW*bw`%z65oETe(dh}Q#sa%%MHtv3u=HRb%ik9i
z6>*Mgcju&H4#!Z;{RlsZX<Wj(FBq#HV-JBT5a2SA5fevqXc!yX)>X%$i*olN#|G)&
z-qtyG*JeA)yM~nne=;BWjBm|5RyAXd6<1vF$^Q$h7Z^J<kvcKU_7GU>J?C48vGm^f
zp8Y^OD=Tt7Eo1EQzCHC6^>{Jow5*i%E&7Q{{!aAb1tfHGxwOS7ZW;Q!MjUPX?fdNV
zf!P(hm^!mpWhIL9+Obq(`lL@@Fju7GCu3B9)-)-d5=V=ib4#QRPSt@<d6gpar)A}g
zMjcl`Z1V4|aGOjdHu@(Ln}Q;!QVt`GjVe1=Ut?mB7d8$xVUb>(7o!S?7c&{yV#_n7
zD*1@ItPQgKd^FPF=oy~4EPDClD?^3!*SSMk4yBr>by2~sStpuBY#rT#bElnp7cgHX
zpH{6x9HZ?&X0G(ELbxpV_n0L1IDOAfQRl@fSiZv_!n!%<5jW+eaG6>d(DI5CI=TvJ
zXBW_5qpl$b6zGh@?1dxC!AoDyr+mtEXYS+J<JlAW#n74`UCjb&Gu^P92SNBadxK1+
z4~}Io*md@G__9@?TOcKU<#^Q=>n4jS4ujeuMs<x>#Zq2GoV!lkiZP-5(4OW&_gV@I
zax8p1RCKf%RcPe7&zfh;@xbZs>-<DL>(t?uDJ;JMeF<~bjqNT8>TDM{oX}n&S)z&;
ztDo~i;)jD8`EixZSdUD}XrpYUJ+3@P_(EO%g7u>V%_L`mHP%v~Gk7VU<s>svA6TD}
z>KpsOdh*`E+zRX-gpF7b667I9vCn=gcaFwSq)4cTX2Y{F$4c0z@;OKI422Jg<O|D!
z_({a{_KZt7VF``GMAWILceQ_?T~eo#L%XIC6eb=r#I{JxE?tHADH&ejp{}0Ul!I^r
z#=W-}<SGx(Of-IDac}=;4Nc+I<gbVi!i}(yP&qzyRQz7WDYH+vdpjvpGeWM78V*M4
z6S7j}Zq0rAiRM{&rK#QDuSt6cClk9apCqZ;-<!>Fd5wYFDWnMzIViu(>Tzv@jIIXf
zDm{|u^&k@=+%MRtJ5xsph^jDBz@>Q1w2)b(CU7S2cTSnfy%a0$JgS7;<~M?Too}IJ
zbkol5OLugBGB7Jej-thJOOY2xHT90S@@o~mkv>I1m!=P0V3#~J@aDeiWWg&Qww49;
zX^=fmoHB<d;R3vF>EuNFq8?uD?Bd(Fzv2oG^UZk#Uu8UIgl!)hY+=qFYUT1K%Ig|b
z^1^7dz%A>%)5axq2eJiuqECT2oGj?2z3HTii8J|*>_XHEyUg-TgzBfG@9#`qF-`Ii
zIEh2wqL+Brem6^|e_H%YdRaV=UAac?nM|aT12+`YCPdrb9q$|%+M)jKQQZ@!?+kZr
z>EqdKoaLh;w^swh-;DiImMM70#N?JPT|))hr>6YUQ(+Fpqs)!mTlp3%bcwy=!zCk)
z{Cpk1|FG1`drr?~1>YTMa6mJShf%G(!m*LX2V~9D(aRu1(bMMPgh-QdwEW2;QM{o=
zR0yXfkChoEp1+g%YsF+g%wde_4clEL9>BVPQL^hU+|n6I67`7%v3to}cA3)&bYTZ|
z3FB_}Yua%h0U0$;JHVOu^gqL;zs75C3g*xxxN2B)n`Q*Sgi{uUL#482jxBkioDjG7
z4%JnA2VXeny`k$z!g*$#y(7qx0V8=MOjAO15OF`{h`uI$9BR5Keb&2jI=fXVeI2J#
zX4Ka3c5o5nq8IrCtRy0ZZFFUFxr?wpYkanTUgTN2$T4C&mD&9zp$5oD4B@PoFPA%7
zo^na9b9y9V1Jkg@05vDt)}4h-3e6g~y}c-9_N};TMiSDp#{XD_=*KOSZYNi0Rw0_7
zONYC^pVkSkopU9_T*t>uHE2|J>-d<h1`RWJIIkITIr~eJ^Bd?pv-FjMkk*XvWg2zD
zySYXHK`p)ZLY2}S>A+n|jU&u^&H*}FIh?hFs+4xkIG`7o=zAT!S0Q7i!{<VsdS@*h
zT*WCvCDG#<?+?y>E3mVfwXC5W*H4}OquGmx;Jve)CxKX)w?`9YHLXFM(RY0PROW_Y
z%3XJ+EKiJKWVE|dC|4!#@yVwi9d@l`?u;}IxR=;NKARKtkR5()h*+(;8;DG&6J=bs
zhcJ@)d9-?BicXy?kR)lPu~#7i5rQhAG`h>0bo^L3UZN`fM7|{Hron9-ohY54@i<PL
zmwr+U|DhC7p?(~!BI@jDZG#FC5iv)cov37*n+#WHG`Szladpk}%2J2;scf$4ebpKX
zbBzGu%~QWD+@Ldks;1416px06mSvmtQbI2Vyb(r;Q{!xRbI=~{t%K>+c4p2Vm7XvU
zkd7u~FT1j<Y&tL|PiWpCW6gVg6+yhR{Ex%QQuVStB}OzWGOCOqMkTyqCwy>V!~0ig
zrnXaT-In;}*LSWfO?SQr3GO9xZtwlv7_JY>xl}?X8>J6MD8?FCnDE%5i7YnCEo|Ig
zHthtG0n<Mvw3eD-<>=GX(u}~=&f!#earEM&{6n|7?DtF!H#AYudS|6VS}1b*Zs}<<
zJ77a=MrebI<3DYIS2A)Fo+!dxDk9mW6}+oD1YWD*L{2DJiR3Qh%xp9>8t;SfTZM?r
z2m*<oF3U)Ut%=vb?_qZeqh4{|A!)M*9_6d<xa>kLA58gv<=0k=Jk-=GB+2(r401Hf
zBHsixpOO$$`qJJ@dy;thRzst<li*@zm4j3AV`f&3sC}I74zsU-S*RJxd#jMz6*&cV
z$bEikN8eOeM*{abiipFOT$GpYLrm}wCVTuvD@`kWvI^nA4xz;{_I6tSEy%l7-pQ+w
zDcDN;YyX0zqXHN_PpvN@%y27A5BWB<+eDl$ylj%JW%%Ck{YVhL(nB2Jc#ZfYh<qQ>
zEuvWi-p_wes?zf;(`aVFZ#~c`N)vt0U6OuE>Xr*<ORU-F`Q&ZnH&JJye7Nn-0ZJKa
zK3URR!a+_j;jseP7o6A2X&5=)n$ke;S1*^IteG{>n^07&j4|P7Uwe#}(g4VI{$Y9O
z{`N<O6Xz$8zxrlr2K$FsA@09XYx8z}qjIKyPR4NEXRVhafBhW5o7^1OMO|+AE_fQ6
zfb(C4palb~5WKG<Mo8vzUV0A<eJfN3A=`O4I?53j*GKBHuh$n4IL7%!+D)QD)YMFN
zeIo%YZW7H%)5_LcJ+9_4?^wZEPNSF+VJ-!)1c=kBxMbL0LXL5SsT)2pXXsOjES;`^
z=FU#38HcTqsGDg4o=s{$4L^ZlpB8rEhw6#e0MZ@YDx}e+^%gWffRy3jUF#z<!#-$r
zcpZe9^F!sy(eM2LiEB|`Raw@5vt&*OVe(-ld-lAM;BxR>&dR9Z%RI!kJTLEFgU-TE
z8k3pa&NQ4QeJs1|H?&l>!Xws8)_F_`zOT~AvFaObSralz4Vmc_3k^LlOQzo+all+F
ztuGh3zWS0kY~=z2;P;HYcoia{H@Q~*s)zY}k8|=+hThZ1X(g+WYtIy4SyRvUH_m-K
zf^=dK=V5fy->duw$|KHcInrh;!CW3<ReL|F)W7(0iX(Zqw7mj;bcU1!H{YMwU+08(
z7N<lu=>CX@StYZ}jL_NrC9KTgQ}(z#A1FG?d-Hq}yv9}65Ab)wJlyTNf19j=p%Xd5
zr-W1}euZU1k5#trf!aX-rfG24e16@I*4-wZ(MvTwrjy9vw0be%-eNu_ly=v6jU&gZ
zells(wVD#dc9eEdyF<M}YBBQ?r$k`Y4|lZgA#2p0Q6BS2=jW4<mgK*xa27czvl)7-
zZjpPKT~ioI?07k1dA`Lcrm77YC02{C^2<X3JQ+{VXz;Xnowec>6kI-rWHy(`k~uG7
zIuOTrkGc1&5Mphm)AytS_qj;Nka0$?<}ho^8=v}#Bo^g8$#zkS9BVPeW{KHa11li$
zeu^V~tC``_?;ZMT`MH!gJT^jIg<uKfiDyJ}jXZKvbJ)#=Ft#~P5?d7Ynx+}CRfX0Q
zY(8kzwyJn_LxW9|th-RNQwIxu#v5j#R2TEr)z{}y_#=vR=jcj}tRyEWabm`XG77iE
z-U18A`LTvSe>e*!V~{nYXLy+<Ij`_{yk^!7yRnJ0vjXU}*C@)=plL#&B9JocFZ6uv
z9(JKjLKY<8z;ktXpZ9c90VWFqX4dZZfgydZ>hNXi2y+?=XCLjgnYAvvmIzXGVPK6U
zR!@H-%c3ywbQWHGneEUINP?s$2|SbuR)g*a+9!0NI%;r)I8&!KkajVpC+G__{@&hJ
zGt6&Q(_$5w7S{ia>Ma`5+dT(Vm5R%BF()2YaRo?20|zr$a7(1zWbZxm{VhnDMD7y3
zhpZpNuh<y%3UQ;-Mb$9Eo%GZDbw0A2?fs7C{a$`shZm4razQDr7dXv}9O>w#vS*^4
zppuX9is*t=_N=MN{Am_F33IF>04*x=DM@wyLtx#|uCkalWeP8w7T<NCnYOcGV@DOK
zIP)U0qwk}7&6CiR^C}orBw)+$@h4#pe!a(z)4Lu(xsQ(1#ZAmGdG%4n9DHpO+Mhrd
zoWP8p_o>t63Co<LBPWElgUNJ8v@U3~LGN=e2gne6Sj8SX$MV(rvq6FG$^EBCd({sf
zWtgh<oGLW7mu=5PR)21~(NP^0gT~B6@;(QUxa^Ms?bIK24D#Ph{<(ylL@{Z(S2Z*2
zR;>Ip$0RbgpZfW$C0%QL@RZ<Cj;dX(xS3V07GR%SsPKh*u=RTY3k;74>niP%(Q9Hf
zGq;Rb(9jLJ4VvklfrzcQ=_Rpr#|ST-*i&NhDr81#0^rVviYpepct3O*I5FDf;Iymr
z`JAUPx&0rT&B?<VlPhj?lpz5>(I!I;i>(P>P7gb7#ridriO4cU;Vn|UZ$YZ45aWMp
zW87;(^Foj9<k|Vd^CW^ySk7;K>*3vIw$o!mEn!BRA*_B`qat;=w{Kw$Ei2gJ(5_`T
zoWOR8n0h(1;UK9g^Wmc!#ii6;gT|bP+hvnAgwd!&xTQ(gYO6!%YCbh0P7tsk3ujN}
z_bxhN7BUtNlLSn{wRF5V$S4ua#);Qieh=hMR#!$b3aR@jW)z89W*1iuk05P~Q>`xA
zVLM}%Vvtcy{fHjRI;@`FGue1$t5Jx5M@IcVPOJCFe8!hNSvPwSP>oyr$f0(GB}NAI
zuQ2b)m9fMEyGVmksS<A;FQ3?pjT#;yobPWVbp@w1IW$l!BHMI>y?^WZ9q0?TtV7<y
z<l(H`{Bgq_0O(ga2~_Q^gV(E!L@K<_5cXysB4$7x7^||f>?u@B!U`A4S4R28ArSk#
zu4R}*`+<krW={5_)wkO-pVlPsn$XR-drs)qH?jMQd+wVXsYlM&<#lD36-y1TF+4_V
zsa}7M7Fm8<klv-FzV#?z9^`~xi1l3hKqWNex&{0354WIp5a%^$xK2MaAZ0nteagBV
zDQgCR;ZQquDPV=>Iv9lchxYMTT~>&Dt6+-zxAd{*H6d7auj9_fvf%Gyy}}8C7B<<o
z%afJ!N^h&{p|_PMZfgO|hcC6h2BUR{_86*k(c>n9?0$xuE*@49x7SDc$XpORWiVFe
zrk`%pH~rOD!^4Q*$LF!(Q$fs>->MXMCE-4x4ZKjs`8UzX15YNZ$v;_XI$#8RESS@S
z3`1;~>S-Q%fmWJPsm{%M3bf%(60iM53XDmSUp<7xs94F!&d9NZ?tiq@L`Or#O!%d6
z*K@0o+<UY8AJeT4P!GA|PqeK<SR`_2>>b7qjiltvDx}G!%R}^&b>$3Q-K74d6%R{c
zM%oRSlr$Msdu72{Q8S7@eRZrl;Lf=hV<0ACYnWUYu}B9OCrBKCJ!je9w>~-QznICn
zymDSl(!cr@rU_lkUnvQ~pWXJ2{sPgMaZGb?p3xI5#CA2)R1F_;(Ra45EM~PE5=-ht
zj6XDQ%H1ma<Zk5Y?Zxk35m9dwsfT_at*^H!NLP7`KBHdO3CClGox<k${|Xi%O{<V)
zm$-s}VmRLB^UCkM-#<lxZ1M&W+xwa5en68MH{VV!s2=A&n*!%Q)Tr3DAyJdcps3LB
zYkE#J@nzPq^PFMfQ*Ohkq?QY<T=KU?8P?c0l}zb5RZmO<a-`Hm5l*Mlf7sbb*@_iR
zdROY|oa?vX2}I6iV<N3m3FTTt$`6_*6a4xi{bv9InI?{+Kh!j`>;13ABRKXq_@G7f
z5AldwI5WRYw3Hga3%~4&Kb!4NRnQ&A5=GK=(_3}*Kcdgf(7(MEX+qw_FRAeGEx5@k
z1HbaJ0pYKI?h~SY%3?&g;iLOoAl|~VTf10#>DwgxM#N0-Iu48Fu|3l1y@z^OsB8Ry
zs?BUEn3&n$a&2fL&(~JZCLw_y`_by=ABLurXJy=i{`w~}`h&ZuB3QAO%h6&~e|ha~
zYyXyldYn#P0Lj;SYeIH;t)_<T$n~pCsmizE8ruZaX5{1c%t&6uv9iKLU7~f7*+Le<
z3+CSfLe@u`@0J~J2ynMZf9NkuCOS`f`Tox1r|(G&nG5G#NRM3K7`ED^FTY}~LjIDe
z+vkT9c!a=@*O%Es-h)_|83Vh?#N;5{$~@CFfnJ=oXW40)w+Fkj3i&D?c2L&rZtO%#
zM2jtkHUro)*Qam)TbuE$1=)Lv$1Nw29m;Rw`YQrgAq++kI9L;P5XT#@pB|Ugvv)>1
zA(tD+17TAq7(FW|*#ur<bB_7*dP$71!nqP#9Ca}u5D^Jv(qk0>Wnv<4ypTPx(UR<0
zg*=A?O7CnWa6ZUQ=1dKwf46gq<^p)e<SHbRW^H(o6DZcmT_@l+Wmc!$v2hjLu`&Z(
ze~sc7@OPGNRxagB%1AlTfwb3yU<I8mI9M@I7BTggpV1>XZu=!l)1w+lX_vB`hYstS
zK6&RSusVIk>JcDo`w;H!jPUOey9Iu{!J!-*u?5=S2vV6Qr#$_eT;v{#H!fx?*b9jV
z8r0%nCYL*7T9uMj$Z$WpvvatX$M_SYk=08hCG}A$0oCPNZa6$@dWLbox<Ne>kg2J|
z!qz`lk$BQ`8ov9BOi7;VylF1L@a46F!<s?0IL0U8&i)*YpWsB+?j^xXpX=S%L<R@W
zFp7l^t_qqdB`1iG-i5ftW1;VDR)jKJG(<U4<rxxy=?$3=U#_QCADb4>M<U0R=S7ax
z4s=yV0N(g6jp|7x>o$pIjg>o>5EQ}RI<}*fFpFguZxyP5h$ZG7nk8Zj?zL6m8%Q&y
zAUIF7!lyyXb)_zm^Y2(j9Q@BHxpqza6@2A|c&wfdsJpF<>v_7wDWOz<pQ%@He1%?M
zikaaHhx|MI_^)8=ojfqdsGQ#9p-&5|kgZ5DFLk9fC@{JItHtfHS+$?VAZXpZyb6hF
z+_ZqDsG#aBA-8@aC$zXb?0{kVVa*HH3r7oeM!do%mK1K~6-sFR-N9nwwY+t75n~bb
zG3nvbGkLefV5htM2%)9MnmSW#7yT}t-k%UH6@2)NQ|bDUHcuN`qN=@)A5)~0-9X8!
z%2i?25_F>?;T)ax!cHxjrsf+TAcaT&8G%DWs~8NYeF?O=PtYkuO5*zE=UuI(gerdD
zCuk$9*io-s)3FRsx!N<d?_Pl|*;Rq#;4y<eXEhzrx0RY_=i5jjOV(r6D9`9pL}b^u
zDo)MO^@?;y1vYGOH|G*Z#`~?L;Keh=_33T2=@t5=yN(e7L#vR)lI;GPJ3lE>^)i{?
zVoWs!2z0OG!}Bh?HkpKry>d$){b~+(!WFqbScQOz%tPP%qYZ0eEA;|=@g5=0;>adI
zz+K57`T_B}c$^on8F6%}P+_Zan#w-h1=PDIEO+vzZ*f1ooJVA&nW8xXc!=?6h(VwQ
zc#3%y#j$`y6&QV-cvPC#<fDDs&CJEc-hSXhp7p4p7er<_{w}pe+=^m~fdY5+qT_o|
zFZ7c$qC0$Z_XGuE0jS`7fKzEDwLn%zzS8aS>p(x-6NKsrkZW&G_i9iTGLYS%s%0By
ztBefx%9}wIhhHNa@MMho&lA;3)2_H%7$trnB3@_D2u<-I73LU!N(ev<vk#{c6LzPw
zmt1U7VeizK8KSJQBKWrwDcVsO%xp}e|Fhs2)|J`d35By}E5DxJ{;XTVZp8<T6p0Fz
zkx0ORMF{(rBxj@@He6i!W`-{2a{8t>D^e+PUF}!AMrxZGvM%@516f6=WT$$$wT?3%
znRo_UBxaMrN_oK9MldsJlruy-5SxMGRM0wjpIkNzmv4?x7D~T{^JLBPSU%<Z9`BOM
zK%(p^%cvX+^sdmi7}2euCtqW~HOj2|!1-$_LTStY+q_!I_^s(&@X5JWG5lV($JyJQ
z1pK7zdgv&+9;e0@@#KtaDW(s!H<^6AM?N=-uHMJN_*(s-vY7c)%aJ{%wwif<fMdhF
zt8u%R3sn|f)JakkE6263SrAmLrF`mbrAVJd>^hJ6bXS=^*98b$bs+BMOmoLoa$5wc
z|Jmi)l>$wCi!)`!iI_iyHlQgOi9)wpz4=v$mefYripOaG@j}+!T9$t7eRh`ZXmxM{
zRn4-WZ@O&{!Z8-aM*7ac@1bV4)8&*ZYl}7uvi?uFXeE|9)J&3-kuvrEtO@3Y(-Xwr
zdIH|JV1k=lCA?Dq-r}ix=pAPjvdgh8QF+Af@`T(Di#j;xdTV7+qmI@~tLSg@65(C%
zA+^OyW#r70;|6E;HTM?G!)5f;mVqXu3gN6MP|yZGeDN{g^#NssK8iCmv+86*swdPD
z#keL{&-ufO(3_*UCg+1R?=}l1-M)X<U)c|eOnB;f7&7hV8rwMmz`7GoSe}XQY&s3r
z$JYxq8X)>#C{nQ|qCq;e8hL}y&^*nVP%ucpR1iB{YrbQ9fee6oI^fhk=N)PUqP93$
zu9FXVIr3K^+|IZ7Un3sY$fKQbvnIHjDNw-f>^W6CcM72*?I<Jg<248mTqW<b$fDZH
z(P^w@GctHi4|Tt_(g9(e*cB$f>bU!T%QqT(>Y)tN3=N-TS*Te4xLl|2^1A7)W^g{T
zSmo(-f=;2Y>usg;$08Fy0?B42UfyP}1+BJj7EJJa0||&cML`wL?84NG60kxMW%`0x
zy%Z4{jln6^k-24Gq~tf@@LqKdl?k(TOX2fGa*_Q(tY5aIaxxynt)v;L#eV%WJVF4+
zID@oq*uO*7kQ~;PK^yLvcukJk^8Q1Znf;}Isp4_&Sp6v%z`jqQU&mM*x0Z2viR|G|
zW350o2T81!!#3P;JHO}@r#Vm6{wWT+J%y&ZME$gETWExDxRzVxin0Bp)uxJ4{n2>v
zld)L9p2Cg{EbM6j4E+=+pON3I-2NUdT7Rqd^UIDE-B9SpCC=FJWDxE%;{Jl6H8NGT
z_raG$ZJ9>KUxj>5BMsQkG8eEpD!pgv-%|xWR&}5AX2w2L`e$u(n@AawtM2GkvmA~C
z-Q8HmsVcJ%BfnjY?Wj~`ZRPS7`kR8@zW{eeMz!AL7QFVo)vpsuF#DLg2z2hv;LdVJ
z&vpXuIef;!Vnw%U-#?D|;<3+}0|!5UgqkJ(SiG;|Qm-kWny)+6{e`ENI^%{)uW7s2
zc0!f9J?;I=Z&-9f-kU>%55COZHTDFBA-rqVh>@DtG6uc)yPTZtmjyj_{n97({iC$E
zzN8dW_k>@M7v9<H&`=Uxw&a5fJC>)Gbn&elq}1CJ>$B@>=jou#&&rm)%xLGEnf6h=
zxA`q+JW`vU8#kkXChnhS^p^j{{JH7VqZ;ciu?yw=(Ll(toc85@{-Yn&l5MYDwLSIO
zg+E6VWtFYEUNyT*zk8;U`vF{etN(Fk70uhm+#hjs5@9B8@taSP{uXX?XsL;Ywa<R~
zok{C*`){Kr$xTvAx#2+s8hBX#U0}^oh$DQK8he5y=c}@$XKPm>fr0uPFR$GPK2U}R
z_}9e}L|Eb|=7*=;_IjLIH2-?v+2PuTPCT(&QZFT3GEA&t&M?x-j@YL-NoSCXJd47B
z&^)}VebTy-E|b8jN`}K_LIs7S>LS06P-+mDBMQo5`PL_*)>Lm+&KY4c%?bUFwc5E$
z#pwl8Ii^bS8_j!RR%h{+tdP<0SyMeB%1$6kmE_?BBKXK1(}q;%E$L;GN+4!3Z=V3!
zQ}lHi5P6<itCr=)e7o*vqms&2v)Je{!QXPU<iOCk{eiG;%~2u#V@v&rzdta)^vlMK
z2u_SO{+um{yp=p~(q;?0pYawg0P%L#NLISUpbXy6M*(Sav~E_Hq>tAFYJ@V9EHs*r
z7nvo7InW+3KQtpk-v%Po!AgJWeJ)QePLO{p*nI^Q=)BwLza(?Wu_@}It~!Bf7wxBB
zX_WluTtNO&+97O$PqLs1R0%(b)>AX3Dl%a4Hw<X7lxFVoLYpGY8Ak&8FLy{B#a^NF
zs3V|QQqO<j_?IHg3jj^CvU%;02vA`*_CMA~y4Dze{y`@eZXLIjOxxMC=iLf1!c#tx
zy9#N@Zd`?=1BL%q(5T1E#a%zd{;mFIP3hU`^jUK}jweSX+L=0y&A6ffj~iOqSTeuR
zHLU|z{YW1BL_FY8m?$F`YBl)}thm~wCM<Hd&@&tGb~?eCk}ON^=-9Xwf9!J=WhG;d
z_cZcb_2mU)^K27lbft6TD#XmRo0Xghib|EkJ-a<E=8!cq0`K?kG9Ytqh0i@W#=BOh
zj(t6AF(*12&2+OEP3+?G<}b0sw%&X3?R}Lq%3Cz*=X6=<R6<7(%oFH79zoOFe)NWa
zFR+k;;$S^NHB@pCG1W``I}|yeBC)R$I~q!)mAz*MKCD8D<J@!&aKbFg=&ySx0R93=
zujpSB$^fx_j<ms`)0n@1si^`iig2d3<3pe1Q9k(jG%ow}1$+|uHPba}j}rS~_t+>a
zF~@o@Za4PBHI7Xa6H|M;T{qSJ*HHCug+}Q%G$W>^2RbVpRc+ba;jJ#H;bu5>pr*H}
z^9v8!=-fp&qk#GliJD$Nn2*|B^K#EUB9?a$u?@_ou88T)rY=LJj9ur!<t0H(S8osj
zZ8^G-_`(GmcZ`Y5Eb`0GWr`U`JK&)B098vmjq@DZlVb#ig+pavO&>8QG|R2`1R>7P
zbLnw0!e1`?k01(3lfHLHNHJ_M!Svk^*)`$JJSWsZBLcuFt~fA;U%ugQz{;y}B)?`H
z;GubKmFoL@4(3))D*w$JkL-e;(0(@2*JKg1hgSp)oNaypDGkhv$tlycvacTu*XFWc
zC%<7F>o$2)efy~BZopPW^b+qm8l4Q~x|f8KerxdD{(R=~&+NQbxLsF|&g6<Hq;xS>
zgSPSfXBDz>VnknBJ+Pp+RDb^7nDw0snB{kUTuP&U`0ylQkYif%tgpYOazRfdp`O2i
zD<uMTv22OA(B0q>rPZz*>bQ|D`6rh2W~{M1AY33gc1N7@p;TodMZ+Fy?Ts#@DorQ~
z%&h5?x_-%n0$Y{tgUO;@-3bvy+-Fc7wNtV4O{rNP4Co*+<icEmK?LC)$#l`wVE#1Q
zpKonwY0H8I^d{3~(hCIQdaGZ#eY|)CuS$c<ZL|YMiA9sT{uTPd)m6y4l8)AgeX9_F
z$(!O<A-}9bF6RG04ou8fS!LDrM%sFRZXj(DMMeK|7wDR3_}sdw9!I`|oj66(#qF1J
z1!j?jd{AbWfC8T)%!p7%okJof^28|r3bawM<SS9xxst4EJN;8Hs_<L4OxbL8f6o72
zBTxDUee*$XNu;X1y)L66<)ZM(mHo2E?9kMc*ic~V13oIA5$w-jM1gjHq?Ko9nLo}_
zQjGTf<&4ZJI|d5kQ$6bTf<HF=XUg}rc*#tUVlC|=OuY7&$UbR%9D%CmQ9Cim=<r^*
zme@`ki<3TZV1slG$bNfWF%Jsk$wRkEO}hKaBtSDY;Q*hI8`jWP>JKY7xyUEtW{vZ9
z@{g@T`WqbctC}uY6zZdwniz+?ayh{)y?aw##<{^`$S92%#sC)y>#_P9_)_GQm@Wib
zyXkMCX{<uc(>1w>Ss1D1mGwZ_@&F-5TG@Ylf-b1eeF6q~#La&<;^kD=_8c!DFg@&D
zi;6W%pl&?EE__<AVQEFZTZPn-g_Ax@h>mbl11ocE85Oc6G|a0^LXmYhe0yS{CAuIP
zUj>{Scl6Ss)%Lhr{#^;DM_pc43%LEY(g#!4D)xwgGL4;>X47%g7Ku~qW2fbY!_u!+
zu*tI;Vd>y)7;;?ml%ws#Na1zS^-=`}o!9g7R)jy4;9)_5$SWmgVLti!x5l@!N1CGT
zTR`ArF#__GxB$c7jnp4I0&I><q@L)4wO0<`@nK+hYUZQ{;~<#;#P=|$JWtUxYl{16
z?ogr8)jfO0{t`rb2%9^M5{_4XhfOSMu0{s)Sckks+&2tl51jpjuiw1tz5Q?!T`(}y
zERJ3#($LGq3i3;zn;U4OpOkWd8r{sU>IKonDCaV%jUbh_>4Dt1=rTqkE&1F`69=Ha
z2Bq|wnwqAh_PeIfbidc5hiUyll?c{I24Q*KN|dX`jHIV%LU2N7)ChP6QJ5Qi2m6pQ
z+evRVqrJlTDblG^%Z=3HtPoX<F+qaN#rNrjZ>2;f;sA*qt7yhyy(}|fUZM7dKeUC<
zo75IAFmC>24rRjYoO~I3b_%w(MY0}%(5L-;p8gG>w`cR3cC-bh+F$TC+55dpZrvoY
z|MW!@kmCE7FkEnZvi`ccJma>0x_^gSQrNYO<i7~+3<_VOJ@qAUZ0w<<ecruPAjSUv
zj%jR`Jd}B2yXjZo;&dbYhX#I}#;zpoXW6ImUjXr<u%n#cCaga8?fC$bd-6Ru5AVZ$
zK5e=#XE%vwJ&7C}1612dr_P?b4BA^4e*+g-9f!HulFMegflA>jB$TFSF^f#M!%PVb
z^N@yR_F3U!-6!`21seI5szVHVzsMi~+pJg^8Vqu?Eywb4W!D#vK^3u-f#gFL#{t9k
z+&3C{(g$g?ofH~So7X;wMuL2x!FJVZ^gxy5bxFy^$7wiohO3!h?Vwq7&TO8;*zEc9
z{9+eR_nQT12VO{aqoV=FHstCxnaHcOQ*l?6lX0}js$rl3N&Y25*=D>HiF3U(bBVpP
z>|F5IxR(kxKH6YN&Q90tQIDTMef>`RsKcuz(;=ea8{+H?@QM9lJTMW4D4isQ+}Zi;
z$EmLuee%O}FZ&NIVXkr6p@|EVe^ftFi?M@4OYn~44EHU)y=K!`brTzK*Gso&5sNc9
zi<g*?v=dtjJiqPAtQ^!RX9TJQ#!revM+xuRZ!M5!Q5THT3lUeWaVFKYpSMF*7H!m&
z-)d)mv{KRypDtmZ2iO>2zXgCYCu>|=tE-kZJhj=(8@LBYgm~lY;(lMEjMj4@@JdzL
zlC6%fa(6SF{L(NcG!3Od18*z(O}0r1K^Ny!QqqIn%_)qI4BTF#9}?h_@mJ?Z&L(cf
z=o9=_%&|u8Qvy>1*-LeXai__?b0v{tq@$Q!7+72azV}u|1Q7v3EU;+hG=t9m61kf*
zIEvQH)Ze)%Qj%vcbjOnU`_&`B+ZzPu2qn8YYhN{eL9!LL5ddi09Y}Jgm-mwHr=*|w
z)P3;Tr%Q;~DSk6bNFCZ{Hs0kaPBB*Wk$~gV`l`^zWUG(i(}5K>)5AlYVhRn{yLT`x
zUz~#dc&|9bYKlXx(RNoiqe)KuS<^|c+njZ@{m<G9r){)d9mD=U8R`~M90Fg%Es9^<
zCRBXOHS~@IPOO^iiRp#%M|Kg}$_nYZlLf*U;iEWKs2wRDWyWR{mwoO0xE6?cwHftN
zkB{@F$WbYfwC`y<mQ?K{$Bbf3LqdQ%fngH^0;jfnXmRi8fSB22)fA&hF@4xCCgpO6
z7XBKkPFIo{QGRILa(n*`^)GCTA^nYtEY+ZC{pXb+ctpUtoK?t=QhG0lNp3~X^?hPi
zS~vRr0?_7xmkzILm@3!u3d5tu8{8)j@EAMB=FoeKEQa1c8kN+4l6xI1*Yqn{LwK+<
z@JImZ>#1${8#19$kpPp4o-O}!6xW|OZQWBils^pGmY@3=U>Mq{hs!I@DH%G)A{5C5
z4s~)xAfm7>QVZUoTF`@)dyC9@*W@n~e#2OTtcd}Ux!?njSSQhetz99%LBONeTqCAC
z$I-7J(r!|ksI8jY^ZcV7VpjxbE66;;=oc@7`ERO)$&~j@f5${_|3^P&ltl~ld63hE
z>l&Cv#NUZ&6qb-#Tpbill>$I770e&6+}EZ^r-m<gYmEUa9K<#skQaQ4YYOG&55)bU
zE}7iDtRPNfYK4($1EAlW1(gOH!GG}KS9RqYG(YUrtFc^2VjmmR6d=oDM)v_@^cz7x
zctGweP+hO=u%7JXf0YhkrunV@Vz|wkbrNaFJQ=I$iu-xP<9T8YNB<S)r=3cAzlW+J
z<rU}LIH(df+5fV~aw(M7q5K4VKoe@yhN2^e)}tY7Lb#im^G5=w$v*T3K${i?a>K$|
zueDkAg;(Jay-o9!S}~@M+8Fl&=q%|ypoA5-xVR+s3g19E(M2<%EH`BLl!eFX?Px;*
zKLW}RNor!=PT<7{fU0>;%8mBYws~x4G+}s>A~8)X;aFNv`ndj#w>e#=P2^~ML<6-a
z&>}n>6x;b;!b$>u+k*Uyrd_k<lzs5O4sfV#*y2D>F~QmzGy3p#NfrTYd_W7iS?Y`~
zU=4+Lo{{XDgu#*<9^M~{ivz@XAHu1(^D;@%U9`c##dDv{cb5K`6SHtbiA0p=rLrh+
zLYs$qGjY1U<x4@H_BT$sAAVGA_2V$mS~>Gch{F;!7t!k73zs6zTJ!XQ9iU=5c_5&=
zB5ZCuP`|f)$7#V%E(b>QEB;7%7@?qWSrjkMe3ax4CpC^}$kA+>i$?s;PwTcAMdAKY
z`8`@1dK%aCZC4$r#=Km%C0`-W*LC`Qx^Ou5+tII8eWE7`P8gFB(+)25!iT9PC)_{m
zbD!1hH)efeu)l#%>yGQC&K7m&S-fR7+C}D6i%K%R@+Go_%)LaZ$aoU=2oJJ{lmW`h
zBP*QFh-GD=(#L&pKz=`@E^w@oIXRF|>>RDVJ%jjk0N_-6Cbj)(D{6ciH8o+-Sxp@h
zlI!Q`soZANDD$w?J!E$<M?C@s!FM;<oxm3qIUAe~e)~pX_apQTD|_5xL;wKo>oUuf
ze6l{9?EThvVyK2oG0BhKv+Nk1|3E9lESZt<0d!P|B8>kHp8h$SE&=~;wg6^DVWNm+
z$5wd-1DHKSu{(gE%HH3JuOjR|NZ+#q85#;DH_pOscN;`S1h|~dwlJ}uD&MFrPABWf
z>b0bgv0i#}Dm_p2N%=4MRu$3qsm$2Ka>|5=K=&n1)E8Y8sW_9c3Q)aH<(m=Ju|uhB
zmF}C!9R$P;f^O1%bXu650()m1n33MPfJvj~li!-TBM$27yKM;918%0ZNbCA<VYljD
zrQRQpSZ<LB>2bdHnU#z%@&W?`RL1t@^V92ns6bFOXRoovq*GhAAKSu4f8ELj{!{en
zUy#`*?vypRh+1%YLxfQ|YzA6pSz~?R(c?8N)T>3{xu>}LxD2tq%_HVX8=@jcBKLsW
z@Rm0Nzz-In3mLA?ttriTS}A7CUD4>tqBo}9BQ-GZ7z9jJCXwVM8%#gA&WM2DqDc1#
z0x*$td3-)n>udun-6MlLcs^e+t=(wHW#0Br3=~}SZ&~x~;n7J)PH3BJo|(-`{{RKr
zE8VM*uF|1(1H+Qy%fK_BqkGZ61ASg2safxCN~Nmlv{oZG|0L%JBmFasB(H|~V3uXK
zv^~2)-w8yI$qU%Mh0$$ZAav;4H-ZKFfpcmcT}{wbi|HcXwY=&>gZb#2^_frbw<3e#
zc}je{bPtC3xYRJ9K~|awOfhU88ZBQ##lgNjwo^%NIkF14H+*FtUce$eXbL#JxacQ-
zeKf$ORW{lu#q)>j8t5?|6T*9v*sr{~xh20%KB7u?3UHPUO<8tD&X0ggwusytv8=wj
z!*fEQw(w4PywofvBvf+WJ4U(+px4NK5z58kAly53*gY1{g{K}#CZ5<DszoRrK{<!v
zKZvx;#xyg}rsWjVSro-fr|n=I3>shYC}S0JTBinjt1*dU;wcw~FF)$gj~=t-gipq=
zLPD~6MlI(juFpR`p>qQGS(KGYNdW47qypWBauHQyeK0qFLcQjw*q670EPmx!5;;xc
z()$Au5ulqUdySaye%}1JfxZBbaSM!_ysm%DEgYEKZ!5|CFXJe-979`<S$G_5OLj>n
za2`I~99|*uf@<n}*MZrR8#gBBSh@f%*|{k~0SFfb$SlShRR4`r-9>;y9mwk#^i@O?
z=S-0xk2|{mipj*7JSK8<3RMjNmj-aOo9-`2&jAl!mO9XDA0n&fV2G~KuB21)18eou
zYBAq>V;Rm=>caJ7*cdK1^xAwqp`b<FZSi{eTQPO$DGOSLX##pG&mU&>U;QMaO?WGx
zZv>2PhXC-6I#<Ep*m~|!hK<!h#<AS7MtWZxx`EhJ-4BXnr;1uqoew%8uuD!+&IjFm
zHt3j2Jv1!lO0j&~pTgLR@ZEDnSq&2i&&b*g_F&4;dz$y=%5kP?(w0z41p3+MCA?U~
zeADx%*>t4)sKpNq|Jht7+C@w<><Wr<(|VF0Z7)>Z=_7KkgEGos|K(cCRY)b<>DkL=
z+Q=gDAjn!|;U~?dvHeT<o&+zCf=IwD0drZ;Dt3#i>4;Cd#ZA{}Q)K<kVT1MjDiTcD
z&3K+@n;-qrLwSJp!qaDXN+nMC=ULX`i1crc&g~;ZlPa^7y0NgHAiMWox0TBZ+6VR1
zGXsk|oAb=yp%-rqy%fXl%FB4K^bIhS<fH?n9MVb+vrhBlr`!h8gXW;+rL8YlA(tDk
zLsJgrtJ@c{(unK1JdlTEL|OB*tS#>*oyQ!#rbeA7bv7hp(&5nhH2Yz`gTI1Vj9~X1
zniCm)2F^+E$!pWKN<7%Rpfk8egL8|6r`%uak}up#`8)OOp@Z5MI#S!*u@lf4CEyE^
z&G>}O9#tWULRwi!Y_ENi_IeBmWHIHnH5&e%?{ClGmR2E?z#D9t=<q;xKtlCbu%|r>
z0g9ZOP9A$tH!$R6P0ifVXqE;2<Fc?fW3eg8nI`E6m%bw)jAdu*aUWe|Hh#7BU^k-a
z<2-eb93R&1M*3Jp;65nFgF2fK;r}~5grk{;ammv}8JvIg`)tOjhq%?J%`8;12lGkZ
z9X8b++_H1&De7p2%Y^WCJzjIyS83SKeQ>hO%3vHkb~lt<X9OAbs-9(E{14c4_;GoN
z8m)_|%WI>L%_8}e^ZCH3M~~;dMf0M~yt6UQa_V2<-c6Mrnk;|4n*i(w5-^DkG`?M@
zXRs2{CAo`y&9Er+Yq-h#B>(hI5_{G$|8*p#>8?U_qC(EfgR7@whp5X1imUSN=rp4b
zK+r`u+(eu@!w^y}ZLB0oq)8Z9JO?<;riWN3bAfH%+5fBt-@k2)dS>YMIbF)N9Pr9!
zcLqRHxxey_tN6u%9=J$E&&4e<KQE-@sRUKHvVT?tKPI9tRxdwKypIXdOe5=V0Sp`%
zra;3U_xBe$oX=~%TDzOAZV$^7rz}r>?8{j+DeBH74+As$>;opWeObty$O6872B5(W
zS~M8QM(@*#V1q+_Aa!*;0NY`h{wH(_DCKBjOH;Zs^0%_9{2vz@h6fgSCi&D?6r;=j
z9YJ{a>lJ>J#HfI*lK?T44~SopYr}SW1ca!pOue4S%2+ub>MqL@@L`#tBWVqF+;I<C
zG3r>`6=N2v&L7XL9G+#N(>_;Rc2&`NVHE@fIZ8EDkJAXE3-otWNG(|Z5y#kTGU2^F
z0;gW>+e!3leNmyW0vK?wv4H7KQogY=X3h0$okai06t`fW<*g-m<ym#UaJVCbRQM5T
z4(<|>Qr@J8-=27bN{`PL6yB!45?ZV<<*}?#n9#gg9TW6jgL+ud73`;yw<X+wv(RtG
zo8}E)?ST^O)YrgXT@HhVr8KfUyc^~(u?#DB(6j-Ic)tt>S(ZT;bbtY?xl4G8*qX&d
zqjqX$D%^B&=K@M-g#=xs%oNqW?4!PAN(bqxEe*w34qC1@$U|AHE!rQIIj?tqDHaa~
z=A|n|(9$=D+8P?7pi0bsQP%IJI)C)MDHJNbWC&Ffdqjw&=wpY6M0f2I54gwmj4dC2
z#B0ua0=<PR9I9Ny`f11MktBI2&!QrE<WxA&ZGr5;--Uu!TbU7>@m5{S1BWZs`47))
zrd@rI#ht|7|Je2f7I)7JQ}4(o^LAXMXdV^)q<b)<5QrB~U0hxTooC&6czZ%oI-w{l
z17<fp?KLX-=vOm;;Hn1mIDUy?b@cFKa1xNMYU>||JJ8-pI7Vuse!%JRHZJgnk9q((
zJwI&EtVvgNA#97;IL)|EBdJ#0OwV)eKnCCL%B1L*g>JwB?wToNrQ~SxHTPz#&!44)
zhb%$4<skH9-E>j1<e}b2lpHa_zbz6uZtjF`=P`}1lcUY7)G1Em7WVo2ar@pou$dM)
zVz4tgUFzZeH5haFy~TI);rxwod}JHgAPboHPn{uApXLs|k?stVSCw>VG8gvAH?#K3
zTD&Rh3k=(A!HGNa{4z_ZjU<V{ZD)%AowFi`?%!cQ+~!31wM+=Y%~pnn2c~@vYp~<2
zmxHA5L*Fjh075)U>T#!ziQTIwDlzd&{PU@>1HCWB^LekMhKE26NNrW#7NWrAL|qz|
z<e<E$BPq>e!31)a;9??Nws@9`v$z*o(l^7U?W_P66b1V|qkwqF+DF}EnN{(;fE4ob
z-SyG%paYtY+NH=p=34K}8r6Z#Twucl8YyI#t*8J_8UqBB5#=*{sW|`_I2h!0`rgt+
zqHh4*@bY|8);C=fQ`iZIlOJ7J2RkNE9^+YC3Fx#%#v$(pubRtb(}it@)haDiRc%8z
z<6Zh~oRQ%B(`s?bQJ})#x+dKHnL$XBiZR;l1%b_Sm7Jv6?GJ1!h8id$DBVtQj#58M
zi3lg{d}sOS$G)ktc~RN$3g(HXW3<OWU1&P5e7*|V8+zN@bAa?-J`k{Sg`4fglaY8q
zm!FQ3em6?J*;93JaX89i1|7aKY0wDOT5Pww2F(|jcacBmrE3m2YD#$B8tANum5?;f
z7w(>1g|vvYlWPm#-o0~K$6BXm#g<NJG_alD3FY};Q^GJ=dCJY|<)x4B!djFn!_RJk
zqm;R_@g~*WEW5Df>QwV_L#V$Q*e%QTx^Oj1)$>DbNrM|ves#yn$&}EsHosikoW;qz
zi+83DjEe38U`%X|-|?r{)IJ-_!QxakLrm(hFR8%Z0+lFR>Y{9K^XUSp!epXkPmzH<
z@v~Gc|9-9*?;iVW0PulSVDmI*NjA>Wrf-Nc6e}q}q!EJs)dr`w41tYm(eQ)0B`Q+k
zp)R<5D|<$C+b2J$(`GBZtFGY@(0bb|8HK?9#$7piD|B2^k}aul!%qx2@#oH;gIOCA
z%rDVn+<bt$_++#?k};TiDiu(f$DG;<T<#P68D6~q%0~RQlv4q1z6C9!83l5!^0;<^
zAk~UyWg@dUR%NmO|03zT<C?nO|7opKwTh!^1thJ2D2P;LC_>VTihvkpMP^i#7=|f(
zbH7eh3Q-UuAVi7~RtOlvhA2a1gvbh;$d(xrAcG{A-{JH7i<dHTb93%F&+}dnwd%Ro
ziDgmGd{^@4n*al&8ayFHK4N9Z>a`Sp$7l_xt}FB%m2M6|+@wGr;azKASO1J+q2ucj
zL8b1U%h!kdLNAdy20N~(#9*~E1ar49d#a=&7JDz~?7I8tm5qdH8Ie?L4;pocR8p=7
z7dD-pWO&H)TXWyl7I@lv8yM`8F;Gy_hs?@c4dzsZJmz4gkfv>Uhh(3q+jZ&Kx&mR@
z>vGp7D;8)wn^v+lS!S96=l=paCA+NtK!^LNEQd0Hu~u!)Rq8WkS~4kMQ5FL!!m_os
z5Eun?EyuDQyT%0hm)Kd?OY?<(y*n(Q9I&N2m!-DmJ?9jdyR0hobuH$*qbmzkB3H90
ztu9lq+W}`ljYZ)|E<&=d_sp<%p0djICSjfi$X-}b4i-B^CrtG!(ck#}N?ljT!v75y
z*rPs3Z0xI$iR5DA?WLe*$-0`j!@?=@+V+z`gzYy17t6R=dIO%dg^G^2sE5WIT)0qV
za}l$!YF^ml5!E(JT~&O_@LnYw8jq`Upx`SBSa{(&nSRbI_PR;RG$Upusd!zXGzDE_
zPt%k2&2;DB=3Bxxa4Dd|#J;z$DIg^oPi~-=mi#<Bo&LAN{J<%WT@s_)0`OsBnLY;(
zOBt;TT6=Q8p4ExL?7M2^G)vR3%m~lwK<`p(o0@o<4+@gLYK9=+aP0WHLYMI(<ut;>
zK`;YjQbpedwTT|wyFRSj76qV(wCS>1c9$kz;>rVkz5^}h3gs%ZZ+}(|vaam-3bVq#
zL|i-R)4#5em*w0q*piio<dkGG^1j+j{iiX}#!FKdrKd%uz_rYCpCOLj|6lnNr%eZn
z(gKMujNv3t0MvY=fd+5*wel}<$|jX5DQWk91hv0;;%Y81Y@)ste57u8WU%1OkRs#(
zvbode$*<7y+VlyDUGrhe!j5et=tNLdC3;-O$D2($Og%<oI*B?nw%q|gD3Q!bw$~>$
z|Cf9aXmS1PrUa@vLTU%h02i2ZKtJ>(g?U$$_jsS*w&|QLBk3jsRgQ*!%;wUP%mfi+
z;M@J9Wijpmcw(;uNG%*qY>BJ*SV8cTR^mvup|y69?w_qw9RDA*Ee?lloW}YrE4gcc
zZMNE1s-_v7m+TAV4HRF<5o`{j_Nl&lY3K_10>EeU^V0r2c)d|clxJD2YG3%y7W7<)
z7aa7A?IEp}%xk|$uuT_{mm~5X#$IU#h?}nY#lJSYbO8mPCGBclc1F8Pf;>+n=Hwz!
zvRbI3PkR?cW^`Olc5VR)2~1VsDgzz|(=CPOH(y-~|1F}_FS^zmfCBl_M1z`wdY<iy
zBqDFH40!OBUylpXmg&lWink>R^=t+=o+nK_UWk}U)d^!;mBD%^DzYx&0!=h#e@ltX
z+*m4oU1K4&B9im&dz=n)K@@+M(b(xU<b5|G@}kMH4zv#J?l8hZ&}FpA9#b3nyt=%r
zNz-E_GTS*gWmrw0$gA-WR#OitMB*emRofpt7&hO&?b4vQ)EgG&W9PoymU!vhh*?-7
zyeRVKb?O95%_NX%`0GE5j7=$8mH3T*Cc*RPSozwc&&t0TiFUEP4BSV6HMzDdulIn+
zu$Tw9{lFR9%;qIP8vR=#&oFo@b}9mvB35}HGpY~|n@G`%JfOQNjEqwuo{ji2mzN9(
zsd8%y)|A@Ba^^0*T35*E)ger9o9GKCfkb*{s!qT$CC}|aFFFjpM0{FGf08MVy-f`3
z#eIXGbzz6JQbp=C%_Vt3hlNt=RMfIqhyHb4Va(dM7zzdotB<ppJhD{?V(ipKLh&6*
zenz=CR_JKd%X%dqKCa%sSGG!}$gHYKaEjIjq(?bj)^Ce^L>#yNf?geQ#fLy+E(5F6
zEPpMz$n6J0p`132&;M^JIPUn07n`}<t7-WYdi#|%s6LF6NS~%%1}z`)j~CoKbWCHd
ziI@-FDn72w25qEjNVH=@<m7aJCq0++HD4)0Q0!=@O};Z1b(G$%9$Dt*4!XRGXRBoG
zvFaG`^Sd)Th`jp|B5)d(F2F}4Yex;KAt8mT8K@Ax*F;3ROzAvF*XCG9FYE-WU}HTA
zPGD!awh|oleHle^fEXroP@+kT_}|tilBiAW+$6xY#PaQdkjH=!nYdVpB*=fv^Gw-x
zQL9bhO?#93s%;u>PfnoAE1#Z!6}i?!{QD_(JlieA4>4ANDxN}Ihg#g_xd8D20OYmK
z(U`>=hq6TUNXVS=o3kI0`ND0%<XI7CC*Ac(E*yk0&AIR@Vo+Q25{`^j`r_vVIP{$$
zj-hhc9mjTAUC29ltSi^Owc)q2ADVN<J4c*)fT*{pZ{8$tcCG1;r`ZT0c5&vz4S#3m
z&E<=Te#nVEcV6hB)dvM$YxZ)+-pnKIueHZtEnhwLKBh&=xC$4#LDYi&33xTww)-w&
zl^OQ@a4wSI`Fss?ZJ!1Rz}U}tC->Y=oN?Xtl5r9Mf2UcZ+(KYMbls^_nVw^y+Y~ry
z3wPQ5-82HQd4|h_+#oC3pIw<CQ-GK@)iG6rDc)hNSJn*?pc5HD&Jo>KFmC+|U4y3U
z*fpLP6qrxgr``GEWVO8q(CgJ)1Ybvv_a>fwptx4aICN_4xb1j><m1<?jN1d)KYM_H
z%fN%X=3t=E3C>as(ALrVd(Ihiy2h714fGB4#dJ-d{zj3G4mzfV8gnMsR$sp$-?H6_
z6{lPQ6u#H5eXZ~X)&rIByc7#B!)X|abb4o~&fGZ9i!&=T7Xl7#p$+6nZGeF^DKQcB
zZtDsrvu&<`?|Vv0wgsB-;#Q3A<bQ7tAiJzjEepDRo2E9%uAc;d#?K~eyk1w(nY%Uw
zIi);JZ=>Y6MlBZM))j7ec`Q@!3|*XjvF!P)*@W$#=f_4a8m#rE+EB{fvW^|zz=$(f
zz{gUk^Vl}qe;|!|*X0HV4XkZFgd&X&S<m-tIsddLw^`h}u>ZqFXFq&Eai70)<juOQ
zQ-$O#6Gj;Y_$62<k$thxes_u2ncJJ^>sm_n*A-T=x*mfAu%L8B%<Py$_?%UG8R5rC
zN`v>E2UKVMf0&1JQLBeM6?s1YQ{T=b8syGIk-Za2m<I%u&R7!pgd^~7fYbJlUw04a
z#jY$zy<Sr=c|o7_kusDLSM!qqN>~2z&Mwe3y$8V+Hnw-(ea*KP%+{{}-h9jBJsa8$
zOS&e2k7@TddukI-0PxU@a1Vb)Bf2FkdtIT`7^^e)*Du*F2xGGOtBZeXZ~Rxvi{hWK
z@-S_?A3Ex7w44Hh7=8nvi-EZ>Vxv_n<9Vw1=+1hDJG`jSvH@<Fq@J+6zdd0b%i&I;
zMRduLILnA&`}0<mY&lJy*Y$D-h^fgFkzk)|;NlZA-t}wdF--hARPEpGYToAntuiuz
zK-OVQ@3?(e4ruH|iTcp&%-$>@n6>@!EGpa%IGyl7d22bQop;krFHDn%7Sw`UvS{1A
z<?pLeuV+ojhVN(|2FCV%3!aRce3marxLOiD8JU|VR5*6)XFN*73;v?uGOcw#v*qz+
z1uMV#+?M1M=64N%vZGAdVP|duC0X>H677$y+LTa7V*Xi95~c3bCbN0=g@Ka{6$}qV
z6wnMoLd`dvkZ3zw!>T$9b?Rh%T})WmUNQHoYqFX9p|A;>1U=ozZ+i=$s_iz_7#L_p
zap7$p#7m__p0!(`FD>*sjXeqA__Ay!eS{7*RmoQO)}@um-=Z=5OF8?cqOKL`&x8eT
zFbRN$wEflm3nLyvu>2AE#;69bRE#8hS!e6Ft8rmkg+uocH_MXu$=D}#9`P^c4Kz#p
z!2TN*gNi{<X*E0V@!~|ObA7Z!)9+q1_WwUS%GNjOdl>>6YVz%KttDId&j=L;=lE#q
z)s%D2tkhxDAeE>j-sy$?^*rBV@;$_iT=l=klt$Kb|7-q<8x;^X{{&sOmo&R1)(B~j
z&h#8Gm`?bI&x6OoTCp4~|LU`v3axg0Tvr&PUF0i1$>1lYiwuR$!Z%&K-XBzRvqntc
z<|25gKEd3Fv?zaapA;1^8DX*1InHaEf<9`$joKONBXn{58zEi&Iw-TM=v)lcRhvC%
zvOrev-8*I)c4*6JnvI2wO`Z;0!7slxIE!rd8~<cjr_0ASfm<aX4oE>fE?5Zi>2Xg3
zXED+3`cyXkACZnfQVfC!VrslYP>nRNoFhDNx+^;*WV>&BY05<N4;7LSJa3aGqPUZ|
zLip7sv~}vQbp`*sq1hQ@&!EyHXgYK#Amxy>l>ig<UqVcm#AE4+#$Ux(KcjX+K?gM~
zySrA7Wl5l(EO#;1uE*Pi)qCu)1>8u$N2ynEmmQlmP+ZH=oM77t18DTXFrnB(G7A$&
zV@$P2)yD8zVJ*@VSw!Puqy;K=T_M<&{C_e{|H&FomcP3y^zqqhtL-kI`ES^sTcwqP
zsCMS3D{+psli2d52~?<U+q%L7z?RYG%MGJ=kVxlg_V0tU6Dbk?k(rAYuB88yE!Z{~
zel1(<iVUTs(p-i@gVb<xzN=Ebl(z3)Z-QylD>&}8|7qp!cad8|Z{50eIPyQjsX}~|
zE`8Y$!`>5;*#N6|o3uWOt0Mn&ua{&VIlX8Di2Zb&UiU2_8)(uV|Hp2VxaGKcK8Jio
zu;nt<zYc@&4t_CfnQG3cjp2pHV_spEwuVzQuaqig0AE>?pvGPN5acfWAPRkbZ!L2`
z7VB91`*Yrebani8k&OJqw8N*imhv7otXLE>TM~@*Oqj|~TGRJMqyQH)cs}7UiHrT#
zbnm5QXjkiVk32tD`{ui#vjFOrIm0nML$q+NiF)b1lF`2Cx0Yd4+Cb(AgXrrnANcNF
zplY$)L!QS9bx8f}my)4Ns?*;(VRTBGP>Il4s=*LILEQ~8EE<w>wsqCtXg+t}smlq{
z#4OFci`T%Rq0F-DW^YI=b8igv*JCc8g;#IRW`-8dA`YgRrB=V7-#<)kZ6)YCL?pqk
z;jcZ^zGh5DYL~2LX&5+-X%yyM2}}L}n1Y-;@&(6uz2R<yp53n(b(vN6GO{*x$V#^F
z>i8Na@ZfeE1_*rHV5E9diL1ABEHs0<vXv7;6SW4skXCu>mH9$<y{5pa?v9N!(B?gJ
zICo-`^9IM)10pzxlvd~cg5K0;n;Zs3_Q6xa0_lctg?8foUv&Q~W$<fY`-uo7o0*+g
zlHf2UQeY0p^Zl0{hTj5%&huoC5l-of6srx)>hejS89{fQqWK?LxP6{8OFcV~z<3EW
zioXKY-3D&=9|i2jN$+j|d;vRr8=FMd0J%lf^FTHo(1znDx%X(Z2dW1efR?kLmz0xZ
zrw8mO`?`9xt8n{3eo_SvmU|91+Jj5rIZ$h;`1X6d0ZvAw+Yg%RiNb~U;uYrbS3>S1
zq0`fF#llDP`)mZ-pWk`<(FY~==f^(jyif0C6%0PhXB8;F5jb_9a&jnm<tzAl+@#9|
z+4e~LoaLPqSAzUu?#Kn8#NCzgMe&^P?bqBQhkpT+z2nrGeDVSi1KpCg#LOc^f|C1V
z{+g#-+(lj~fpL(Bhn&<BUs588pw)nL)6}K3ICuIc-mxJui_+xiARVJdo}&hI<hSAG
zo7IcL20K6lE4U60e`Z)&NtKdz_1YWkNT!)kxRJ8;yHIHiK%xJmw_+GkZV}}ZGdB9n
zk=(shW4iutcbD-ip}#r=Dx?e)n%gaaKmh+ICwnw%W|}+S3uZj;;h2^_F7eucAkMTs
zU-HTxGvl=9;-uXvkOyFJ`l!Xe)2;a=M7=#|a6RvV3<^AIGVKNcx#!Z%CqsMQh5sd(
zNyl&snm`GY8m=_raPvAar8q-Oj0U5PY~a{6Z_;n5sc;%-3!)Z$`e)MZy+fdS;&I5Y
zEORMA0{Q)ybyo0O_&rrpe=dI@YI(9SAKoRT#v(qcd6Q3Jo;$riOjy`?ifaX=35U!q
zL-KocWm~0{4ZRT>e8Rx%-0tZ=bFVF1J*&>NpUdOuBR+sFPS9C&|2D8a1(L32VA`@R
zYBzA;*S7k?N10EbqXIPnOk?3M9q1ZRU>nU{5io1epcDeEpLvP#w(FqA%d*z6GvE0B
z57;T;dw^xwVl-kzfllM1V&IkjrD?|I|5NQi)D)n+OA_dB)j0yA6E&!MN@D+obp>b<
zgUcM~|86J+hQy?RaHM<p$4P&x=@n>)SRHXrOSZGrAT5ktx8yynN_1)Z7pYzC7GQV`
z{BW6zeoE^wQW_m^Uf70IB#$HOl^$hAi+ASV;7|10%9wt|tJ|4|)^p%AD#%%61}}&D
zN)l^EncKOuq@RWO>3S`0u$)VBqZB<+&*Z-OGG=jA7{<)%i_9CpofTLVp-=A|N0({<
zc~gb7l78fo&pzgwY1{tXb%n@oxhLYzEagcu5lIqa)6&m$=DT@u_7}@&s^leOdg#0U
zR+V!utU$Q&dRdJ13$%Ed*aq)dd?g9YLPd1CjarVoIp;&eW>e5$815+}mAs(%bi6H2
z<*@*19Ur+y9aH+PKGR~7QA3j#r)dyDrw8Ko_!r-nN@11;0@YkRSNYowRRf(XGqS-D
z09LV%NKn&di!<@q8e)5`%X9fk*aQQB_GQ4i>Rpy{*{4)P$`z3zF^V^}R`E?r;slm;
z4ct?go=3eT`?p1swd5sKByAIUZm;Qqy0xs*T)$_{lQm%!*&jtSVNYoN9&uK=yVcNZ
zIPBR79sZ$-DE-(4kL45IqbZPPmngLZv99n8Wc-=<=HjCcERAH)<wwT0#s{EBLgR>l
z-Mm<dQB&U}i}p}CB%7`gyP-a`6McX2L$VS%O{2Pob7<~F6MfOxoA$#J>T_~d+`zOb
zNdWnF$?t|uKZZ};2>CF)5Zt6X2=bNEsFyN$w$!W8RyyL7T*s<BfU&H;jOwH5i$|qr
zB`M(}c!DYs(LPgK^=Vvh#Rz@M`c>^pz<=Xoaz^3X8Dn!}b8t3JQfx}J7N1z^<96Ck
z5clBI?VHj<Rmt9E^3N-Un{F&ka1JCmyM(?pAsZ8Dd9Zc}_5y!0b!dj5s)pk};fm+j
z4E7V?3La2B(Pb`7MI}trvg^icSZKxFBq=<)oSpG*2=AXcUr4Tl4<xw7tB_BNI+*Nj
zT0ET$zTPA3-`%@SW+p<B6R4<4#G@c(!V}r`UyMkwYkP(O)jSmni5kPy2Cw=*nyr<v
z))nrVc@?_o_1AVwg%Lby`5a}5*<Z-`IjUz8US3!Dqx)2dktN5#>NTBNDdp94_MpU-
zGcv6uXX~O@N6Nb?mFo)bk$yl~6!<msbhw$+pl4knzKC6G)bI9bv?7Di)rkPuWPt>E
zp-}5aMQJDedCfIC*`Urlm<v<q-giuP7rrm;^05g$0Zmpn!-d9zxh~Tee&>Km$FB|>
zFF*hiW6RptZj;?v=JffZPb$EJ2tX&d@X%YKx}Q1SnUCa5$&9nwfsU!Fbp?BBQ-C0X
ztQoR;lwLJ($UEwQG_tNr1I42(f~?)8L^63|$jqI|%es3{?YCuj`NBjz<mYLSrrgd6
zfEJ#k0F^fzg!!e2{;I5G(ui81Tf$uZr(T3ybMQ&e#X+IMGZ_LTls2~|+*N1cpSA%&
zo3}q(mIQiT?fRpG@hqw%_iw}?V&dsRS+hoFpZ&j^7t~LG=#**tc!iJ!!y<V@;nT4j
zKJI<ZQ`Yj9(L$u2Sj)UDa-c!T<c0({V`PW;(8sXVR2GgFnY#eP>=BD~g^0*CBHo77
zuhrL;T;@xd8k7|^AGSvoxk0TO@y5Efe}-5ANc83X8ZRxWimb8%@o$MregoiTXe1+%
zp@SReUCqOTnq32fu!z^C%eZ`(I3*wU8M4Y8R!V_6!GM(w$m@(ao3gGjO|N)(0p79t
z<f>yEvM?@eUBS+p{OQKp(+s%5Pt!;IXf!AvPnbRx8if_<qzclHnN+=4&L15Wvh{Y8
z{AE9#<i7s^5~r91daI;X?oi&@d4$sBC1oaAF7a<*CrnJ-oX>n@5{{ori^Xh?PE-T^
z^79*O&|)Df9OR|~pq}Us<<s6aA`o%)?Z7Bl0DwB<jsCO^J(BW0aJv%2qE>H2^X8C~
zJZY@jaz(yepJTX8X|<ziQuTCL^suJx`_(zH=d=)Kdj4rfV6vfuccO=d$&7YMyu^MO
zZI){Dqybx<7rdVlH7*Y{JJPcF@4tBm%k~33qu%iiMBsGq-LtPjwytG{UKkU#R&S?8
zyY%MQMWp;%)eHtp#ev1RFHHYq1^{O504`&#!MJMS)lIolW1d!GA<gp&_!V$Jotq9F
z@MPlf<g~m}@_|$gI8ZQ--9NGtJqPCt!&!ntpq3?^D);Kx<Z5ikAGY5Pppg?jlPzzQ
z9R%=V!62Y&ft(Oae^KG7d|-vQM2&$)njC{7y=>YmtWA^sM!-Gr!VhaxncO%aZ=sqd
zXZW=+ylYoIz^`tUZiyKg{y_UUf=NZwV_5m*yMoM|+$&$3y43~l1&7W%eP;|z@@nPo
zxzpW8N~x|$ZC2M9H5RGOym!x~tT<E$V^t)XNr|NT%mn=!{@0PN70;2bm4Hli5%{4x
zy71}iI<6H~Zz{L;)502{o}K8LPe5^y=dq)~KGomdRkJY<s4489SiU?urFXoVwuZYQ
zdWAvfTzoU~f%ySQvseXg*`~Egf*x{FsC^kO6AH@)ZpXK7fN6LEbbN(*Q=fBO?s2Q*
zv+a-IfqG*eRRdmY(%cE7j7_}Q07M<FTm7$Ss}^P)G820Ck*${RNIY5DF;aGg3)lnR
zPWdG}Ma51vI|r@pz|X9mfF73ltPr$EY9DP%e7m~SS*mPYh66rIhsMSaW_Ex`bHq4r
z`f?AC56X283aYhtpGlj$4MISkD24h*(@~yB|9b&{H+>|gNOJyrPitk9Gyz7l7R?fP
z-m7x(cmT5PO#eCpz%dWn#s@$FE&<0z+iPufRq$K_NfKrwFY>n6QZjteXntR@a2xu=
z`}5#7UeZrewGRg=x0N8-;~EIeBnOpjO5aGB@pA5T0sv1w`W6T<eS~Nc;A=6>n8M?z
zsw-u{b?$yLNyx||+?q6Z2#}wk4cub~`T|_8BpY1@`x|mEh0D!uX9dIC#aN9hjaNXZ
zRI5V~`z(=Iv4;}cXqXO}qR?se9_Z@c@bld%4iPWUu+&Ed1D^z0c#Ch*mGHI|T~s}z
z827H49B9%q(P%5$aqKfL1rKd?gV7c13UL@SicBR{46STiAu7#8VU_@6Jrl?m7aW`I
zpqy@6MDAnxAXqM<XA#Q64^cvd%&#`Kyra4gzEg<#oPNLpdRSeVX!^>n4%d=?W{Hrh
zQrS!LN;y5y{Gm3BPpRiIORJ%#+5>{JMaw~@IN1O6mk~YQbs>ftX=^3jT;HQa$7HQO
zI!`sc?AhCo8qAib5bxcy&!$+Wk7?g+aJxaR$#^$#G-qtV=?A0aYa`w-$XaWacY<hn
zE{8X?a6{Ce(19YaaC2Y>7PVqlpq-HqP3IHCuaR0l1QUj3i9J`N&#s<z11;umXYvP%
zY#Cg(+KJ0$GypdcdkDKi;_yDhhYQ2eOSKsVLs7E_PaFYMBnTEOi>}Lwz;zVf2!Gu&
z@HAIQlYCF~|7)o>tKbV6R~oOMAb+u<rzqQBSz2mAL$VRc@)hbMXy?BXZ^-f{itWCi
zr7w*rmmt*^H5IXu&nSzO0>W~6^TE_u_s?q%kG8a)0kF?_U~>q$k@hQbiUnSFQPcl`
zvaI9pVrK9Zv<Vi_DVO|3Q-RXUHsYORJ8=edoUE5j7aMUf&ynibR=iRQ{|otJTw<H&
z0nDGV@zt-okX)aAZ<`PBWK1$#(TnS8w;0np%$8|j4xFs*uV$VUIvmM>^aY`W<ytw>
zsWMV_YLJ<_uArwhafB_wIXX4H*n{HglGoUP3Yh`lIOKCR`HAJzb%iIgRND4ghv2QM
z1dvFN&{}KiM>RVdKX&s;IcJ7Q&}x7FAy$3Npv1|Qy!J&_MH`n-Kw3lV3SZ|+`IlmM
z^wc~pzBMU1g)TM%TokA?!k}?-6<4;eXTHre15~a*dn0wl1g{+hC!72|c;_;~QGo_E
zOJlDJrO*1^+%AdR9VHccbADIEfjqOL$+x5DjbB4mk%piG6oKmm9mP<>bbbo=$qH4^
z4qak~68h8;ESQty=yio#>k9m}V=cZS#n!E=Q4fAK#t{GDj9dI(-L+VHj>1z<ke6Am
zkv_tkpcl%je@ebu{DPO$YJZgvSIKi>NQn9eSh0riZmx>;X@<H8sinrl@OxbMYLuV@
zv528YobJ-oC(s=m{Z$d(U6cph+vWmmCJw&91#OGAr=51%rjJob><CtdtxmNj#9P_*
z=mt=MJGbmfSNJ?yx>yN45wK_>uR1*9&lU)cp)Tv0+QO)=^i4h<)`&)jt*QssBIDHu
zjiLMzUNOKR5ry~1E<>X?%>q5adxN_l9$c`MyFgQCcXwt}=x=u%Tdu?9i&0}e?D_@B
zhTao@W`QcyVhbWchXO-0Y1ZS-5&6O01tVMk0KJs3`Nq1!ev^~Fe8rDEzamN42-)}?
zbB$SIMu))X_W*>gfpV`d%BZ@yW1;q|z+#g55@d17`5<YcH^z3mQk-IOG)?H?!oP#P
z+wY&v(nvBwK-23A4&WmRTSY&N+EL0!KUypdmiRkUzDVaDFGcpm<>rN=<`xPO)1W$@
zObhddRZ~A9c1}rEPhFA@8_h4P7fi~YzJ`(hU#f3GJ9-C?uTI2qJ{xhTy+NP+?SCr^
zrRgh5*-VZ$!Dq`8aXmio1NsetDPw+J;s2oTfyLu2o59a(lZ-MRs$+QJes;8+oi?nK
zy5uTnKapwS5Cb=Bi>fQbH3HD5E{o=aX*N$#|M2I!MJ!kMv0spzdJUXib@lr?QRJ|{
zrA)ZJa0XWAn1tUa-vz5OREsBq7thQlWqcci#8<pmkH(*)8eMyImnJJAPD^y&cWOrJ
z*p-&1wxtuuU!I_XRUt0eZYrFmXB2r#PGZ6+q&<Fv?wA=b80pb62fQWZzpj9<u^vM|
z>k7S}Wb|j>OzHiX=u?NyHHh$VXm-VT>l<cCf$qr9+#8R+fL};T-0_)?8x7fOlRWXt
z0KMYOT?<Y|!feq*f%Yxy+_AGem(lz?97L^Sb|tK6PF`2IL)BFu|D5WXpl;?heL0R?
zfgXV>YHR)Z<}n@}1&h}`;?Ky|6~JRZ`JSv93O1Odo|V+kEZq};n#dkJN=fwJe5LE<
z+6Z>Q+`Pv?iS9hh?6<KH9KHe+b0~gKZ14?^!NMLs+`qYV=rCdVT?i6L%C%%l;tgo|
zb;-KI)AYbfFXhCE-C5J^LVr{;xQ`WXq9ugXy(xV=M}IIN{@fYi-#b`rp6<9g3>pLX
z399zp6@0`I{pDjl;?|TSxk4%+5$l7X`<*lm`5G1=sa`;mT27v~a7HMtRFtqc&(>mM
z+-vztFGUVz&jS*gaq^XZdepkYi3+_v5!%&^U40irHNt$D>>opCG?JDf2oixa^-JJ^
zXxX{{#8zWJ89#}caq@H?7-I4$A>&eqrdW6^f?OTO?(h1(PuuRSSQc8~1bs2GudIY5
z3;t5TN>m|~WOw-9RVKrGKF<;=gsG-4UCiwZkqFOP6aK}ui@0~@{;KN=-<clh6X)0>
zE)GUnKN_Vp#OgKd4}#noWKnZXr%;JLNRe)J<Yb)3{$@*a)A}#u(Sq?3-Svc(tImzG
z2PP{O4D_i{Apxp@<;u`!@?Npw$i4f80Xg#vT@g!ik|-YH?wf>lJ7I0B@$G5nXP52!
zH5O;K!?0=U9AjzZ5mg-54j;0;&=b|<dw057|4&r18k@WbIwbw}XSeeX?IcNUW}Mmx
z@{HWSGnq2s1p(j)nmS8Ypco?*4$~=f&hiAn!UZeZVGt+EeiX#nV)0+s&7LUe)sY9^
zK=!_DH<b0p!)LR8z%nYXSL6qMoKsHrQTh<j)#M<>b-O9b-v{crUQ%)Oz<)!318W#8
zHg4ee>tgQT{EJN_-N}FB3DQ(qrNq1rR%N~z)jN@qU{*?m-EMI;K%?s+xyBu`J~dl}
zb>Tr=XA}tlEWJc$oyYR=%JiesQ{$g#V@H`^;nu_6uwvo;<xk2}kJOp{?_Z&YXh|!e
zhl<h=<AQ~a98?FhVw*`k#tXNuuz7p0X4kN;tXVfxq7}-VO!Ms>mB{`<aBiW3aFtEB
z1cY*VlXTS|ov3+Exf&W>S6IN~#v?DO_$*;vhEQJ;=ebHU^IPLO0Vx^}(d3D~)#dW}
z=y`$KiPJin4x8@lx~U5|Kzx-7baF#C@TE)*o6rRBLc)y>Ss#2Of-TaSKI!<&_@+_5
zqw46ADq>JZd$kd438!<)5cAEh-bsJf=Yj?lk7!>_EpP=h2z(8Di1OIP<(?wsXRT=L
zc7vUcZzIh#46=N^CM}AAq3x>MYSUIVi}RQBGFPcq&o;zVg?YET+bb6wMFtt+qRqIW
z-i!;6OxNr~wI^BE%HhQCwwnxj^1C1ki4!|*+1wq5q5k!Y1h97?`^fZ0RH6;&i?ZF`
zS2S9@?E#7=L<+ve@E~LrBUhuzQ)13QL5a8)Gf}?j#oY6kbA^5qdk~qP7rfiSev4;6
zP{_R91M1(3@bIa)QhoW~cMYaFnR?H5%mLA551k}e1MwifPNe|;wn@$a!8V>VKyp#d
zpx`(a@?=VhVS!H2M*3t*uo!bO3rLNq$GY_OoEx1gBkZrX>lv5oi<!Z|%%V5g$d;|-
zg3M~_Owx2qT<$Dsbt9!s`(VoZ+B;-}yUhSiZPr{yv(RNAVATIDb@L<6XCgR3Pt2xt
z_5zhPfP(FbpD}fgom7xl7ErY<1DK!|$d=^WE&BRWr$GR__RSetB~_|y8%R6-PMr~w
zM>tFyY@D_|q3aoYtotPIa6$f;TDi~cE)LY6|L;I@jPI?fZq!{tKA~mJ{#=aHbdFc9
z)0vzE5kvnU5FJ~=%I!LeMu=vgG}uQ8=yORK6(lg5N4tm-dX<$}rj|U_(;BJL5|^oT
z)i1gA*`Gcu2yGC+(+93qs3bg=elc9^qE+kHrY}EHve8nZyT(9ho3v7TTzA_)51Otu
zfINXc<MRDumDc9q4u&;xX+|eAcA8n<Wg%TGoJ##93^racW;xVViD7*vSI6by78rob
z9yEUs{R+TW8@qHH+gcWuBsH7-3~-;^W4W9H=SCo;yW?xu(FhV|7PI3xbP!TVcizwU
z$n6JY`3973n4R&aRR?U~g^BruEXj2_h_KEKwbxH#Rux|N#7QjdHC~jwXXJGaLO~Uu
zfgmbx>nwXCWFMrgz3_N^%6zH^b(jXVS_UUfb<FqKor?Md1k}om0J#cFGEgW%+7oh<
zvhUVJ^Y+x}jT+UH7pxu!Sx!cvG9#JSF3{d14~l({>x+Z6mN2x$uhXKb(6diM+oM{x
z(4u83J4uvCZaTwf0Sa|eBP`CSr?%2=mz8@xuB+RHp!7L3rh_!2=qo&Dj&EeM&a_vz
zX;{EzpB3ha!)MZgwTq`lIJ6ldd1fmtkC5Mw@-HQq<0BI_iSo)%{4KGrCP6fNh84))
zHdrcpy)7qX`i1^|Y+xvnXre*7UNuh(<X@z53sqc-mhVUtmqYS)?iKA+ek~y;nh-{V
zi(ZK|ed$dTtyqhQ%S+0`&dqN7#@IWNvA&uCH~A4G6KykZkU%x35#{qM=Dqj%4k+yT
zAGy^pbRz%C0H8^KzE$%wesgq+S6JYVW75g(=M<SKRZ72vxcdCQoRuwxE(u8OBoW>T
zW!g>F8=~2yA*PXC>MhXZd_(tPs~fVG$-r>h!a3H9_|TKg_U9XR-S^CCks)t+zQ7f!
zRr;z^D^4G5+s$BziB4yBWH4R&1L0lYMcnCzgfIM0(v`^9j<dw9exCEaZ<c+XFe}4z
z`($YP)px`#01$F?LA)@zG=)wCoT)&QuyD3se5vUf@~Cy5bDmN12QGYrA}c9GF1w|k
z1Ix-B{u$J?fvNHutz<#9FNF`vI*dK7&9Dl|o&*<AGMAUGw)^a~o1Y%gg<T@8Jr!3!
zKT-~(RufZmTr~?Nn#&p~&sJ0K6)fJmLtHqe^<_rBHf5j!B(~#I@<Biq!(m_=g_f@6
z)5Omp6Ai`GS_CYI<~6uGg@Z1sOTTR{n*GfHy>Ql$Kx~H<{~OauQ=U9h7V>Qw)x(t0
zLGw3DxiXn%W`*wAQ+GBVrN?`}WQyhg;=spN(PZIn=w%*ymEh<gatL;qF=$#GO%N#w
zpnPZ%$fEtxr1{E6eXd$0pHTXpK@+y_x&qTF{50y`?i<docz<UXtv-*q04N=O%6J7E
z?Hie2?~f05yC4kS<qet&6Rue25!{+GZJsiKiS4`~uU}VSqlCv`#pM!}b8muW@kg4_
z5}at(I?z}bAu2Q4e}Jf=q$*W^iZ^LKK8ymr(rRa!_hNRBzTC1-{;d-KNB>W~D8W){
zmq-bmc4U-nXE{OnqHn>FvzM~#L{eG$B}qoA=+zLU$jwi2tC<=yWyp{&om%iukg|RF
z$?&Tdf<u`9lbMHpi)kvtzfT|Fn>=1-1_Q7xYAaKS79R?aekcpYLGqN@VtLAClgDTY
zzSuA#ae0CHYy>;hlJ1e^v92IKxD5qIyV^I!VC&Wu`fZ`svVk<vE*34WHrtR-4xgtS
zn<wu!xO|@xD`2i|$x!UaNl@c#k0x+Wh`n#c%cJi{PAx^HPFC;nbaH{gUDJ|9Ik9E`
zFh#NkDS4%n5pipbTQ(DPAXfS%s{18Meww?fS8<8g_&jSw@9FBXY@!)w_Xy_>SgcuX
z&zZ2ez?59k77&gu3ggw)T$iy7`5EQ$?dH<`ncLyzHVG(3rHCr3-ft0ql!@_$p4VCu
z&{=NAR}-{&D1OVhOldrrS;l<2-1-n6xd3+rtSgWnOVc6Q&YDM7d~f4YB2E|`9}Ktz
zc0BqdY6wQj54t&Mzh&Dh9aVh|?KnQK9&KNAS$IjR=0z9@4IBv>lTUVyMjEwMmc}cs
z<Uo^eQ?*sXbMC)iF3>Znf|y>=cF-NlmXdV{bs~#`p~&nz3`TdR1OZ3#kYR$Fl5g!i
zoKjIlKjO*g5;?{|NBS&6ZaCILNZTuV#giDK<RTXb@+c&}P$CXII&zMx&9ws;UHEK9
zgn-4gLX%sg;Y#}lx%IjwL8mP|XHYUafJ&wTCWVwou*WJqmXb1ZLy&y;r%hijqzRz{
z2sp_$P1D}B`nq*5@%!Aa*DCQ*!k@!Y!_B|EJeSo9pa44b4ZMW=qP^~UDZDFI4TiC&
z%**?|wtz)SQj!tiX+Fn?Re;>Rgz7J~(C9=qn9C=^jVSP0$65`g@fd3z%NGQsS1|W~
z7X!LgZV3P#bo!p0X2GLQ?8Y7YD?;Y<$=>DC1c+@)1|4m!j{7yfW-0wXh&P1v%zLyT
z*)|C7Bf1g%^E7*(p#rCyguz_o3fOR5F^^Zg(t>YPbQY4OM%LYXBl9V1tq|y3GMeoC
z>N5X~xPGE|Jn|6o^0#U*WJI?&O<=CZu5hYV692vPk;;ghOOpn7Sz-itpylaR$@)Hq
zpSX8Up@j|o0X*Q&JdpsJqXi1wou?cbEzD|KyKu6-3an+|zbqA<{T)9KI`)XvdOqIC
z;oVHupexqo`3FdX*C5L-hA|(>P9!mvR*&B8SOr^k>4^+$DX0@KaOLvVhVQVt)s0RS
z1QHVdK@>rv;o$fXkyH;|)D>JuI(4pAB%fx>5Nn%58M9Yb{#m&h1d7<RxL>c;ae6y|
z6cq7?hG4F!{Hyn3Y4#V5iiC;akUf?H-d6FzMz41*+2di)xcLK=FCcv~x=aX@AyEel
z^-Nmxp;uG=lTC+!ulsa=<~;j6U5woU+y;7!vhqV+;p+-&>;!qsr!w(oHBy1;gpGx9
z<cj$NbpaPA-Iq$>>$SWRdF^q^YEbDIma$J2x`g~!ZxxWDd)tcg%J9g#0=cd5pwyp$
zyV6>|M0jp;Hb>h#E+lv!t;q#_V69Gv?t;hHh@HYc_2-5>RgA!%czoO%4902vCydhI
z1?_ZGr#Bsje$*1pDUK;F94Gm?nRyvd3r<!Z2585n26$S!ujjnMB)?%Ycb;w6wHo8)
z{AD4tG;VeZ{pwJcC}=h7NdAt0(*p~$H2ht(nm;J5gaBf%-%VwSJti||ztA7_a@4A<
z?%so+4zYzzM=wC|A9JPMNX<Tcn8`q4mi|je`Io(NoNSYvS-zU)d3syK)56^S#bYti
zOeSaHPBibo!=ZkdgOFY-9Gi<btRy9CEoqT7o?jaQbHnVO8>E<f;fjswq|@=^@Rn60
z*>SH_?8;g9hd=d$({=JKc^)OwN%DQWW2WoDbN{77Cm274V;5o#5zOMnYVmA(@lvmK
zQNmqLVkBJ(PP+E0FDCbsN|y$?l2<Hs(E0ma9tY$E-D~iVS0)Y883XVbfwfqxgQ8yD
zLbf+)`UL&3!0h7b4{p!@HNNND2v5pP>p-oztqt<G&_kC<4g1wpmgH@OT$jJnp?JW(
ziF$8^E=_qk?im;ngcj-{Ko>5-yC4>}zN?A;*C2*^q}`PNX#${KW)mCl;M=~Qs|;i2
z!D%}%+%oMO^dfhZg=p_(%=}(aF4=u(kA(&-4>ra&o$~><oi2}uAwKZBf@~#0UMX87
zH69Q-QTiG8aEuD#1W*Q=0MMaudX!Am(^rZ4a=SYI?E41`5y{NpBcg!9D-PGU$`n!h
zntbv<vj=7(J$TyYTFEZd#)tS|wL9SW)?DiSynwk>ahafYwi8vm${iF7>KlBu*s26A
zxjv0ecS*-3#<t>_kt$IdU!%B)G$k%<Jhd25aTwnAJs_My6dCP_h>vVx_3C;ssslj+
zZo};&gJV~lnmx{<2Okh~oa7|51Az&m=|dq7#<{?$+D)mnx-w)unjM0g$-3DL`D7jv
z3VpwT{VY{P7Ecn;+s}ZU&fbhK*Z7Lj_XBG5&>+#|pV^;zigNvam(`EW`6IvgW^?YF
z%;mmMCkW>>X(pdsJBWg}1BnDpFk-F;1fOUNoK}w7?zntklLg{VaIiFAL~`@F;}%GB
zR=Q%K4JIFSTx)jAI!TOk>gfRX4^v}+;YDXI=NmunHt-&!G=td|$dR6-z>pr;{%gzs
zlA1i_4fbiFoNVBvD~Rvr1oOP?CV4g(bNZB_5NA%=NE7(lKdiy{=-k4O92o2bBJ*;c
z(JSrn#%zLo3M?#7Lp9iU;=@|3L|!eqW-oW<HSu~aGGSqb?uj{8|1vNp4{O-R8b1<7
zU#A36t<J=2Pg7U#KGz1QHiKNMbT43!>-+2SwJ$xWaFHijrV)kDwt%KMYG3OzoGhSF
z2M~LhmnYZuLMHC}ao^4uEBQh|N&plb=&y`gEhJu@bAi8R0v>L-M+(h3aw0v4{5UUj
zwluy4%HUzlNt~`XUSv-xG2WRE^2KsRdpMdkJyyasdu`>tLzeN~Mu^$Qi$LkD#kyLa
zR35t}6k7#aUy!{iNpxM~1n$hci#^wp2LiW0*p)$Z+HYSusD15wI)*qEi?UjNFUez7
zyLl&O5qu`iug^=GY%-iobx#U<sv`AR2!nh0H7viU86?7q1VdZvZ8Dzw-+X26_(3aC
z)7x`5K=P$|LapXaKf+{bo(K2`1($c-R}a+xAvC{_*Sa-9J6b)^R~^I3Q^Rz=crE#u
zq3ULjcO14q_bew4rCmKBcD>$lMcxK-W!A*2N@MIVlt>cb7(p$T4N;wlR?A)j%S0v8
zQOCZBo+z$WTVNLG=j@I8P&GHg|2loE2ux2C5L=y&)VCPm=AS!C|2pandcaDW(oA3~
zr4LMTNbbFr(WjO4+U{fy@|;q9z6+qjid~iZP#t-U#^}^TxA9j%I=&z?58YWxJ02qO
zLXL4B%-%)AMO~Ua%n2W;#%=;sV*<|8k}r3tu}YVgBPuC4FA#xVx-=3yX<l1$GR@3z
z3=H>41%p>a@s+VQy~L#AEJo;k?cA<yIQu0+J%Z4^TZs8;Y)b48Sg}rQfZ6aKLCH!G
z?Pgh#oE7P?g{--$AyeAYnH+7s9Fe;>kl=y`%mVO&-#~hi_FWS$t+b|qlUU^SzH=2l
z+=~E-*o0wcWss3hOU-pzy=QywTsYIvxMCwp-CsE>cM`OU0qJ)`R{_uQ2a|3*xSh$f
z_iBcMMaPnU^+fP_E~`4J(w**!{7Y=|TJOOEr}rN)_G8Z@a_0W6X4154?)yK@I<44{
zf*qjF)khr@W81hNYIt^)%RX}~84$MftP{s0_D-Miv_%G0$IR0!dz?o2pUFa3YavGi
znw^_D%1$|Og8Wg}_>3F2^7Rq+c)p=vLkITgzci#Txt}N>=v(@n6hDioLB|_Y3CBAu
z1faiq0JQGMg%?0`t3lNIlKA}=;61$83Mg7rWRs>jl}U1##J3(XlvfsCQxFbz?DFSM
zLB5nXJZ%WPQKl~^C|9>M*S9!=Ej|?Xnq5jkCzz?Qs(X+Z6I!Fi-^)qT6WrUZNlsEm
zP|DVRxCXcl3w0WlDXBHRqQH(TdFeAJGRE0r^AobqM7E<L!FrV?{%=MXD?fbs8~U_p
z@8M9;+TAN72{OM3F2zInpz7DvzPDg=Lze6zIk8vV1&S%A8^idY=k+%4Cma$Mj5q*O
zFGGt(((hy-aN-t*U+159+K(OqNfHbT!V2D`%1)vV>xX^f{M5+{^_dpjM?z<R{~u?i
zsB4j2rYsV=#LWvXe}Me5Ifv1^XYe7+Y5@$Y3h?KKxQ+*QBgvwSWzgCY>7rN74l<Np
zAF@km6nFWK^&)u=#RHkXdtX!jaodxQTO2_HI5o-7fg3HmM!GIfwR`&W0<$}m4QP}u
zT@5Q5*Kt0c4Lc8_fJ2E1_^=mqhToIGP4;>`Le^TGpw@K#38cG(X3h!y@Rem$$?x2|
z{!CHuMnwy%-pyvX0*RB8erYFxE^k=M1aDUfV}ep0aAgXw7R3K8`=^#I2A`Ra4#s5(
zgvGBbXb}EMHKMFlY_x;I&KHRa5eJr9J%|&{hh4PTKnCMKUnHpwl6-^4LBSmiEViG%
zHcl2w@ewuTk3>*hjg*vxOG;E&F_X<cT1%k%E{IHiSC9A4nz=U{Z!SD5%FKipFND#3
zqe#~stGU%uWRv*@<_q!#xcw14oi@Q8sj&UI2DG$|A}43J`kvA@m$Lx;Ynl=E^j*ZD
zC@|&nRIKRJDTfVyZ!7xA$iNY~=nb!UquAj>cYQ@dn%80Lz0Duc32-QQLtG$)pG|j=
zbEC{b1+b}L_P~|d66UX_(~r_Lp&=d!N=Z4wW;%i+ZN@F&oUAqVY$rHtM^W-&6bQl#
z&cXK6NQl9`Y>-+G@p?^z^PrpZhs&Z@^>D`j=Ry@>GYM)T?V|DB?wkNvk)PTpe)UIn
zsD{);$rF@RlVd<GB_0mLK9XJc&te-qrkkIeSywoGg$EZS*H9AJbahObl6E9x2aC+p
zn;+IfuZ37Hl*q$Wr02G?$NMKxQt~IzSyVa%em@lAG+l&`I+eoVuR1FVPTYZ32G1t6
zl_kJGtSeaSlq$bBOj??C@(g`B1S(@KIgTV>q3u{o{~#<QOu@^oXt07%yFi}u*g5j1
z5$0O+@kK;r$c+NM+VD4FBcn4MXm<v)TyWoncZ4MZt;hxx&&S_Dl_);C)%(6;c;Yf?
z=S&SMRO22%N<f46px0>JRJc1k>n8t8>fS|w&6%M1n+?8?E@P)-LEorvneyvdQ}MQ}
zt56UwWp20iEkZ8749j00E#JKtChy)0ga(>^{O{-kFAQpE8o@?M%-b8Q!8cRh1V{!Q
z4kK3gF#iG>yc{Vy^jj(%27<C%;4_h#^(hUf94YJ&7?S(<(<f-*+n)*3XTD+T1>sX#
zG7bE`%Ja>__wm-mQ&7`qu#$D&Ke}YKL-)uF0;)A~hAzK@2g5wW4n1^obMui;4;~s(
zS_8-1rz^w;Vy36c!pLRrZFQz>1-*#5n!Q^TrQUI;XK$k#BK!-p*SQke0GdEGHq%9z
zQ83V`o@tU$3lwn!h~cI~E=x7tCtX|yo#DkgJ~9NFCX3WQRR3LIHmbW+PxvX}vJ}*D
z+R(v3Z56cxl@;*U=mk>xd2`Vp(Xb=fr<@0(|D{szA36>+fJAV_W%~lV;T&tFN|JrD
zI#-n->d^794r5;`3&Nfl!y_QDO&p)qw$-OxTfGPW&VrU|c)Ag>>k6Nxs9?GX0dNx+
z;CnxD=6&h{=48_^FC)lWq$%i7=pvc#ISt+qf5(#)bB)fwYY@1_@qozHrtfRvt?EO=
z)*56~`!ZAzPn#{0-a3vEATABb{$5&zNj@Q^L8l_qkm1SixB$pOa4G$=`{7iSO?BB*
z&`Fe8&upjgG{Be!^Cyedt><3Lr`L$Ze**v_KXw>wH1n_J=V!7y;Eyzc1+qCCP@Jho
z9jliWd-GKGL%RZ%e)U2SDwj1Zv_{Cw?Z&M{Td=ti8xABmGLxsYUNNWT(}3B_4s;l|
zvvO4vOpVGO)B9c?hVtWz1C`WJ(a3%y-tW<i>OdyYKy<RLe<OF7up^hqak{mKLLTz>
z!67TWVv}Z=-X3D;jh01ys67(Z$q760E`_itt1;cvgM`LmBbv^Vyk{ym$2{aK_|b)H
z>P#SO5CHbLX$DplFv>mnJF_%Mr_j^YhFp_)0xab~wpqfKwUyqF;YP8jd*RK2R_DAF
zpGsD@=O&0y%(x5YedM*xfmi@sP~{)+j4$5aZo?)kR!sub5Exor3cQufBJZiEtZz@$
zE8(qxNd}KE4=Bm3_%)3(LX}ONQMaCLI7PH~8j{Bs<tEnA`t>O(S5bSBt)1{$@qG^J
zh@46&42l$AmsKFdb0uO7->Y8DsNZLQmc~|u{Lc_|BG`*QVSgG5i39QpwWAhP!bIG`
z-G{gk=}@H>zb0%Sxq&c`*unD0NvllF<lDBU?QQE9Em8o8Kt2o&S_<<2nFqe$$RTM$
z-9Vdhb`A(KX2#8lJB%dp7VvO@;2vk7olLi(KeQrzi%fTo3K0{=uW)KLN-xR>n-s}N
z_OJw+hraJyiT(r))E-hXi<a8jS0=Otgcz}>BFLZ9(R{F5<FRMsntknRH+9!d{hF7a
zTNv^C*NE%>zo0ydD<NJcEHGZ?K1Y1mN!(BN56#Z%X`FzL08EAi3FmrNpyyEs#Ti<|
zaU4RebZ=`sTCD6aOn$ad!cr5oj|@aw;th|8`VpjMo<!$M=8Hxfvbu5pt$TLS)e$Gb
z+4{M7DSH&Qwp`;vV5tf%dGG;onKb-Hsno>ix&%5`Hv@mDecPj7v)8U%YM4t<9N2i)
z4ugf!7Ba>`?7Sz{=k9F!2^Bfgj|v5AkSv_*%yrr~D(&H^T_}3XRI2k23w~jsYYPpI
zRzCCrk7+uV<Vtug5Jw$M<uwVQUd!ct=%AZdhXfh);koD#SLEB|y1$qf>V{xE1-yB?
z6xF^sGbtfrwcgyVL7(3DVCq5En1#(;o$zOFb;x2iTD%E-V7FZUjhB>4RluLbSP)LT
z;%9&dx%DzOa-&I9(}@mAn4l#$Tq|pcIN_7T9)Hj@y9XBJMP^gycAMDBnkPAS@u23T
zT#;ZszPdyS!5|ZsOF8oj$W;%V1R2S9UaxMA$ZJWTW991Ik7&u3d-Y{rQFMuH`JXi+
zms9$qGnk_6ih4R$cppRr1RxPf#W~hy8R%6ziv!J~qu?tT>NZk%efD~Hn8Vdf*r3c;
zDcP}Xw?lU;<w`@mGA?nIiuwT2&HM9n2K!%U%6qI2thGS>s9<y%Be&rPgH&d+fHOi0
z;CmMgBYXEajF3RewZPZ@caMM+(=Kqn<w0dPQX*~uW>H*xC?rt(FS3XC-+89ihoq9k
z^CO7iZjO*K)t&pJwR7kl;AsKVE?8X)ZrVL%F|7u%SL`<D`f){Iz|TO}iWtmT1EUfP
z-L)S8tE)H2&Z`6iy`7jiy+jv-lRsRUIleK4t>?BQNO8~qFU=nfCWq-IYGTWhiWk-u
zs4iudg*0Hz1hb#yETk3S89q=!3_qAM_H}UJz_$u`)!G-5rnG?k&E^yN#)&(QktUdy
zxthQfP4*9z&ptit=F|?_ML^wX<jnZ|C+D)zm#dqB>nXbA_)HLJMgjO%eC<0wvSpAC
z!W+6jc1&vxD1i|%c`DEHCK8>-*Lpi`MZf#MSpzw=fgppHc094i<>Hib1_;=7Ig|JH
z^XvBeVD_UOk5kGlo@IRgceVAZzdndBHqM;|o@Vb*?A<)zq|P6rIH^XTeFYqxz?_*C
z?_@&D!YjW_y%fE82#|w4=0%W7(G7>hv}ox*&=U%X(tUm-+-6#%JVP+K_4qOJO(+b+
z?&3gV?LFNq+@kQP*W&p-VA`Hu#f6}fU-YHhX7s~dn(g$ZVBDdQ>^14!iz+#NqWi%9
zTEcKH93d+K-k1M7xw_p6Oyv>ezwbU=kh{RF`s+8N{me$Y6S`2S>n|y`tq563p5MLh
z134l0!TjZ_)N_QRlECNR<~B>sS<ao7#Tc`kTj=qFp?GOo0To%#>i%QH%|1b5W!49c
z+%F>YdNZzoxs(&(w0diud1aTQOhIQ=>vl8`qw_7KIzPm#oIZoSh!*2gA5a$K!DOdm
z4zf6_*Z#mz!LYlCQU8Lns5YfK>0X2$v#gkm;!S3|M9o@8`1O7SL1>><kBfkZB&!+3
zlbsyaN?vwItPx<^<$k_7f#Ii%K$b&Zn-s~u0kXLdbq5+uO66%V7IaN}Y3xmw0qxG8
z_f4-ortPR-EG%n0K+t1Pn|~+=feMGqC2kg|AxnWgqu%LRYcoO&g}UHgpg0z;w%iJY
zA6l%Ms*}#wm7M|$GP+d)s?OvaXz|lMfb?yw{eL8V2Ut_*{=dI#TWcL$#cCapDkusH
zw~C+;lUq>{P=m6!iw#Cbgs@Is;HX5vKp{d(k-d}+0<i)jGqN|45ikS@B$5zL&guWl
z{Xb8iK7DK($a~)NzTfZnvkuxuNJ4CO?zwm*B$J_wdgq1<rzrS)WbwyoXvKJ5aWV=&
z6ZLeS|1Pt_m9nAbXnIZYNEj2DU4Jz~l&CM;`e-~>>%mzQIPW@Qt^Qea=!mbZ3FW{6
z%1;m3c50&c?=kt49fT@~Efay*s2w$&ryN6BGrP$Lba*~Id<gDp(^wN1QH%QR{h{0N
zwW8O$^g{`SqPf}+k2=AZ<Ht=?ZQ3J*oBl-h-$hvtEgP-p^q|}#*NPmamE%LKZ2dw7
zl)pWFP6qDjbKiL<RhealWveT}#QT1Pk7z<(2#gR+2JTPu8k`DDlt@5B!AD)|)X@n(
zs)0(#iB8>um&dXd6HA+p%&HAc)1L#9cqF!n^JXkwgE6O9gzTak$F<~Zk+*u5?RYaE
zd!C01Y7Nx;s*hz+v9I_YDBL#X2SF-5`L=8AeP5b8+8t@kSneRehz_&s<ahZ-oU0aV
z>6<_PO8uIwf91`P#xQD1jBqvYJuY~_8dT9U9*|TY@4NH>@;EYlvHNE@Jiga<QXu=C
zz|KB1Qa9AeC}h<04QH4!Ef&UB^cBvzc@o)238MG-O{frOmzaKe09#N|n}Mq=6a|-F
z<;e6K*Clmjy}KfpGotnJ6{yX_WELJBB8F_?0}H1t#Q@LB)*uo^11~Q8t;dxrs?_lQ
z4qq8A*5!!-!W!uvZRJa&=-0*{^yQD0Rf`XpD2E_j6c}IIxA&}@htrL&q*$!P_<p;P
zxI$x@S~PX#I`qJ!<t3*s-+Cp!#R;NQSDPe$`i(1zr3O((QU}9-)+9$L5Vf?f<4WtR
zZSn)CGIdJIE`%i&C+OjhLBA-X*^&+|(@vdIV@Wu7!Z@p2n0cXb_kQsNPL_7QnO8%@
z8<Wu%6;rNA6ekP%vA1zYjB;88{u4X{ya-%9)?unQ%c0bn10>GWJnO8f>w4|lo=gM%
z#BYWaG77f&DLtacJwR!t{Fy8hWgdvqhq-znyOuFeR+PNz`dVJvO=K@U|G3(79fnDM
zj+#ZN5hpnRtDG~<UhJ57_KRz`&JhluYmTiTU1Z6ASI-~|<i_x6Uc^Xe5Y(pZcS~Ku
zEy%599gHALi1(~r2SqNEys@4AWZllpX0c%5J(u4`6~p_&H5HHuLbIHqHn&mu?zPR6
zrB6l62}53He7PYWxY}?6&C)ap990*;EqSW$*S7mFGDd{98gFvw&g8C*e<}A;Y0r#U
zan7#onT+=63eiB356sbEmk-vX`dwpX6%=hxWkve!U7zuRuF)x-5uO7l1-j2unvqek
zW3DdW8=8(a^lmhUsR?nkdgcZFb4bbJp14!dqYfWS<cD`oq_k6D5&#d|zw&A5tIo-D
z<u2OZ@I9{pSkQ$E&aua%-c*Ms<2R3n#bx4L8{)6m+>tCfdxrFhO~yY89Cb0???UD!
zB#ij0ny@O&^A_$tNRaL3wfwV&<a9%EzQbi4&<lFL19r@qH(kqJdMu_Q3jge3CsIP5
zqo6#Fj(A{-&Cs~img#PCZ>|XT={#{*>T_3Lo^q26yMMWA^cVi}Ml6$DsrHe!`vuN@
zxSgs^*sBcInQ^XX^9U)u)TKDb17FWTODQZ~%zO}M+X+;G5{@?c%|`)|3}5bzV**p^
z5L8K(2ZcZWUn`w#)RIkk(b+Lo`II7eCYKB;M91Ky(#839i|XbhUfYA>7n(E%l|$h%
zUW5<+XU(71x7cb8yNFGD7@*0CucS$xlxE>{>*2I7r61c`B9rn4BnH?Ve%9alU=OK>
zI$4j~Be}4aDa`B8=WK;CHiIqSq#4a7u(FVB$&oZ<1nhN;!ISv_Z4)Q*&iZSdNip%G
zmga<I(#!;(qSF$0lb~?&l5?)UEq@rHh=cmMIseo>GqpKvXc)A4U)#vfW}0*%GZjmy
zgJ2)fSE}?v8ta!YjDOaYYA$`qdHqE?WFd<e6yr%gykek(<~{Q|=o^T7ds~V-$#JeE
z9wM!W2~%#_vk?{YG&F3n_m*^;P~L{7<4|=^J5y?vK>VRkaO*z4uCfA~G{j+kAs62G
zuw!AFdda0kqpkSnzxz)5<ze?m33AWy;4durQa$P0T60wNQYSRt^zMCFJI%ZI6H>wE
zfw^L@Gv(g~_`Gg3lDtL1Md!0;k}?NrPhD-@<66WK6xj@(@TYLc%B!v;<pWnJ?9je5
zH@<&a^m4e>NiD3_|44Fg3j^jpjV77)!~MbGP9;OOylH^26D0~}r|0Nej=qu<ISOw8
zpWU9~<XF8Np3{)|s<X{|Ej+<fufU{7i$Y!VZ08@+kaUGJ;o@<hxf|HDNUGMT%AL2a
zhg<DdSLaW8pBc00*1j8ZWLm~V#$>;ZJu#^sTAnXJo^2t(#;z6Sf6^^1a-^0<8fKUI
zNZ6~*eWfE!6WQBy>Gy_DB*KAbw?y>G^J0y5coK)ZuoWS3)1P0+3$dQHK7E7KL5%@o
z?`@cr!(N1msAzD1Krg;2$ssCs{3n{$N8Y4_jj8hReoPj^Td2LS_iWtEv!GNfo4_>=
zzILWGRu|sqM)FX>t`zq>gqL#>DvERHk-E0@FG>8GmsDumS6+xT67gyHK66Pn#h(AH
z*}=0aj{K>5c`8oSD&S)&)d^NfL+G8UDe)j>)UZlpFeP}d3wu&IhCJ%Mvm;u@9=I%L
zOC&UY(=OyYZj5lsuiw;yO;mdI-ty%&Q3{VrbEna#bP}eKwQuDS?(hQ~5HB+)&21IM
zcgG+ojKpQbaPC{WGh-2{8*ES8R5Vis(ECIgy_15D;l>41<SiLBhG`eUIDvgCEJE|)
z`CFmeF!sPnm#4@N8H*|`-m*WHM37V6M9!X`N2cQUMheuQO`uD2_$@aSN}a!k8zl;8
zmY5%cCGT!8M;nI*fja|%3qM@TfX3l>x9?hZDgPJuZt41hlF&aKT5<B;(W=6^KU}+2
zb`gf<N^f9w2t1y%=VuHMgQ*nYXpDx#+vD#16mpkS_mF%`lnZ4Y#HxkGZn+nmoOqR9
zv%CkdJd%>Frl@sT)fo3Z(seII%SLaKkq~Ry6J2ht6d3-tpt*(PzXc52Ag;3fELHBt
zQmqtpMD>%_9fkMw7p~V1b2*FLQ*%{FfX8pSlsf*sy`6sHaKW9=#49%GryonixZG)_
z3mk>sXox(S-2u#*RWCI0!5qHZwH;nP9U?{c)}k~<b8Z=1sAce6Gj$MhJAG(sOL@MV
zh09vEMs;-i*dIT3=kIZOn-Lyg@~}{r4Hfp=LrGnS!tc8NxI^mFTYBRu3gKe++j5sT
zZ4NP0(qpSK9XbRw-H_wA$8%%mHinbxWXw;3J0<9;-K$hdK~s`E&-&+&;mP@40_lqu
zL(5z#x-Yicp7~qSXkQcB1D*t+bi)Qa%K<Co_vYCYZ!om)Dei(`B=dnGx3a@?-U&jN
z)^lkPf#DMUXk47V*kBj#(flW@X5MkP!BnxPhXA`8yTmr_C;<e>PU>d`=31M-dqKNq
zU=@1O3#)BH?m^J=57PT{{A?V;4k*Lep!?w9+f%8pG@+O9GSU3WP5cEi-1@+^5{9m%
z_CDE*<#E&!Sc%}_#vMoke_;ErIWk>xS^C2p>W+91>9x5{&q(S|O2c^hH^5Q05<;$A
zevSX|9Zhq`KWqBBk9DlZYD7qDOnXkf%g~49f`&3k?*r<nb<}{frUZ*RnaaZAnXJ6C
z{Bx*QDl)R`T`wm(C!J*be=Reov`Av02F61l{50!pp>~GW^H1r17^Jz%Xy5Ytm{zqs
z(MsRB-6}b2W!J%lU^cCv98=QCd20dAQwXSfTb?S7^nKP{G;Z+<;1Xn>9fNYKJL8%+
z?=VNel(rmP>hs6jC{nLLKkJlFZt=-GWVzNSs<UPy6Mpp8uy1XI+~x=|Tk0};d5@L<
zXkT0GZ_-Gg6^EAngnlqJEr>N#(lf}<0*Ef8(#!JT-xZIERe$&FyU=Ii2kQlFQs=V2
zEUzDXFXYpQa!tntTKYy$vAu9sK!^mVMAr5n7!&FX97dH&dBLDs2!N!3qOhLcWdi25
z@^xWpbI5{BDR_aS2r+VkTmj#j+o~ISwmRsV&O!)?-e_&?!%H4}0-<yE66frkN8VbB
zw4F7NKp3;%IP_YjM<Y{#8~YPEh|pp)onc(uT6n)TJ0)G|w^TkkQKs31QWoSiw^J$Z
z!?|pA=E8EJzkBKh<l+2FP{jj#+|#95au(DPxxsjgMxtV?^{^kkY$;>MmU;gN8Mj9d
zzCQnoSKJzh&cka91Wn#Hw!+>fclkd2KE?%W>vy@3{d0#xr+(DjQy=H1FV|lk*Z#2>
z*<y>|#H8F9t^DqNIF~VRtj>GKgh&xGX9^d4lF;7aPwd)jbDMWNMw{hx564D`WH6SK
zv{ybeu1Ba?>+44KUob9+o@-AgYzNh$3-I;;ZAj}oM)l^0&A~t4tI1O#UCmq+zw7CG
ze{HLcgy7!9!CY&st2?GRJ!+`&{1{`}7-s4ImsN7Y84+AIIMiD$FC{z~*bCP*d3g1z
z>rbWdNV$jJOB6Tu$j@!F1P1vk2c($R6w$K15rJ$8)6Q<)%Dlr0VUUE#RU|;OTv@4I
z+p@ceBYK50h1a;Rm&4zyoaP_#Rj`*BGM?*oNALE_aKR7BX`9~^8hNY2Z7-_vw~ws(
z{uxguHYPL`)p%{&Y|q?~lu^Vs{AW#JEM+37;D&jR>deI_xH0+yGqR)mj6y>hg*8vj
zA2+T|aLu73b2Xvc4yw{jBcqtU-jZQ*q8QoT%^57~lZtemZ?buS?Hm@ao87RDHJ=d+
z_xrt!awh)ipEd5{2_RQ;P3JQ&Oi3Rm9-l^kkHHc!hqMm&?1BDG&(Qif+_nmVV)$;i
z{`U1b4sRRy9~QB%IndQDYB6qcj}oMszg1>=Qhha&y>%bOhJArgFP??SRJ@CU9n$`j
zDwjXpdVXS+UY7caAK82A_aYNt4W4m9T-}P(LtLKkCSL{9-p1w*iIrzhMr)k^bTfYa
z-k8+da(FzqVtvFsj9bghP4yUjn9pgJK&5aL$txJ5ESxPVSCZ1x;((;s&OVT!mmrIq
zME_X>SI6uUyLa7^#qZrjz1U&39Q7SBnTt@Q#bM9BI<({n?x1{1sm5ZRf6C2xkPiX_
zC?~eBtsEJa3uGg>36Ue~OynD-IVgCGbH$T9ynrlIEm?UN`Y*~xZ)u+kvDWn|)@Y0z
zJxLx88L3EUu8>!M<SiedEYX@_GXjbSY+J69qPz?lX)0p7=e3Q6$M-3l>}M~m>gG(R
zv$3ua8u_JQUk{0Qpego*j+$Hr*!m4d8Y{obIYIi1=|)*+l9H>!7C*qQA2?XSTrvx1
zDW0MTEMvUCCF|eA9y$p5CFgB8OTSk=!NS&ywI3V$fOg^ZChTkO%0oqmgPd2*Sk{AL
zrcu+Iq2b&m!$mM6ji-gY<daMH7gW|DK~q$K5jyjNk$R-RFFFoL$G}vRZ-8qZE6y=^
zMLF`|*jZUVFEkTnhm*hlpf-3*xfvVxS$&QDpIr=3%>|ESEWx}|T+J!=UJtPML={wI
zSV_ULS&jgAti8F(T}Hs%<Js5)_R7(>&$hzHyHi5lkYg=pkmYqUVSM+#P^ZfiES!9#
z>ju>FXK>7kFu5;N@=m1CK{n^Q`yQ{8KQ8`Ahi5z-lAq_nb1P4JKOsZN^MC-Pu&2Qo
zqu|Cn8JH9=6t1vqf#Mg)UWmu%jua?!BX#>>D@IdIr(d4jkZHl1(1peu=hnJ#sOVED
zWm6tI{TmWFP<>uyF#xu5f#W>;daQ9(JM~y=e>4Lx(#J6Zm36M7jBfEUlneub;Z=QA
z87-=K$}qcoQfGM_JD#k%o2xS&9cYZmWjLSw-n!O0^_ZOeB`Cf&#0Qoe;bjU50vFH0
zn5IqRVetDLp3LXm3)$4x8h<B(lIVUr&JO82Sw^K`|N1MP5-@x`Q`Gu*?-3W{UX`5y
zB5KIUUk(0VJa>P!`+7{Cn3&g4ND5Cc;?JZTg3fcghnn61VCEMeB+|x49aCI}DRRMC
zgO?v@d!?IiwfB6jA-6M$O`N;r>EyEk|Ey8|B8`y90%n6&7cZieXs4qv<26atL!;0o
z##klNbqC3nkV5948MS54@8LZ;u8#L74MMRzl5PjdfCD}qyH`u~Ns6e~s-{rd{w5d(
z8WTLI!Iq!&?{E>QUT{IM)5t6sDFBJZubB)2AdZBEebnT?6PKElBgl0NQVZW}Hz>{%
z0!@j()(Xuf3G?T`Aw?IC82(u5#+XyX9zq;*?2_6K8<vX*t^I6S!?E?=lkZ1eAzHR*
zIl_HFGCS}ugi{N_E3LsPhe}1;j4IWGeOI}XT@<M%p1dHOTlrmI-@<qg55^Sz)(QOw
z;>Yw}`PEU;^2C{5_K`drZ6W@mBNJW-NoV==FOxS3S6`QO2Q^Gl{A484p7N^T{E_|V
z)y~7%1Z{59$DPLMCL0+*QU!aCHwO}?M4{Q$9QHC;s06fjCZ@XQ7|~QeRL8Drlgs>i
z(C|Y`4i848g1xwcR{_V^tZ?h7;K<E0ucKO7qK{x%M66=jE>f9(#qF`i6}T>C)Wl-8
zo#7D}A7JFI_R5;4vtY<cn6gfY;)5rh-1&?zfrrT5Z!w!3X4upL3842-DED3lmVmXV
zTkXy5L$dbg9Fh9!DedKZVOB&m&S(fIH;Up`!XA{7h3dI+%RKZbuc<WYd({anyagUn
z<JO7|r`+1L0?Y3G^f{7T!Gcc&x1>3RdF-gkMi*C%_YvJ%Ib)%pX+Fa#bK}4x%bu@p
z99>GM7J9h|IYHhVK~X9p)~_DzTv`h%xTQQxCC_)^m5ne`>`5j#v1U<`4)H5Pq`)1K
z6%~KW_sLL)z4jPW7*o-qpC-@alcT5UY}rU4PFR>sa+*%Ya%nVQKM8ivgG}dOQH6vK
ze18pIUoQR}sf*6zfCpJeEg~>OcW6?l#D&6ukNNrff2=6pN{{XeISVm$=_XRok^!~Q
z2Xatp;38~=MOnV@D-A4V9=QRWT*^t<%})!qa>wn3eahs)Ysqu?)H2NKfI8n>%P8~=
zX=P~_Tz$id!;Cn1le5YNvg}f&<=r6%Sg`tDZ+9`USj8F%Ky%L(oB5>=)5%w3Px$_`
z<{6o;LeF@UgSZN0j}g6eB4BJMQ<PR&#^Jq%(xp<2y&_O&eUz(Kcwe135jwr!sG#St
zi)97nP+0kZM1&2~rc?d{);I(iZy`ebc9Sxk{X?S{Ul!3Bgkd<H><!pad&LSCW0d$9
zt$|RL>K|TAn}$WTyYD1w)}^eA5rnu%6>N9F-t`xdE>k`&TxYg?GfS&yPO)3p`EW6+
z0xf~C^9?a*VMW~NSQ(lX(XuhtFs*gz%cq3O_6XXe_m@;Bxxa|3lZfn5tCkj*Be>UU
zb<5-D%asV|!xQ7C_s-`iVu)9Kyl%$O-}DauUY`jud)Q0oTin=e(9dh7F5n3Y+B4Ie
z-P#^fRV%7P8^7lS<R($TgSByH><8Crfz@P&0}mHXWrDF=?}3JAhWQ>24Pg14*^sDZ
z`omPAIZad9VX%ks+B{k7^eFTp4Cl({tHBr$sjhTvzUv5hiu=MrT2;s{G`D{~Bv7U!
znigZ9-1495j3)ILzm^!c*joO6^3>m<$F_3Mg>)8|BIBk*<()H=cQ!DRs)?3A{4zJ5
zD_sQJH7}%}n6n_X{MS$8*_xBvPevz8f0&T|W+9&O2ASGxt3Sr`UoZXc^(}<={OA8y
z|IN|0_cvcB@m64zuhY!nXZencA08dIUpn-g3E)vTZFr+OJ9dD>3eQWNoAqfJy=d5m
zja+RET(s;MG55V7_)5Q0dLy>-nX1rGD`Z&S!zq?+dWut%&)n{s8|T>^8P8jDcwBNL
zH-3?>+j1g@%UmkR`6>FpQrAEDCSF)_6l=emU=fnQe+=o?3bi=RXXbp5^C?mnz4YS8
z5(|?bL$?W%eoA^+$aEZivx8Rv3PBm|ejZq;@f-a8cfN!Gv4BCwO0!^zA=P4a?}K<~
zW<&C}*4#(c9d=dlzo}5e<FjXCB1AWA5{Sn8&IKf*iD2&`yE{*4QBTr~n6s#W>0po(
zRZ1<j?mkS+63VTkPsj-#x4Q($tc4o<OFH<U!0&n5hnVKvv+-I%#{Q`Uv?`TPx9W6+
z1jyo>PpSmt2X-+!pp>)c3AJ_&V~IlRQBm77t%Br$A0BiJ*8DFU6FXYhR?f30xaA3L
z{&iw3!_i*;rl&-3xk&-U*2u_<9}*r3cUVG*un_h{rJa4f)fWpLi{IhAJ=+a66LE%R
zt7_HQVpm@7BJO;gaDmk>&dpySWkcB0=X{Z3LSl1yj5Q<7G}j8#$X%w?Q-1`l-}wc+
z`j5gNx<outeu&QfCHB`~nN2t`=uqP<Ch4jMt26p#I?2kg&L7L*P33#)mgJ|q3?_HC
zuGjCiYAvjNyIz+%(z_WlFt6COO=MjVWtzJ}p_cDJCsC4$(w-E+L1HQ=T5l6(I>G|j
z+4z8YTJiEkUOyyLGoTQbwh8N!cP2Z3>Zu-}xl6E>vFgid>MkOvxvH|$Lv6vcIW;g=
zbO)O-vAy)Fbw<@Qw?F)zu>=Vg+iV&)bNOn6$fspmJw%gh()^_<{4mzn<Ya6Avg<@R
zdnj=t<>yim^=2m6^@`Jb|71(J%UXXfsyq8IO0~3%Uz^z-NJ3=Fc#_S~=ZLj$*Iy|1
zyC%&hiaz7t<a9J_yh3lq;fk9yaLd+eInd7rF;6)2(nJ{NfSf!87nDk<<sr5&^AkVn
z1lp1*A2fM2Ku|0e>~7fg>dtm_Ko4G;pMqPq;}@$;_WYt?PT>c82<Wdem>PXHmAx)e
zI$e70ICo2JHUZtjS+G8n;B3Vag>hv1T}PJAJh>>*U}JFE#3P~}-_vuVM$wg1P?Y`4
zru0(cv}G26Me}!78<lIT1K?bP$aoI1gY*?-A+B&8DgXM0q(G_*&m|v=Pd{yeXe_kt
z3FI2iW=kMzRO9(ui^&}6;Jvdo`>{c*=eLG<H3~M;!g7bZT0O$mrE5OFP-?7`NDaU+
z_S-mYWjcS(XTDb0w5OxbD1AiTTCnMT*do>jU9jX})_3JhJ+>d7iKAdF>51G(nvlKb
z-q2;My~XEGLi^7ttzyjfIfr>d3p?!q{i{;Jt+c?>;Nu6OdX9z95W{*9!nFvu2NU&D
z7jj17D%&<{1kL5{{1n$+ZrRA^M=))W@a$ky#CHMbBj4Q{O9+tZ<hhmO>o7hClR0d$
zwVR0%G1a=LYG}fLYCq1C`@@;Ll2ylYXu^{>&Hl(wV_+o%Q^pqI@q>y8VauwRAOJ6T
z4NrGd0DoBhPOUqS$AMvO_`!-#RNa~c1Men{#p*-FEx@L89R7XiCEId=$1L&=LJbhr
zdWjm0b;<W~9UU|h%C8hhhf+m#D6AeYcQCx$;44xk`8kQ4JO&Ms%2~gxi{7E&tu`Od
zUGhhyv~vM_7x2V@RB9A5xLO6?=ZJ_U*-INN@of@SG88&JJ#(t~?qx+y2i%G81Zd?!
zREOzTBp@>8Pkr|?(kGtaRUYhsJCjWRjy}-2WPBFtpiBke1+&7Oiqdc$bK`-j18rYc
zdw0`9dOAoS&)yPI(YKJ<)dVZ}BJ{t>$Bwm_`0$z$-g%$^%2!9!nkSJCsTu!oUFsBd
z;D3PaaBN96TVM8c>Q_I)V%O4!?`h{JDxG55cKNVzdt>k^Lfmc$ci52j^o&(MR%c90
zqzEi$IC#>XyANE<TM6!Tx5dVQ;xJ`|OOdK3W;Sf*WY#k2Xk{A8unAKNTyaTG<009+
zVjRl0a^n(RXv*Qv=7{Ucr~4ORB5D?dGAK1w;<Agym<z1#yp7Q~W%I=!r=%2Z50F6N
z5nI7uYOJdIOgwe3{%kVT;Yp{+p6iuoT~1&SIhbNvjxwg8d*+%B6ndgM<j&RBdqu^s
ze3uK*yzhv4Epqk1g4}mO6qR}{&4{Tn5(NlVc|jHio5<(P^0nXpR1n4~ewzWCg*<Qb
zI!t?^xWWA|qZ_c6&wRE245WO0mSTi8i+TSybTL!NaNkOg4U2;s{2~GQXU*=yD+|s=
zvdfM`c6A!kJl0&`99!H56f2bd7EwewTbV}XM`h4Czq^IzUl$J^dKFDb(LJ;J!vF0Y
zngtJ4d3_w_0t1r!<_k4tPm*4AkpC!(82<(a7`uT@Bo{b`lJ1Fz!?Hm$^}jJdm+9z3
zqv#st*b0DYl6hjT2p~AygxJ~yDqUake`G;2?Q#R22zG9s3fldN4SO8Y8UWfR@q;X~
z=%ok$FmQUncE@@#F=?gv+k0noNW4)xvX2Z@cw{==F?!&uugVsr&sdDS6G-oHZk8wV
z|943DO`Ql&JPm%?2Zp9r9ZDYMA30sO;}M*-(;*Re|Ew;<Z)Qv2%&W8!9VRvN7JfLD
znpu2O_(wtEl2RpJIC&=D>AGbps;k5Q$dc7qcj@rvL`QMaECRcqmkHKyx#pF~Qp$Dp
z_5ZB7@I{)k97?{ON<BQ-Cn`uXbAVcOza66qH8k2ra$?KK{B&?)INq9d6AHsABHNE3
z3vBUr(Hq%nBOZ%UG(u(RfEsPxsnc0^Q%|smp#YPjD%V8%9eUw(8;)J{t96KqJP5M_
zA9xZe?714!`1_yI5Pi`{c6A`K#GbYK4YRO|?K6v-&Blu-&*bqoe9_^z(F4Vo#Njd?
zUW_qhn!BI5Dkyn$Jx{_w{^yGlgsYpIau`tKxxk^5#K#3B6i`B49CQ1oH$>9nr`v&x
zPvB?3drH4SRqf(BikV(@v>}VZDaKs4FNP;jLgOiM^Y&>R;11gAh3HGUkMwhlX?z81
z3ei3>lX~f!=2z`ee+Svy#LF~eFR=}XeL9Nu3L1>jsSaNjMJ_t?M4&lxKIiQ`OfJ<v
zk~dBr9-5WwA-UP5&vwoiXkX5d6Q8k!CwEz#*mUEAz3kCaWs04K*$LkD(~oUt3+GBa
zou{o?sHvE|wEZ?`Ue;TX?E|FwAnMm`;EEE{dy4abrlacUTl_lOa0AHug2cjHnOnqi
zo6(1rgh!Jm>8w^(#K*nha6@(CJ{Yfl-BsI_L)?n&ehXv#0pt5Pq3zEP&%gAN2W_q(
zh1G%Z<N%A>T16+WQ)<G}188cElG$STQvyhiy-nApMrEE*oNI&}C|g^H_p>S2O~e{Q
z8t1ju|5@XwmAk-WTyc0vDGvW@H=`1L1~Zub^x2TchhZujgT7zs>YQgXId?60zb|Dm
z)3$Vg?;&a0R1e%)v4X=!nPcPsss3lpH<Z&US_u;|!^_1^oHymwW(X-Tb`y&ftbGJX
z{da-7o#heV+t)?!@{w$TmK*M>3J36o8qLlM8$ELyx=mAKY&rqPG1lCuQpVgLV^J3)
z&rc210Mmjt(fbZfk@uV{uMIJNxb!04IO*Vxd*0-@Fs?J`b}jI&WTn}7j|sVcTAlNc
zpONogIcVF=+1C#dYvPe=m=2Z~UhbGZurPVMtw_m$!ck&R(LG(r4(qtbif2QoeLpYP
z_W1d*elD$y!$R9IuBb0LqGQ*FWnQBa{ne0{Mcsjq`c-6+p3Ps46K|E?RJQ=`xKHEd
zW4;`jw=~G$Y%X?N$Ztic1JfVoQ*I&)>+&?srRI|)mlMr3h3~>-ehZmbP@`P>_ScQF
zsl-l$LhQbK8l5L#dnM`0r5f|X4#hQT3)&DpDqhc9mi-kmU#Z32FdF=1Y^<~_c6`bN
zpFA{0XK5Z16O<mcxUWZ}Qijjs&zCl}az+ZK8wo!Ygy|Hw1y8cv+u;boo=j-#mdBe8
z4XUbmDL=p#lN`xjF<LprPoW!uFv*1pxdT7nZXbG>_PG66E5ub(D&kXP8E&2zh|R^B
zEf>n4wjFnatj|i}u3h%wJzhgCw(*PPMEkNu8^+U<Z3i`5{d-Q3d!AG!drxcrUm6w7
z=>q0e?ymJ=ytnpce)J-nM90lhW;nA8E>!=@IaM9as(g}8r881ua45;zkG`sT%Bc#n
zA1oF+9v3Es9yRpdm2^s{ExIIcE^MY!C2Fycc_oo+{&$=)sxzF0w>jzb6Z>(m`~ytT
zaYyY<yuWHv4xLzUbe)XtpA6ZHuTw+g%+plz?H~t9C7s|_7_h<d!wuNpHdZ<YJ&!|s
zHZ*w;r8$2W(V7}yRY1;niYRqju?aVbd>G8nB~g2`hY{1QE_&se=7WhfX)R8-7(e<u
z6CfaV2yV^AS+?m+rg=XHWL_7)H8z77@A%Yo1J~uZRxCtlIm?%LTZ7Q8<HDy>K&)!n
zJD7H5Fe)kafmP|PLx1xcXt0iGvC8M8EU)RoSj{C;#kZSI_g2<;)qy0>54v1Zw$8k;
zt^UTJ5X8CL_BFc1b+&~T|I`&7J>vqZ<x^2#`}iBj)Va+e5}6fKLv%~)#^tCsv;-rc
z2CbAc&8xtOosBv{8@941{8vR+)3vrMJx9X&g&}74nSS0bA9S?{2mIj<7m@5EC(H_>
z%{FW9y*8D!;zLrCUG-0T_|SE@zt17Z)_Q+Kp$JkIZ~q6Purv*#%pmna%gj6qQ!Vy^
zk=zB-*_FSefBveo30RZ$HTqU;t+t%OJ=xMg)79h?uS$$VY=afsn5hnA$<yONMJz}~
zvxHkgFzEbn?M0K>mF|#wXWtq_3iA+6XNe}XI4X_WIle(juktB(_yg))*0T>A@wcBv
zTzU2?maP>1=GZbKMAP|$r71Nx$*Cm9@m8Lu<)neqX;6*ny=8BhdA7M(!rL?mX|6g-
z{d8+jXPQrtI+R)=nGcp;{^eUR$h9=NK><MCs4CPJx1Z6)+)Cb0Wsu}NV@*18+-+vN
z>a7(nd|G8y0Vx-ok=9mTx(zd}zXCa0A`5j@o0057?Oe?Xi}U4*o{90wO@ahckBu6P
zyNm;|VdQU_kl9T%kLMX!Tfdp8kLO*_T<mKdKdEH;&?vuRksvK-d#i_VtX@?~NHYAS
zqjmB)`D@fUs9M;kZo!&qBsi;h2DDZ&*P2&B2~U*vB?ph{l*&K8ku&fHTGhk8!B+*L
zwgW#_b9bzWCek)6J~RlMX3lIUjJmMHuL<>PZAM`77BZ(W@rqY<o`f-!FcR*w0r19C
zr>$&vSWul`xBl4X{}y4q5ji`eNbze9;$b}5fM)`tWjU(eqiov63*yDiLwBgOBb;?9
zu$)&_%U*ZRz1ITkKKX;{&pqTW_%OPsBjwTY7mwhqj_(X#aeI^RC}-^xPf#YHpFGF@
z^HrJf7?JH0C#nUH0p{1>kpJAB?#^yo*rxUtT{mK)k3^((E3w?g90=aMmF6wAK~hYJ
z<#Id((%EF_=`b+@`k?eniQGBTNA8?)rwI4JFQO`kRwCPUWS=q>n>4p`E(T2}l7ex}
zrMN0mutkrK42R4-JEnR=Pi%XuV5=*GUm@>uH3y<;+wb@dY~{->qJemz>a3C|P2Qml
z?3^4udwVZG7z5WM@OP={r)g!gvZRCmtO@0V<0CW<YWd-W_NSN^U4Rc-g&NwCg_-CQ
zC{{0Sbh%SGW2u|DHiBz*@k(0|ou!6P;1YbzQeoN`k$3T|=u}?<CX=W~ztOF^LMSnk
zK1fkoEv{%)B(`sk3C@_J;_G<)CY9Um7KWbnAlaS2<0aVh9B|Yo__@#rsFtZOoK2Rd
zBpBRE-*d+w*#-HHeW$3jJP-X%RfA@^&@t_!vlnzjzJ!s-pPopg6!%jy+7zL4VVt9H
zpnn*l#LdOuT!`Zhq$f9&7Nq+sJd0am0lbRsCH?5F`h7)c@=mp?*Ss3wkJzjV#6%N4
zq?TK3ugDFSJiKZfqWwtWkbPEduB^P<hdf<m9XNBLum8W|8l(Cked92WS84ESz6qDS
z{Ov_*!H~;P=1}L(u6a7NNQXyje!zui7Wc4*xTTf2E(>$=TWS1lR=YrDb~1Jyt_yp{
z-^RG)B>$Z2_jA{tOgB~0HCF#Lg^eXUN>UDv{*)0Nd{eI64ked%m^P`6=DT0Y)@WyS
zt$qVlwmL;el&@&Bq5MykKhMJe747{E3LonEG*qRVWZVQD2S3@Ox^t{5_7qoLX*WJT
zMOcdIy_JyHw5eQCTottpbw{st0UO!0#F;04RB!>(aa&@j=^m)~<i;7`6SulRZ);c&
zJvO?;q^8#t{3$anqB15^RG8_0*K}h<15-#ic{<&`s{l;&<?e<bSY!b#NO87S%*#0t
zeww^-ri_MxXzwcp*DgiIehNp7&y>?iJSyR%2rnvd^!PLrKPyBV@DrEGbOJ=jz4SzG
zvpwi)l??1`D_PtL>1uGXoFWP5q~L^Uq85xpQJq0^Fz>`$&@U-u12S~<Ev5qX$2zZ~
z<`#ef6fpOno;IVu8Cy->${rU_!ivN*RX=@Mscf<vtkZe<jNb^gTEKK{6=97B`3p+?
zawiM|)nUecguGgW<vIl4@hDX)YTC%+3>W;fW(<ki+e_olj=VmX@K|;LJ}sL4fuZ=Z
z$zsd=Zu2_s%Os@@ZQd9wznr};A&|wx>2I->uTOQ>JA3f9>c7Vwu-wVYGuUV&U@)sq
z^6Lf8J%ZiBXzpK*c1?jOX}XEPT{jH9O(V*Q!v}4wK6C!BO?ooF;DF>n@!gTJV90LL
zgMW>RrbEOt*BNdpJ6<dxk5o4$^_f+lGui9?xQp_PJk5@gjerhR(*LzGy&{Ra6mipI
z6$_83Em)ielN-H>`a@ccYJvqLgA1zw>0E^A!mH(Q|1cB!1_zU3%02H)ihSy^*s7}`
z#^Q(IsW)REMN8{bAL8eyVZDEYDb%)Lzx^@#4o!PlUDuJ86ZllK=qvdlMAO+`geHb^
zY!Y7wOFb^^ApIP+1=$%~<n3+uij8XbsPOO*Cnr)pbme}ce7vUFA24*nA-iQ$@7%ZS
zSYx?#AE4>Q^syG|@L!otdjK?qA)m`>$1okn`xT;|A2r(h1Yz~pu!GUw1bOUxP;mJS
zwD~D5(7yl}TOR4UK5X3{@o45tXIrB4jUqatID2#E7kU{wpgsUK|Lel@i`<8!TF+#U
zakd{IVPIJQdpFRiD#QpKgUQ7(&Zl+N2fX8_?BJa|IIDV4dNfQ-lI8v)z%8HGDG*}x
zDwCpY3Hhot>Vth{A81bX^VS%+qpzqAgWY!u%7cLT^tD?}uGsCS&X2|5(~6Q<HlJ92
zs1kyMrq4t4xR1lK$pkN;=mc+G13Q*EY-^Neckx(+*i#wDt-lI+W4}nhvrgS=J0$n!
zH!1?!?Cf7r3LS8v>^9ciS>8Fds4{*UIPe^Jq%8&&KHFWicUy`l81vTnr)lX;gYX9i
zn<F1(6JX^yOvbnO6%xmAAtScz`1-H`Ju^ORJez-6{?dPH)iB)#AL^L<SNbvK`lz;k
z7L1A%kCyZpX&LdXAIZI8A~BMee}wdYuy+DHyl@wp(Ci#9Z}`}3^a+n-<o2NsS^Yx9
z@6s(b{61a<oH<;JrXo8+Gvz3C>CyjIiPSRHxX(<cO`1kunB+K|b!)q|`1eNYo2deV
zr=l_Fwd~{t74qL?YPHMUK_p<eBK{Kxk6g+fr)(EE@3@cZfvC!w`nkB6GSY~nJt{XE
zvbXLpu`p3#%R0#P{Q&@2{j=s3(ZIKyi}OV41y63jtW_g<7>()86MeH0*V!sFr{m=5
zHi8VUGmc$(%0ZUpfVZ~13w{2!kpQGYa{<1!vI<fPxrzEbv4zYJbixmM-^N@qQAQu5
zRfYcF1<I$4()vxdML2O{uCv2OlrgxAR&C6UU#F;)Z>5KlP+V-H*_M32!R=A|bL2H!
z+@83nob1U0sl_zP(Cq;Sg^^2%x`S!FVf7<Z=h%O5JcKrpc?EH2s>(Vi&f61~82`I+
z9G6~DJZtnDIm=Ulxf=NXASK<~ZMVf5!<401kW18EVV@kilnL~Ba{XKOn^|M=R&vZ1
z<(Ax|!SiM)LnAE3g@-PE7KfRM3rLOMa)$~cCRS?^T7Q^+uZ!i###;AbUQvagE#kU4
z;I9--W%k|~DX!nUm#0qo=1w0$V;CT`PXb({I*E7lO=B%NS#?LDZkI^$mQyTBp&Y}W
z^mOqnORLXF((Xc_#pZMp^81%lSGYh`dXRFSs;w?o#zU=T(yydVfMJYV1bBaAs7L3C
zJ542=_1;|Mzz1kxWt!wY%K_*vusH4YoCN;(Dh0vDnOgD?y0=q_SFimPkXRL2L!;5@
zm3W5|Z*-~7(FA{vB0*qtE#z)V?_tO3B)}6`3!BZfvHa-{j{dxm;uc0ST-&zRhQb_&
zIy?S_{D9=pg7G8Hbh0W%q($%uD=(frBoE~1m!4YbfV2JJ!FWKR{x}p5S6;?_>?#mh
z<;g}i#!ru0H&i=&=Ijb{wr(qZL&dx!Q~yXa6X)2@dGR?b#TLe1aW+xTiGQ{j+K+b3
zc|EKt6m2apsmQHsu=qpJrCajWUZA_2t3`<}n;pYO=*Kr#xuQSxca7!co~X_l>KaFx
z6XTlymwH1cJa-ZavIHD0#ip|&{8hWZ$C$*6D|N3q`d&v%WX*&h=3tS@T}*_KdsKh$
zah{g-_+cx^wzEYyo7`pX&xZgXFU9i?e(wuG+-z&;Q+qgtoHoWo4ngBqn>(tByIw9e
z<XgmQ6vU1<LaMCWu&vFjUmyE<Q@X%|5F&kY4V)f2L4${>9`-57HA|ScCV?u-IwiUD
zt!KBcUfR>PflKJ|v+hUiBwBxd$=K4uSBftb$d=KbKd?iuo0r({JZNP|O}<uev10){
zhi>(0VCL~*S`E>1W19orIYSaG&nc}L^pSf;y6C-Fgcv97{rDW1eacJyCm;-CvUJ+I
zz|GZ*JYl<P=N-6<Vc&wTOO)ll%eQzrops$o5aGitc29q0Vyy-cRi(;9>+KBnn3PPR
z>uT`fuS@GBj7dxV?WO)FJmJR1=Md$w8LzN>qusNFQ)l-V%5txp*+-h$O9ilme{|1z
zr&LGDm_6RxOYdi$b+XiY5fJhUOjAY)r4rf?#d!#!Gh-pVK%3+>nvUFVKetrv;+iWB
z!hMg5$s;v4hP?=`S*ebK%nO}8+OhWau@p^8QkIwMK5V+pR;GH;RCdrt!y?~oGTNXp
z%lntU9ptB84;!C2Ul#YJQMT!TZtz1fAHtv;SLmZX4s#Yx;WO$9vcTFB>ZQa>V#_BN
zpMqhG-+ps(ZK)eqX0cy0@@xC_dw+S+{t)MAVt;P4f<WW@6kb|TaK50zx`v%_^4GnB
zy>7ZH<Bmrn*wh>%IFmXysq#j;%azq@okb%Y{P#kQ!3#5!ck|uH^-FX0RgVOxq0F`>
z9r6+D>Z*|W)JIwVsDWF2>IAr=ruvQd9cR#MA(yDEpwP2@n}D?|3QqB%yj;wcEKD|M
z$u8GeM7xZJ^)%Qse(Coe5^}{*+Y(2sayMDbSp%M%;2gTA)@A`&$8`u%EmpTi^yfz_
z@f?~(=1JCIMmGPPsLVu*#aY~EKTKxnBD`>RHU2|0SV8CMRt(H%NC?YYgv|=SiKfDN
zy)(7;CeG~+F%qwEJqKoZWwOQ-qIp$&mP~&W43^&ZvuA{V^blP)Rz<Y9a4diBD4+@H
z2bdtw3wdBZ<k0#QEl1f)owZ$?9zHl#_a$3wG<LG)x?QP>s;5gU{*CE)7^Eu}g-7ei
zgV3cn<Im`GzKTC;vD<xs9lfIaK%pip%y>734@cWC{V@2j>&)dtv0k^xy>duNvY)U#
z|0;+&iUfqa&FpG!0rwAgost6;Jw#qC*js}%^yTFiKMs<BH&FZnrm%sW4Z%q+HT;jv
zo(uK)M9#H1?1GpKcPXXH<OXOa)Fa#%3?k-DZ${95XMYh)A;^uM#C>L2GP7$MK$$AI
zf9w_%ZOvyM#_m*xOIG_lj0~l^1}|CT*vPbu4F0lL1uOPvsd$DEUq_f18kun_Uo&LZ
zohJD7swLpG?%iz9w2O!g2?`+aj7>B1JVq_q0##QA8cGh@ADE<9yt!sqc+r4b61f5l
zwiFRnl;fmNk7~p7SR^!arMYo%w?)S75ahwFLYQ(qc22)RgJFl0(3JaYPari`NU3Gu
z6#%2n=gpD@gS`TBE&FY3{t%00D;sR15m03tav6T3c;?M7MDn;{oA$&F-B@+@-$&J%
zJ&4DtrD~lW19yD-7pmyAOXI>hYeW!#`#g^~!0#~(&DS@J3o{`Sc)>2M(XYS(H{|4%
zzA2m7F6^y$;ZZU=o;M&|z|y8T_w=DLi2*u(vNWGy2^~KxcnZq@7Kvu^)U)Fc*t+B|
z;_$})xW@ef=&@V3jM6H)#(MK*g)v0ly9M~&KUS1hcjBTLBKbo!8|KKhTARmve=1P+
z>HJlH!3WXK1JuibevMir(9Wb()&PVLlAOy6Q6(F&P~29|bET8{zw@fg<1i3%=*Dxd
zRnwX3rHGUu^S6HZA=@|a!^adCG%jL371fd6WGNEWqtJyK&$;iDN!Ndm&!%a#@jr;e
zzYf^sf3=Ap>5|2g7gw*i%>6wzU5Z*~z^W{J;a=rhO30PPGJj(`^jB2RtKZ47-`NPf
zHzo&aOR2h+J>>AMbdb5NdZ3r&<&&m%=LS*?E<#ny!dzX7N~;$pIXa2^%Xy~ULF8nq
z!8Lb%Rt?`pdwLmqnH09Dr)gi(Aw3iHaT!8bsnjx^I!H59G8k6@dHqRc%mo!dT*&UW
zXJc+}63GInroSlJc4yHn{@flU?Zl_XevUz)`$!L5AxF8Dj>f}v{eVpZ^f;c@J{-Ki
zgd1z?E{*{BXJ3`hhA&*&o=<}_;A{`QH2pah2t-<K`4+>5Sr#wN^zl7WmK9}`1HtpY
zP(T;QlBM7-8L@}5g*(|Y{dX4f%_kW3!%%?CF&DrYwJVJ6R&`!IX+-ww6W8fLl$2dU
zW@R*~iFh?zh#!S*`Ho++yY9k!vsU3MRa#~SGd?EIb!^>a<{krpjy}{$88BTb81?il
zoY@VW`_ZuH>O;gz5+w$zMEEP7CW&X?&@F#Edt67`Q-uV;O#r$iLe}Fy4-4)HuzdIL
z(l=Gnm8;3C;4{xul4EIDllX@48_%x$_{C3+cue{$XiqviMl_58`V+TTY+JU%va`Hz
zeQNr4GRd(wi#<!1K>P5iv!?J;UxL}<x6$RdVog$;#1uX5QA1=|<<2hl`z-4Gky0n^
zpFj)SHTzay&i0^umIJgw7LB-+{1AvqCK(UGXkc&8aY*F6?m*r*#Wh2%3KfviN#;7=
zT|nRYJ9(_cl_vlwJQrA66-b%5KS{x$nA&HP8+LVBU+VH`eWC5E+sI#{)gD-n%%dov
z-4u;@df?xq5wAsQ4#v~xo{x^~Bd>7c+%egdPgb%?!lgtBp`QB<;@XtoT86s}uZB=)
ze*u9Z4!Zs6Its83CC;3v*4Xx5f*PKL_>o1^To)TJWJ4DyghLG-Jk^RT#1_+(qh?XO
zsZ&<Ve=lSc_m825o>xqG$YAmo@Py&{ZGAnRBx{_#8m2MMcqo%rHIydR?e9%@WAPA?
z+B0d`V`ryvm-YJ}JO`d)Q<>q&1pus}+FO2t+L$lv>pff;a;&a6KiOTn!6{lo7C{v`
z%e!v#hvL7>X5UBePG&Fhu1AQl2k?OI_N5!`x!wCtLeMk$%v(M`DT&{y7RjAVnxbNx
za~;8o!iDRtl!D?HmqdiE#4T7tx}fZhdJ08RRaY!aP%55=)8RTr)VB_vhVh}}^&RpK
z3=^Og0PR2~@B~Az_8Up~>0WO%9PY7{>dvViZIWf&O{CE|ZO22NbN7|O_MMX;@r41|
zRbkTcwx0TUZ{1Keu#|cmZ7`b|eZuRin_s+CnI3V$1%A{y%fYt7fe3KIXc8Ot8DaOH
z<6;feI062)WMugoXoP(6gj~AccPaNJTsS9>STwzkA-<9vsQ7FAP%XE3Sq=ZDfK`WY
zVp&#?ev(s*aV*_L<3WKdnyr3&i1Sh8M6kch=)OdyEKL3q!RPda%LeQ(w`|ngEv4UX
z6#uVfR|QJ#Gu8x{J;4j<YJzmS$asH$16#c~UhR)VW6fKsPxO-n3eGR2K%T8ZM$J_H
z^TA9uK9sq_k!gjRf8vy?j0&Kbp}HDT|HRs|`E^c~n*ZH@$!$~ZeVl>604B+*XqG6n
zF<qEx$czxRK2wwP+!ZDHHRL)N6BdA3EdqO$|B~iz*=vJ4`o5}S&F|Y6Aqw}j*miB{
zN*OyXV(tL^SDyS#h>1&7ueF49L3|u+XxP}ZJo^aLGRbgT-27>_P?KNHxmwQKWwIwW
zyb*!+tI{^q2yrtn`V{sysFIU(UX_B%E$HRqM(HVS!oH#9DP+_{1(03OTdGq64GCu`
zZzSM@`EtNCRojGfza7yYB`>dA?3kVYS^E5O;r@py34~-nKlM?UMGko6j)fU7TH`Zg
zb6;8OCncndxRXKn<s~$zq5?e=-vP={e7w^j({It}B3Q>gIO<4bHv*4#G+8-?)~2O}
zek?h)l0Gf<KM&{OmaQh_&p)P*A=`O_GyhKK43_RbNm6u?SI+wXvt}V?*u{~au)T91
z(sh%k;_ZPSDgT7@Htm6kXCu45%wYe`$&@f@%ZBX2*)fN}SQD~{mtYNm_yiB*OauXA
zW`lR%<zafW*vSsVm|b$~kfnqb!zKbskaX5s*K9UPDJ+@3`^9-}tgrT%OFP`jr(m#G
z^D~x&Qg}N=ooD17s?`L_lPRtKAm?A#HNENJ$zpBNf(i8(y>CBytze7f%(1DTT*{tI
zJs4{`My_XX+G;Cn@TKiJN`_MNf>2fR-r}rhkrvA#lYxTrtS`)H1FxU@v?Yf8OskD(
z;!R6a5&G@VLEbo?u<t^4N`k95s?BdKe;v9ZP=fH&k9|xtTHNJijEYE9nUqd@gJrwZ
z)+vI|F%;C=lB}>xH||O;{u5SckjM}BHXZNXc{2!zlb&kg+yuZ2e+4IcPtcOZrY6+b
z!)4sp?d5JhScLyCPB+=Tx6r|6|9>;QhM+9x_^yInH3K$tz}|HB5hU%Z3Uj8SOEmz2
zZBADF_(|a3$8!E{cSv~QJZ|3^ox0i^rc=G0PlX+Bf8yG50xT3)|Hz2)v^f?!Oiqxv
zkK6aYl{>iIcRXLq(B6&xqa7S47LFwgQ#aJHo-HF*-jBTqrI!udA`6Fz{WF^BRGRhm
zIlJy-N?Oy|X_1d+TK%kFj5WKP-@HTeHS$aE&F6eguVA!A*X#<=82Dqy_8%FmA-970
z)j)xN)&wsVmMFPh#qPJqP33Ea+9Ppjb1`*Cvel*AS_2RKtWb~GMCx`g5BPpg#%I=p
ziwdBNnR{OFN_ta1ok|SA6T1;{XSSTF>u*iddiSYPrH^TI1ju@J9N~<I3^FvfeK(Sl
z&9_3s-Auew%AY`}fg{HuF)`gQ$BJA^gcn|`?NxMNa~}W7RsCj3HsBM{c|#3nn5876
zqxlz-HFZFd__WmXhZOPJrF*OSx&K~SD<3Gs<}OZJ8PYj5_CG4f53)t*baVI5vAx-&
zXZgksI|#i+g<3ty*Dr-y;!Ljhmhct9(phnNpH`mPRJTQ8vvZ~vov?D&GngW?VcLh<
zvtYh)wu0xRIyB7RmjU6tM*>uTu7dc(nH`{aZ1Rqkb3)4ATN)hdJ~?+<P|sx2Yi)(s
z&2}(ncIsBi4)y)^6WKM^!X~hW(3ZbDd{^mL3}~<O);wDk(@0>?7JkmsKCIlDFMEy8
zKv=_${JrK??uHPm5k7eREZ;i6p^#-&U6@bn%5L}Y33lEC#njruvkN2ttYPj_vtfM^
z%dNV;$SB)rkv}&wQ(`i~Y6fB9&za3%R%EhVFkRbU5#>v-Z5@2sl49`)x6hZlu%}j|
z4x@AFv>Jnmu|y`~Jsm#ST=Tjh$NPs=ziTp>l-cgu!>otsWSvoPq_HVObw&%^psvAw
z5r#y_J1((Lh>q7kV!y>k+?MMa$o;)@d}2fp)T><vZHvZ_cl=r|N9X~5GOgbkmZ7<A
zb0~MBFko#wR>}5c@)yjfbB<2TCH4L((T#=kdIB=LH#Fd-oQVnSNoVnEB-Sm%Yisot
zk-gNjWmdI2ecr>mq6+<%CC{GHK$RSoem|b&8wipL^^`!6bTe!@;u0u#m!)A#{84pI
zXud>05#>}mXM7h`OQ~B+aO@4sjq;6Y!g(l-3(hq1PW=Syn^oA<hmcgii0Sr+F0FF?
z%qADBONn*njj=AJCP#I6C@Rz(KkTUJ`P7t8BsU%q!K(CHTW8ZY_0*FEGM5E|`HUOp
zjlc|$^kIeQc$xa+@e2Bmxhn{dP@P>Ozw+}?o<=g9#Hop_8`-CeF<IO)DcJjlS^S`I
zzWR;`Yhy;7(ta<T7hEyMpz<#HitV__9f?&!Z!wQ+?%Ld?;OOv!$zPp(Jf+#vaB-bF
zGEZ8Gqb%@~d)vw%!zM88FJA~~B+RFr1R{>HSQrg1K7sY+j5#EzB@TUz7XjqlL(Gzz
zE;eFq3&aQ)yvf=}ms@;}?O~P$6?2e@T7HeT<zs*xAgsu-dfMv5PHR7XMNu$O09Jc>
z(WaHu2vDc=PMv~DZX+@;48^z9gT&t|;2Qzf9A&w1I$Rn_k&S4P0&)jlKnVB{mIidk
z0C&;B>epqg<r|TddEz!_Te`EO{=Y{|lw>o6Vu!ODK;k>Vo4<$`n4U^KyUD07J_u^j
zJKyt`M|Zigk4!PBMLIf7_~ek#{(Nl@K|yaMC&;8^k!F6Y`JiZIe@~%oZ(tsl>fBn0
zN9AGDu^*<fD9Mq@9Qy}B@mppksjC4_tF++F&wTY4j5JUNze6Re|E3(d!yXRGl18#^
zP70qU)^?!FSK}~{t}Z3!k><+dS!9kwmwjCXd145@gs(=1(t5`Rjd|;nP_Y5&k|O-S
zOLv(EvVCciVFzOk{P*ZYX|5+S(d!9S<h8EW{I|Zl#D|E?P7WP!aPCyB3pfnKi0M6u
zXf*=&zXdLN|D9Q>ZgrWh=Nz1Yy*L4xCDmjkz}tPYgnSEbijPcp{70Y?p1viX2<G9z
zbXvLZ=ONTiSw?b48F(>pMwfmu*Ux<Tho`vC^Ub&k6j~o+8l9A+$4eEPQ7KZ9a?{^x
zlTKYw?C9x52NQ36lsnQFkhW|lWB)&rzB{hzyZhefYg=2ZrS4XRv<gy1pfVLOX+=dq
zjLM!7ku64+7$AI}x=^g7fB^v^rEJ0wA<U4dpphBb5=Lb21QJOINk08up5N=$zi11|
zXWaKa=bn4ceD(l_D<USfmG1pG-ko*#guBlCWdMRRds1#51zSz`>e#Ul(H46Ve{*a)
zNmEe;pJ$+}ta(YM11jtj`;;voJ5f~xE^TQ%E=gd9nVWAfi~nQB_RZ53mHTVg`@fSw
z4;nzGtvjVTI|M1V6#^OYIEeg3A3*LpxBx=Rcxlr4RsTYlvt`@e&%sYC!V>F1>1MoU
z$XWAxZH7aXdcEU`%%W!%*>h9G2cM(LjP|8J{({zuA34873UP&^R3Yro@w+)RBmH%5
zuLm_;bpnoJoe0bIT#gN7sw*BmFK*IialSAk`(qj=XhtW)OjP?HX~%RM7Ms}jgy1^B
zRi_aS=Mx@nBTMW*!ztP$^NlynRo_WT%-Fkac!?yMI!pToJvhtuBOA^6YX>2Bu7Qy&
zkO5d&$^ZdrQzW&o-%f@dJ8(U*A;P?Cy!WWY-B0Qfv1Il^Q#Rmk7Z6Il{QTfXYq{>?
z8X-w{;6~!G^wmtJTjFm3hW_1P4v_WRXl(jxoPSN+k7lVqqbeho>ZX8}0+4YkJ6nMT
zTeU_{--tXW?Z9<pnB$(AlFOp)HNTnAY@AT83UDAS%A6w4-?Zt@_BUhGt}noCV80sV
z`K_)ZfCA%Mdd+mVa$^NITz;IW6>a}|J8=bwgodaXT5f)_a3Uwhmv3c=`{qy~@p}4t
zTj$j`!hQbEUZ(P7g>vtk2z4BfyZ@1dj}61G1TT<hsBc!sKPg7k`;1GTiyO<kdd(<0
zrU(q)<Tu7gS2Fqvjd?rT9*iL;yJ~fJ-}V@^PTc8tjU|TbV;0Ool_4#uJ#;Z`V<6@~
zqZA8fpW!oK78{1qQN$I%%uQf+!JKzh0wQ6Av8&vjn*;MX*rp2n2#Gdiv$Cd2S_(SA
z6qiliu~y08UnOM%3G&HG%zudaj$jL7-P>N>mkkE4rQ@JGU7t!Tp)TaKO4Xyy$5g%@
zylrhQS4-KlgYSW~zQhT&0hL1*1^8rErD(JcsYmqV#P9ZiMumcIBKQQ*UiS1m?$LM6
zS<+NgBR@~bp+i)zH7)1A3ahM;pRf8JY-dF3TzRcJAaQ^EuHy-p@2Mm%qTA;qr2BRc
zzDK7MGksIeQ${1t+??Uh+9G_e4p{kNF<4r@&^cQ<h$=f_!5Nt-Gg;QW>r<P+mrANS
z6=LwhfMISJ;(y^R#@_57u{GLSjj#CUtO(mq6Lq}^$A4oJxN(Tz43uZcPI$RAqP#Po
z<eu@7V%=B79MSa$05CZtssC=+oc!+w52kf%$&on&3VQOoQH;Q3CO^LV-Qg>E8k~>+
z8M3}1B0rfRfn!S`@(tlFQS6F0LqY{H0@feMH)exb^8I4=P*}xj3e+pUoi27eUzwpA
zR;cayL@G=jvBWJasRSOg>!937^RcVq1VRhty#oYo@A=6f?KCeFk<RxD%y#5`1V=xA
zK^`1Ikja4MzY08xXf<O}Q3bUV54+CS@t7Vn-7SvaNDA4ZQV8qF=S-7nKIwrHCuF*c
ztJ82<Jlb~b9crgPjFV1LT8sLz`{mkfL3dOipZ6D3<ColDYL=#{n!FpdHgvqc&!IeA
z;so<1S6_88vL8%WBIC11Z{J{%f>_AfDA-#y#->cTelvkiDMgNuMT_wpE&GG^(M-#>
z3ufB5G4B!?)Dg4mofApuDn2nad(}f#$GE1VQ$2BdRR>rp5`<1lw>LanJ!s!miVOGr
zLXE(W!0TB}Gc7+2t};0(3*|X9j$wbwda7+MUhiH*)9n>Kaf{;8XuIv({%@2eg``KA
zp;+a$;J!2L`wO3mt1A!2Kw|>kdwqO;5Yf6KZu(laM9&O)6)$oiPj*nG2P$Z&f)qY$
zTM9C2`81rsJH7=DZ!!KIMm8p#<Y-*?L$}6G`q8F~_CBDK0{`9c)8I+1X3DfuEK9T}
zuAVQ|9sk&`N2IK7Gpm`Kz7VRP-z?#tSz;wG2kaB%CEzHq(}?>NKI4Ij`+<cY0`mok
zv%eM&@pyy%nHFo!u<WoxA4PWB?5by$X-c);y}jbA-}h!LYvasqg|27#4a)5#z8mDK
zx6_y<&StuX_h}h<vdr@c0(+~QmXI-5W#-QHHyqneapyKYx^bh@fZ0WOAJ3ntgA^Xs
z=n|LECmxoW_b*(ya9fpoe?@4F|JZF|x`1vfQd95rK!E`bAyJ!FeVwi4w~@(=2}HKN
zu0R*%!yU1qzkYj3Vr#~Xc-?XHmZZY3Khazdd8L(AjebQ~2_dhgzuV(+D>KPexyqlm
zC`tqGV<o#)&emT&d?DZL1ee-Y5ar^wbg1^Ry!VU5-ulOmk0*$1Rma4=6O!1*p8RI)
z<-HZTki%S}ZV!2Laz<X>t|NP05PTZrdJ*HfJ>54DeH+qq5TMwoXigFCGNQc_!e8sx
zto)@Ov(*3lD7wO(U6wKGv*CAqYEt2;I#9HO23p-DH0_{SQ9tcsUHI1d<8&fEu67Yi
zI8tYWg*CmcR{KBsxwe8M|B(A7b@mL<Zx@+$rJJ9{{Fb+8kNqBA0QGIJep~60ryKgj
z5HPSf`POS4Y1R_M-Kf9((LhuNw1uY=!zb;_D!U|CT;p8`mAwQ8sj^w4v?c5nxMf&e
znzbZ_+X=u3GD*cpYb8e<Lsj81dA=Ew4ly4-blq7iwG4NY^1%ATLfe1kli{_xJWZj^
zMe&h#W=*k1yn!xfs|_*md^O6T`|k2S>Uccr_vBmq?b#LfgQhO*t@lHF^b7TkM*2!!
z!6GDdL5-j5T+Jv&{CpQTLxOk_PN!_>%tg)~jG_O9zjuLo%9Y2M$PyXB#W!i{gW89D
zbvxUMflD|Sp5e&}znJn%XLg~nYNLu7IQ)wZjRzHlSeGnG(SxY6BkVh~eY6uIpU)96
z!rK$kygn%aS<49B!+OfmvER2G`=O-R-Ip91nb$JNgq{`R!yP^cY^ppaI8dZcvM&q{
zw2x``$S}FTRUADS*`BCt1UEMuTrG<eP^rMu)waN1-*|zrV2i8R?hL2y4UXqj?;!a{
zt#enm9)4yNxs^aUE6ORECu^Hk=eeDk=(jO*4x4?J=!BHp2@L8+lBD)q5{t8M@aFU5
zbO)ZloqA%Y-fdPif8!{)WzM~LA!7ICM%b3=<9)9B-}*WlA_*V2$QfH3%BaCE4$Gud
zrQwG>7r%nSRF}x`s`FzB6&13%jD`{$jG*X{bC>fxe+CYjH<v(fvc1+7zWYnX6TBQr
z#|%M-aeI@c629~saOZT6S_RdH){&06;z8OGoB96@&hw~^E;&FlZ1p1XYv=!5&h1wm
zOh!Y=GOU##{2XvF*lWiW!gac(3H>RMTNaqUM}W-KN%hQh85!KrBd^34#Cl~KQ8Klu
zaVa>T0C`TW9#!sZxqXSHpv4r<+`<IZh}o08b_p?Z;WPVCBOYS8FsUM#F$nv69SYx*
zuhGMPaU;P0sE(WKGRZ1FBeB8yr%U}Sgx$hP@ij6RBUoo3(#NeoKfZPpCCGO<MMjU}
z<<q;yw%Q98r+6qK)gx%^aemzRq@@`Rq-rxOeXDQgTdHq6wu)J3%cqrZrHl&kj}s7?
zw$}FD{v$saV;U0uQ_bqy<xy|NeWkDi$SG&m%&Up|evGjZ{SFPp8e1-CXgkq*F{>zM
zTG}U6|EpPQ1V||Bv0arsC4mFxccQLRi*V)rn-7~smI`G4m%V2)dT0$63=(D{3}6Cu
zh>n*YMkgrd<!k{YCnthIEUWiWb2QZYL15-d7kPfa&hSONa|*7+jH}1EvP7-SCO1sz
zA>BKX5n}NqZbHS!xq7MT*ibZ=4A`Oy^>z~_waWjx0B0=@v<!<<lV8I`)A6|RSV*c1
z8L~l$^0EUkkIU586ly*H5X5;X2#b1BGWkl5PA6PevTQCG2j&B?Bu;i?dtvq=eXtJb
z-ogM&)s|V8=8Wq)x^M-U!});dKNhz(Y;3a39l)(ci_~dIhf?Y9yxMBDj`|P{IuKrn
zj>+Wpl9JqkNoQpdUSiyv5SF|fHtxEZ6hMMFpP<c2kGkQ}voJ9JX731zav(ZgLP~Tf
zO&KR!HC`2hWAeWK{{)SzKfEsT8u)hu!Nc1b<RjJXGP86?e69HP)VlY92FSeQ!nuy!
zhVvP|)5Kx6QW0+zi*7%8N}KOjA;t|_eKJs{@J&3(R9FI9H)hG|nq-z!q!kusxCQ(a
z30X23ExfQP>r~D}_$B^8>y0FX7$_p4-tOHiIrS9ZLCu5+W&6q>zJXI5QM*QeDm3Q@
z3)wGaG8VLv@=}angstI?&DO#40<Vn!ZDTl}PG<RXE7}n0;Wcu}+a6-wkLq|~zEI22
zI?n%~Y!oog;J{?F8$(N^+A|aStm@WwQhF6Ys#o(KC!%R1V70bd^7!Oe)3zX_{7W6d
zO7Ad`7ny|m(EVUK5jk2IZ(8{2ybaDd3BW6*V0T{4BSDTl@vI05R@ADO)Sws}oxf=T
zw<kbXDF^O@<9>+piSp9zAZN;AQpu?r*iVxV_N(;&6yE)&?KL2k2SS5}OgrN)vqufa
z!o(`=g+o<CQil(mEwp!n<$h1%uIYi{U7861tMo|VBI?up3C6XQ&r!#v&5BTqDN^`U
z4@d2Z+0U-0;yUJ|cpois(qYZ8_&WTzGko55Mc)Stbeu`$D{wEmn5Ma!l9UuP7`6N#
zJc8^l0YgiEyW6t!V0nd{5(@g9j*@tj!(C?e_^!e8H5AAZmhcx?zNzlCSat<b@ifJT
zRR?(w_yY}?M(AWq!)fDU+<XNps3UxH+lu?fg_1;)IP+J{(!{xOse>!FE$Hh>58Qxf
zeDD9dD0V5`VriryJYR;p-hCqx{|TO~myYEF!%p8qYk3ExOBBe_q<zv|w5AL@xqK{J
zGJS1PiRtAY=tOtr_GLCBo?paxDTLEZL=Mw%!t21GeRfr~)elTD0yC3_NC9O@ZBW=c
z?T+Ki=5xBy@12`sf{gm%jut*&IdOp0myzxE(d}r+TvbI54cnZc4pf;i?z8T<3)l<&
z@ra~LWw`Gt^4;}CLiEMg`}v{DGyXG>VW^G0Jsvrq@8YX{!8`)ri;F0auAM?vGNFRM
zF_qBolY9~_k^uXc=5>Xg$ddi|X>c#{e-50F<BzI!N6OA(rSC|k`MPf`hylwM<p78<
zh0l~vmDwmMf5_@!$~Kr4n`9RdWEKk&m^d!?6RIXoC~0PI<d3Gp3CCi_G(g#p8AujN
z+%qHikv+~n`*zu`Vk5JWor73kQNR3=8}*3l&N1(Rv@OPjSyT0lY}jFTiM?}u{BB3w
zYn|<<N5JBx%D{<9#~s4!;XtiwPY=Yr90CF8HQLGVpK5HhY+5RNsP=W;vg*6mZ{L54
zjp2xF-@~=xqe@c#pV)6*$rT*{+Q+`42o826k~3Mf<-EI+0_mVE7!-RuAj+9Voyt^S
zn#`=YnPeRVjrV)OLz?_#NRLTD)Ca8Ha_;>HDLWP`<XZ3J6S7|=aG-|E!`u9k|BTkv
zJeX_O?8yVS!6iI!XO8_2=+_^v>#AyBpMVrPvu22*z6p1!$5?I83r0Nt<*ef+CJmW5
zH=cybOHX7xkL5-puejfTwD6Tg`KhPjYNuVe`-Ai4aKK`|zy0$hJ3)8*+H5vC{^9=*
zEW@o%lC?GOsQK>*zbDd^8s`M}99#X4n6|5`oPh|;9;t@(73v3sU5Vz9mO59QB!;nT
zMxa+P!h>@|xLnWq?Ew$NjN)&mh&BS$7d=6+b5$IvWh7LSM4HPBurnzaRB5Bz-*{P6
zKj<??aY>Nf2&Gh|I<<G<r|2@xH;&t6$IR6qSI8fI5ez5AiVI&t##bPm%HSLX@h1BR
zFHKJ<dud9^iYvP9_Vt6ZM4J^#Wr1VGAEFysOZx5AzOI2KP!2F_b<;Z7uWSOvvYQBq
zL0aVdE-pPac111W<A!<%qlcH0T!y0iK3oTu%&b`pDZZdV_SlZK?!#hiJP)mi078V+
z5O<y_bQ!Xgkigw+b)u{+`u8Qe{IW5*>$gP6!b^cg3GBDd$|s5vtR;>GC;hw@>w#&~
z`0>C`+(!yeWrLQ2yFb%+xd9A8B<ap-yK5<kGEzpB_%`A1+xmwbah;L8RHs1zNZEna
zKSp&8Oj`3em=u(sLb#MX^^}{+@vgvL$y6@hFtRo*euPe^*sW~U>ws-u=bR@K=%f&g
zNgl%t87$BCjdgp$;T(!O_y1V98e;R6coGIXeEy~sf_LoOZrZEppy;Ec%ln5p|K%&a
z*{KJWYpqGvc-d|7PwC)THDckOoDz_tIT`!D7FE$uJOU0T)~#y+*RPxEg-CU(^HcUi
z&~@p}p1jcAK$3aO_O)i<YF&*a?0RttoL*wsvo4mm5{`_w*5HApxN{A}2GravQm18w
z(iilSc>w$W>gr^qGIa|yCe#1jklic=o2vc~|8Cf-aQ%*+52HZKDnLcf^7?z|c>f)X
zfU51$g;VCisJm9yDsc?ApnB=(G?Ik87ZPx3SI9X!kxp(FM`bFf`m~YJub2PN=Eh6Q
z+yIOTbQ{GKW!z#V@|pexvl`LEDfa+m3Cld#InptQOIpRCqz30zL~GUcViYN6f~FCD
z!z5$WUt!^JfOY~<sJwk1%^Mf?X)rAV3v9mCl>56+W&I63QO4Ax^`yPFz`caE^ap@7
z=Nq#Ks5?#bp>jz1w7GavZc}#yetbBAhl;1@Ywoe>7-g8OtCC$l-~RUM$*0_eHveZh
zAG*;k_Ut#V!7~Oh)weJ!)S}G~akxDNHu*eMP*zMB&c=7m|K=ZKkMG-}%yQUVp<04h
zjWxVF(u;eL(|@@SjBj0%*L&*1!MBc!W5tcOj`+F~SJR@VYW|*)5?5s2&C5g;JHK5c
zEE$kRslIi3Ya*aC$c#(P)%S%_o`&y;_0**)d9UdsB*LwCHtqYN&M7-RcO)iNoiS~f
zcitMPJi1YYJ!L;5WW+@rVEfBRbse1+SiEi?$*c_7RH4fWKb>Ol5;tS;BT4&WQuIrE
z7<A2^2L}J|UD<Ju4y-FeX%ZEqij6wO&b_o3UP9Z&MdV|t%L7l<vUJCz#h^8gO?Ppq
z!koO>M)7m#UX13gr-T=2FKAiu`de^%4o@4`E&A7ocG@s21nZan-{OLKb|a2dRX5S$
z#4}Tlw2L3wYm^IA73ybt$~Jrds6On6udfx{&=6%8<`hLF!U*rfgE0WW4A+ZnIFPFQ
z4CZ5G|B-*WzC(90DpnjgWoNwIpz_j$;}U6kqAvs$73(eTI$J^-x#|$|Fj~X)A>C-K
zk8v%IZn-BN;M7;Rfx_jFF@iGXV`W_0i0+7^Mb*aLHkkH&#0%*+84(@HXtEoBn99&M
zG9_pUy2q8h_)D!Lb)ZF++;2r{?ZVZl+Dw*R`0nhkx<cytHk#72sLNKUp`3L1cY~`3
z)x`IA4GVRus*%;_7oWDD&h%|{-7R6ytUMCS`;ude$SJ}YQBl71Ynpm%0<Xt-8_AHa
zZW*p7C&7>=w#XgXXxDUEdcNT@;Rv36hPD3GQnzx20Y9)i2~(v-S0LVjL}=7-LkE=n
zmPCh>mF$tE*23%*>7OFS5=Y_h-17XpI1l+R(dU+vW+N>m*AJ_Qo};m4@J2J^#wKy(
zNfHg7pKcT0^1BMdzAQOkKfF<htocyykKWFdH>rgph1Ih8MLpiHx#mOI!A<yqP80st
zk2!3g3TG^yebWDSg`Kst*)t}4SRq7}ww)8sm#3x(!(eiIW%X_}n}e21>mbZ8&r!kD
z2A8WV-6(P7WC->sH1F;q-9V{Yv4hD|LNaQBc9)vJO%W<HAE6`CGT%++eA9wA(Xqw_
z?nr=}4K&o_!>IDge2O)KR!hNw-m09Wo8AD*KU?KmOONh&ovdFO0ou}{tn(e=TgX>6
z8Py|vHeQ$;+P_D5l%^}heWbfg6&f-)88<{ha2^y*>as|<4?bWMPcO5|(BE!Nx=diQ
z*A;H9=jH>g8P)}o7!m#$8de-d)|onNbX^Qua!ujElE*)jb|PBviJlhic;Bu?x^Z3o
zG$WmhUkh?gBNthVhx{F0;-p=OPQ_<n4i}aeMWA66zIJz@yqtqILdGA^Aj)whC%O4Q
zJKvwVPvgrC{?b$$A$rH5Ank0%?r#ihHoOakPcFx_#aqn=jaPuRr69;FT^|1klX}sE
z{3mhf<?jZF_^qN2WROuiL-%CvVZJaG8VpRI1F^|V_}p^A%O@p@OP~itay6H8`1Qaf
zmcHq53c6ujqU?hYFQ-;uo-DGaGrsIb{?8`rix7x(VVK;L|Dfhe%=HMwX}lqvrEw%d
zOBNOiE$jc3qwCQ}{ny0v>>e|3V;*i|pK8Bc1q^K+vc`In&?^Z%c#>41PiVF<YnJ?a
zOk1ImJ!m0jCgS9eRGqs&Hy90|uHViAV;Gr++a_Zl`G|+sh~}uRn2kX+0b$%wLAB>i
z9#qc0N*m$rx0v)3Spb6BC!==xNmRD+Uw)0^$7!vid9@K&dRc>Uv-16wbBemI?$5QQ
ztU1Wi5un~A`#H5zwbTZ+_a*SVl`<=Kj(_qx8UEu$WC^gFU)Y4JM`e=K@U@CvvoU*C
z!wm@P6~B9JL0+RTnPv{U1DN0MgE6QNBtO58ZsGw33Ezu-5*nx}fNv2b=jt%Vm#EJj
zzX=M2Sx&$2x;ikY^K(sDgJ9%LF>aA9)OywAv#BBW%~Jz*Y`66dO1Mhu)FG)%i+Eva
zl94B^d+_c{3d*x|xM4V-ntdAf-T=u>SLCOthGF+CX|$KdOVb+KcEeJ{IfN7(?4f$y
zQG8yI|6BfKi~x58bAX2fEa)woNUW@sZxSh5O^^Qs*NwOWHon<zk8!5W)#VRx<Dd<)
z4^q>%c1h^A7OBgO%=n^?T5?wB!UOAUSUFnJJ=jbEyf!zH=RdL)<uNVdF}R75N9_0U
zRi6Q*Q3BB<gk&bAy@tzAx0?M-{LXw&iUiTINScs=cidI>Uo-i?-F@S-JN+N!^c`cl
z;L#?*cxj3?EOaEqaJHm)5QYG}_V$%hmU54&@Ur4bIkHYw+~+UKPAy5_&`n(p)5Py7
zt+MSqO9}oRVcq#HS7z4SI|_-cx$#!K;K0dSBj2w2PYDNAQl_FoXC$)vxI~LRI*I>$
zI|jBH>l|}$6MjFJWAma}Q#w3v6(id<7t%O%LWvpGT{|TsgbEe2?uP8UK8$Lc{uGRW
zC>k&QhxaxYugqjz|4cM8`Fwa(#@f+b@)-4^c876DD0i<VxK6lVppI%lqmu~=LYL&U
z^G4qvP%r|O*8RD$Z$#0)Nre5=OFu68UE~<IPy-jX3BaLiLPm?sbw!RUd7leE9QSp8
z>h(f7JyiHl<$A=8Zi)i4s<ap9G@ux5zg2VIh12@Oy2J60-Ejv>4U3KX<h-2wKgI}$
zvy)`45?)je)^VWd#|7I}`sLr1lLa@%F3Bh98T!9C_HYtgHwN09QcPY|1B$#2OMmzO
ze(UY-DhpjCg5PG?g_iIWmHG~jJtfi`qAAp%SUc3(@>=?$!><<-qvi9YVh?M|iI|nk
zJ=O2Myk*Ha7WM7r{JO}USp8J=O<L!!&oU-sefo<-b+Q_gG5X$Xpf=I5n$cePIey;D
zT%JzhYdEnwv!6mo=Ll6GvQ{ak^M0G0SfbwVU(1Qd>!Y{XYc28oMqN*lt86=PQfAch
z;L(rXYPa5xBkYDF8H@3``MRlJ_VbeD@p84=fPJ<Jmu<Ai<Xj+mdiur}_(u!(0kK52
zcIx+pK==2=Y@%>M$yZ9KhIv`{#oC@EC>*khQvAJ{>KfyVeB_4w67+`T`Tb7n1Wf^q
zL%;egRxhd5o$A#{I8ZTw4)xM}b4I=ywhuyJlIiRWYrs29@ZS!;B~Fn*gU(s2d);St
zLfHdz+3fyMOsv^}5jh|BdJA;TPDn0^JuKJ54Sdg-WXh&0RzvnVNvnl8k!tAPsZ`Hh
z>54=sv$E|CXN8T)UCk^le`5f){+Sigzklj^L77C3m12B{iX;zWxoSt3lA0(eMLl!f
z%y=?`#HL`sC$qTMsyY`EU{N`RV82RxGb=%~yW7ePmSg`rRab>nG){J2$Qi}moGy#K
z_jmM<%UYx4%qPM6yvFGv7;mj~FdsLiNk3w|dl^msntT~>c&g;;Wv@>>cj7H2M;<PU
zc&8HEoE^C1pn9U_5VZJ?1aiW7mg7+BlB{a?CFwsT>Oxh-Wny(*;#Vlj9q!q)_aDN$
z7pr%;i@T9v-9>hUI-+p*0g)$!9_y+FIs<bnQOjH6KOANAC1LS>(*hg7TFiL->X+oV
zCNa}yDo+Y+`4hj~P8n^TY4k2p?4@RKxSJtf1WsC5u9j>k9esJ0|C$Y<-`~~yht-5z
zpU7gIlUSmxc77X0`8l$wM+0rc`1G1JmsBs@5u+Y}JNW3D!_ztP9q>5A<Oi_pE%+k1
z?l`4>WSYn^MW_jCU$nN@-=Mk+Jqsp^O(RK~YxNXK*AuK`JYRWG$;loNzv3!<=?ddz
z3m$xwLqI#fsAtQgW3HltKqO(lNug4Lc+Y`?RXG{i6A?p93gORPlNt9n`P6v03{BHd
zRhy~UF6}NzoIz&4nX+4(x<m6ypO9UXQ@PPN7)n-)e3WC3|IA7b>!g&!yGeUZ_)mP{
z0$m>aNBnAs^_xfnuj+tONz({-iFq=m0FskC0j(<#R!n)O>${bHS6*%j6yxqUj;V2l
zT>UAq)z59&i;KNHKjEF{aXa`xVjWqn_W*^A1uuFFnN|li#(ZLVX9re$U$dOC9zvYZ
z$B|q;gRg!eDvGHjDgJCm-xTC@vOktqjet$y{xp}Xb>yt_R*NfRrLJ!$EnTYjy6Z2f
zU8GC?Yfju9Xf>i+dp^Ej-fIvnv)fbXGve~GTfi)OEskOM@YX6MSMQrgj?F<biM>iS
zwA>em2tDiFFO0`Yj4jgMbf}ori%NQX*`WqKWmY*c+);b7cpoVM^1*KQ9G$r?V5ap}
zB-cJREdyVP4C8bu9pmRmw9s~@NEzwGBlhnnU>5VmQ=v}w1!};^k$1VjVTggW28Wo}
zi)(-}0u;d{2CY)Rz?*z`T24L5N>TE7)i1<gdjG_Yaag<_S^-2n-PhB_!C_af?-gp;
zOwvNjZU<aFeaXpQ9`yw}X#=uJ#OG|TX_QM<#u2>EBdxs;vi;TLlH<k;&wt1z?V;My
za^0EAMV}F?1PdqmuRk-B%MHIF?1~Z16@WM^t|LtLio@jF!MV%$I&jCuIuZRkc2BbP
z^BJ6v-#>BxZaAlM1-)UD{|xIAF@Quk{zSRjEdaL_^h-%>bE>1^1xrQY5oJ@19rePP
zu1Q^CYR{qgMV;|nKPHdMNz!a})E0IT)_hMF4vua{_$mkT;=3q@aA8AAT~Uci0r%;L
zQe{B#iqE*z{(@zI&E|-0_TO@c?OPu|8!IMXm}@v<ygR3p->s`dH!>}H);iUnb>YA7
zuPGPx&J_{0n)CY0FVGH`Re~>kk$N&sonhN9VlU<r-#ZD7M<@)Ey-KS64IOrad)TY)
z>V8&>KT)^aS<bJIoD>ihyay+}$7)K;inc9fsBm}E^lTLnk~TR1>+qS$>LIX_Lg~sD
z?m(Nl0M{94+>`>sqfQAzCmjiFzob!9>dM)hKSV)N-JiMP47je^`Rz{A;Tfb!adnKi
zjh==ZC<)6CR}OWNTV4a<VI^OQ0dvqs!lea}Uy<*A988>CFsSKPdNqq-rjAVd!~4^T
zmG|)8{<|SvP8&x}nwG!p9|%$a=blW>+x@8XRBC!bpspn13;+zxj+OWGd(iVp1EQ;>
z$b4PX;tMDJ#X<NLYGXjT2Puf5o}_G9JFmL2D8K&yR8IkZmsn_mZ&|6Un<)HS3M7JJ
zIF9i2@m&AiP?&`9i|MARjE$2+&dn^m?D`|{g@}6EvG*RwntT~oJB8(DbfYc~c57Ss
zZ`e!5C6tBwR>F#<2;p9%_k|3#%F`eFu2ZKk%XphA^eb0OujB5(MsGSU!gVj{!TiMI
zHU=^thSxJWDxjTZiq#+3&|X7HiEvk=l@(Y0yFstf6q-&Iofnb^f93g-@ZZar^<|P_
zFaVkwL|WHD*Q>eq2B?p7L0<m2Kh#ANMSG|2dLo!q9codt5jSb!#?uv}!X*`EUreK%
zR^A*AFzBc>n`6)7=kXWh<aWtZh|6RFZz><3DB@x6Tt_4BuTV@;a@kK%cbC^{;g}qJ
zAT#_0ql6*434iD~8PL*Fynl5tI)9mwfMZYK&<E75>{#twC>B<=j5-lt2t_Xx{pzV4
z`NqR(2sf~z<-`}(Mbpq>D-E*Fxbo!D2#zAg{I$iZ&Hd^R*9~C5V9XVhD&3~Kz9qqy
z&~bVODGPe)$SX-1_%`I4gKNfuQ57;HcE2u9-v$@xe3#<V)?Uuq$@X3t2a&tmAn&;F
z)`+%Nn=Ga`a0=n>Q4ae7@bHPle|B}!Ov8<*^4p4nTaoZ!(YiID0GHzE)vbE~xQBiM
z6E%*UE(q&3@Jg{yQQB7m;Ye-BpXpD2d2om%wY8A$KvMRHKg#Ac#15xfj)0$8e&<+i
z9Yx5Ib3a)vFK?>2Z-S_RBO+S}y9V$6THl6WFsP@~UJ|R7ZxF7paw5_3SQfZ@9`E!l
zZM1$-n|$13lzES`sx=kt7TZ0#Ra@<FDLa$}>2{^uMs!~lyXIrFBoAPN1M$8>Cnd&X
zmRSi40<Bh`pKP=ydC3j$9pflv)%|T=^f#N>r=GnB@$>qfJ(!N7ma0Lk_(ey;@_ars
z^D0qpGY!P%atoU{8g+8>@F6C068az9G&DY*?uTfe230X(g{mdb5q{b8LRT67YzAgZ
zub8>bsQiYo(1Y|BM?nN<0*8*d!QZ>P7s~c0S&DwY{s@Lcy)>1kwI$@Rdd5MS8DJwv
z%)c9UuXNo;Mmfu^Tfhl03ACE9T|e!<dDF2`N^F1TL8jcM8zwysxCoCF;Ag)uA8kb{
zV?@^6Pd3zsQT8|FB7-x^p=0o*t@*p|zQrc?7&+&sY$1xF(>$Cm*Ly(8ZFtgHuSp{X
zLx`x!Oc?&FcFDu&0Tv1S?*>JsXg+I+AG=*QAqo9zrF(GIP{C!xA|AuUXP1^}rvjI)
z{*q)=2sI?Feo^gh&_D5*2B$Tn_%yF*wzNHrx6|XwQ17g#f2NU1ne8cF^CfJ+hdb)B
zfP%`vM_rX!l=u4rM;d9yE?N8gqL2sAwJE9fyFxJ<C;ky#8HV-PxBFQi@Bbs#paeP8
z*Z56{BH$$$qJPp?NzPAfF%7N>FKI}nRZd2xTIK>!oyz}upQ)pu?^PvVT9CQxp?%a3
zr)kB{3Ij%B*8V!xnMuu>P%;0lYI>_hxz^yWU(wHh>}2(oeD!kRlJXCYB(ho?<+`nr
zJfLB4^p<jsVG#9yi$&8?nqg><ah~@(vyY0F)}HIZg{PNMp?p@k#=jl?-l)X3fpJxy
zzIvIt_LSWCA>VdHe=DnrAoHu|ds`Z1NGL+PE?3rb2`IU~gE4N^PY+Ib=HgY_{Eu4b
zaP%dc#1aKt*h9%)7AdIg@GFTumt9HO5K!W2yZPH6I=ny0jYnd`eFN0?cdzI+Y`NJC
zx3N|u9Mac{DrRRx>uO@kj;mgLyWgFAS4TbQ!<-{QaPr!a%Uq;+5LJ*9E1!9|0(8Pv
z@U_Rlxe$_&m1Zc<^nwKn#xJUs%jYM8rpj6HAMjLIcwsa(TluWUhDDIC_{>cm?#-4t
z_+!cOurSk*oUrvh(Wpa3ddp!y?aKTUo6Xe;u8kO2Jp&_>cJxgkZNxykdUf0U-$C0=
zJyFUQ7{An{AMSpON?R{2v={ascMr9;PAd0|KS6)gXQmk%en{eM1hb3CzWn^$HkvV*
z8??`-sigbJJ*=iBvGyjh|5cn`V&083WTrqL=Gewp13D+1XiUwQg;;__(ea(ye)&;K
zHN>l|jN^8go!HtO7D&{cki%3%@OlhpWsQ$j@8A0rb0gYrDX1f*b~08;SY9a8=r!1x
zjMLMFs0)OK);aRnKbUE3EzJtu+JjT4aR^!pr=_rw{k=F?UeSx5Sy{`oPK|Pj{!>wZ
z{FPj@BX|w>XI}E?wxm{OHHrgwNZy41n2nAp6|d)qTKu~qA6R<m?v$KT2QgkA)4Cq{
z%?4+>j><}M<PX&{c6}9-;+3xeM&L$6v-x7v@@$WM$Il;D&V|)tESbv5`yB2@_F8Mi
zy2(G(`-6jSNUMct{hatzJbbxVD9zSf^Jc?o0Vb()L_^`ip+U56*f?MDfB!Wo(T>iy
zaQt@zaHa=g-v{G@_H-(e;Y3Gbm~|b5&#@5PICSW9Y078}GkI_^7lxD(7G)T{Ebd0S
zifv+aY`p?kXDz>X_O@aMwXgu=z{Oyq9t7NZXn&gLzHl=~c5pPJQtk=BA3B97^P|PE
z4{;BR>`sJkj*+RvPKv!E>||1yKVL~1QL9Z~m0T~TM}2)Y>1uu}t2#Rcbx)CkIBe=j
zzAiJm!*nS1&>y<I%Fl!7WB@ts<@%oR4R?qg%QUqU%{SBDMZeP;)5~GxSp>RN?`GHM
z%D+4kCZqhyjn_Sr;lOGK1q%qUC=2}0+?6ti`})U59GfpG?+$*3ZJ0dKkw2AL>FS0m
zYenpv+rb8Iw-(+HL`cEmm&o*%e7uS@;CW)MTGz83h<{W!j)A3uUz@Q&!(8>eY(tma
zF)bz_ZN#Oex~?$0u31LsHtmZtcleQ6S3wMSqWRN}fDva}t(^F-$k*IA+%=NiFPKm3
zuIp=m&X}}oQdMgkiJxz$9|OF6>t)F#U2=;RuJ)k~f)h$ykF-=UxFaQxkF)EY{)ibl
z(%U^&#ET|`FoMREllX)BI{p&1pn%t&7iX9IhBM02-9P`b?Q)jOzRhf+C#AtrdoiHB
zp(I?s{qWQA7oq~WAzZqYmbHG3NbesBJ_Xm}s<5q>nmyl!MCqIFX)W*;x>O9x?9-t&
zck0RW@%C^h**_v_2h45j+o~ina&a%dguS8+=mM!{vsk#y+C_q0DW>E?Lg#xoX5Zx(
z;ahFniy|M;ogMe)M*iUDXqJ#Ar>##3&P9Pk!!)VVQo}Z$%=js#-B7V<ftz$N6ECz6
zq|7?_7L|3?9Zr2pJksFAl2b3#XT8|r%r~>oOJnbPvL_(DtuVvzKw*lGVOo0)D>87U
zxb+b@_5~PR2`n@nnzCx^(U7kgB=&AS<?^|pTYC5Mj~b$!!oOL?B!E=0@-uW^)@ef%
z-Kty*b@qb8$p+|RZAq+^;mzLNI&N+<_AR=b^|YOy_4!1X!G!cJH7SM{#t0^PHGE}D
zR;avaA^-f>H#CZL`%0R%eTJ;lR(`S7Pc>}l9)xf)v=?RoFg(t^!qGMl)_?1+_HJW-
z$91=1gdg6%dgtE_AO`to-VV_#9CDGdO&uNfsI+23XGKLmb|P6wbeU_Uqnh=CSgqiU
zCpdz)OApf1qVdK;SehAHce9$c%Ol(G^_qCRP|oaXpKJ)J<E(LRDJQ6idtdYbmRO5<
zPi?!MZ6{(8R#hWB{W9!iTkt#hIo03MC*M)q=k^f1O?y$~6Me0Tb)5)V1~V-!umDG=
zqzHlI?eB!R=8zs~OYpGG(ac*}6MTdPJE#sFeeYZ&ZdKJV&?(M8W3R6!;QEl5;=x&j
zmq?6Iwjr-wqJGOipKjf)_$VD5;>nOj6n>pKeR-zB8Y8q_U=h}x2<*_-L*=CM%f}Z>
z*6oymNs@&7SRxeyvzp9v6O@UMl*`xm>@EzHCoA~?#hKzGm1~B*)oTUUDDrsP+}uQr
zb{Y>~p+}}qd<2_YlXSTcS82nB3blZ=;?a)(o|u2)FxNOyCq76J=3@D8tB=J@X{}Dc
z4tcczh;3F^adS+f@SNgt?Ee%|DH@@B)Kt5}>DA((iSn9~!tUb%b|(Bqn;Wj=WpeU-
zEBXaZng|fDQdTdhba%i=x+36j%|D}@s_CAHN_TyvVAnSM&pwE@=I`QiwxNhOxWEq#
zOGLg}8yrYjJkg3q@N#6fmnp62H%V<`uv_S=PC!rldC}1N7`Q^$is{IsNa{nGXW|!d
z%tkUap9oj*4WXJs>>89OWd@$*uJ19_uKn(P@#lec(plV5{7(CyngKnRcXHfhoP)-5
z#}o@ha1bvUsVvdWi&X|qmht6}SXR>oAR8~KCDU|iIQd^BWNlxs68jo=3)*kssaPu)
zI-E5U*Uf{fD_Y~N2D=twdMnz+>aZc>eY2-fzo+q4S7)|$AvP=?FWu1w4f11ns*`a7
zhZ`x`n$42f_^**aw%3*D^u6)xhJV8X-;qA--EU5JEurt(BzbkZ{1MpiDo%uk-%fHj
z$0$@#=RVvY%v2)oL)VEBoGj>NeR@<*93KVO*!PGeqAY=PHGk>g%u;3hyr~K!X40|s
z94gNZ%fv8hTQur9kP2NKZ!#J7?}lxIA1z<bc3IOPTFXRehS^;{Hi)b64~B0xXekxk
ziV<1Ko;%NbN)1ZT_UwRfHQrc|3oX%qU?#$Kr#(<?BaICh2PBawnp}7&T1^q@+`k(d
z+4rhq_EZnt$h_7CuE6QiL`#o^EGJjLKBDp?@Ol+!<Vlim`T6z_%zZ)I9&`+w)dwOO
z^O5|sXitXm0SjNE)EIslUNS3jV9y}_HA)`xe+U<XxGX++pd-dq+$UIrttcQ=P8_J{
znySli=x-g+9EzO(3?x)zo@>rA^+bEx)|tb(L#C~m)KGW(hS;a;zcGOK{6vS#v%5$5
zzbnT~E!@9K4Vo^Ui%IorxMiH`^4IL+jYzq&MVNnD9Q;G+JtLEAzwc#eYa{h%m>z*}
z^txQ49Cgf&&EEL7#66yYABwBQ;u|gv#w<n{59e!Cc;MPa+ELF!+n+z)4I8QW<l-{n
zo+;&|+3E7Pi~vqE?B^c2X|_iFTA-b38_*dr_tT(*hD~KVw!bA}7$iDa<Yw}(P0_u(
zn(T8$XH*?B2c`9N`oOd9!a}QWy(Sesd1mCfm!0djC}gjN_F94E;8dQ>TAiSMlvcNE
zOM=}~JCRw1{d-p=X*JOD-LjqF6oqPktAGEeuv6Fmv-@isAB3aiv`YgN<+8sPT<-XV
zN@G^M7GxbQ-gvD=!mX0QMQu?h@y3U)=D_rO;bJX}Z>w<c1@9EuEKJJtMJ%g`r(Ld#
zE;A=cZSNa*7nF>NrUDvv(a+9bgqyD0R&VU6Y6Y}u$3wgRr)3(|yYLGhw)Trp!ilwh
zfygmzfOz`+%zf+q^8=@R2G^sD_myonKh9%aLl(397Si;{*<`bi(6RNpvF)c#SPVt}
z0fWHD8nQeRZZJn~&{5Bvo4ujE4<+@5qt7yZ=HBIgXI_=5l^(iXG^ki8B@!6zTv>d*
zR{iclQ9}qzy>qG#zk-cWe8=Q{=HkD(IL7=vPorOH0L6is{VvUgbVGhH{v2wPuGPml
zm&d3f_jR33ggly2h36>0S~(eSoLEE7nvK$*D2qq;zy?d2Un0(QwHu9eeD7iQqN*>Z
z(`V!=PO%)R{BE`I6Qz1qe3oA?!^N|9DRa#>8Bs|FEt$ShQOURnf`8-jcG98f7}8zo
z32s`r<+UaDBefqd<I&^P?+UlODBud#CJF3Dj`!dg22!Xj?!HcI(R^N-Yoj7q$(3rY
z#KkD}MQfRp7cO@cmYgifU`#I$uoFO<ga1S~F=Kl#L$CV&T4`jXU6h<sVU3oGRDK5C
zO?t2LJIBYTDeZDes7wW&bUdiV3st?}UPjGtgnqL1gd)y|0-?qAT**OblA=$#iP)73
zQ}>Zc(HCLGW#2nNclWiDGXO+?8VO+2Vn2qn(JE8Oie&$>@+|uOs5m=82Ui334F3^i
z+A7llZOrkdyF?N9gy`$S*?RUZk%@_8Cwt4vbZw3G`%GNr0E>f{Xo*=GZ=w=?sO+fI
zl7t;^3(iAhUbpWybKvJ&r9?ax=3VURe;h4GW!V1QcTd)}r=sVV#6Jilzu=L}2EzBC
zQ)}}<W8!QZM*ASbX%BaaCd~NFyJd2p%i3->Ya<QkMeKS<b+zku?-v8Bo}W<pF3WYH
zl3(FKp|0eXG-Mq@2K?c%u7sUm{RIa011BLh#3|Hy?f(5RJ(u3V$0|lOfp!KGUyWc-
zd+h6}W_OLrSSdoXM=Fq6+N>MRMa9Qcc_)3{0lH52g&hL<oh)XUZC+@I6UiQvurBJ3
z1b5><B`R*=6$b;tw(vDu=<qPaq)QwNA&V!c>`?B7(6WKFy6DXF;q-h|^0Ii06c}aA
z5FvMJujpIj8R$yTz+304V5}C{Iv?%#Oobk`v%9X>+SH}1BJQrq)AkJ0T)#n70{(2u
z-hf$zRkG!XtueTy!IFD1S?$Ph#jHm%X82gohdZ#(ZT~l93HekR=52e6mm9*uKw)-V
z?cBvFgToe{Z;b*s_lj7RmVxeeOIJc8k{Of&mwwk^&#AtkcPVa+U-eIP7+-u*eDYL(
z3*Wt}(9^B7b`N!5e>y>DLX)>YrdF4#8f-GbZjc3*0DDPwGk&O{oNgtU#x-Wx&Ha#e
z|KANywKj|GMb(S>x1n)sDJ5R)3#5N}PnwWliOaJ3<sWv}!697QD!^^*h?_%DL$7mn
zGW%YDE!K>!&I)o!X~4Cwb*m?qU-J8qUjQjqwsd1mUlGnlkk9y&W2>H=swpT;*^UaT
z3{;Hg?F6{o?ba8YwZm-xi2Ms@)!L&WqC0?t`=es(Nyiw>*e-peF@Pf4Mxyza#6mas
z7!fO0<$Pok5@2@OzLo5YiL9M}T=W1qQY`^0YOo5s61dP&zvw|!8Wbq_kyDF|wA!E|
zB(h5KW$0eMe}Rq;n@P1^L<u8#Lvw%eI1Ox)yTQ!2yzL$&961`;D}HhP<1#^6s$KY2
zlDE8<LMmqFPeRDc_mT%x!Ap>21ym2NqnzGDabtPt$n6|?!uyrpg^s%K(U6H-Y$hKJ
z$cbR4Y@{pbqN%RAV^VR;YX~)HXF8k2s{3`i*E<aPD<5?KRi|jL*#i3vbN2^Mod^C0
zI8%c?A<2$M)K$ji7r2xSpo9kZ9;JAuuv<Ue##`Gf&EHl@7%J5p)2(ivCc@-%Rm-|5
zGrT7TpQI@~lFJp88WEw%3_~X)Ya*ln>k|kBC6_QPLtZ-sE#S&47o}<*^0<n8cXH8q
zvnZw~-MAjY7nB+aYEID<+BJW6TVkCu|D%D#2jZ62uy2tRA(QLkAQ^EKT!lh+fC!yn
z@~v5yOM~X&V%dnVT+O4!H+_;=#fKOOv+e_z4uA2JZI6KUnyA*3BwV<UlSJk#;Z^cd
z_A8>B#sAp#Z&%hk@#VE<Y&O7;<(8PNqK13O%<QHN<=O^L4WpLvB&cLG(NbN;pD22x
z73DswnQ|34Y+vONZApdg2!kKP_a(!7{d6+%8J*KsS;2p^D#`^%rx`#EVE7!32;1WU
zyBLo#Fa70XV#Ct_9{y)P^eLQ59N)u8*xrZ9#C=L#A6W)~rg)oCO0eWv(jp%Rp@+TQ
z6KOx>Sg_Y)BV&T7)hG37iC)mC{HW1WIOY0IjF6ACPd)K1M%Ubr@X<6g-N|NK{|HHh
zqv_(p1VzcAr|fm>65eLY?LY^*PB(&><f+$^!{eP%(z$Ip2pP*;i9ET<=JCX%i6^*0
zM9=Dh`{g&fD-{+8;pExT21_%(q2*Ez22enKA|=`zOf@a{G;g;!fK)pKji(*P5?|)a
zA35E@e|j9lm2}l%RAl_7zmRe^Ikd+p58|Jz6PrajNua8dL75UV$bTj^8!yWYT`w-5
z@(&?lZJu!Ce$an6*&i$OaJLkxL-Y6|eZHemm`TMtW!$^WEJs(+7TW90xK!{VyNz}A
zV<9>KSU$UxdTEl%OW9=!d)Mi77fW|s?B~FC+l&8hz}G?~dmIi0`xs`iJ?^ID*YK0#
zUTwwg<YUTs>(+hyh%!km^p$X6IpRN&b)A-jrdq$g)_om2ouNkxfuC<EwH_UE!QB^_
zO+7e)5ge=sT@FOIOfIoN<+OV+f573~cKk|;uAB`9#AS~;b`rujD^7%{al`1Jm+s=1
zhFea)u_Pm!((X19z|2SqZR3pbv2zba7Vu%qVP{M$W61+1PbS0^6AP&THs>OJV<*p*
zMpGfn5QT0tGklp*bRkqq3H|Q6|1HeGtyu$>Tatz7H=y4A4wKbn9_Jw0HzJZ^-qrVR
zRBg1&SPr*nIwO2{<o3X0Z)i+wA`31n4x_w(HPWpqbKeqM(#{!#0?B}k<?R18$n&M0
z2EKKfK2!x;y1m4I&1GL0kEXe#5j0ze8@LtS6Qv)Y8={J{6tVB3@{)QReN1Gr^T+E!
zy&)sr?WVkj{U<jzm&F}qFu3iP%@&pY^m1PQz(`)aLEK0K#!C^Ke!2GOZd}b!&qodC
zYjo4hS^p)MgSb|Y*b3A<7JSWgC_(Zk?ecf@<^5PmzEjcSMY?q;k%?4zRH;GKRbjiH
z_3@&%y9<27-LcYrMV{YnYWKJgUKq_M<}8Bb{Is0vl=ghiE*s*maN9hu6I2!#l4!d#
zJ|bIP3Znbts`Mpyu>@hS|26KiT|cd%2rP`9Brq^>?lCzWPxCfs(~|Rky_y9#sNSi^
z=)e8*&d`0Z`E=v$IkW=}zdfoJDB9f^-#y&LtogLF^&%S4?y$T4Z(5Yy6O~jW;b?Jt
z!`}lz1Djf{efWOv#SE`WbW+U`vI)8ep2<&@G-2(w!YjfVE)*QF4EP%9OsMK5yPc3F
z{1{#&Jy!Ot#JXV9_8S3Vu{TRyXzzpYwHKnEJXMEr&3_6#_{5Q%JDmqj10N5xJ|E<r
zE-|aO7%rIWp)Cu`3zvDhx;~DThhYxeSX=a@2jf@r_~8qqK60DK<$mn|U;Die+}mTR
zPSPsY)#%>tA#-^hr$;-G({%BqnYLF4)8blkMV-~lbBSc`2$<zRCKz#jA#K%W`MAXp
z?X7gA2EW^hbP1jiFmSS!a&sGd%v?EX1YYs53ux$Amy~(18C>ViX`N)X$Ti;?VP>Eh
znk-?SsO@pT+A+CDxPVSZc-K(83C}osjdCYUGGV7S@*<prNai1O3MM{8du}#XkVeSd
zRn;hD(fLzsC-D%O#!>7NzhxDO1{aW(WFdj&ZKy2yE_6x3qr7|@k`5W%<bAGT1euR~
z-s^12;wdq4C;{FR{!Z=>XTTlEGlVVbQprpoJ%M!NJ|?KuVPCgOxW6wA6)IB##m#Kr
z1XfnhRk=gFJo>$&wJbAhiFw&3SHTwvW@a6AG+<zT8vXX(fQSDKchy^4#m@EX^$BVU
z?h_&(Yaqfj=Fd_2nU_dGZH>$b2bOz{LDI%z4|7FGG%PcmBt{=xe*CuhkWdy85mshw
z)JiVdxY>~PT1sqe@LF`)347)2W_RKrlkj&C0a2#)hV?`AS#fkqwLAqA)6n`_G{z?`
z_m9>le-)Om&uR0M$J$GXMkCh(K6VP&V;<B;SE2`R4NK=8EouoB3jxcs^1raQyM({7
zr(~DypUqV|u<OCg1s%rng`JBk2Xe8Ok#rvAfB$6cw@=Nm@+9tFt5q$N?^I&@Dzjgp
zi@u9nl&L9_&3DG$)SdfWcP-65*bXcL^Fl8B_3n`vLdn4_^o02F7r;n2r~T*i<G7b7
zAvyI>iu?7nt>(emjv1G8+Go3ux2CHcDR6Ug^oq)r5nek>_qqp@!BknFT2tQiR35c?
zFv%)^5KLleA(d+%qV!ZT*5bgNuFnDK=AEpm30Mj0njd`CeQ#X&oUtW}yti!NBgwv2
zvN?X==FggEF;_O<T8<HwT3jZlv=l~{mEd1&sK$m9{Uq#=a<J~53^UnJ2&u?F5A#Wr
zXv=$GbIVNYsF-(=APtEPD!y&L?+F!gl_g_Ek<sC~#9d*w|Ac`tQ#-V;RwYEGmQ}}*
zx%}9vXDadi?J)84BC%gPE-Zoq<jC3<olVb9rnU_EhbI*{IffTNC}aPzVi%b`<9hW|
z2qP^%Gx2VvX*FALGGcAQiSK3{_p^LubnJ!Mw5ko)7%JM8QcWj@a=f23_BEU2R$3k?
zuP)mt*UIz`AhF}LW0W^}96@zIGOqI3ePwFxT>;xqMz4C{_@#Q#dGybMf8x*?>|dz2
z_9Q)7YX4|mL?WQC#^macx3i6<;VxrysrxJW>AYIIqZ{|js9!d*Y_J7x?v7`U4{ZYN
z3C_?QU9?S{dnlk+47@B%awD%5i)424$3^Wm$yNF1`!D+o=sTQJq~V5dd#?rpC;ZF>
zEBoq3R=Bg{p3llt)4F!*$*iPr&(Gvxt&8&E{SY2b*<<fw8Q2Hjx~WLJIA#(<L?YYc
z=V+>3)>5{xZa)9~2R4*f1N*>MX<Z`SQg;BFmQ3K|=jvv=j};1bc(|+E;}<=yQ(Z&^
zqbxBZtP@DC=AUP4aF=?LgMIL672^-8K9hA@h$aN+HlN@vRPbruN%E41>=?L*;JF|_
z&u5ab=XRixm$E;~s`sVCj$LOdzfnS=swYUUgY!xF?a+mnMc7%YS(zj@jWB|f@47qo
z$mcN{8ME%&*ljXc!?OOmllcrgtqd!Lj@P5MzZ4TF%LFPz>*Jg5lg+8s+hDB*6&caf
zd{!%Ed37Wl2?W*5-aY3NfTbcBageoX`!5y!A+86_5=oSX`7VhsuF}}6FQzqL7}s|k
z{QzV7NuR-mWJHf3i@*=VpS6hec@a&&ci&d&+l*)Ge*a+LGHzHYg{Evq;*(V1o;bH}
zE2aZX@6tPuJcXT>u2CD2g&{{sTTlDoH4y@qzcAW{a2R#)9mnR-6kSPfQ$KDV_s0&D
z)VVqOg^GW>;Cs$ap2h=766mZqDa56>_oPgxv_VtAajAP(u$KD<X+3u>vLu+iCB~}=
zp##UNUvQPsbQj?sk{!AKwq$CX_F_ICvRc>!w(hQq=KVBC049YYZ%$|qbcZ$vDnH|4
z8=!LH1UZ%KAK}tlOw&!pNF^u3*2rkCHhb-|69>d;r78c9q%RL^>RP|{UfZ8_K&n=0
zMM#Sv3L+{31tDprihu~p5E-MQARtBr!~n@@wL)<q1q~4pQbY)ZA!-OSL<K~~$Pi|T
z0ts_M63D<wPQT6l{%D`4wN(h`?7iOguHo~;XA%Fdi<XQ4P6EUm<xY?{2D*S6Rf~^K
zJH%qm)YJIWXL<*vuwXOyQQQsc&5B5$VZN(IdA_{N&M$-!I%_G&USU9$m{qP4Xy!xS
zddC^qr8243l1^)`(QfX2vAM{){n#xB&~pi7jK1--i&H{|FS)tKt`ar#3X#ELr^tu`
z(9?Y0h9*{vR-Q(4OfbvQDJ3(jN1KhaZ%RpG<$i^MZHQwYAN-`>X_Y`C@B5qwsCL-S
zn?H*IJcf_|XwKe0omj1DzrnP<s#~7@$bR^%_`R~d(B$}<4=N?!f|2czTS+;1XnQzN
z4D~>-vBxy$uCG6C&DFGk1a<!w^*-!?LjU$4R1F@c^77+;St<ofg*TSe1D6qK-iz@@
z%m_iMG=d!m4$+HVJ;~GbH|0z(957bD9zx!{w!`EP&FIR<3Dl#+f7d-xnsSu*e}?#@
zdB_A%ZU}Og*SaYG7)W|l^i6_s^&fN_z3IlPXcw)VaFq<=s|=YjOFMZW2H5ONqL~%6
zFo-}#nAkluaXn$+kL6HK`L=_?H5sy=**}Q32#PeFVJ41$1Am=eIie38SDNKQnjDUO
zrzz^veR}(P`V#t)yuocmc(;ETQ>~SWEx0BjHk|J1w5uX%q8d=_iXKolHztNt7u=54
zZ*Gk9o40~_hIc_A;Yu2|Q)<yq_jsD+^vVg3iB59^*Wi@%GEQqazXY<Tx+{a;6<xZK
zY)&<XclOW9U#TK05ufgl?_*jIf=U~JmU;Q%exOIQFD_y8&De$F{z$tw(CdKjW}n9}
zcKDG*<s~3t8T;m5Okj$+sc7K!iHxa%Ld(m5t@JLRQMbw$f%?K#Y9goU{7qZ5kNuP<
zer{<J|EI7en=k8nvQSl3?0AC|M$yS!3GKC0ocrr{b-A-0%iGEmA0cS3FD{%G8dqxi
zVl3-$wW=aB(&r*G0Hb3)Y_8};Lbo5<;NYh-v<|Xze^r%qB&;8q#@Nsl8()&S_cRPT
zao0)T<DC1XFot1BmT<_I`(@LWYv9dL^)LeYBhAQ)Z#-(0xOz8!XBlB3#$&4b!h9;Z
zwjxWe%17NQEjO9GJ-qI%su&YuarVx4dwU^5gJW9B&;sUmlD?}G%|wf*-_dhkn`Ky7
z>b}Q|W}(=5=GS_kBF{}%|El=N25Wu3SL3G**_LkQ$K<yULcMN1j|eW6$}4oBdvvI{
zPgabCI~;8&ju1L1=CV1Wh80}jS+p<r>6^}qs&KvUNZZ6cnU}#+dJR%4R7DaoaCJUC
zdYY3`@KEGwA$o`mpA#aYyOlpgvOx3VgMz9d;5Pyh?YZou_nW+EfN3czwT9W*g^t2s
z+2QR?`jqweC0B5>8!HiCENVi_wC!;>PE)gt+u;i&3L547y?z6z{P;lI09{P;x<@^x
zZ7MmHj`(qwu&D`7-L&bnhP#rJiLL~E3eY6K%-GGMs~u|Sob@s{dCStspoRs~NS4Zq
zkv~e#P*#25Yj>hF`a)YZUzrgh*Zvj*ufVjg2jo>Z93*8&8>QaU$HO7zvjlWS1|%3S
zQljVESYY*k8Tj!aIdj9fpS5BRpCqy8m5h)Cwe>_4tMZ79hWcq%Ut7}`b?{9>mNhTy
zqq-_L<0S}01yX6oxK8rEK7Eu5U`hi*gcZciS(PF~b1t84aNAJ}^}pKDH3|uj2zoX)
zG+Wb_I~DmZW!lzFKsGT*_OxuLBQ2SNG#h=)C`P?rguUt<n{+@RgQt7=>sQ3=P{bKb
zx^aLG)movk9m8cU9EgkCP3l7SJCQ!jf!_{^TTKF{j=#pu&h1dd8!}szS>}S`qs5Im
z8RA_d=x!riih0$%znn^<dIKEoQUh5aaYm#lcV%6`&$@9WWy7L>+C1DU^x7Q0yf(PL
znD8I4JCK7DYh4f|t|e^vu#@fDntBDLizr2Tyu+iO-o@?gh()N@eOAt{3<(F3e*SEe
z-5v$ll*Y_hISv%=tp@m{yssNh`ZZafdLG<o5X(=#8sH+|^rZ+uiFW^MmcGOdAZ!sE
zqM-_TAa}fuvFuv({Qq+Eygk!V3)uL=YrLejI@{ZITRcO$LKn9>Pr4M_k{+c!7)08U
zMI5WUK@fd)dD<qU>z_`POH)iecyS#)LgR3&n9<^;Yh2*Ne$)7+>wGq6ncfmE?5E1L
zDQ+o^ZOjwdHW?Y`eZ4}>!Y@nB_pz>mqu<Zd;)f6&ieH?6gO@w2^egZ@yp}`P$=7ax
zEKmnJ(2}CA#t6K}vmv-<F4x^YcVK9_^c&NhUQsdRM(s$eErJET=044!Y0xVIZCjUZ
z%71_9>|Gv5#F)C}jnDAVb8Lfoi(lSW+egKTCA{{|;MbO$K`hDx-hYF)R_}@(*f_zQ
zEE8YQEJXObJ^V>CGC=iBZakkcy<5RA!(Gtyug=;13YV_D16DI>UYsEB)YtJA_mrv8
zw2(N7R+J}H$&QOnv2?St*+C?jCu>t~uH^6j_UYfK-WX8HFp$)PYJVQ<72E}QR21n|
z0>9K19|N}`mPNm)EEtuXqUM#0eq&xAK?G=E!b}GBkWpvwctDiQL$t3MBvF)J>pf;V
z9zZzniNP1*ZFvWb01tWC9AM7E8+c$Q1ive2BDh?8;LD-F{7w%aX>k_MT+OdN(+BuR
zQ!5vSe5oqX!x!Rje#j_|1YPop;D704#Oip>_5Krz{5Sl6|Jtj}d@lP#Q6Odaj{i<k
zJ-I+yofQQMdly7?bUq*fKu^V>EXRDTQX_F6C14r>ljC(-jPRr`P6GQ9U_OtIw>SX-
z0`9d}!ob7n;v-FI-SUk_n5Zd+cCdvD3#{4Yrn$X~fpe39M6C8)j@LFtGWtt_{V+zu
zUo!AUe^MO&88>~5{R8?PehOe2K1ii>vF3v=KqeQ8f6YjI4Ml`=7S_s^0fE~0IaI^S
zkzC<~k%OS9paB#x>0O->YjH$~+vn276Y~nc0S!RI)tv7}Ro=6eAe8*l)|!<qdMAw2
zB~bNE3gq|-TKvlcA@o^A5^H{omRUh4jYV0K8$0d&M6l-*<qlHYGJR>!v5vvXc+R(C
z{Fo-^A)$d^cw!zd2PjsI#k{61?l|r$sH3%bILSdFtIZ|Y1DHV8Vkj<T2X?%xl;x*M
zDEe+k)PI&f1pQaL$Wz5FKvp_7C&*C+-QP9RuCi`ulFsR!m<unuZ7!N4(i^@dkNiOR
zXV&+KTX~?99e?z`$;Lw^i?<EGRj00fJH?}+xcKPq7J*tU>!#0!PLWpD5;lC}9gYfV
zF$&?8yBKp30NF>KtMgr~if$$!{M+%^|Kg$NbdO(%j*wXc@#V6Aw0~G~o}bF9A!PUl
zX8Hk1`da>c`lLmWS53ty(n?cgry8t|<|Y}p6&@Ej!+0Tl3u@PX(gC0?qPgmb56K^e
z=$srW)LyanN7?;4!Cla!T|CVP|3wh^>v!*`05KhS&L9@)ZJ`aK_a_T0>ry@dnU_<;
zoheA8y_Wbl=J2JX+fmvXvzw@yL9W(c92yI4*jwk6Ux74&Z9hb;qg0|Epj^nBy^6nE
z6eytH3`<1!K5y%{Ga}@xBAKbS5YaTNj)DeiFFTM%QdW$W{5IeY<*EQwjRzw^jc}^}
zQVn1DG8O2`PFmPVf52SLT13@kp8j8UNjim|uZ&V;iS#l5Yb>K!(uQ6<=^8U01%W@+
zAu)U25S55#N8w4^t6A3y0OuWu%hojAt#RG(ezk!0T1TO+QE@<b9E%t6f-K1Vrsw}#
z_DvA#q%qGBgzRarayizk9B`i1)jS91@XAef(xoq$uN=U38l`jOBc}z_NC9bKJ*yF<
zV1R56vjQG!!78#q`4b;*HT^)+KWSMy;nc7ZrTJ54SEJx0u5MPQX!g}ek?D^zK+n=d
z*ft^C#;u^;?Yt5b9#QC*UvW?CLskTe9}6P$=SS*{zYInzk%%C#oN1*n)(tVJi*ifX
z+dZLcC9~sBRyaz*fc3{f=^ZyuDTf%n<Ybr(Ld%QE|E_z;<Vq;^vbp{Gd7n93ja#j$
zhA3bzG<<?=2xNW^$5~$ivWfwU(%c7*|Bz~!W(di<>Kz-m*;Q_Y#VcgR4ov`II&x-L
zq)`b(G(<GlhMJKSIIu7@9qm<zXK6Gm?2Dvcsre}Qbnbn>5YTHNtvCg|B<2*U7ygav
zp4hW3p{Sztc5lJ0zJw3=i?3tM{3{+a9(lvX=Z6m`*8AJr0<(8h>ab=QOn-h}rN9!F
z1-gh7rhU1<Gk!Yr`1RJcgzmmi+e?1!6*8TlZ{3~t6Cik^M>5&&9N$l^N6f%E<e_qM
z2L^|dmR*LWMXB!By-k24K82q^yZso1X!aLf9`+D~%@u@np}%b|Vx1InJzOgzjtii;
zg~P&rfscXjpG|p!;vIB~mzsN6&E~p~=QLq}+ZOs7<P6l5Il+T-1<jXyI)?W)bPBc8
zX#&#XjO_dYv}QYC#6KO)(7&K!7$fGTE_OapW^oP^u%9(ooerVnSmBChY^HrOJFGc*
zaQE&H8Fk2Z1*L1w2~+Q`a@&dN)bQH_;+|)ww(1Q3_XY!4-mqKv<3(kg{rvi@v!TyB
zTittfDUzBSVS^9#%els#m9Fe#P(4{wGY$9zuT8P2`V_|d@vwyvk5TB>Q}RJi4eN#O
zcOe)|yL)|q7_Sc<q-LXriqrBf3Z8%VtU@SfCs(~-;9dt+vI6gE+a=-FN)9nHuE}St
zRy+_|;sVzQV(w(cAIEYhwCV5E8&Hf;B!VDLIfl29Uq?2rn2z90Y`-Mn4O|R>{Q)Aq
zE{N?#Z_%)#bu@BNi^psi4{vaR4^>(K$ERvuZXqxK6vXKjkw9r4v(;_*9>@;;>k!Fp
zlF9p7XPaER>*rx|byp;96CfETaJOg+Si)yuPzumeki^qqWL&b9@$W&>Z?oXk0tNH*
ztK@})>U3C&&jxZ(P;Y7x_4zO-*wN>UhPL#~XA$OHC9cp3Z%o^P7T-zMe}jBc;%~>F
z<9{5ayp#|ceoR7q9U{Sd`w#YReCBhv2SzS#dqO#*RrjuX_n8s;w|`MrU4hg@)D&Gg
zfjNGmHyBslkP&%wj;fOd2`1{pK=w)>V))qn9<mpCC%MYbL>3L*avI8(&@8acR|X@;
zV^#ALK(&vNx3nWQ<C|8Y&ja8YtcYH@s+sUlcmj0lxV_Ea>)(mWI;Z&Zk?8Un`i@xa
z2xez9)6$-mr_%Z6Iz0xOdgJd(1>(GLEP^nx=F~JZmDJtVNegKeJ|j8hBx{%m&kbMV
z1RM#@U-AZW%F8t#okM}H4%1<t$AMkVblP{W{7&8Qmpbzpg(+uAA+9*h7WNrW*t+V2
zFcl~IaKATMXS9sw!Y(tRY$XSy$9X0lw?U=@&jfEe>rc@t>NRz|<l%71JLo~l$ne0y
zx!v(c$%7`P0tO+54JwykRI$ql>h*n7?9H2+>RzdeS$zjhw@Vv^Oau11zUjPIs(Gwi
z&s=8?Rp2B88R)6ly!0=Gt<IDUv%|j4daeS(F)kY<cHvx4yxh`SS97&xIj?iIJJQ6P
z|LqUHpfM|`T`_-IUZlC#`DD6`(93xna{iz8jku1|`OV(xwsiU|RJV4^ON%SD@6$$X
zh`HX!x0;^dDm<M~6n9mFD}KenHh7#G4bL;W1!WjVDrm<Fl_H{gf35Y5j87wDB#=Nw
z4AK<j!Nm9-MIUeLqVQ4%`$Lfr)|z*A(zAqA{xyJ@MXd~PuV#&VbwgpEf5%`Q?}%QM
z{*Rgkyjyic3G{7Pj#vHdUIn-;1w&2B_nr@l1jk2*8Z>d{k1W5Ub}$Vj%>V+8_){Jq
zc#e7mB%OlsgEeJfZI`C1o&Q~8l$2FdtgZenWbbO+iwCBwpFzUATMAO3W6Aa7^Wg9~
z<Xq|9*V5pXY#uIU?p07tar$aLA*OK0Lc25o1mf4Vl^XFJB4c1qdO@~DzzHyVC}PO5
z(5YMq*i8B3Ob_iOEypk&b^qC1MsQwzjV#<siW3d6PyGIVVy@UJ#(fm%Vb4zZE*Etl
z+gHbt7K7D1T;2*arhxCPcm8f2YhRH@e5lxLKoM4+)@!f`k|=_6K2@Lh+Am^U6BXlw
z^*dM**n^^%50Ok`3GZitbEf&YW?1V$=DB9AK3okEEK`e07WP?hWE+yF!HW=cb~DaY
zn1!qZZI;a8uqfXasfN39jSPRB#{|b-nw6ayWWknenPp~%a8|D-0GDQ(5z%etZKEUF
z*G3Qd4g+3?`lNQ*j*yQl!4vx<09i_={e&6G8=|=;6*vGwrXSvg$#I(;^8fG}vL3~0
z{#)Z#DU$^fW-sLY$f>B2S*b>l3GB&DA*>S{tP5R^y*`l&RjPNMP@KsOzz|yiv>Gg3
zbRfQbC?G_2g07H$?Mxu)Ilxlzq4)uI(xKe5<K}Nb4lI6!cB_n7k15yF?Wh7yPot1%
zg>PbOV8!C3l>OBh%spD0a=~*SP!~`=RhLqJR%jF&0md_RqVM2htcuK9tNBca?A>AP
zDh9q~kE^1#Nxm95j^Vv9@Q&H~qANE>jsqB#<fi#=p`#83-{7eN^YX`N_+yR+h>X%n
zSN>ghoELG~^WjxmhH<v>YA5CKx{R&4CILkL7{Fd>>}aAnZ0<%VE0FeJR$_dQrt6=H
z06k35h?5Ch$g*M)rbb>u!7$A}6cazT3F`8fc{E!C<Bs9q0J#@}FAwVxcmYifmL2To
zf|@8W<?TKf8KYHN14u-mSha0~H&AXWq@6-T$N)4l(a&rtb?~hC6gz%8%`M89E31zh
z&^PO2P7ZyC_P0j8rSydDUbcPt7u7eSiE9ixn{ZU0Hx~kltc1XTrXxV!uv?U5{L^$l
zGNVDAs(uK}dWIOHqW{l0`f!6nw3w%|qk?an;yht?0>_7n!ADa}!0Pyc?0S3(OW8&j
zWxjD)d+0Jj{Kf1;;O=Sb!^A|&j6qYGchv&~H>tvm6sPy^Aks7jLK|S1JFrvoouOp+
z@Mr>`lo83a2X-GBz^p**_V-eKWd_V2hh9-CbCrROE|2$BRiwCyPRx4P{{4sNY}YC5
zeYK6IC{pNZot~<Oh2Uhr0-6gr_byRGD92)*G>SjeHBh1eXQA-Ebt;uUdVjv+6MG&m
z{_}KQD?n@8FuayPebb#51Me?gjQ)4sR`s?h9q!JO$VQFgw-g)TDp_&WH|3gjv;6`r
z_qx#*ASt*a6Nrj3ZI^y?q&p;puoetlm4YMyT>KV2fpz)}7l+rM54jN1kZG*~*ps6~
zEnz=SR!<QFb)GEf7cKSlkF;l)onM^=1bSIDO>qnRDgi?=&mY>WrbS)B)Plia{=O3T
zIV;<vHOr?uv3~?1<}wLO`u9S@_vV)zc?arj#D>h|<~{}Y)_sd=W$c&ucKDbq=eQr{
z^H3o3OH@dH)2k6g0&Y3~kfaGv%rm0dg{q?TDgy^Pf&C^OH1@>2j|=P&@5O|%U?fCg
ziU%|34A>+OA!TpCmGy~Z+!~<uy!d)ncv!TG-WA3Dyw7L1HHaN5yKoZjT=cxOX0#ud
zp*3NCt;wb}G|AT8BfC(sOT5BuFL!Qo(SY^3&mZCajX4ocyGkZbC$(dDgTNhL_?_2S
zkJ7lOvpE63c8|)u<JCOhQe)pafJ^rk&d7+fK%`Z3;Q6H8gG^MtwA*}?-l9YGo7-}h
zEb~y;Gtc+t3>egeK7)UO&2tV^)WlL047cNLFM^4DvzTi^;+<jx8ENIjhM~OT-(T<4
z62q2{or6Eo2El9UB?Wm4{8OzuqPYnu-?5ru`8cnnvnbW4MF51QxM)9y&B%>@WK-I>
z`PirJ$Yu6h_;lgbiecD9(1JWHykYpRaE<TDh}X5`wkyKgB04RQ3qTF^JeBpB-4PSL
zhsF=X^tU>+3W+nbv@i`{RA~4bj}k%4wndDSn&H>qN<WVvWsI?X%2-eC=be~Gmp{Dv
zI-g*59xTGmj)xO2rN6fBD@6}|ZRNDvG@>@lX+n1L<Q)h!ve@L}gz`M0JRemH_q{m@
z_TfX>Cy$fm;YYz@x1@9<NpP-iKJe^*QRB1S%}hWVmBmRhY{vla*V?P-w&|B(taQ9H
z|F#)y!~c2jHfm#bQFWdOfLobv^RA*ptIK8%r@&%Y2HHs`bhniAn&LdU&oH4{D8wi#
z0uhj$NduX_zRJ5YP*ym|CGUDQHlsk}M+a9_j&R6K>!H_Cl`w27syf6uv|oib&*T1y
zzPa?D2y-_u&q;}5;B1t)Eyqw7LGn3N-B6`%b=<G^7)})eUh%g(L|8w-_<_0-q`}x(
zgV(9FQJvK$IrQeeh7aX{_-MOw5W4?P=u&(Kn$6-Mtys&Ab+vacC1d)*+9#<IF45#e
zDdY2iyc`PrjkGmrlq%VZoiJbhy7>*nJ(jgL8lMK@DTaegowjdvhGgZd@{R8Vw^|;N
z(&`kQdf@_R>6C~ZSfDfh$L9e>xQ_8FAgIaUOy@0tWl|h{K|Bd9gz9%q0w{YrZW7(8
zDase)IeS15$kjUrngvUj@O1D(Jy|G`^!?<g_0h`)wrv^8(dF&4{m@PpB~XTD6o^L+
zHv0}PknHnmVNF%ezkGbn%S6qa8NZQR4^`umgoELpc6IZU<}HxlI4Y}S$a8Xu1BST*
zN`0;}YJu|(XW>h(O0bX1Q4QV+5}Cy!JE(|HrMkS#xbgO(O;|$Su*%O0RQD8kS=245
zy?CLK*aKfC|LU(<Jmf2z(@UhLp7$i->-F*V1ooVs=WKe!zw1f^&a!EE7#P_(D<F(C
zVxdL#-N5|WB2$OmiLQdu;MPli1KU6wiTM*nIQle^m6MxX=pyjiXs%{hJ_JXLPo<7m
zw%xhpJo##Lth(PGBb0;KrKslvDRU3OuUi$hm=GXK2OxVo`_FFh4AvK?4(DGD<$v)#
zH%2%&P<;Ogc%dqjFBco&Ox~dR=l)$68b6SChC7s5sS_As(J8x97)0$XPLI6oJWqFf
z-jz|DkIYqkZYYTl%j#4xy|eXC>wO<}*=04+WwkTS8T@^^N$+H<nDJb}I~zZ@w)M^O
z|Ir5!cZ{~2)eJ@eN%Y#>(s^dRb3|}8=ll8Ao!Q=fmSWS6GK&xT#xgg488f1NokhYq
zCIO_d21ZS824AzE?S~?vxXhwS2b_H<%b@kPl&x5AP8rtoVJF`&u6bbfr2A321ba%q
z?oiO8_UsGL5Hx>pmOPbgBntz`Z2NIgD%%ULNY3*)ceMW~XiH&a+I!G4U+o3;KA1%W
z{2U1ErMrFO2(Uli$cQZI|B9;ia(TGg_Vad4Mm~tvWRnSyX09lT;br=ev3%`|bAeCV
zTv4l$gOSENZGMdf-tnufRWp}MSc`mHLy`M?wSyfD*}iULo;?bN6eyDJAKvsB!#j5#
z>vec<0fFO;oj=!Np5?n+2bj(AF>)VkCe@g#-by*KDb9IP)PM2%$!NuSJbv8C*ZX$E
z^-v(_MdDgOQ<T?xtOFiH*~?jS^wk&Q+!m?ol2K#et2$jb<{$*wT_@|or+!Edr}k>~
zjs;qSEA~te%f2n)&Aum^eUq1s)&FJTBckec+WDM#0N3XxOL5k1uBlEaI0|b$@sMfl
zb{gV=yC~HVd>S<~@bqgp<yFi!{>x8xR!DH`UKlWzJ<d(tf=sg+F2YpmmvaPT7y*qc
z_1gT<lii2HXJ}Seu0cO#JJ?R_zdV2e*VNlyMNE-i$<c)v$h;kzEL@4#X8%^ksdZU1
zUU~$PMK@p?sdghABwD<rkq@o)r>ji5a{pbYFXtPta@S_uoen^kM~(#+L7nZY^ZN!=
zd)+wxD_j40qQC_MIHubo<6#bnnEK!!{#XF#L5zKUAJzJ31i=`Y@P2f=D15hJ@dg-L
z?jiqapFuWkxY}q-Pwz4QI~kB|J>{i~5Ni>^AGJ=!{9)38_1?8{`q)u?D&m$?P|4el
z*dx)YbeQtbtsl+}y2eOPt`+>Hgn&QR)9zdWuJyZXMf%*&vCyHKK>@3xa*#zpwbb_%
z{%ShrPnw(ipaQx&cDsrcU=p)s&cmkOypf7C2sC^GJTi!sIWl8QDS>9>(hGDLG@UWJ
zmutml>f&%8;I3wcWOz7!Iq-rnoKc*kOBz<+Unsh7cc2lNfML%Rh0_#hm(`!(VFY99
z<uYXAok5=+MK%qIj`NPUW0RoaV?`j>8d8P&dX(+l|NJb?oC`O}Oa#;FgyV0Z5_s)<
zpZA`G(vg7Ye?yg?m^VUej;yCbo`~)sQKyDmrN$Z7lKN;{=!w+6C1Wqp37eW|9l92~
zC<RgR*rN-#?|gO^6nQ)w&gk(AFzS1_sdG=Lrm5^nV_e$>#|qw$RaH->z&^|eR4e$G
zCFK#yWX@7Y?Ipa1pAk@bf4M3m$gwKaj#dpe>flklRcGgQTEA=S^RA?K!^e6?p{5?Z
z0cx@$(QVub(Zr(~UC*PAejjbG?<9PT2)X8fbu80;x2l!Ro9@&aoi#{E|3qKqD#jcB
zR1%lcLl1s|gWi3CZP0@3N^Wc<PA4<ypN75jH-8RQhd3<p8#9|KkBbWKbs^teQmHvg
zJtB}ez6W;dL4}jyEhia=E5xFfIA2x-r7f$6vd~%Jz{Xf(=1oWJjKApqT-vMIJ@>yH
zX$xj*kw;F#^d}FxNKZR)x#~=oftws4ORn==Inhi|rK+n*a_kXZeysNeSm=9i6LX(j
zhoWH0-o8&gC6v$OofYNij<gn})04%P<~eiztMc}P9@KA2NZR?UeB=sQ0DOZW|GvWX
zRRlh>e9>^w^u^<!&rFnEs35mLC^s{}O)w%I6%1iEvUB0mtTe~#vWBx<6k7NUY+2cB
zNH4k(Q(u&)S$O(!qWFL@RT2Io+ai<n%TLAnj_t0}xliAhF`~Odflw0UC>{g`+j;LF
zA9mc$Ldq)S!TO)bcAgcJohZv+WuCnJ!+*=qhJHoz$C&AkbQIK9E)85c-G>p7VXv*7
z+?tm%UEQK`o$YoUs^=6R93bYSrJIV4LM+0r92vEv-)Os|j~%0DBXQkGB@y)Vo;W<>
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


From e1b7b3f8af6672be084330f73bbcaed9f110a290 Mon Sep 17 00:00:00 2001
From: Kenneth Knowles <klk@google.com>
Date: Tue, 26 Nov 2024 11:43:24 -0500
Subject: [PATCH 023/135] Increase Go test coverage run timeout to 25 minutes

---
 .github/workflows/go_tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/go_tests.yml b/.github/workflows/go_tests.yml
index e85c4eba866b..5ae3609ed997 100644
--- a/.github/workflows/go_tests.yml
+++ b/.github/workflows/go_tests.yml
@@ -50,7 +50,7 @@ jobs:
       - name: Delete old coverage
         run: "cd sdks && rm -rf .coverage.txt || :"
       - name: Run coverage
-        run: cd sdks && go test -coverprofile=coverage.txt -covermode=atomic ./go/pkg/... ./go/container/... ./java/container/... ./python/container/... ./typescript/container/...
+        run: cd sdks && go test -timeout=25m -coverprofile=coverage.txt -covermode=atomic ./go/pkg/... ./go/container/... ./java/container/... ./python/container/... ./typescript/container/...
       - uses: codecov/codecov-action@v3
         with:
           flags: go 

From 292da721a575732d257077e2220a2e49fb9045da Mon Sep 17 00:00:00 2001
From: Damon <damondouglas@users.noreply.github.com>
Date: Tue, 26 Nov 2024 10:04:30 -0800
Subject: [PATCH 024/135] Add
 beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow (#33181)

* Add beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow

* Fix yaml format
---
 ...ValidatesDistrolessContainer_Dataflow.json |   4 +
 ..._ValidatesDistrolessContainer_Dataflow.yml | 114 ++++++++++++++++++
 2 files changed, 118 insertions(+)
 create mode 100644 .github/trigger_files/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.json
 create mode 100644 .github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml

diff --git a/.github/trigger_files/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.json b/.github/trigger_files/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.json
new file mode 100644
index 000000000000..4897480d69ad
--- /dev/null
+++ b/.github/trigger_files/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.json
@@ -0,0 +1,4 @@
+{
+    "comment": "Modify this file in a trivial way to cause this test suite to run",
+    "modification": 1
+}
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml b/.github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml
new file mode 100644
index 000000000000..a0de6d4a0428
--- /dev/null
+++ b/.github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml
@@ -0,0 +1,114 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: PostCommit Python ValidatesDistrolessContainer Dataflow
+
+on:
+  schedule:
+    - cron: '15 5/6 * * *'
+  pull_request_target:
+    paths:
+      - 'release/trigger_all_tests.json'
+      # Since distroless is based on original sdk container images, we want to also trigger distroless checks here.
+      - '.github/trigger_files/beam_PostCommit_Python_ValidatesContainer_Dataflow.json'
+      - '.github/trigger_files/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.json'
+  workflow_dispatch:
+  issue_comment:
+    types: [created]
+
+#Setting explicit permissions for the action to avoid the default permissions which are `write-all` in case of pull_request_target event
+permissions:
+  actions: write
+  pull-requests: write
+  checks: write
+  contents: read
+  deployments: read
+  id-token: none
+  issues: write
+  discussions: read
+  packages: read
+  pages: read
+  repository-projects: read
+  security-events: read
+  statuses: read
+
+# This allows a subsequently queued workflow run to interrupt previous runs
+concurrency:
+  group: '${{ github.workflow }} @ ${{ github.event.issue.number || github.sha || github.head_ref || github.ref }}-${{ github.event.schedule || github.event.comment.id || github.event.sender.login }}'
+  cancel-in-progress: true
+
+env:
+  DEVELOCITY_ACCESS_KEY: ${{ secrets.GE_ACCESS_TOKEN }}
+  GRADLE_ENTERPRISE_CACHE_USERNAME: ${{ secrets.GE_CACHE_USERNAME }}
+  GRADLE_ENTERPRISE_CACHE_PASSWORD: ${{ secrets.GE_CACHE_PASSWORD }}
+
+jobs:
+  beam_PostCommit_Python_ValidatesContainer_Dataflow:
+    if: |
+      (github.event_name == 'schedule' && github.repository == 'apache/beam') ||
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'pull_request_target' ||
+      startsWith(github.event.comment.body, 'Run Python Dataflow ValidatesDistrolessContainer')
+    runs-on: [self-hosted, ubuntu-20.04, main]
+    timeout-minutes: 100
+    name: ${{ matrix.job_name }} (${{ matrix.job_phrase }} ${{ matrix.python_version }})
+    strategy:
+      fail-fast: false
+      matrix:
+        job_name: ["beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow"]
+        job_phrase: ["Run Python Dataflow ValidatesDistrolessContainer"]
+        python_version: ['3.9','3.10','3.11','3.12']
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup repository
+        uses: ./.github/actions/setup-action
+        with:
+          comment_phrase: ${{ matrix.job_phrase }} ${{ matrix.python_version }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          github_job: ${{ matrix.job_name }} (${{ matrix.job_phrase }} ${{ matrix.python_version }})
+      - name: Setup environment
+        uses: ./.github/actions/setup-environment-action
+        with:
+          java-version: |
+            11
+            8
+          python-version: ${{ matrix.python_version }}
+      - name: Set PY_VER_CLEAN
+        id: set_py_ver_clean
+        run: |
+          PY_VER=${{ matrix.python_version }}
+          PY_VER_CLEAN=${PY_VER//.}
+          echo "py_ver_clean=$PY_VER_CLEAN" >> $GITHUB_OUTPUT
+      - name: Run validatesDistrolessContainer script
+        env:
+          USER: github-actions
+        uses: ./.github/actions/gradle-command-self-hosted-action
+        with:
+          gradle-command: :sdks:python:test-suites:dataflow:py${{steps.set_py_ver_clean.outputs.py_ver_clean}}:validatesDistrolessContainer
+          arguments: |
+            -PpythonVersion=${{ matrix.python_version }} \
+      - name: Archive Python Test Results
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: Python Test Results
+          path: '**/pytest*.xml'
+      - name: Publish Python Test Results
+        uses: EnricoMi/publish-unit-test-result-action@v2
+        if: always()
+        with:
+          commit: '${{ env.prsha || env.GITHUB_SHA }}'
+          comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
+          files: '**/pytest*.xml'

From 54eb50d0edc08d4831eb99e034ca446ac4229308 Mon Sep 17 00:00:00 2001
From: Andrew Crites <crites@google.com>
Date: Tue, 26 Nov 2024 18:11:32 +0000
Subject: [PATCH 025/135] Changes maxBufferingDuration payload to be taken from
 millis directly instead of seconds * 1000. This causes truncation. Also adds
 a test case that fails without this change.

---
 .../sdk/util/construction/GroupIntoBatchesTranslation.java   | 2 +-
 .../util/construction/GroupIntoBatchesTranslationTest.java   | 5 +++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/sdks/java/core/src/main/java/org/apache/beam/sdk/util/construction/GroupIntoBatchesTranslation.java b/sdks/java/core/src/main/java/org/apache/beam/sdk/util/construction/GroupIntoBatchesTranslation.java
index 499c7fd21f51..7129854d44cc 100644
--- a/sdks/java/core/src/main/java/org/apache/beam/sdk/util/construction/GroupIntoBatchesTranslation.java
+++ b/sdks/java/core/src/main/java/org/apache/beam/sdk/util/construction/GroupIntoBatchesTranslation.java
@@ -83,7 +83,7 @@ private static <K, V> GroupIntoBatchesPayload getPayloadFromParameters(
     return RunnerApi.GroupIntoBatchesPayload.newBuilder()
         .setBatchSize(params.getBatchSize())
         .setBatchSizeBytes(params.getBatchSizeBytes())
-        .setMaxBufferingDurationMillis(params.getMaxBufferingDuration().getStandardSeconds() * 1000)
+        .setMaxBufferingDurationMillis(params.getMaxBufferingDuration().getMillis())
         .build();
   }
 
diff --git a/sdks/java/core/src/test/java/org/apache/beam/sdk/util/construction/GroupIntoBatchesTranslationTest.java b/sdks/java/core/src/test/java/org/apache/beam/sdk/util/construction/GroupIntoBatchesTranslationTest.java
index cb2054e09144..65f571467ca4 100644
--- a/sdks/java/core/src/test/java/org/apache/beam/sdk/util/construction/GroupIntoBatchesTranslationTest.java
+++ b/sdks/java/core/src/test/java/org/apache/beam/sdk/util/construction/GroupIntoBatchesTranslationTest.java
@@ -71,6 +71,7 @@ public static Iterable<GroupIntoBatches<String, Integer>> transform() {
             ImmutableSet.of( //
                 gib -> gib, //
                 gib -> gib.withMaxBufferingDuration(Duration.ZERO), //
+                gib -> gib.withMaxBufferingDuration(Duration.millis(200)), //
                 gib -> gib.withMaxBufferingDuration(Duration.standardSeconds(10)));
 
     return Sets.cartesianProduct(
@@ -150,7 +151,7 @@ private void verifyPayload(
     assertThat(payload.getBatchSize(), equalTo(params.getBatchSize()));
     assertThat(payload.getBatchSizeBytes(), equalTo(params.getBatchSizeBytes()));
     assertThat(
-        payload.getMaxBufferingDurationMillis(),
-        equalTo(params.getMaxBufferingDuration().getStandardSeconds() * 1000));
+        Duration.millis(payload.getMaxBufferingDurationMillis()),
+        equalTo(params.getMaxBufferingDuration()));
   }
 }

From 720b8247b6ea6ff7531a8abc465dcfbbca29e075 Mon Sep 17 00:00:00 2001
From: martin trieu <martinkt@google.com>
Date: Tue, 26 Nov 2024 14:08:20 -0600
Subject: [PATCH 026/135] use direct executor to deflake tests (#33187)

* use direct executor to deflake tests

* address PR comments
---
 .../FanOutStreamingEngineWorkerHarness.java   |  22 +++-
 .../worker/windmill/WindmillEndpoints.java    |  23 ++--
 .../client/grpc/GrpcDispatcherClient.java     |   4 +-
 .../client/grpc/stubs/ChannelCache.java       |  24 ++--
 ...anOutStreamingEngineWorkerHarnessTest.java | 123 ++++++++----------
 .../client/grpc/stubs/ChannelCacheTest.java   |  12 +-
 .../testing/FakeWindmillStubFactory.java      |   2 +-
 7 files changed, 100 insertions(+), 110 deletions(-)

diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarness.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarness.java
index 4c73e8c7f61c..21aaa23d3f85 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarness.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarness.java
@@ -68,6 +68,7 @@
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableSet;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.Streams;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.net.HostAndPort;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.util.concurrent.MoreExecutors;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.util.concurrent.ThreadFactoryBuilder;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -125,7 +126,8 @@ private FanOutStreamingEngineWorkerHarness(
       GetWorkBudgetDistributor getWorkBudgetDistributor,
       GrpcDispatcherClient dispatcherClient,
       Function<WindmillStream.CommitWorkStream, WorkCommitter> workCommitterFactory,
-      ThrottlingGetDataMetricTracker getDataMetricTracker) {
+      ThrottlingGetDataMetricTracker getDataMetricTracker,
+      ExecutorService workerMetadataConsumer) {
     this.jobHeader = jobHeader;
     this.getDataMetricTracker = getDataMetricTracker;
     this.started = false;
@@ -138,9 +140,7 @@ private FanOutStreamingEngineWorkerHarness(
     this.windmillStreamManager =
         Executors.newCachedThreadPool(
             new ThreadFactoryBuilder().setNameFormat(STREAM_MANAGER_THREAD_NAME).build());
-    this.workerMetadataConsumer =
-        Executors.newSingleThreadExecutor(
-            new ThreadFactoryBuilder().setNameFormat(WORKER_METADATA_CONSUMER_THREAD_NAME).build());
+    this.workerMetadataConsumer = workerMetadataConsumer;
     this.getWorkBudgetDistributor = getWorkBudgetDistributor;
     this.totalGetWorkBudget = totalGetWorkBudget;
     this.activeMetadataVersion = Long.MIN_VALUE;
@@ -171,7 +171,11 @@ public static FanOutStreamingEngineWorkerHarness create(
         getWorkBudgetDistributor,
         dispatcherClient,
         workCommitterFactory,
-        getDataMetricTracker);
+        getDataMetricTracker,
+        Executors.newSingleThreadExecutor(
+            new ThreadFactoryBuilder()
+                .setNameFormat(WORKER_METADATA_CONSUMER_THREAD_NAME)
+                .build()));
   }
 
   @VisibleForTesting
@@ -195,7 +199,13 @@ static FanOutStreamingEngineWorkerHarness forTesting(
             getWorkBudgetDistributor,
             dispatcherClient,
             workCommitterFactory,
-            getDataMetricTracker);
+            getDataMetricTracker,
+            // Run the workerMetadataConsumer on the direct calling thread to remove waiting and
+            // make unit tests more deterministic as we do not have to worry about network IO being
+            // blocked by the consumeWorkerMetadata() task. Test suites run in different
+            // environments and non-determinism has lead to past flakiness. See
+            // https://github.com/apache/beam/issues/28957.
+            MoreExecutors.newDirectExecutorService());
     fanOutStreamingEngineWorkProvider.start();
     return fanOutStreamingEngineWorkProvider;
   }
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/WindmillEndpoints.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/WindmillEndpoints.java
index 13b3ea954198..dd7fdd45ab08 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/WindmillEndpoints.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/WindmillEndpoints.java
@@ -88,17 +88,23 @@ private static Optional<WindmillServiceAddress> parseDirectEndpoint(
             .map(address -> AuthenticatedGcpServiceAddress.create(authenticatingService, address))
             .map(WindmillServiceAddress::create);
 
-    return directEndpointIpV6Address.isPresent()
-        ? directEndpointIpV6Address
-        : tryParseEndpointIntoHostAndPort(endpointProto.getDirectEndpoint())
-            .map(WindmillServiceAddress::create);
+    Optional<WindmillServiceAddress> windmillServiceAddress =
+        directEndpointIpV6Address.isPresent()
+            ? directEndpointIpV6Address
+            : tryParseEndpointIntoHostAndPort(endpointProto.getDirectEndpoint())
+                .map(WindmillServiceAddress::create);
+
+    if (!windmillServiceAddress.isPresent()) {
+      LOG.warn("Endpoint {} could not be parsed into a WindmillServiceAddress.", endpointProto);
+    }
+
+    return windmillServiceAddress;
   }
 
   private static Optional<HostAndPort> tryParseEndpointIntoHostAndPort(String directEndpoint) {
     try {
       return Optional.of(HostAndPort.fromString(directEndpoint));
     } catch (IllegalArgumentException e) {
-      LOG.warn("{} cannot be parsed into a gcpServiceAddress", directEndpoint);
       return Optional.empty();
     }
   }
@@ -113,19 +119,12 @@ private static Optional<HostAndPort> tryParseDirectEndpointIntoIpV6Address(
     try {
       directEndpointAddress = Inet6Address.getByName(endpointProto.getDirectEndpoint());
     } catch (UnknownHostException e) {
-      LOG.warn(
-          "Error occurred trying to parse direct_endpoint={} into IPv6 address. Exception={}",
-          endpointProto.getDirectEndpoint(),
-          e.toString());
       return Optional.empty();
     }
 
     // Inet6Address.getByAddress returns either an IPv4 or an IPv6 address depending on the format
     // of the direct_endpoint string.
     if (!(directEndpointAddress instanceof Inet6Address)) {
-      LOG.warn(
-          "{} is not an IPv6 address. Direct endpoints are expected to be in IPv6 format.",
-          endpointProto.getDirectEndpoint());
       return Optional.empty();
     }
 
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/GrpcDispatcherClient.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/GrpcDispatcherClient.java
index 6bae84483d16..234888831779 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/GrpcDispatcherClient.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/GrpcDispatcherClient.java
@@ -150,6 +150,8 @@ public CloudWindmillMetadataServiceV1Alpha1Stub getWindmillMetadataServiceStubBl
       }
     }
 
+    LOG.info("Windmill Service endpoint initialized after {} seconds.", secondsWaited);
+
     ImmutableList<CloudWindmillMetadataServiceV1Alpha1Stub> windmillMetadataServiceStubs =
         dispatcherStubs.get().windmillMetadataServiceStubs();
 
@@ -190,7 +192,7 @@ public void onJobConfig(StreamingGlobalConfig config) {
 
   public synchronized void consumeWindmillDispatcherEndpoints(
       ImmutableSet<HostAndPort> dispatcherEndpoints) {
-    consumeWindmillDispatcherEndpoints(dispatcherEndpoints, /*forceRecreateStubs=*/ false);
+    consumeWindmillDispatcherEndpoints(dispatcherEndpoints, /* forceRecreateStubs= */ false);
   }
 
   private synchronized void consumeWindmillDispatcherEndpoints(
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/stubs/ChannelCache.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/stubs/ChannelCache.java
index db012c6bb412..c03459ee732e 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/stubs/ChannelCache.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/stubs/ChannelCache.java
@@ -18,6 +18,7 @@
 package org.apache.beam.runners.dataflow.worker.windmill.client.grpc.stubs;
 
 import java.io.PrintWriter;
+import java.util.concurrent.Executor;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
 import java.util.function.Function;
@@ -31,6 +32,7 @@
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.LoadingCache;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.RemovalListener;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.RemovalListeners;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.util.concurrent.MoreExecutors;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.util.concurrent.ThreadFactoryBuilder;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -50,14 +52,11 @@ public final class ChannelCache implements StatusDataProvider {
 
   private ChannelCache(
       Function<WindmillServiceAddress, ManagedChannel> channelFactory,
-      RemovalListener<WindmillServiceAddress, ManagedChannel> onChannelRemoved) {
+      RemovalListener<WindmillServiceAddress, ManagedChannel> onChannelRemoved,
+      Executor channelCloser) {
     this.channelCache =
         CacheBuilder.newBuilder()
-            .removalListener(
-                RemovalListeners.asynchronous(
-                    onChannelRemoved,
-                    Executors.newCachedThreadPool(
-                        new ThreadFactoryBuilder().setNameFormat("GrpcChannelCloser").build())))
+            .removalListener(RemovalListeners.asynchronous(onChannelRemoved, channelCloser))
             .build(
                 new CacheLoader<WindmillServiceAddress, ManagedChannel>() {
                   @Override
@@ -72,11 +71,13 @@ public static ChannelCache create(
     return new ChannelCache(
         channelFactory,
         // Shutdown the channels as they get removed from the cache, so they do not leak.
-        notification -> shutdownChannel(notification.getValue()));
+        notification -> shutdownChannel(notification.getValue()),
+        Executors.newCachedThreadPool(
+            new ThreadFactoryBuilder().setNameFormat("GrpcChannelCloser").build()));
   }
 
   @VisibleForTesting
-  static ChannelCache forTesting(
+  public static ChannelCache forTesting(
       Function<WindmillServiceAddress, ManagedChannel> channelFactory, Runnable onChannelShutdown) {
     return new ChannelCache(
         channelFactory,
@@ -85,7 +86,11 @@ static ChannelCache forTesting(
         notification -> {
           shutdownChannel(notification.getValue());
           onChannelShutdown.run();
-        });
+        },
+        // Run the removal synchronously on the calling thread to prevent waiting on asynchronous
+        // tasks to run and make unit tests deterministic. In testing, we verify that things are
+        // removed from the cache.
+        MoreExecutors.directExecutor());
   }
 
   private static void shutdownChannel(ManagedChannel channel) {
@@ -108,6 +113,7 @@ public void remove(WindmillServiceAddress windmillServiceAddress) {
 
   public void clear() {
     channelCache.invalidateAll();
+    channelCache.cleanUp();
   }
 
   /**
diff --git a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarnessTest.java b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarnessTest.java
index bba6cad5529a..606d2b9dbdbc 100644
--- a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarnessTest.java
+++ b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/streaming/harness/FanOutStreamingEngineWorkerHarnessTest.java
@@ -33,8 +33,6 @@
 import java.util.HashSet;
 import java.util.Set;
 import java.util.concurrent.CountDownLatch;
-import java.util.concurrent.Executors;
-import java.util.concurrent.TimeUnit;
 import java.util.stream.Collectors;
 import javax.annotation.Nullable;
 import org.apache.beam.runners.dataflow.options.DataflowWorkerHarnessOptions;
@@ -65,7 +63,6 @@
 import org.apache.beam.vendor.grpc.v1p60p1.io.grpc.inprocess.InProcessSocketAddress;
 import org.apache.beam.vendor.grpc.v1p60p1.io.grpc.stub.StreamObserver;
 import org.apache.beam.vendor.grpc.v1p60p1.io.grpc.testing.GrpcCleanupRule;
-import org.apache.beam.vendor.grpc.v1p60p1.io.grpc.util.MutableHandlerRegistry;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.base.Preconditions;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableCollection;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableMap;
@@ -103,7 +100,6 @@ public class FanOutStreamingEngineWorkerHarnessTest {
           .build();
 
   @Rule public final GrpcCleanupRule grpcCleanup = new GrpcCleanupRule();
-  private final MutableHandlerRegistry serviceRegistry = new MutableHandlerRegistry();
   private final GrpcWindmillStreamFactory streamFactory =
       spy(GrpcWindmillStreamFactory.of(JOB_HEADER).build());
   private final ChannelCachingStubFactory stubFactory =
@@ -146,22 +142,21 @@ private static WorkerMetadataResponse.Endpoint metadataResponseEndpoint(String w
 
   @Before
   public void setUp() throws IOException {
-    stubFactory.shutdown();
+    getWorkerMetadataReady = new CountDownLatch(1);
+    fakeGetWorkerMetadataStub = new GetWorkerMetadataTestStub(getWorkerMetadataReady);
     fakeStreamingEngineServer =
-        grpcCleanup.register(
-            InProcessServerBuilder.forName(CHANNEL_NAME)
-                .fallbackHandlerRegistry(serviceRegistry)
-                .executor(Executors.newFixedThreadPool(1))
-                .build());
+        grpcCleanup
+            .register(
+                InProcessServerBuilder.forName(CHANNEL_NAME)
+                    .directExecutor()
+                    .addService(fakeGetWorkerMetadataStub)
+                    .addService(new WindmillServiceFakeStub())
+                    .build())
+            .start();
 
-    fakeStreamingEngineServer.start();
     dispatcherClient.consumeWindmillDispatcherEndpoints(
         ImmutableSet.of(
             HostAndPort.fromString(new InProcessSocketAddress(CHANNEL_NAME).toString())));
-    getWorkerMetadataReady = new CountDownLatch(1);
-    fakeGetWorkerMetadataStub = new GetWorkerMetadataTestStub(getWorkerMetadataReady);
-    serviceRegistry.addService(fakeGetWorkerMetadataStub);
-    serviceRegistry.addService(new WindmillServiceFakeStub());
   }
 
   @After
@@ -174,27 +169,29 @@ public void cleanUp() {
   private FanOutStreamingEngineWorkerHarness newFanOutStreamingEngineWorkerHarness(
       GetWorkBudget getWorkBudget,
       GetWorkBudgetDistributor getWorkBudgetDistributor,
-      WorkItemScheduler workItemScheduler) {
-    return FanOutStreamingEngineWorkerHarness.forTesting(
-        JOB_HEADER,
-        getWorkBudget,
-        streamFactory,
-        workItemScheduler,
-        stubFactory,
-        getWorkBudgetDistributor,
-        dispatcherClient,
-        ignored -> mock(WorkCommitter.class),
-        new ThrottlingGetDataMetricTracker(mock(MemoryMonitor.class)));
+      WorkItemScheduler workItemScheduler)
+      throws InterruptedException {
+    FanOutStreamingEngineWorkerHarness harness =
+        FanOutStreamingEngineWorkerHarness.forTesting(
+            JOB_HEADER,
+            getWorkBudget,
+            streamFactory,
+            workItemScheduler,
+            stubFactory,
+            getWorkBudgetDistributor,
+            dispatcherClient,
+            ignored -> mock(WorkCommitter.class),
+            new ThrottlingGetDataMetricTracker(mock(MemoryMonitor.class)));
+    getWorkerMetadataReady.await();
+    return harness;
   }
 
   @Test
   public void testStreamsStartCorrectly() throws InterruptedException {
     long items = 10L;
     long bytes = 10L;
-    int numBudgetDistributionsExpected = 1;
 
-    TestGetWorkBudgetDistributor getWorkBudgetDistributor =
-        spy(new TestGetWorkBudgetDistributor(numBudgetDistributionsExpected));
+    TestGetWorkBudgetDistributor getWorkBudgetDistributor = spy(new TestGetWorkBudgetDistributor());
 
     fanOutStreamingEngineWorkProvider =
         newFanOutStreamingEngineWorkerHarness(
@@ -205,17 +202,13 @@ public void testStreamsStartCorrectly() throws InterruptedException {
     String workerToken = "workerToken1";
     String workerToken2 = "workerToken2";
 
-    WorkerMetadataResponse firstWorkerMetadata =
+    fakeGetWorkerMetadataStub.injectWorkerMetadata(
         WorkerMetadataResponse.newBuilder()
             .setMetadataVersion(1)
             .addWorkEndpoints(metadataResponseEndpoint(workerToken))
             .addWorkEndpoints(metadataResponseEndpoint(workerToken2))
             .putAllGlobalDataEndpoints(DEFAULT)
-            .build();
-
-    getWorkerMetadataReady.await();
-    fakeGetWorkerMetadataStub.injectWorkerMetadata(firstWorkerMetadata);
-    assertTrue(getWorkBudgetDistributor.waitForBudgetDistribution());
+            .build());
 
     StreamingEngineBackends currentBackends = fanOutStreamingEngineWorkProvider.currentBackends();
 
@@ -249,8 +242,7 @@ public void testStreamsStartCorrectly() throws InterruptedException {
   @Test
   public void testOnNewWorkerMetadata_correctlyRemovesStaleWindmillServers()
       throws InterruptedException {
-    TestGetWorkBudgetDistributor getWorkBudgetDistributor =
-        spy(new TestGetWorkBudgetDistributor(1));
+    TestGetWorkBudgetDistributor getWorkBudgetDistributor = spy(new TestGetWorkBudgetDistributor());
     fanOutStreamingEngineWorkProvider =
         newFanOutStreamingEngineWorkerHarness(
             GetWorkBudget.builder().setItems(1).setBytes(1).build(),
@@ -283,12 +275,8 @@ public void testOnNewWorkerMetadata_correctlyRemovesStaleWindmillServers()
                     .build())
             .build();
 
-    getWorkerMetadataReady.await();
     fakeGetWorkerMetadataStub.injectWorkerMetadata(firstWorkerMetadata);
-    assertTrue(getWorkBudgetDistributor.waitForBudgetDistribution());
-    getWorkBudgetDistributor.expectNumDistributions(1);
     fakeGetWorkerMetadataStub.injectWorkerMetadata(secondWorkerMetadata);
-    assertTrue(getWorkBudgetDistributor.waitForBudgetDistribution());
     StreamingEngineBackends currentBackends = fanOutStreamingEngineWorkProvider.currentBackends();
     assertEquals(1, currentBackends.windmillStreams().size());
     Set<String> workerTokens =
@@ -325,21 +313,15 @@ public void testOnNewWorkerMetadata_redistributesBudget() throws InterruptedExce
             .putAllGlobalDataEndpoints(DEFAULT)
             .build();
 
-    TestGetWorkBudgetDistributor getWorkBudgetDistributor =
-        spy(new TestGetWorkBudgetDistributor(1));
+    TestGetWorkBudgetDistributor getWorkBudgetDistributor = spy(new TestGetWorkBudgetDistributor());
     fanOutStreamingEngineWorkProvider =
         newFanOutStreamingEngineWorkerHarness(
             GetWorkBudget.builder().setItems(1).setBytes(1).build(),
             getWorkBudgetDistributor,
             noOpProcessWorkItemFn());
 
-    getWorkerMetadataReady.await();
-
     fakeGetWorkerMetadataStub.injectWorkerMetadata(firstWorkerMetadata);
-    assertTrue(getWorkBudgetDistributor.waitForBudgetDistribution());
-    getWorkBudgetDistributor.expectNumDistributions(1);
     fakeGetWorkerMetadataStub.injectWorkerMetadata(secondWorkerMetadata);
-    assertTrue(getWorkBudgetDistributor.waitForBudgetDistribution());
 
     verify(getWorkBudgetDistributor, times(2)).distributeBudget(any(), any());
   }
@@ -354,10 +336,14 @@ public StreamObserver<Windmill.StreamingGetDataRequest> getDataStream(
         public void onNext(Windmill.StreamingGetDataRequest getDataRequest) {}
 
         @Override
-        public void onError(Throwable throwable) {}
+        public void onError(Throwable throwable) {
+          responseObserver.onError(throwable);
+        }
 
         @Override
-        public void onCompleted() {}
+        public void onCompleted() {
+          responseObserver.onCompleted();
+        }
       };
     }
 
@@ -369,10 +355,14 @@ public StreamObserver<Windmill.StreamingGetWorkRequest> getWorkStream(
         public void onNext(Windmill.StreamingGetWorkRequest getWorkRequest) {}
 
         @Override
-        public void onError(Throwable throwable) {}
+        public void onError(Throwable throwable) {
+          responseObserver.onError(throwable);
+        }
 
         @Override
-        public void onCompleted() {}
+        public void onCompleted() {
+          responseObserver.onCompleted();
+        }
       };
     }
 
@@ -384,10 +374,14 @@ public StreamObserver<Windmill.StreamingCommitWorkRequest> commitWorkStream(
         public void onNext(Windmill.StreamingCommitWorkRequest streamingCommitWorkRequest) {}
 
         @Override
-        public void onError(Throwable throwable) {}
+        public void onError(Throwable throwable) {
+          responseObserver.onError(throwable);
+        }
 
         @Override
-        public void onCompleted() {}
+        public void onCompleted() {
+          responseObserver.onCompleted();
+        }
       };
     }
   }
@@ -422,7 +416,11 @@ public void onError(Throwable throwable) {
         }
 
         @Override
-        public void onCompleted() {}
+        public void onCompleted() {
+          if (responseObserver != null) {
+            responseObserver.onCompleted();
+          }
+        }
       };
     }
 
@@ -434,25 +432,10 @@ private void injectWorkerMetadata(WorkerMetadataResponse response) {
   }
 
   private static class TestGetWorkBudgetDistributor implements GetWorkBudgetDistributor {
-    private CountDownLatch getWorkBudgetDistributorTriggered;
-
-    private TestGetWorkBudgetDistributor(int numBudgetDistributionsExpected) {
-      this.getWorkBudgetDistributorTriggered = new CountDownLatch(numBudgetDistributionsExpected);
-    }
-
-    private boolean waitForBudgetDistribution() throws InterruptedException {
-      return getWorkBudgetDistributorTriggered.await(5, TimeUnit.SECONDS);
-    }
-
-    private void expectNumDistributions(int numBudgetDistributionsExpected) {
-      this.getWorkBudgetDistributorTriggered = new CountDownLatch(numBudgetDistributionsExpected);
-    }
-
     @Override
     public <T extends GetWorkBudgetSpender> void distributeBudget(
         ImmutableCollection<T> streams, GetWorkBudget getWorkBudget) {
       streams.forEach(stream -> stream.setBudget(getWorkBudget.items(), getWorkBudget.bytes()));
-      getWorkBudgetDistributorTriggered.countDown();
     }
   }
 }
diff --git a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/stubs/ChannelCacheTest.java b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/stubs/ChannelCacheTest.java
index 9f8a901cb629..1781261e3400 100644
--- a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/stubs/ChannelCacheTest.java
+++ b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/client/grpc/stubs/ChannelCacheTest.java
@@ -105,19 +105,10 @@ public ManagedChannel apply(WindmillServiceAddress windmillServiceAddress) {
   @Test
   public void testRemoveAndClose() throws InterruptedException {
     String channelName = "existingChannel";
-    CountDownLatch verifyRemovalListenerAsync = new CountDownLatch(1);
     CountDownLatch notifyWhenChannelClosed = new CountDownLatch(1);
     cache =
         ChannelCache.forTesting(
-            ignored -> newChannel(channelName),
-            () -> {
-              try {
-                verifyRemovalListenerAsync.await();
-                notifyWhenChannelClosed.countDown();
-              } catch (InterruptedException e) {
-                throw new RuntimeException(e);
-              }
-            });
+            ignored -> newChannel(channelName), notifyWhenChannelClosed::countDown);
 
     WindmillServiceAddress someAddress = mock(WindmillServiceAddress.class);
     ManagedChannel cachedChannel = cache.get(someAddress);
@@ -125,7 +116,6 @@ public void testRemoveAndClose() throws InterruptedException {
     // Assert that the removal happened before we check to see if the shutdowns happen to confirm
     // that removals are async.
     assertTrue(cache.isEmpty());
-    verifyRemovalListenerAsync.countDown();
 
     // Assert that the channel gets shutdown.
     notifyWhenChannelClosed.await();
diff --git a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/testing/FakeWindmillStubFactory.java b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/testing/FakeWindmillStubFactory.java
index af3a3e8295bb..19e05efb50c6 100644
--- a/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/testing/FakeWindmillStubFactory.java
+++ b/runners/google-cloud-dataflow-java/worker/src/test/java/org/apache/beam/runners/dataflow/worker/windmill/testing/FakeWindmillStubFactory.java
@@ -31,7 +31,7 @@ public final class FakeWindmillStubFactory implements ChannelCachingStubFactory
   private final ChannelCache channelCache;
 
   public FakeWindmillStubFactory(Supplier<ManagedChannel> channelFactory) {
-    this.channelCache = ChannelCache.create(ignored -> channelFactory.get());
+    this.channelCache = ChannelCache.forTesting(ignored -> channelFactory.get(), () -> {});
   }
 
   @Override

From 0d55231a19f890f3377fa3f523afbee0a0ea86d7 Mon Sep 17 00:00:00 2001
From: Ravi Magham <maghamravikiran@gmail.com>
Date: Tue, 26 Nov 2024 12:50:23 -0800
Subject: [PATCH 027/135] Better error messaging for chain-type pipeline
 (#33210)

---
 sdks/python/apache_beam/yaml/yaml_transform.py  |  4 ++--
 .../yaml/yaml_transform_unit_test.py            | 17 +++++++++++++++++
 2 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/sdks/python/apache_beam/yaml/yaml_transform.py b/sdks/python/apache_beam/yaml/yaml_transform.py
index ab86a2aaff56..0190fe20413f 100644
--- a/sdks/python/apache_beam/yaml/yaml_transform.py
+++ b/sdks/python/apache_beam/yaml/yaml_transform.py
@@ -576,8 +576,8 @@ def is_not_output_of_last_transform(new_transforms, value):
         pass
       else:
         raise ValueError(
-            f'Transform {identify_object(transform)} is part of a chain, '
-            'must have implicit inputs and outputs.')
+            f'Transform {identify_object(transform)} is part of a chain. '
+            'Cannot define explicit inputs on chain pipeline')
     if ix == 0:
       if is_explicitly_empty(transform.get('input', None)):
         pass
diff --git a/sdks/python/apache_beam/yaml/yaml_transform_unit_test.py b/sdks/python/apache_beam/yaml/yaml_transform_unit_test.py
index bc0493509d5a..084e03cdb197 100644
--- a/sdks/python/apache_beam/yaml/yaml_transform_unit_test.py
+++ b/sdks/python/apache_beam/yaml/yaml_transform_unit_test.py
@@ -325,6 +325,23 @@ def test_chain_as_composite_with_input(self):
     self.assertEqual(
         chain_as_composite(spec)['transforms'][0]['input'], {"input": "input"})
 
+  def test_chain_as_composite_with_transform_input(self):
+    spec = '''
+        type: chain
+        transforms:
+        - type: Create
+          config:
+            elements: [0,1,2]
+        - type: LogForTesting
+          input: Create
+      '''
+    spec = yaml.load(spec, Loader=SafeLineLoader)
+    with self.assertRaisesRegex(
+        ValueError,
+        r"Transform .* is part of a chain. "
+        r"Cannot define explicit inputs on chain pipeline"):
+      chain_as_composite(spec)
+
   def test_normalize_source_sink(self):
     spec = '''
         source:

From 9138697ef60ee2d0da315e15292d15d5a4df1183 Mon Sep 17 00:00:00 2001
From: Ahmed Abualsaud <65791736+ahmedabu98@users.noreply.github.com>
Date: Tue, 26 Nov 2024 17:07:47 -0500
Subject: [PATCH 028/135] Cleanup Iceberg test files (#33218)

* cleanup test files

* handle IOException

* handle Exception
---
 .../IO_Iceberg_Integration_Tests.json         |  2 +-
 .../IO_Iceberg_Integration_Tests.yml          |  2 +-
 .../beam/sdk/io/iceberg/IcebergIOIT.java      | 41 +++++++++++++++----
 3 files changed, 36 insertions(+), 9 deletions(-)

diff --git a/.github/trigger_files/IO_Iceberg_Integration_Tests.json b/.github/trigger_files/IO_Iceberg_Integration_Tests.json
index bbdc3a3910ef..3f63c0c9975f 100644
--- a/.github/trigger_files/IO_Iceberg_Integration_Tests.json
+++ b/.github/trigger_files/IO_Iceberg_Integration_Tests.json
@@ -1,4 +1,4 @@
 {
     "comment": "Modify this file in a trivial way to cause this test suite to run",
-    "modification": 3
+    "modification": 2
 }
diff --git a/.github/workflows/IO_Iceberg_Integration_Tests.yml b/.github/workflows/IO_Iceberg_Integration_Tests.yml
index 22b2b4f9287d..68a72790006f 100644
--- a/.github/workflows/IO_Iceberg_Integration_Tests.yml
+++ b/.github/workflows/IO_Iceberg_Integration_Tests.yml
@@ -75,4 +75,4 @@ jobs:
       - name: Run IcebergIO Integration Test
         uses: ./.github/actions/gradle-command-self-hosted-action
         with:
-          gradle-command: :sdks:java:io:iceberg:catalogTests
\ No newline at end of file
+          gradle-command: :sdks:java:io:iceberg:catalogTests --info
\ No newline at end of file
diff --git a/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergIOIT.java b/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergIOIT.java
index 5df8604699a3..c79b0a550051 100644
--- a/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergIOIT.java
+++ b/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergIOIT.java
@@ -24,6 +24,7 @@
 import static org.hamcrest.Matchers.equalTo;
 import static org.junit.Assert.assertTrue;
 
+import com.google.api.services.storage.model.Objects;
 import java.io.IOException;
 import java.io.Serializable;
 import java.util.ArrayList;
@@ -36,6 +37,9 @@
 import java.util.stream.LongStream;
 import java.util.stream.Stream;
 import org.apache.beam.sdk.extensions.gcp.options.GcpOptions;
+import org.apache.beam.sdk.extensions.gcp.options.GcsOptions;
+import org.apache.beam.sdk.extensions.gcp.util.GcsUtil;
+import org.apache.beam.sdk.extensions.gcp.util.gcsfs.GcsPath;
 import org.apache.beam.sdk.managed.Managed;
 import org.apache.beam.sdk.schemas.logicaltypes.SqlTypes;
 import org.apache.beam.sdk.testing.PAssert;
@@ -80,6 +84,7 @@
 import org.joda.time.DateTimeZone;
 import org.joda.time.Duration;
 import org.joda.time.Instant;
+import org.junit.AfterClass;
 import org.junit.Before;
 import org.junit.BeforeClass;
 import org.junit.Rule;
@@ -87,10 +92,14 @@
 import org.junit.rules.TestName;
 import org.junit.runner.RunWith;
 import org.junit.runners.JUnit4;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 /** Integration tests for {@link IcebergIO} source and sink. */
 @RunWith(JUnit4.class)
 public class IcebergIOIT implements Serializable {
+  private static final Logger LOG = LoggerFactory.getLogger(IcebergIOIT.class);
+
   private static final org.apache.beam.sdk.schemas.Schema DOUBLY_NESTED_ROW_SCHEMA =
       org.apache.beam.sdk.schemas.Schema.builder()
           .addStringField("doubly_nested_str")
@@ -176,27 +185,45 @@ public Record apply(Row input) {
 
   @Rule public TestName testName = new TestName();
 
-  private String warehouseLocation;
+  private static String warehouseLocation;
 
   private String tableId;
-  private Catalog catalog;
+  private static Catalog catalog;
 
   @BeforeClass
   public static void beforeClass() {
     options = TestPipeline.testingPipelineOptions().as(GcpOptions.class);
-
+    warehouseLocation =
+        String.format("%s/IcebergIOIT/%s", options.getTempLocation(), UUID.randomUUID());
     catalogHadoopConf = new Configuration();
     catalogHadoopConf.set("fs.gs.project.id", options.getProject());
     catalogHadoopConf.set("fs.gs.auth.type", "APPLICATION_DEFAULT");
+    catalog = new HadoopCatalog(catalogHadoopConf, warehouseLocation);
   }
 
   @Before
   public void setUp() {
-    warehouseLocation =
-        String.format("%s/IcebergIOIT/%s", options.getTempLocation(), UUID.randomUUID());
-
     tableId = testName.getMethodName() + ".test_table";
-    catalog = new HadoopCatalog(catalogHadoopConf, warehouseLocation);
+  }
+
+  @AfterClass
+  public static void afterClass() {
+    try {
+      GcsUtil gcsUtil = options.as(GcsOptions.class).getGcsUtil();
+      GcsPath path = GcsPath.fromUri(warehouseLocation);
+
+      Objects objects =
+          gcsUtil.listObjects(
+              path.getBucket(), "IcebergIOIT/" + path.getFileName().toString(), null);
+      List<String> filesToDelete =
+          objects.getItems().stream()
+              .map(obj -> "gs://" + path.getBucket() + "/" + obj.getName())
+              .collect(Collectors.toList());
+
+      gcsUtil.remove(filesToDelete);
+    } catch (Exception e) {
+      LOG.warn("Failed to clean up files.", e);
+    }
   }
 
   /** Populates the Iceberg table and Returns a {@link List<Row>} of expected elements. */

From 159c8300ab368d7719cb6fe50470aafc6cb4525d Mon Sep 17 00:00:00 2001
From: liferoad <huxiangqian@gmail.com>
Date: Tue, 26 Nov 2024 17:15:36 -0500
Subject: [PATCH 029/135] Update beam_PreCommit_Flink_Container.yml (#33230)

Installing Beam Python could take a while.
---
 .github/workflows/beam_PreCommit_Flink_Container.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/beam_PreCommit_Flink_Container.yml b/.github/workflows/beam_PreCommit_Flink_Container.yml
index 77ddcdf18788..519b0273420a 100644
--- a/.github/workflows/beam_PreCommit_Flink_Container.yml
+++ b/.github/workflows/beam_PreCommit_Flink_Container.yml
@@ -131,7 +131,7 @@ jobs:
 
       # Run a Python Combine load test to verify the Flink container
       - name: Run Flink Container Test with Python Combine
-        timeout-minutes: 10
+        timeout-minutes: 20
         uses: ./.github/actions/gradle-command-self-hosted-action
         with:
           gradle-command: :sdks:python:apache_beam:testing:load_tests:run

From 409a31a388e660599bd9a93a6c6361cac6d1d556 Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Fri, 22 Nov 2024 10:13:14 -0800
Subject: [PATCH 030/135] Add bounded Trie metric type.

---
 sdks/python/apache_beam/metrics/cells.pxd     |  11 +
 sdks/python/apache_beam/metrics/cells.py      | 207 +++++++++++++++++
 sdks/python/apache_beam/metrics/cells_test.py | 218 ++++++++++++++++++
 3 files changed, 436 insertions(+)

diff --git a/sdks/python/apache_beam/metrics/cells.pxd b/sdks/python/apache_beam/metrics/cells.pxd
index c583dabeb0c0..7590bd8b5966 100644
--- a/sdks/python/apache_beam/metrics/cells.pxd
+++ b/sdks/python/apache_beam/metrics/cells.pxd
@@ -60,3 +60,14 @@ cdef class DistributionData(object):
   cdef readonly libc.stdint.int64_t count
   cdef readonly libc.stdint.int64_t min
   cdef readonly libc.stdint.int64_t max
+
+
+cdef class _BoundedTrieNode(object):
+  cdef readonly libc.stdint.int64_t _size
+  cdef readonly dict _children
+  cdef readonly bint _truncated
+
+cdef class BoundedTrieData(object):
+  cdef readonly libc.stdint.int64_t _bound
+  cdef readonly object _singleton
+  cdef readonly _BoundedTrieNode _root
diff --git a/sdks/python/apache_beam/metrics/cells.py b/sdks/python/apache_beam/metrics/cells.py
index 10ac7b3a1e69..f04468b00b5f 100644
--- a/sdks/python/apache_beam/metrics/cells.py
+++ b/sdks/python/apache_beam/metrics/cells.py
@@ -23,6 +23,7 @@
 
 # pytype: skip-file
 
+import copy
 import logging
 import threading
 import time
@@ -312,6 +313,35 @@ def to_runner_api_monitoring_info_impl(self, name, transform_id):
         ptransform=transform_id)
 
 
+class BoundedTrieCell(AbstractMetricCell):
+  """For internal use only; no backwards-compatibility guarantees.
+
+  Tracks the current value for a StringSet metric.
+
+  Each cell tracks the state of a metric independently per context per bundle.
+  Therefore, each metric has a different cell in each bundle, that is later
+  aggregated.
+
+  This class is thread safe.
+  """
+  def __init__(self):
+    super().__init__(BoundedTrieData)
+
+  def add(self, value):
+    self.update(value)
+
+  def _update_locked(self, value):
+    self.data.add(value)
+
+  def to_runner_api_monitoring_info_impl(self, name, transform_id):
+    from apache_beam.metrics import monitoring_infos
+    return monitoring_infos.user_bounded_trie(
+        name.namespace,
+        name.name,
+        self.get_cumulative(),
+        ptransform=transform_id)
+
+
 class DistributionResult(object):
   """The result of a Distribution metric."""
   def __init__(self, data):
@@ -630,3 +660,180 @@ def singleton(value: str) -> "StringSetData":
   @staticmethod
   def identity_element() -> "StringSetData":
     return StringSetData()
+
+
+class _BoundedTrieNode(object):
+  def __init__(self):
+    # invariant: size = len(self.flattened()) = min(1, sum(size of children))
+    self._size = 1
+    self._children: Optional[dict[str, '_BoundedTrieNode']] = {}
+    self._truncated = False
+
+  def size(self):
+    return self._size
+
+  def add(self, segments) -> int:
+    if self._truncated or not segments:
+      return 0
+    head, *tail = segments
+    was_empty = not self._children
+    child = self._children.get(head, None)  # type: ignore[union-attr]
+    if child is None:
+      child = self._children[head] = _BoundedTrieNode()  # type: ignore[index]
+      delta = 0 if was_empty else 1
+    else:
+      delta = 0
+    if tail:
+      delta += child.add(tail)
+    self._size += delta
+    return delta
+
+  def add_all(self, segments_iter):
+    return sum(self.add(segments) for segments in segments_iter)
+
+  def trim(self) -> int:
+    if not self._children:
+      return 0
+    max_child = max(self._children.values(), key=lambda child: child._size)
+    if max_child._size == 1:
+      delta = 1 - self._size
+      self._truncated = True
+      self._children = None
+    else:
+      delta = max_child.trim()
+    self._size += delta
+    return delta
+
+  def merge(self, other: '_BoundedTrieNode') -> int:
+    if self._truncated:
+      delta = 0
+    elif other._truncated:
+      delta = 1 - self._size
+      self._truncated = True
+      self._children = None
+    elif not other._children:
+      delta = 0
+    elif not self._children:
+      self._children = other._children
+      delta = self._size - other._size
+    else:
+      delta = 0
+      other_child: '_BoundedTrieNode'
+      self_child: Optional['_BoundedTrieNode']
+      for prefix, other_child in other._children.items():
+        self_child = self._children.get(prefix, None)
+        if self_child is None:
+          self._children[prefix] = other_child
+          delta += other_child._size
+        else:
+          delta += self_child.merge(other_child)
+    self._size += delta
+    return delta
+
+  def flattened(self):
+    if self._truncated:
+      yield (True, )
+    elif not self._children:
+      yield (False, )
+    else:
+      for prefix, child in sorted(self._children.items()):
+        for flattened in child.flattened():
+          yield (prefix, ) + flattened
+
+  def __hash__(self):
+    return self._truncated or hash(sorted(self._children.items()))
+
+  def __eq__(self, other):
+    if isinstance(other, _BoundedTrieNode):
+      return (
+          self._truncated == other._truncated and
+          self._children == other._children)
+    else:
+      return False
+
+  def __repr__(self):
+    return repr(set(''.join(str(s) for s in t) for t in self.flattened()))
+
+
+class BoundedTrieData(object):
+  _DEFAULT_BOUND = 100
+
+  def __init__(self, *, root=None, singleton=None, bound=_DEFAULT_BOUND):
+    assert singleton is None or root is None
+    self._singleton = singleton
+    self._root = root
+    self._bound = bound
+
+  def as_trie(self):
+    if self._root is not None:
+      return self._root
+    else:
+      root = _BoundedTrieNode()
+      if self._singleton is not None:
+        root.add(self._singleton)
+      return root
+
+  def __eq__(self, other: object) -> bool:
+    if isinstance(other, BoundedTrieData):
+      return self.as_trie() == other.as_trie()
+    else:
+      return False
+
+  def __hash__(self) -> int:
+    return hash(self.as_trie())
+
+  def __repr__(self) -> str:
+    return 'BoundedTrieData({})'.format(self.as_trie())
+
+  def get_cumulative(self) -> "BoundedTrieData":
+    return copy.deepcopy(self)
+
+  def get_result(self) -> set[tuple]:
+    if self._root is None:
+      if self._singleton is None:
+        return set()
+      else:
+        return set([self._singleton + (False, )])
+    else:
+      return set(self._root.flattened())
+
+  def add(self, segments):
+    if self._root is None and self._singleton is None:
+      self._singleton = segments
+    elif self._singleton is not None and self._singleton == segments:
+      # Optimize for the common case of re-adding the same value.
+      return
+    else:
+      if self._root is None:
+        self._root = self.as_trie()
+      self._root.add(segments)
+      if self._root._size > self._bound:
+        self._root.trim()
+
+  def combine(self, other: "BoundedTrieData") -> "BoundedTrieData":
+    if self._root is None and self._singleton is None:
+      return other
+    elif other._root is None and other._singleton is None:
+      return self
+    else:
+      if self._root is None and other._root is not None:
+        self, other = other, self
+      combined = copy.deepcopy(self.as_trie())
+      if other._root is not None:
+        combined.merge(other._root)
+      else:
+        combined.add(other._singleton)
+      self._bound = min(self._bound, other._bound)
+      while combined._size > self._bound:
+        combined.trim()
+      return BoundedTrieData(root=combined)
+
+  @staticmethod
+  def singleton(value: str) -> "BoundedTrieData":
+    s = BoundedTrieData()
+    s.add(value)
+    return s
+
+  @staticmethod
+  def identity_element() -> "BoundedTrieData":
+    return BoundedTrieData()
diff --git a/sdks/python/apache_beam/metrics/cells_test.py b/sdks/python/apache_beam/metrics/cells_test.py
index d1ee37b8ed82..68e3f12a73fd 100644
--- a/sdks/python/apache_beam/metrics/cells_test.py
+++ b/sdks/python/apache_beam/metrics/cells_test.py
@@ -17,9 +17,13 @@
 
 # pytype: skip-file
 
+import copy
+import itertools
+import random
 import threading
 import unittest
 
+from apache_beam.metrics.cells import BoundedTrieData
 from apache_beam.metrics.cells import CounterCell
 from apache_beam.metrics.cells import DistributionCell
 from apache_beam.metrics.cells import DistributionData
@@ -27,6 +31,7 @@
 from apache_beam.metrics.cells import GaugeData
 from apache_beam.metrics.cells import StringSetCell
 from apache_beam.metrics.cells import StringSetData
+from apache_beam.metrics.cells import _BoundedTrieNode
 from apache_beam.metrics.metricbase import MetricName
 
 
@@ -203,5 +208,218 @@ def test_add_size_tracked_correctly(self):
     self.assertEqual(s.data.string_size, 3)
 
 
+class TestBoundedTrieNode(unittest.TestCase):
+  @classmethod
+  def random_segments_fixed_depth(cls, n, depth, overlap, rand):
+    if depth == 0:
+      yield from ((), ) * n
+    else:
+      seen = []
+      to_string = lambda ix: chr(ord('a') + ix) if ix < 26 else f'z{ix}'
+      for suffix in cls.random_segments_fixed_depth(n, depth - 1, overlap,
+                                                    rand):
+        if not seen or rand.random() > overlap:
+          prefix = to_string(len(seen))
+          seen.append(prefix)
+        else:
+          prefix = rand.choice(seen)
+        yield (prefix, ) + suffix
+
+  @classmethod
+  def random_segments(cls, n, min_depth, max_depth, overlap, rand):
+    for depth, segments in zip(
+        itertools.cycle(range(min_depth, max_depth + 1)),
+        cls.random_segments_fixed_depth(n, max_depth, overlap, rand)):
+      yield segments[:depth]
+
+  def assert_covers(self, node, expected, max_truncated=0):
+    self.assert_covers_flattened(node.flattened(), expected, max_truncated)
+
+  def assert_covers_flattened(self, flattened, expected, max_truncated=0):
+    expected = set(expected)
+    # Split node into the exact and truncated segments.
+    partitioned = {True: set(), False: set()}
+    for segments in flattened:
+      partitioned[segments[-1]].add(segments[:-1])
+    exact, truncated = partitioned[False], partitioned[True]
+    # Check we cover both parts.
+    self.assertLessEqual(len(truncated), max_truncated, truncated)
+    self.assertTrue(exact.issubset(expected), exact - expected)
+    seen_truncated = set()
+    for segments in expected - exact:
+      found = 0
+      for ix in range(len(segments)):
+        if segments[:ix] in truncated:
+          seen_truncated.add(segments[:ix])
+          found += 1
+      if found != 1:
+        self.fail(
+            f"Expected exactly one prefix of {segments} "
+            f"to occur in {truncated}, found {found}")
+    self.assertEqual(seen_truncated, truncated, truncated - seen_truncated)
+
+  def run_covers_test(self, flattened, expected, max_truncated):
+    def parse(s):
+      return tuple(s.strip('*')) + (s.endswith('*'), )
+
+    self.assert_covers_flattened([parse(s) for s in flattened],
+                                 [tuple(s) for s in expected],
+                                 max_truncated)
+
+  def test_covers_exact(self):
+    self.run_covers_test(['ab', 'ac', 'cd'], ['ab', 'ac', 'cd'], 0)
+    with self.assertRaises(AssertionError):
+      self.run_covers_test(['ab', 'ac', 'cd'], ['ac', 'cd'], 0)
+    with self.assertRaises(AssertionError):
+      self.run_covers_test(['ab', 'ac'], ['ab', 'ac', 'cd'], 0)
+    with self.assertRaises(AssertionError):
+      self.run_covers_test(['a*', 'cd'], ['ab', 'ac', 'cd'], 0)
+
+  def test_covers_trunacted(self):
+    self.run_covers_test(['a*', 'cd'], ['ab', 'ac', 'cd'], 1)
+    self.run_covers_test(['a*', 'cd'], ['ab', 'ac', 'abcde', 'cd'], 1)
+    with self.assertRaises(AssertionError):
+      self.run_covers_test(['ab', 'ac', 'cd'], ['ac', 'cd'], 1)
+    with self.assertRaises(AssertionError):
+      self.run_covers_test(['ab', 'ac'], ['ab', 'ac', 'cd'], 1)
+    with self.assertRaises(AssertionError):
+      self.run_covers_test(['a*', 'c*'], ['ab', 'ac', 'cd'], 1)
+    with self.assertRaises(AssertionError):
+      self.run_covers_test(['a*', 'c*'], ['ab', 'ac'], 1)
+
+  def run_test(self, to_add):
+    everything = list(set(to_add))
+    all_prefixees = set(
+        segments[:ix] for segments in everything for ix in range(len(segments)))
+    everything_deduped = set(everything) - all_prefixees
+
+    # Check basic addition.
+    node = _BoundedTrieNode()
+    total_size = node.size()
+    self.assertEqual(total_size, 1)
+    for segments in everything:
+      total_size += node.add(segments)
+    self.assertEqual(node.size(), len(everything_deduped), node)
+    self.assertEqual(node.size(), total_size, node)
+    self.assert_covers(node, everything_deduped)
+
+    # Check merging
+    node0 = _BoundedTrieNode()
+    node0.add_all(everything[0::2])
+    node1 = _BoundedTrieNode()
+    node1.add_all(everything[1::2])
+    pre_merge_size = node0.size()
+    merge_delta = node0.merge(node1)
+    self.assertEqual(node0.size(), pre_merge_size + merge_delta)
+    self.assertEqual(node0, node)
+
+    # Check trimming.
+    if node.size() > 1:
+      trim_delta = node.trim()
+      self.assertLess(trim_delta, 0, node)
+      self.assertEqual(node.size(), total_size + trim_delta)
+      self.assert_covers(node, everything_deduped, max_truncated=1)
+
+    if node.size() > 1:
+      trim2_delta = node.trim()
+      self.assertLess(trim2_delta, 0)
+      self.assertEqual(node.size(), total_size + trim_delta + trim2_delta)
+      self.assert_covers(node, everything_deduped, max_truncated=2)
+
+    # Adding after trimming should be a no-op.
+    node_copy = copy.deepcopy(node)
+    for segments in everything:
+      self.assertEqual(node.add(segments), 0)
+    self.assertEqual(node, node_copy)
+
+    # Merging after trimming should be a no-op.
+    self.assertEqual(node.merge(node0), 0)
+    self.assertEqual(node.merge(node1), 0)
+    self.assertEqual(node, node_copy)
+
+    if node._truncated:
+      expected_delta = 0
+    else:
+      expected_delta = 2
+
+    # Adding something new is not.
+    new_values = [('new1', ), ('new2', 'new2.1')]
+    self.assertEqual(node.add_all(new_values), expected_delta)
+    self.assert_covers(
+        node, list(everything_deduped) + new_values, max_truncated=2)
+
+    # Nor is merging something new.
+    new_values_node = _BoundedTrieNode()
+    new_values_node.add_all(new_values)
+    self.assertEqual(node_copy.merge(new_values_node), expected_delta)
+    self.assert_covers(
+        node_copy, list(everything_deduped) + new_values, max_truncated=2)
+
+  def run_fuzz(self, iterations=10, **params):
+    for _ in range(iterations):
+      seed = random.getrandbits(64)
+      segments = self.random_segments(**params, rand=random.Random(seed))
+      try:
+        self.run_test(segments)
+      except:
+        print("SEED", seed)
+        raise
+
+  def test_trivial(self):
+    self.run_test([('a', 'b'), ('a', 'c')])
+
+  def test_flat(self):
+    self.run_test([('a', 'a'), ('b', 'b'), ('c', 'c')])
+
+  def test_deep(self):
+    self.run_test([('a', ) * 10, ('b', ) * 12])
+
+  def test_small(self):
+    self.run_fuzz(n=5, min_depth=2, max_depth=3, overlap=0.5)
+
+  def test_medium(self):
+    self.run_fuzz(n=20, min_depth=2, max_depth=4, overlap=0.5)
+
+  def test_large_sparse(self):
+    self.run_fuzz(n=120, min_depth=2, max_depth=4, overlap=0.2)
+
+  def test_large_dense(self):
+    self.run_fuzz(n=120, min_depth=2, max_depth=4, overlap=0.8)
+
+  def test_bounded_trie_data_combine(self):
+    empty = BoundedTrieData()
+    # The merging here isn't complicated we're just ensuring that
+    # BoundedTrieData invokes _BoundedTrieNode correctly.
+    singletonA = BoundedTrieData(singleton=('a', 'a'))
+    singletonB = BoundedTrieData(singleton=('b', 'b'))
+    lots_root = _BoundedTrieNode()
+    lots_root.add_all([('c', 'c'), ('d', 'd')])
+    lots = BoundedTrieData(root=lots_root)
+    self.assertEqual(empty.get_result(), set())
+    self.assertEqual(
+        empty.combine(singletonA).get_result(), set([('a', 'a', False)]))
+    self.assertEqual(
+        singletonA.combine(empty).get_result(), set([('a', 'a', False)]))
+    self.assertEqual(
+        singletonA.combine(singletonB).get_result(),
+        set([('a', 'a', False), ('b', 'b', False)]))
+    self.assertEqual(
+        singletonA.combine(lots).get_result(),
+        set([('a', 'a', False), ('c', 'c', False), ('d', 'd', False)]))
+    self.assertEqual(
+        lots.combine(singletonA).get_result(),
+        set([('a', 'a', False), ('c', 'c', False), ('d', 'd', False)]))
+
+  def test_bounded_trie_data_combine_trim(self):
+    left = _BoundedTrieNode()
+    left.add_all([('a', 'x'), ('b', 'd')])
+    right = _BoundedTrieNode()
+    right.add_all([('a', 'y'), ('c', 'd')])
+    self.assertEqual(
+        BoundedTrieData(root=left).combine(
+            BoundedTrieData(root=right, bound=3)).get_result(),
+        set([('a', True), ('b', 'd', False), ('c', 'd', False)]))
+
+
 if __name__ == '__main__':
   unittest.main()

From f83c6836ba0625dcdd86882c277edc0811fb0367 Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Mon, 25 Nov 2024 11:55:15 -0800
Subject: [PATCH 031/135] Bounded Trie proto representation.

---
 .../beam/model/pipeline/v1/metrics.proto      | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/model/pipeline/src/main/proto/org/apache/beam/model/pipeline/v1/metrics.proto b/model/pipeline/src/main/proto/org/apache/beam/model/pipeline/v1/metrics.proto
index 4ec189e4637f..33bb5ae729f8 100644
--- a/model/pipeline/src/main/proto/org/apache/beam/model/pipeline/v1/metrics.proto
+++ b/model/pipeline/src/main/proto/org/apache/beam/model/pipeline/v1/metrics.proto
@@ -198,6 +198,17 @@ message MonitoringInfoSpecs {
       }]
     }];
 
+    // Represents a set of strings seen across bundles.
+    USER_BOUNDED_TRIE = 22 [(monitoring_info_spec) = {
+      urn: "beam:metric:user:bounded_trie:v1",
+      type: "beam:metrics:bounded_trie:v1",
+      required_labels: ["PTRANSFORM", "NAMESPACE", "NAME"],
+      annotations: [{
+        key: "description",
+        value: "URN utilized to report user metric."
+      }]
+    }];
+
     // General monitored state information which contains structured information
     // which does not fit into a typical metric format. See MonitoringTableData
     // for more details.
@@ -576,6 +587,12 @@ message MonitoringInfoTypeUrns {
     SET_STRING_TYPE = 11 [(org.apache.beam.model.pipeline.v1.beam_urn) =
       "beam:metrics:set_string:v1"];
 
+    // Represents a bounded trie of strings.
+    //
+    // Encoding: BoundedTrie proto
+    BOUNDED_TRIE_TYPE = 12 [(org.apache.beam.model.pipeline.v1.beam_urn) =
+      "beam:metrics:bounded_trie:v1"];
+
     // General monitored state information which contains structured information
     // which does not fit into a typical metric format. See MonitoringTableData
     // for more details.
@@ -588,6 +605,30 @@ message MonitoringInfoTypeUrns {
   }
 }
 
+
+// A single node in a BoundedTrie.
+message BoundedTrieNode {
+  // Whether this node has been truncated.
+  // A truncated leaf represents possibly many children with the same prefix.
+  bool truncated = 1;
+
+  // Children of this node.  Must be empty if truncated is true.
+  map<string, BoundedTrieNode> children = 2;
+}
+
+// The message type used for encoding metrics of type bounded trie.
+message BoundedTrie {
+  // The maximum number of elements to store before truncation.
+  int32 bound = 1;
+
+  // A compact representation of all the elements in this trie.
+  BoundedTrieNode root = 2;
+
+  // A more efficient representation for metrics consisting of a single value.
+  repeated string singleton = 3;
+}
+
+
 // General monitored state information which contains structured information
 // which does not fit into a typical metric format.
 //

From d8358cb95b07d290a4e2b50ef1e9ddbb128fad98 Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Mon, 25 Nov 2024 17:53:13 -0800
Subject: [PATCH 032/135] Bounded Trie translation.

---
 sdks/python/apache_beam/metrics/cells.py      | 38 +++++++++++++++++++
 .../apache_beam/metrics/monitoring_infos.py   | 24 +++++++++++-
 2 files changed, 61 insertions(+), 1 deletion(-)

diff --git a/sdks/python/apache_beam/metrics/cells.py b/sdks/python/apache_beam/metrics/cells.py
index f04468b00b5f..e044693a6e9a 100644
--- a/sdks/python/apache_beam/metrics/cells.py
+++ b/sdks/python/apache_beam/metrics/cells.py
@@ -32,6 +32,8 @@
 from typing import Optional
 from typing import Set
 
+from apache_beam.portability.api import metrics_pb2
+
 try:
   import cython
 except ImportError:
@@ -669,6 +671,29 @@ def __init__(self):
     self._children: Optional[dict[str, '_BoundedTrieNode']] = {}
     self._truncated = False
 
+  def to_proto(self) -> metrics_pb2.BoundedTrieNode:
+    return metrics_pb2.BoundedTrieNode(
+        truncated=self._truncated,
+        children={
+            name: child.to_proto()
+            for name, child in self._children.items()
+        } if self._children else None)
+
+  @staticmethod
+  def from_proto(proto: metrics_pb2.BoundedTrieNode) -> '_BoundedTrieNode':
+    node = _BoundedTrieNode()
+    if proto.truncated:
+      node._truncated = True
+      node._children = None
+    else:
+      node._children = {
+          name: _BoundedTrieNode.from_proto(child)
+          for name,
+          child in proto.children.items()
+      }
+      node._size = min(1, sum(child._size for child in node._children.values()))
+    return node
+
   def size(self):
     return self._size
 
@@ -764,6 +789,19 @@ def __init__(self, *, root=None, singleton=None, bound=_DEFAULT_BOUND):
     self._root = root
     self._bound = bound
 
+  def to_proto(self) -> metrics_pb2.BoundedTrie:
+    return metrics_pb2.BoundedTrie(
+        bound=self._bound,
+        singleton=self._singlton if self._singleton else None,
+        root=self._root.to_proto() if self._root else None)
+
+  @staticmethod
+  def from_proto(proto: metrics_pb2.BoundedTrie) -> 'BoundedTrieData':
+    return BoundedTrieData(
+        bound=proto.bound,
+        singleton=tuple(proto.singleton) if proto.singleton else None,
+        root=_BoundedTrieNode.from_proto(proto.root) if proto.root else None)
+
   def as_trie(self):
     if self._root is not None:
       return self._root
diff --git a/sdks/python/apache_beam/metrics/monitoring_infos.py b/sdks/python/apache_beam/metrics/monitoring_infos.py
index 5227a4c9872b..397fcc578d53 100644
--- a/sdks/python/apache_beam/metrics/monitoring_infos.py
+++ b/sdks/python/apache_beam/metrics/monitoring_infos.py
@@ -50,11 +50,14 @@
     common_urns.monitoring_info_specs.USER_DISTRIBUTION_INT64.spec.urn)
 USER_GAUGE_URN = common_urns.monitoring_info_specs.USER_LATEST_INT64.spec.urn
 USER_STRING_SET_URN = common_urns.monitoring_info_specs.USER_SET_STRING.spec.urn
+USER_BOUNDED_TRIE_URN = (
+    common_urns.monitoring_info_specs.USER_BOUNDED_TRIE.spec.urn)
 USER_METRIC_URNS = set([
     USER_COUNTER_URN,
     USER_DISTRIBUTION_URN,
     USER_GAUGE_URN,
-    USER_STRING_SET_URN
+    USER_STRING_SET_URN,
+    USER_BOUNDED_TRIE_URN,
 ])
 WORK_REMAINING_URN = common_urns.monitoring_info_specs.WORK_REMAINING.spec.urn
 WORK_COMPLETED_URN = common_urns.monitoring_info_specs.WORK_COMPLETED.spec.urn
@@ -72,11 +75,13 @@
 LATEST_INT64_TYPE = common_urns.monitoring_info_types.LATEST_INT64_TYPE.urn
 PROGRESS_TYPE = common_urns.monitoring_info_types.PROGRESS_TYPE.urn
 STRING_SET_TYPE = common_urns.monitoring_info_types.SET_STRING_TYPE.urn
+BOUNDED_TRIE_TYPE = common_urns.monitoring_info_types.BOUNDED_TRIE_TYPE.urn
 
 COUNTER_TYPES = set([SUM_INT64_TYPE])
 DISTRIBUTION_TYPES = set([DISTRIBUTION_INT64_TYPE])
 GAUGE_TYPES = set([LATEST_INT64_TYPE])
 STRING_SET_TYPES = set([STRING_SET_TYPE])
+BOUNDED_TRIE_TYPES = set([BOUNDED_TRIE_TYPE])
 
 # TODO(migryz) extract values from beam_fn_api.proto::MonitoringInfoLabels
 PCOLLECTION_LABEL = (
@@ -320,6 +325,23 @@ def user_set_string(namespace, name, metric, ptransform=None):
       USER_STRING_SET_URN, STRING_SET_TYPE, metric, labels)
 
 
+def user_bounded_trie(namespace, name, metric, ptransform=None):
+  """Return the string set monitoring info for the URN, metric and labels.
+
+  Args:
+    namespace: User-defined namespace of BoundedTrie.
+    name: Name of BoundedTrie.
+    metric: The BoundedTrieData representing the metrics.
+    ptransform: The ptransform id used as a label.
+  """
+  labels = create_labels(ptransform=ptransform, namespace=namespace, name=name)
+  return create_monitoring_info(
+      USER_BOUNDED_TRIE_URN,
+      BOUNDED_TRIE_TYPE,
+      metric.to_proto().SerializeToString(),
+      labels)
+
+
 def create_monitoring_info(
     urn, type_urn, payload, labels=None) -> metrics_pb2.MonitoringInfo:
   """Return the gauge monitoring info for the URN, type, metric and labels.

From 5a6c90287198cc42fedf6d9623c8239d21f6ac74 Mon Sep 17 00:00:00 2001
From: liferoad <huxiangqian@gmail.com>
Date: Tue, 26 Nov 2024 19:05:41 -0500
Subject: [PATCH 033/135] Make the model names unique and fix the tox package
 deps for tensorflow tests (#33216)

* make the model names unique

* fixed lint

* pin keras==3.6.0

* pin keras==2.12.0

* pin tf_keras==2.18.0

* pin tensorflow==2.18.0

* use 1 worker for pytest

* Fixed the tensorflow version
---
 .../trigger_files/beam_PostCommit_Python_Dependency.json | 4 ++++
 .../ml/inference/tensorflow_inference_test.py            | 9 +++++----
 sdks/python/tox.ini                                      | 5 +++--
 3 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/.github/trigger_files/beam_PostCommit_Python_Dependency.json b/.github/trigger_files/beam_PostCommit_Python_Dependency.json
index e69de29bb2d1..a7fc54b3e4bb 100644
--- a/.github/trigger_files/beam_PostCommit_Python_Dependency.json
+++ b/.github/trigger_files/beam_PostCommit_Python_Dependency.json
@@ -0,0 +1,4 @@
+{
+    "comment": "Modify this file in a trivial way to cause this test suite to run",
+    "modification": 1
+  }
\ No newline at end of file
diff --git a/sdks/python/apache_beam/ml/inference/tensorflow_inference_test.py b/sdks/python/apache_beam/ml/inference/tensorflow_inference_test.py
index 52123516de1a..dc35aa016013 100644
--- a/sdks/python/apache_beam/ml/inference/tensorflow_inference_test.py
+++ b/sdks/python/apache_beam/ml/inference/tensorflow_inference_test.py
@@ -21,6 +21,7 @@
 import shutil
 import tempfile
 import unittest
+import uuid
 from typing import Any
 from typing import Dict
 from typing import Iterable
@@ -127,7 +128,7 @@ def test_predict_tensor(self):
 
   def test_predict_tensor_with_batch_size(self):
     model = _create_mult2_model()
-    model_path = os.path.join(self.tmpdir, 'mult2.keras')
+    model_path = os.path.join(self.tmpdir, f'mult2_{uuid.uuid4()}.keras')
     tf.keras.models.save_model(model, model_path)
     with TestPipeline() as pipeline:
 
@@ -173,7 +174,7 @@ def fake_batching_inference_fn(
 
   def test_predict_tensor_with_large_model(self):
     model = _create_mult2_model()
-    model_path = os.path.join(self.tmpdir, 'mult2.keras')
+    model_path = os.path.join(self.tmpdir, f'mult2_{uuid.uuid4()}.keras')
     tf.keras.models.save_model(model, model_path)
     with TestPipeline() as pipeline:
 
@@ -220,7 +221,7 @@ def fake_batching_inference_fn(
 
   def test_predict_numpy_with_batch_size(self):
     model = _create_mult2_model()
-    model_path = os.path.join(self.tmpdir, 'mult2_numpy.keras')
+    model_path = os.path.join(self.tmpdir, f'mult2_{uuid.uuid4()}.keras')
     tf.keras.models.save_model(model, model_path)
     with TestPipeline() as pipeline:
 
@@ -263,7 +264,7 @@ def fake_batching_inference_fn(
 
   def test_predict_numpy_with_large_model(self):
     model = _create_mult2_model()
-    model_path = os.path.join(self.tmpdir, 'mult2_numpy.keras')
+    model_path = os.path.join(self.tmpdir, f'mult2_{uuid.uuid4()}.keras')
     tf.keras.models.save_model(model, model_path)
     with TestPipeline() as pipeline:
 
diff --git a/sdks/python/tox.ini b/sdks/python/tox.ini
index 85f71e559c15..7a2424325890 100644
--- a/sdks/python/tox.ini
+++ b/sdks/python/tox.ini
@@ -410,8 +410,9 @@ deps =
     tensorflow>=2.12rc1,<2.13
     # Help pip resolve conflict with typing-extensions for old version of TF https://github.com/apache/beam/issues/30852
     pydantic<2.7
-    protobuf==4.25.5
-extras = test,gcp,ml_test
+extras = test,gcp
+commands_pre =
+  pip install -U 'protobuf==4.25.5'
 commands =
   # Log tensorflow version for debugging
   /bin/sh -c "pip freeze | grep -E tensorflow"

From 96962011e7e323c568a6594fd1d93a3b8b6a4861 Mon Sep 17 00:00:00 2001
From: Yi Hu <yathu@google.com>
Date: Wed, 27 Nov 2024 09:49:03 -0500
Subject: [PATCH 034/135] Unpin Dataflow legacy worker container for Nexmark
 test (#33224)

---
 .../trigger_files/beam_PostCommit_Java_Nexmark_Dataflow.json  | 1 +
 sdks/java/testing/nexmark/build.gradle                        | 4 ----
 2 files changed, 1 insertion(+), 4 deletions(-)
 create mode 100644 .github/trigger_files/beam_PostCommit_Java_Nexmark_Dataflow.json

diff --git a/.github/trigger_files/beam_PostCommit_Java_Nexmark_Dataflow.json b/.github/trigger_files/beam_PostCommit_Java_Nexmark_Dataflow.json
new file mode 100644
index 000000000000..0967ef424bce
--- /dev/null
+++ b/.github/trigger_files/beam_PostCommit_Java_Nexmark_Dataflow.json
@@ -0,0 +1 @@
+{}
diff --git a/sdks/java/testing/nexmark/build.gradle b/sdks/java/testing/nexmark/build.gradle
index a09ed9238991..0a09c357ed57 100644
--- a/sdks/java/testing/nexmark/build.gradle
+++ b/sdks/java/testing/nexmark/build.gradle
@@ -119,11 +119,7 @@ def getNexmarkArgs = {
       }
     } else {
       def dataflowWorkerJar = project.findProperty('dataflowWorkerJar') ?: project(":runners:google-cloud-dataflow-java:worker").shadowJar.archivePath
-      // Provide job with a customizable worker jar.
-      // With legacy worker jar, containerImage is set to empty (i.e. to use the internal build).
-      // More context and discussions can be found in PR#6694.
       nexmarkArgsList.add("--dataflowWorkerJar=${dataflowWorkerJar}".toString())
-      nexmarkArgsList.add('--workerHarnessContainerImage=')
 
       def nexmarkProfile =  project.findProperty(nexmarkProfilingProperty) ?: ""
       if (nexmarkProfile.equals("true")) {

From 9560fe1d18eabc849b62c89698097d84a7452008 Mon Sep 17 00:00:00 2001
From: Bartosz Zablocki <bzablocki@google.com>
Date: Wed, 27 Nov 2024 14:50:04 +0000
Subject: [PATCH 035/135] SolaceIO: refactor to allow inheritance of
 BasicAuthSempClient (#32400)

* Refactored to allow inheritance and overriding of BasicAuthSempClient

* Fix docs and use Map#computeIfAbsent with a lambda.

* Fix integration test

* Remove 'serializable'

* Revert 'Remove 'serializable''
---
 .../io/solace/broker/BasicAuthSempClient.java |  31 +--
 .../broker/SempBasicAuthClientExecutor.java   |  35 ++-
 .../sdk/io/solace/write/AddShardKeyDoFn.java  |   5 +-
 .../it/BasicAuthMultipleSempClient.java       |  62 ++++++
 .../BasicAuthMultipleSempClientFactory.java   |  92 ++++++++
 .../io/solace/it/SolaceIOMultipleSempIT.java  | 207 ++++++++++++++++++
 6 files changed, 403 insertions(+), 29 deletions(-)
 create mode 100644 sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/BasicAuthMultipleSempClient.java
 create mode 100644 sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/BasicAuthMultipleSempClientFactory.java
 create mode 100644 sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/SolaceIOMultipleSempIT.java

diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthSempClient.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthSempClient.java
index 4884bb61e628..0a9ee4618b1e 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthSempClient.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthSempClient.java
@@ -17,14 +17,10 @@
  */
 package org.apache.beam.sdk.io.solace.broker;
 
-import com.fasterxml.jackson.core.JsonProcessingException;
-import com.fasterxml.jackson.databind.DeserializationFeature;
-import com.fasterxml.jackson.databind.ObjectMapper;
 import com.google.api.client.http.HttpRequestFactory;
 import com.solacesystems.jcsmp.JCSMPFactory;
 import java.io.IOException;
 import org.apache.beam.sdk.annotations.Internal;
-import org.apache.beam.sdk.io.solace.data.Semp.Queue;
 import org.apache.beam.sdk.util.SerializableSupplier;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -40,8 +36,6 @@
 @Internal
 public class BasicAuthSempClient implements SempClient {
   private static final Logger LOG = LoggerFactory.getLogger(BasicAuthSempClient.class);
-  private final ObjectMapper objectMapper =
-      new ObjectMapper().configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
 
   private final SempBasicAuthClientExecutor sempBasicAuthClientExecutor;
 
@@ -58,13 +52,12 @@ public BasicAuthSempClient(
 
   @Override
   public boolean isQueueNonExclusive(String queueName) throws IOException {
-    LOG.info("SolaceIO.Read: SempOperations: query SEMP if queue {} is nonExclusive", queueName);
-    BrokerResponse response = sempBasicAuthClientExecutor.getQueueResponse(queueName);
-    if (response.content == null) {
-      throw new IOException("SolaceIO: response from SEMP is empty!");
-    }
-    Queue q = mapJsonToClass(response.content, Queue.class);
-    return q.data().accessType().equals("non-exclusive");
+    boolean queueNonExclusive = sempBasicAuthClientExecutor.isQueueNonExclusive(queueName);
+    LOG.info(
+        "SolaceIO.Read: SempOperations: queried SEMP if queue {} is non-exclusive: {}",
+        queueName,
+        queueNonExclusive);
+    return queueNonExclusive;
   }
 
   @Override
@@ -77,12 +70,7 @@ public com.solacesystems.jcsmp.Queue createQueueForTopic(String queueName, Strin
 
   @Override
   public long getBacklogBytes(String queueName) throws IOException {
-    BrokerResponse response = sempBasicAuthClientExecutor.getQueueResponse(queueName);
-    if (response.content == null) {
-      throw new IOException("SolaceIO: response from SEMP is empty!");
-    }
-    Queue q = mapJsonToClass(response.content, Queue.class);
-    return q.data().msgSpoolUsage();
+    return sempBasicAuthClientExecutor.getBacklogBytes(queueName);
   }
 
   private void createQueue(String queueName) throws IOException {
@@ -94,9 +82,4 @@ private void createSubscription(String queueName, String topicName) throws IOExc
     LOG.info("SolaceIO.Read: Creating new subscription {} for topic {}.", queueName, topicName);
     sempBasicAuthClientExecutor.createSubscriptionResponse(queueName, topicName);
   }
-
-  private <T> T mapJsonToClass(String content, Class<T> mapSuccessToClass)
-      throws JsonProcessingException {
-    return objectMapper.readValue(content, mapSuccessToClass);
-  }
 }
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SempBasicAuthClientExecutor.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SempBasicAuthClientExecutor.java
index 99a81f716435..965fc8741374 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SempBasicAuthClientExecutor.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SempBasicAuthClientExecutor.java
@@ -19,6 +19,9 @@
 
 import static org.apache.beam.sdk.util.Preconditions.checkStateNotNull;
 
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.DeserializationFeature;
+import com.fasterxml.jackson.databind.ObjectMapper;
 import com.google.api.client.http.GenericUrl;
 import com.google.api.client.http.HttpContent;
 import com.google.api.client.http.HttpHeaders;
@@ -40,6 +43,7 @@
 import java.util.Objects;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.stream.Collectors;
+import org.apache.beam.sdk.io.solace.data.Semp.Queue;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableMap;
 import org.checkerframework.checker.nullness.qual.Nullable;
 
@@ -52,7 +56,7 @@
  * response is 401 Unauthorized, the client will execute an additional request with Basic Auth
  * header to refresh the token.
  */
-class SempBasicAuthClientExecutor implements Serializable {
+public class SempBasicAuthClientExecutor implements Serializable {
   // Every request will be repeated 2 times in case of abnormal connection failures.
   private static final int REQUEST_NUM_RETRIES = 2;
   private static final Map<CookieManagerKey, CookieManager> COOKIE_MANAGER_MAP =
@@ -65,8 +69,10 @@ class SempBasicAuthClientExecutor implements Serializable {
   private final String password;
   private final CookieManagerKey cookieManagerKey;
   private final transient HttpRequestFactory requestFactory;
+  private final ObjectMapper objectMapper =
+      new ObjectMapper().configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
 
-  SempBasicAuthClientExecutor(
+  public SempBasicAuthClientExecutor(
       String host,
       String username,
       String password,
@@ -78,7 +84,16 @@ class SempBasicAuthClientExecutor implements Serializable {
     this.password = password;
     this.requestFactory = httpRequestFactory;
     this.cookieManagerKey = new CookieManagerKey(this.baseUrl, this.username);
-    COOKIE_MANAGER_MAP.putIfAbsent(this.cookieManagerKey, new CookieManager());
+    COOKIE_MANAGER_MAP.computeIfAbsent(this.cookieManagerKey, key -> new CookieManager());
+  }
+
+  public boolean isQueueNonExclusive(String queueName) throws IOException {
+    BrokerResponse response = getQueueResponse(queueName);
+    if (response.content == null) {
+      throw new IOException("SolaceIO: response from SEMP is empty!");
+    }
+    Queue q = mapJsonToClass(response.content, Queue.class);
+    return q.data().accessType().equals("non-exclusive");
   }
 
   private static String getQueueEndpoint(String messageVpn, String queueName)
@@ -199,6 +214,20 @@ private static String urlEncode(String queueName) throws UnsupportedEncodingExce
     return URLEncoder.encode(queueName, StandardCharsets.UTF_8.name());
   }
 
+  private <T> T mapJsonToClass(String content, Class<T> mapSuccessToClass)
+      throws JsonProcessingException {
+    return objectMapper.readValue(content, mapSuccessToClass);
+  }
+
+  public long getBacklogBytes(String queueName) throws IOException {
+    BrokerResponse response = getQueueResponse(queueName);
+    if (response.content == null) {
+      throw new IOException("SolaceIO: response from SEMP is empty!");
+    }
+    Queue q = mapJsonToClass(response.content, Queue.class);
+    return q.data().msgSpoolUsage();
+  }
+
   private static class CookieManagerKey implements Serializable {
     private final String baseUrl;
     private final String username;
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/write/AddShardKeyDoFn.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/write/AddShardKeyDoFn.java
index 12d8a8507d8a..c55d37942c72 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/write/AddShardKeyDoFn.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/write/AddShardKeyDoFn.java
@@ -23,8 +23,9 @@
 import org.apache.beam.sdk.values.KV;
 
 /**
- * This class a pseudo-key with a given cardinality. The downstream steps will use state {@literal
- * &} timers to distribute the data and control for the number of parallel workers used for writing.
+ * This class adds pseudo-key with a given cardinality. The downstream steps will use state
+ * {@literal &} timers to distribute the data and control for the number of parallel workers used
+ * for writing.
  */
 @Internal
 public class AddShardKeyDoFn extends DoFn<Solace.Record, KV<Integer, Solace.Record>> {
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/BasicAuthMultipleSempClient.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/BasicAuthMultipleSempClient.java
new file mode 100644
index 000000000000..637cecdcfd15
--- /dev/null
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/BasicAuthMultipleSempClient.java
@@ -0,0 +1,62 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.beam.sdk.io.solace.it;
+
+import com.google.api.client.http.HttpRequestFactory;
+import java.io.IOException;
+import java.util.List;
+import java.util.stream.Collectors;
+import org.apache.beam.sdk.io.solace.broker.BasicAuthSempClient;
+import org.apache.beam.sdk.io.solace.broker.SempBasicAuthClientExecutor;
+import org.apache.beam.sdk.util.SerializableSupplier;
+
+/**
+ * Example class showing how the {@link BasicAuthSempClient} can be extended or have functionalities
+ * overridden. In this case, the modified method is {@link
+ * BasicAuthSempClient#getBacklogBytes(String)}, which queries multiple SEMP endpoints to collect
+ * accurate backlog metrics. For usage, see {@link SolaceIOMultipleSempIT}.
+ */
+public class BasicAuthMultipleSempClient extends BasicAuthSempClient {
+  private final List<SempBasicAuthClientExecutor> sempBacklogBasicAuthClientExecutors;
+
+  public BasicAuthMultipleSempClient(
+      String mainHost,
+      List<String> backlogHosts,
+      String username,
+      String password,
+      String vpnName,
+      SerializableSupplier<HttpRequestFactory> httpRequestFactorySupplier) {
+    super(mainHost, username, password, vpnName, httpRequestFactorySupplier);
+    sempBacklogBasicAuthClientExecutors =
+        backlogHosts.stream()
+            .map(
+                host ->
+                    new SempBasicAuthClientExecutor(
+                        host, username, password, vpnName, httpRequestFactorySupplier.get()))
+            .collect(Collectors.toList());
+  }
+
+  @Override
+  public long getBacklogBytes(String queueName) throws IOException {
+    long backlog = 0;
+    for (SempBasicAuthClientExecutor client : sempBacklogBasicAuthClientExecutors) {
+      backlog += client.getBacklogBytes(queueName);
+    }
+    return backlog;
+  }
+}
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/BasicAuthMultipleSempClientFactory.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/BasicAuthMultipleSempClientFactory.java
new file mode 100644
index 000000000000..0a548c10555c
--- /dev/null
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/BasicAuthMultipleSempClientFactory.java
@@ -0,0 +1,92 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.beam.sdk.io.solace.it;
+
+import com.google.api.client.http.HttpRequestFactory;
+import com.google.api.client.http.javanet.NetHttpTransport;
+import com.google.auto.value.AutoValue;
+import java.util.List;
+import org.apache.beam.sdk.io.solace.broker.SempClient;
+import org.apache.beam.sdk.io.solace.broker.SempClientFactory;
+import org.apache.beam.sdk.util.SerializableSupplier;
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.checkerframework.checker.nullness.qual.Nullable;
+
+/**
+ * Example class showing how to implement a custom {@link SempClientFactory} with custom client. For
+ * usage, see {@link SolaceIOMultipleSempIT}.
+ */
+@AutoValue
+public abstract class BasicAuthMultipleSempClientFactory implements SempClientFactory {
+
+  public abstract String mainHost();
+
+  public abstract List<String> backlogHosts();
+
+  public abstract String username();
+
+  public abstract String password();
+
+  public abstract String vpnName();
+
+  public abstract @Nullable SerializableSupplier<HttpRequestFactory> httpRequestFactorySupplier();
+
+  public static Builder builder() {
+    return new AutoValue_BasicAuthMultipleSempClientFactory.Builder();
+  }
+
+  @AutoValue.Builder
+  public abstract static class Builder {
+    /** Set Solace host, format: [Protocol://]Host[:Port]. */
+    public abstract Builder mainHost(String host);
+
+    public abstract Builder backlogHosts(List<String> hosts);
+
+    /** Set Solace username. */
+    public abstract Builder username(String username);
+    /** Set Solace password. */
+    public abstract Builder password(String password);
+
+    /** Set Solace vpn name. */
+    public abstract Builder vpnName(String vpnName);
+
+    abstract Builder httpRequestFactorySupplier(
+        SerializableSupplier<HttpRequestFactory> httpRequestFactorySupplier);
+
+    public abstract BasicAuthMultipleSempClientFactory build();
+  }
+
+  @Override
+  public SempClient create() {
+    return new BasicAuthMultipleSempClient(
+        mainHost(),
+        backlogHosts(),
+        username(),
+        password(),
+        vpnName(),
+        getHttpRequestFactorySupplier());
+  }
+
+  @SuppressWarnings("return")
+  private @NonNull SerializableSupplier<HttpRequestFactory> getHttpRequestFactorySupplier() {
+    SerializableSupplier<HttpRequestFactory> httpRequestSupplier = httpRequestFactorySupplier();
+    return httpRequestSupplier != null
+        ? httpRequestSupplier
+        : () -> new NetHttpTransport().createRequestFactory();
+  }
+}
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/SolaceIOMultipleSempIT.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/SolaceIOMultipleSempIT.java
new file mode 100644
index 000000000000..77d00b4e41ec
--- /dev/null
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/it/SolaceIOMultipleSempIT.java
@@ -0,0 +1,207 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.beam.sdk.io.solace.it;
+
+import static org.apache.beam.sdk.io.solace.it.SolaceContainerManager.TOPIC_NAME;
+import static org.apache.beam.sdk.values.TypeDescriptors.strings;
+import static org.junit.Assert.assertEquals;
+
+import com.solacesystems.jcsmp.DeliveryMode;
+import java.io.IOException;
+import java.util.Arrays;
+import org.apache.beam.sdk.Pipeline;
+import org.apache.beam.sdk.PipelineResult;
+import org.apache.beam.sdk.coders.KvCoder;
+import org.apache.beam.sdk.extensions.avro.coders.AvroCoder;
+import org.apache.beam.sdk.io.solace.SolaceIO;
+import org.apache.beam.sdk.io.solace.SolaceIO.WriterType;
+import org.apache.beam.sdk.io.solace.broker.BasicAuthJcsmpSessionServiceFactory;
+import org.apache.beam.sdk.io.solace.broker.SempClientFactory;
+import org.apache.beam.sdk.io.solace.data.Solace;
+import org.apache.beam.sdk.io.solace.data.Solace.Queue;
+import org.apache.beam.sdk.io.solace.data.SolaceDataUtils;
+import org.apache.beam.sdk.io.solace.write.SolaceOutput;
+import org.apache.beam.sdk.metrics.Counter;
+import org.apache.beam.sdk.metrics.Metrics;
+import org.apache.beam.sdk.options.PipelineOptionsFactory;
+import org.apache.beam.sdk.options.StreamingOptions;
+import org.apache.beam.sdk.testing.TestPipeline;
+import org.apache.beam.sdk.testing.TestPipelineOptions;
+import org.apache.beam.sdk.testing.TestStream;
+import org.apache.beam.sdk.testutils.metrics.MetricsReader;
+import org.apache.beam.sdk.transforms.DoFn;
+import org.apache.beam.sdk.transforms.MapElements;
+import org.apache.beam.sdk.transforms.ParDo;
+import org.apache.beam.sdk.values.KV;
+import org.apache.beam.sdk.values.PCollection;
+import org.apache.beam.sdk.values.TypeDescriptor;
+import org.joda.time.Duration;
+import org.joda.time.Instant;
+import org.junit.AfterClass;
+import org.junit.BeforeClass;
+import org.junit.Rule;
+import org.junit.Test;
+
+public class SolaceIOMultipleSempIT {
+  private static final String NAMESPACE = SolaceIOMultipleSempIT.class.getName();
+  private static final String READ_COUNT = "read_count";
+  private static final String QUEUE_NAME = "test_queue";
+  private static final long PUBLISH_MESSAGE_COUNT = 20;
+  private static final TestPipelineOptions pipelineOptions;
+  private static SolaceContainerManager solaceContainerManager;
+
+  static {
+    pipelineOptions = PipelineOptionsFactory.create().as(TestPipelineOptions.class);
+    pipelineOptions.as(StreamingOptions.class).setStreaming(true);
+    // For the read connector tests, we need to make sure that p.run() does not block
+    pipelineOptions.setBlockOnRun(false);
+    pipelineOptions.as(TestPipelineOptions.class).setBlockOnRun(false);
+  }
+
+  @Rule public final TestPipeline pipeline = TestPipeline.fromOptions(pipelineOptions);
+
+  @BeforeClass
+  public static void setup() throws IOException {
+    solaceContainerManager = new SolaceContainerManager();
+    solaceContainerManager.start();
+    solaceContainerManager.createQueueWithSubscriptionTopic(QUEUE_NAME);
+  }
+
+  @AfterClass
+  public static void afterClass() {
+    if (solaceContainerManager != null) {
+      solaceContainerManager.stop();
+    }
+  }
+
+  /**
+   * This test verifies the functionality of reading data from a Solace queue using the
+   * SolaceIO.read() transform. This test does not actually test functionalities of {@link
+   * BasicAuthMultipleSempClientFactory}, but it demonstrates how to integrate a custom
+   * implementation of {@link SempClientFactory}, in this case, {@link
+   * BasicAuthMultipleSempClientFactory}, to handle authentication and configuration interactions
+   * with the Solace message broker.
+   */
+  @Test
+  public void test01writeAndReadWithMultipleSempClientFactory() {
+    Pipeline writerPipeline =
+        createWriterPipeline(WriterType.BATCHED, solaceContainerManager.jcsmpPortMapped);
+    writerPipeline
+        .apply(
+            "Read from Solace",
+            SolaceIO.read()
+                .from(Queue.fromName(QUEUE_NAME))
+                .withMaxNumConnections(1)
+                .withDeduplicateRecords(true)
+                .withSempClientFactory(
+                    BasicAuthMultipleSempClientFactory.builder()
+                        .backlogHosts(
+                            Arrays.asList(
+                                "http://localhost:" + solaceContainerManager.sempPortMapped,
+                                "http://localhost:" + solaceContainerManager.sempPortMapped))
+                        .mainHost("http://localhost:" + solaceContainerManager.sempPortMapped)
+                        .username("admin")
+                        .password("admin")
+                        .vpnName(SolaceContainerManager.VPN_NAME)
+                        .build())
+                .withSessionServiceFactory(
+                    BasicAuthJcsmpSessionServiceFactory.builder()
+                        .host("localhost:" + solaceContainerManager.jcsmpPortMapped)
+                        .username(SolaceContainerManager.USERNAME)
+                        .password(SolaceContainerManager.PASSWORD)
+                        .vpnName(SolaceContainerManager.VPN_NAME)
+                        .build()))
+        .apply("Count", ParDo.of(new CountingFn<>(NAMESPACE, READ_COUNT)));
+
+    PipelineResult pipelineResult = writerPipeline.run();
+    // We need enough time for Beam to pull all messages from the queue, but we need a timeout too,
+    // as the Read connector will keep attempting to read forever.
+    pipelineResult.waitUntilFinish(Duration.standardSeconds(15));
+
+    MetricsReader metricsReader = new MetricsReader(pipelineResult, NAMESPACE);
+    long actualRecordsCount = metricsReader.getCounterMetric(READ_COUNT);
+    assertEquals(PUBLISH_MESSAGE_COUNT, actualRecordsCount);
+  }
+
+  private Pipeline createWriterPipeline(
+      SolaceIO.WriterType writerType, int solaceContainerJcsmpPort) {
+    TestStream.Builder<KV<String, String>> kvBuilder =
+        TestStream.create(KvCoder.of(AvroCoder.of(String.class), AvroCoder.of(String.class)))
+            .advanceWatermarkTo(Instant.EPOCH);
+
+    for (int i = 0; i < PUBLISH_MESSAGE_COUNT; i++) {
+      String key = "Solace-Message-ID:m" + solaceContainerJcsmpPort + i;
+      String payload = String.format("{\"field_str\":\"value\",\"field_int\":123%d}", i);
+      kvBuilder =
+          kvBuilder
+              .addElements(KV.of(key, payload))
+              .advanceProcessingTime(Duration.standardSeconds(60));
+    }
+
+    TestStream<KV<String, String>> testStream = kvBuilder.advanceWatermarkToInfinity();
+
+    PCollection<KV<String, String>> kvs =
+        pipeline.apply(String.format("Test stream %s", writerType), testStream);
+
+    PCollection<Solace.Record> records =
+        kvs.apply(
+            String.format("To Record %s", writerType),
+            MapElements.into(TypeDescriptor.of(Solace.Record.class))
+                .via(kv -> SolaceDataUtils.getSolaceRecord(kv.getValue(), kv.getKey())));
+
+    SolaceOutput result =
+        records.apply(
+            String.format("Write to Solace %s", writerType),
+            SolaceIO.write()
+                .to(Solace.Topic.fromName(TOPIC_NAME))
+                .withSubmissionMode(SolaceIO.SubmissionMode.TESTING)
+                .withWriterType(writerType)
+                .withDeliveryMode(DeliveryMode.PERSISTENT)
+                .withNumberOfClientsPerWorker(1)
+                .withNumShards(1)
+                .withSessionServiceFactory(
+                    BasicAuthJcsmpSessionServiceFactory.builder()
+                        .host("localhost:" + solaceContainerJcsmpPort)
+                        .username(SolaceContainerManager.USERNAME)
+                        .password(SolaceContainerManager.PASSWORD)
+                        .vpnName(SolaceContainerManager.VPN_NAME)
+                        .build()));
+    result
+        .getSuccessfulPublish()
+        .apply(
+            String.format("Get ids %s", writerType),
+            MapElements.into(strings()).via(Solace.PublishResult::getMessageId));
+
+    return pipeline;
+  }
+
+  private static class CountingFn<T> extends DoFn<T, T> {
+
+    private final Counter elementCounter;
+
+    CountingFn(String namespace, String name) {
+      elementCounter = Metrics.counter(namespace, name);
+    }
+
+    @ProcessElement
+    public void processElement(@Element T record, OutputReceiver<T> c) {
+      elementCounter.inc(1L);
+      c.output(record);
+    }
+  }
+}

From d723216eeb38698156226a43740f59d4fb751e33 Mon Sep 17 00:00:00 2001
From: liferoad <huxiangqian@gmail.com>
Date: Wed, 27 Nov 2024 11:00:52 -0500
Subject: [PATCH 036/135] fixed ML tests (#33234)

* fixed ML tests

* try some new setups

* created py312-ml tox section
---
 .../apache_beam/ml/transforms/base_test.py    | 21 +++++++++----------
 .../ml/transforms/handlers_test.py            |  8 +++----
 sdks/python/setup.py                          | 20 +++++++++++++-----
 sdks/python/tox.ini                           | 14 ++++++++++++-
 4 files changed, 42 insertions(+), 21 deletions(-)

diff --git a/sdks/python/apache_beam/ml/transforms/base_test.py b/sdks/python/apache_beam/ml/transforms/base_test.py
index 1a21f6caf7e1..3db5a63b9542 100644
--- a/sdks/python/apache_beam/ml/transforms/base_test.py
+++ b/sdks/python/apache_beam/ml/transforms/base_test.py
@@ -21,7 +21,6 @@
 import shutil
 import tempfile
 import time
-import typing
 import unittest
 from collections.abc import Sequence
 from typing import Any
@@ -140,8 +139,8 @@ def test_ml_transform_on_list_dict(self):
               'x': int, 'y': float
           },
           expected_dtype={
-              'x': typing.Sequence[np.float32],
-              'y': typing.Sequence[np.float32],
+              'x': Sequence[np.float32],
+              'y': Sequence[np.float32],
           },
       ),
       param(
@@ -153,8 +152,8 @@ def test_ml_transform_on_list_dict(self):
               'x': np.int32, 'y': np.float32
           },
           expected_dtype={
-              'x': typing.Sequence[np.float32],
-              'y': typing.Sequence[np.float32],
+              'x': Sequence[np.float32],
+              'y': Sequence[np.float32],
           },
       ),
       param(
@@ -165,8 +164,8 @@ def test_ml_transform_on_list_dict(self):
               'x': list[int], 'y': list[float]
           },
           expected_dtype={
-              'x': typing.Sequence[np.float32],
-              'y': typing.Sequence[np.float32],
+              'x': Sequence[np.float32],
+              'y': Sequence[np.float32],
           },
       ),
       param(
@@ -174,12 +173,12 @@ def test_ml_transform_on_list_dict(self):
               'x': [1, 2, 3], 'y': [2.0, 3.0, 4.0]
           }],
           input_types={
-              'x': typing.Sequence[int],
-              'y': typing.Sequence[float],
+              'x': Sequence[int],
+              'y': Sequence[float],
           },
           expected_dtype={
-              'x': typing.Sequence[np.float32],
-              'y': typing.Sequence[np.float32],
+              'x': Sequence[np.float32],
+              'y': Sequence[np.float32],
           },
       ),
   ])
diff --git a/sdks/python/apache_beam/ml/transforms/handlers_test.py b/sdks/python/apache_beam/ml/transforms/handlers_test.py
index 4b53026c36a4..bb5f9b5f0f70 100644
--- a/sdks/python/apache_beam/ml/transforms/handlers_test.py
+++ b/sdks/python/apache_beam/ml/transforms/handlers_test.py
@@ -20,9 +20,9 @@
 import shutil
 import sys
 import tempfile
-import typing
 import unittest
 import uuid
+from collections.abc import Sequence
 from typing import NamedTuple
 from typing import Union
 
@@ -276,9 +276,9 @@ def test_tft_process_handler_transformed_data_schema(self):
         schema_utils.schema_from_feature_spec(raw_data_feature_spec))
 
     expected_transformed_data_schema = {
-        'x': typing.Sequence[np.float32],
-        'y': typing.Sequence[np.float32],
-        'z': typing.Sequence[bytes]
+        'x': Sequence[np.float32],
+        'y': Sequence[np.float32],
+        'z': Sequence[bytes]
     }
 
     actual_transformed_data_schema = (
diff --git a/sdks/python/setup.py b/sdks/python/setup.py
index 3b45cbf82fc1..53c7a532e706 100644
--- a/sdks/python/setup.py
+++ b/sdks/python/setup.py
@@ -490,12 +490,9 @@ def get_portability_package_data():
               'sentence-transformers',
               'skl2onnx',
               'pillow',
-              # Support TF 2.16.0: https://github.com/apache/beam/issues/31294
-              # Once TF version is unpinned, also don't restrict Python version.
-              'tensorflow<2.16.0;python_version<"3.12"',
+              'tensorflow',
               'tensorflow-hub',
-              # https://github.com/tensorflow/transform/issues/313
-              'tensorflow-transform;python_version<"3.11"',
+              'tensorflow-transform',
               'tf2onnx',
               'torch',
               'transformers',
@@ -504,6 +501,19 @@ def get_portability_package_data():
               # https://github.com/apache/beam/issues/31285
               # 'xgboost<2.0',  # https://github.com/apache/beam/issues/31252
           ],
+          'p312_ml_test': [
+              'datatable',
+              'embeddings',
+              'onnxruntime',
+              'sentence-transformers',
+              'skl2onnx',
+              'pillow',
+              'tensorflow',
+              'tensorflow-hub',
+              'tf2onnx',
+              'torch',
+              'transformers',
+          ],
           'aws': ['boto3>=1.9,<2'],
           'azure': [
               'azure-storage-blob>=12.3.2,<13',
diff --git a/sdks/python/tox.ini b/sdks/python/tox.ini
index 7a2424325890..68ac15ced70d 100644
--- a/sdks/python/tox.ini
+++ b/sdks/python/tox.ini
@@ -101,11 +101,23 @@ commands =
   python apache_beam/examples/complete/autocomplete_test.py
   bash {toxinidir}/scripts/run_pytest.sh {envname} "{posargs}"
 
-[testenv:py{39,310,311,312}-ml]
+[testenv:py{39,310,311}-ml]
 # Don't set TMPDIR to avoid "AF_UNIX path too long" errors in certain tests.
 setenv =
 extras = test,gcp,dataframe,ml_test
 commands =
+  # Log tensorflow version for debugging
+  /bin/sh -c "pip freeze | grep -E tensorflow"
+  bash {toxinidir}/scripts/run_pytest.sh {envname} "{posargs}"
+
+[testenv:py312-ml]
+# many packages do not support py3.12
+# Don't set TMPDIR to avoid "AF_UNIX path too long" errors in certain tests.
+setenv =
+extras = test,gcp,dataframe,p312_ml_test
+commands =
+  # Log tensorflow version for debugging
+  /bin/sh -c "pip freeze | grep -E tensorflow"
   bash {toxinidir}/scripts/run_pytest.sh {envname} "{posargs}"
 
 [testenv:py{39,310,311,312}-dask]

From d01424997156915821561bd3ee80c7b9277da0eb Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Wed, 27 Nov 2024 11:10:03 -0800
Subject: [PATCH 037/135] Remove (long) obsolete declaration of unsupported
 features that are now supported. (#33239)

---
 .../content/en/documentation/sdks/python-streaming.md     | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/website/www/site/content/en/documentation/sdks/python-streaming.md b/website/www/site/content/en/documentation/sdks/python-streaming.md
index 2d0bdfa9500b..7122cc8b9ae5 100644
--- a/website/www/site/content/en/documentation/sdks/python-streaming.md
+++ b/website/www/site/content/en/documentation/sdks/python-streaming.md
@@ -155,11 +155,3 @@ about executing streaming pipelines:
 - [DirectRunner streaming execution](/documentation/runners/direct/#streaming-execution)
 - [DataflowRunner streaming execution](/documentation/runners/dataflow/#streaming-execution)
 - [Portable Flink runner](/documentation/runners/flink/)
-
-## Unsupported features
-
-Python streaming execution does not currently support the following features:
-
-- Custom source API
-- User-defined custom merging `WindowFn` (with fnapi)
-- For portable runners, see [portability support table](https://s.apache.org/apache-beam-portability-support-table).

From 4d2d2ce8da04287948131dab1b20a84fad90e893 Mon Sep 17 00:00:00 2001
From: Damon <damondouglas@users.noreply.github.com>
Date: Wed, 27 Nov 2024 11:57:37 -0800
Subject: [PATCH 038/135] Add Java Distroless Github workflow check (#33233)

* Create trigger json' file.

* Rename trigger file

* Create Java validates Distroless container workflow
---
 ...ValidatesDistrolessContainer_Dataflow.json |   4 +
 ..._ValidatesDistrolessContainer_Dataflow.yml | 108 ++++++++++++++++++
 2 files changed, 112 insertions(+)
 create mode 100644 .github/trigger_files/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.json
 create mode 100644 .github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml

diff --git a/.github/trigger_files/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.json b/.github/trigger_files/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.json
new file mode 100644
index 000000000000..e3d6056a5de9
--- /dev/null
+++ b/.github/trigger_files/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.json
@@ -0,0 +1,4 @@
+{
+  "comment": "Modify this file in a trivial way to cause this test suite to run",
+  "modification": 1
+}
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml b/.github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml
new file mode 100644
index 000000000000..98b604be00e8
--- /dev/null
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml
@@ -0,0 +1,108 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+name: PostCommit Java ValidatesDistrolessContainer Dataflow
+
+on:
+  schedule:
+    - cron: '30 6/8 * * *'
+  pull_request_target:
+    paths:
+      - 'release/trigger_all_tests.json'
+      - '.github/trigger_files/beam_PostCommit_Java_ValidatesRunner_Dataflow_V2.json'
+      - '.github/trigger_files/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.json'
+      
+  workflow_dispatch:
+
+# This allows a subsequently queued workflow run to interrupt previous runs
+concurrency:
+  group: '${{ github.workflow }} @ ${{ github.event.issue.number || github.sha || github.head_ref || github.ref }}-${{ github.event.schedule || github.event.comment.id || github.event.sender.login }}'
+  cancel-in-progress: true
+
+#Setting explicit permissions for the action to avoid the default permissions which are `write-all` in case of pull_request_target event
+permissions:
+  actions: write
+  pull-requests: write
+  checks: write
+  contents: read
+  deployments: read
+  id-token: none
+  issues: write
+  discussions: read
+  packages: read
+  pages: read
+  repository-projects: read
+  security-events: read
+  statuses: read
+
+env:
+  DEVELOCITY_ACCESS_KEY: ${{ secrets.GE_ACCESS_TOKEN }}
+  GRADLE_ENTERPRISE_CACHE_USERNAME: ${{ secrets.GE_CACHE_USERNAME }}
+  GRADLE_ENTERPRISE_CACHE_PASSWORD: ${{ secrets.GE_CACHE_PASSWORD }}
+
+jobs:
+  beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow:
+    name: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
+    runs-on: [self-hosted, ubuntu-20.04, main]
+    timeout-minutes: 390
+    strategy:
+      matrix:
+        job_name: [beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow]
+        job_phrase: [Run Java Dataflow ValidatesDistrolessContainer]
+    if: |
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'pull_request_target' ||
+      (github.event_name == 'schedule' && github.repository == 'apache/beam') ||
+      github.event.comment.body == 'Run Java Dataflow ValidatesDistrolessContainer'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup repository
+        uses: ./.github/actions/setup-action
+        with:
+          comment_phrase: ${{ matrix.job_phrase }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          github_job: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
+      - name: Setup environment
+        uses: ./.github/actions/setup-environment-action
+        with:
+          java-version: |
+            17
+            21
+      - name: Setup docker
+        run: |
+          gcloud auth configure-docker us-docker.pkg.dev --quiet
+          gcloud auth configure-docker us.gcr.io --quiet
+          gcloud auth configure-docker gcr.io --quiet
+          gcloud auth configure-docker us-central1-docker.pkg.dev --quiet
+      - name: run validatesDistrolessContainer script
+        uses: ./.github/actions/gradle-command-self-hosted-action
+        with:
+          gradle-command: :runners:google-cloud-dataflow-java:examplesJavaRunnerV2IntegrationTestDistroless
+          max-workers: 12
+      - name: Archive JUnit Test Results
+        uses: actions/upload-artifact@v4
+        if: ${{ !success() }}
+        with:
+          name: JUnit Test Results
+          path: "**/build/reports/tests/"
+      - name: Publish JUnit Test Results
+        uses: EnricoMi/publish-unit-test-result-action@v2
+        if: always()
+        with:
+          commit: '${{ env.prsha || env.GITHUB_SHA }}'
+          comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
+          files: '**/build/test-results/**/*.xml'

From e8dd3c6ed695e3b63780feab03e37d490a7a6a5b Mon Sep 17 00:00:00 2001
From: Damon <damondouglas@users.noreply.github.com>
Date: Wed, 27 Nov 2024 11:58:33 -0800
Subject: [PATCH 039/135] Fix python distroless workflow (#33232)

* Fix python distroless workflow (#33228)

* Add artifact registry credential setup

* Edit trigger file to trigger workflow

* Add setup docker stage

* Add gcloud auth configure-docker stage

* Add registries to configure-docker step
---
 ...Commit_Python_ValidatesDistrolessContainer_Dataflow.json | 4 ++--
 ...tCommit_Python_ValidatesDistrolessContainer_Dataflow.yml | 6 ++++++
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/.github/trigger_files/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.json b/.github/trigger_files/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.json
index 4897480d69ad..3f63c0c9975f 100644
--- a/.github/trigger_files/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.json
+++ b/.github/trigger_files/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.json
@@ -1,4 +1,4 @@
 {
     "comment": "Modify this file in a trivial way to cause this test suite to run",
-    "modification": 1
-}
\ No newline at end of file
+    "modification": 2
+}
diff --git a/.github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml b/.github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml
index a0de6d4a0428..6f8a7bdd0631 100644
--- a/.github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml
@@ -85,6 +85,12 @@ jobs:
             11
             8
           python-version: ${{ matrix.python_version }}
+      - name: Setup docker
+        run: |
+          gcloud auth configure-docker us-docker.pkg.dev --quiet
+          gcloud auth configure-docker us.gcr.io --quiet
+          gcloud auth configure-docker gcr.io --quiet
+          gcloud auth configure-docker us-central1-docker.pkg.dev --quiet
       - name: Set PY_VER_CLEAN
         id: set_py_ver_clean
         run: |

From 95322c69a18254a5e08f5c9259861450752b04cd Mon Sep 17 00:00:00 2001
From: Yi Hu <yathu@google.com>
Date: Wed, 27 Nov 2024 16:00:05 -0500
Subject: [PATCH 040/135] bump hadoop version (#33011)

* bump hadoop version

* add to readme.md
---
 CHANGES.md                                                      | 1 +
 .../main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy  | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES.md b/CHANGES.md
index 654512c3a4e2..a5d0cca0b559 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -63,6 +63,7 @@
 ## I/Os
 
 * Support for X source added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
+* Upgraded the default version of Hadoop dependencies to 3.4.1. Hadoop 2.10.2 is still supported (Java) ([#33011](https://github.com/apache/beam/issues/33011)).
 
 ## New Features / Improvements
 
diff --git a/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy b/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
index 84c7c3ecfd4a..2abd43a5d4cc 100644
--- a/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
+++ b/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
@@ -614,7 +614,7 @@ class BeamModulePlugin implements Plugin<Project> {
     // [bomupgrader] determined by: io.grpc:grpc-netty, consistent with: google_cloud_platform_libraries_bom
     def grpc_version = "1.67.1"
     def guava_version = "33.1.0-jre"
-    def hadoop_version = "2.10.2"
+    def hadoop_version = "3.4.1"
     def hamcrest_version = "2.1"
     def influxdb_version = "2.19"
     def httpclient_version = "4.5.13"

From f28e65f5e57f74834d74a66c2e510b405cd6694f Mon Sep 17 00:00:00 2001
From: liferoad <huxiangqian@gmail.com>
Date: Mon, 2 Dec 2024 09:11:38 -0500
Subject: [PATCH 041/135] Update
 beam_LoadTests_Python_Combine_Flink_Streaming.yml (#33241)

* Update beam_LoadTests_Python_Combine_Flink_Streaming.yml

Increase the number of workers.

* updated parallelism

* try high mem machines

* updated the script

* try n1

* fixed zone

* change heap size

* try prop

* more propts

* try more

* try props

* more opts

* more props

* props

* n1-highmem-8

* n1-highmem-16

* n1-highmem-32

* props

* move props

* fix heap

* task mem

* more mem

* updated props

* increase --max_cache_memory_usage_mb=256

* try new props

* more mem

* updated mem

* mem

* reduce size

* options

* reduce top count

* timeout

* mem

* fanout

* small

* added small load tests now

* restore old ones

* fixed args

* minor comments
---
 ...adTests_Python_Combine_Flink_Streaming.yml | 19 +++++++-----
 ...n_Combine_Flink_Streaming_2GB_Fanout_4.txt |  3 +-
 ...n_Combine_Flink_Streaming_2GB_Fanout_8.txt |  3 +-
 ...Combine_Flink_Streaming_small_Fanout_1.txt | 31 +++++++++++++++++++
 ...Combine_Flink_Streaming_small_Fanout_2.txt | 31 +++++++++++++++++++
 .test-infra/dataproc/flink_cluster.sh         | 27 +++++++++++-----
 6 files changed, 98 insertions(+), 16 deletions(-)
 create mode 100644 .github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_small_Fanout_1.txt
 create mode 100644 .github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_small_Fanout_2.txt

diff --git a/.github/workflows/beam_LoadTests_Python_Combine_Flink_Streaming.yml b/.github/workflows/beam_LoadTests_Python_Combine_Flink_Streaming.yml
index baf950589c8e..243e9d32c066 100644
--- a/.github/workflows/beam_LoadTests_Python_Combine_Flink_Streaming.yml
+++ b/.github/workflows/beam_LoadTests_Python_Combine_Flink_Streaming.yml
@@ -65,7 +65,7 @@ jobs:
       (github.event_name == 'schedule' && github.repository == 'apache/beam') ||
       github.event.comment.body == 'Run Load Tests Python Combine Flink Streaming'
     runs-on: [self-hosted, ubuntu-20.04, main]
-    timeout-minutes: 720
+    timeout-minutes: 80
     name: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
     strategy:
       matrix:
@@ -89,17 +89,22 @@ jobs:
           test-type: load
           test-language: python
           argument-file-paths: |
-            ${{ github.workspace }}/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_4.txt
-            ${{ github.workspace }}/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_8.txt
+            ${{ github.workspace }}/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_small_Fanout_1.txt
+            ${{ github.workspace }}/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_small_Fanout_2.txt
+          # large loads do not work now
+          # ${{ github.workspace }}/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_4.txt
+          # ${{ github.workspace }}/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_8.txt
       - name: Start Flink with parallelism 16
         env:
           FLINK_NUM_WORKERS: 16
+          HIGH_MEM_MACHINE: n1-highmem-16
+          HIGH_MEM_FLINK_PROPS: flink:taskmanager.memory.process.size=16g,flink:taskmanager.memory.flink.size=12g,flink:taskmanager.memory.jvm-overhead.max=4g,flink:jobmanager.memory.process.size=6g,flink:jobmanager.memory.jvm-overhead.max= 2g,flink:jobmanager.memory.flink.size=4g
         run: |
           cd ${{ github.workspace }}/.test-infra/dataproc; ./flink_cluster.sh create
       - name: get current time
         run: echo "NOW_UTC=$(date '+%m%d%H%M%S' --utc)" >> $GITHUB_ENV
-      # The env variables are created and populated in the test-arguments-action as "<github.job>_test_arguments_<argument_file_paths_index>"  
-      - name: run Load test 2GB Fanout 4
+      # The env variables are created and populated in the test-arguments-action as "<github.job>_test_arguments_<argument_file_paths_index>"
+      - name: run Load test small Fanout 1
         uses: ./.github/actions/gradle-command-self-hosted-action
         with:
           gradle-command: :sdks:python:apache_beam:testing:load_tests:run
@@ -108,7 +113,7 @@ jobs:
             -PloadTest.mainClass=apache_beam.testing.load_tests.combine_test \
             -Prunner=PortableRunner \
             '-PloadTest.args=${{ env.beam_LoadTests_Python_Combine_Flink_Streaming_test_arguments_1 }} --job_name=load-tests-python-flink-streaming-combine-4-${{env.NOW_UTC}}' \
-      - name: run Load test 2GB Fanout 8
+      - name: run Load test small Fanout 2
         uses: ./.github/actions/gradle-command-self-hosted-action
         with:
           gradle-command: :sdks:python:apache_beam:testing:load_tests:run
@@ -123,4 +128,4 @@ jobs:
           ${{ github.workspace }}/.test-infra/dataproc/flink_cluster.sh delete
 
         # // TODO(https://github.com/apache/beam/issues/20402). Skipping some cases because they are too slow:
-        # load-tests-python-flink-streaming-combine-1'
\ No newline at end of file
+        # load-tests-python-flink-streaming-combine-1'
diff --git a/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_4.txt b/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_4.txt
index 650236a9c500..6280e01dccdb 100644
--- a/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_4.txt
+++ b/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_4.txt
@@ -27,4 +27,5 @@
 --top_count=20
 --streaming
 --use_stateful_load_generator
---runner=PortableRunner
\ No newline at end of file
+--runner=PortableRunner
+--max_cache_memory_usage_mb=256
\ No newline at end of file
diff --git a/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_8.txt b/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_8.txt
index 4208571fef62..e1b77d15b95b 100644
--- a/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_8.txt
+++ b/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_2GB_Fanout_8.txt
@@ -27,4 +27,5 @@
 --top_count=20
 --streaming
 --use_stateful_load_generator
---runner=PortableRunner
\ No newline at end of file
+--runner=PortableRunner
+--max_cache_memory_usage_mb=256
\ No newline at end of file
diff --git a/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_small_Fanout_1.txt b/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_small_Fanout_1.txt
new file mode 100644
index 000000000000..f16e9e4b06ef
--- /dev/null
+++ b/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_small_Fanout_1.txt
@@ -0,0 +1,31 @@
+#  Licensed to the Apache Software Foundation (ASF) under one
+#  or more contributor license agreements.  See the NOTICE file
+#  distributed with this work for additional information
+#  regarding copyright ownership.  The ASF licenses this file
+#  to you under the Apache License, Version 2.0 (the
+#  "License"); you may not use this file except in compliance
+#  with the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+--publish_to_big_query=true
+--metrics_dataset=load_test
+--metrics_table=python_flink_streaming_combine_4
+--influx_measurement=python_streaming_combine_4
+--input_options=''{\\"num_records\\":200000,\\"key_size\\":10,\\"value_size\\":90,\\"algorithm\\":\\"lcg\\"}''
+--parallelism=16
+--job_endpoint=localhost:8099
+--environment_type=DOCKER
+--environment_config=gcr.io/apache-beam-testing/beam-sdk/beam_python3.9_sdk:latest
+--fanout=1
+--top_count=20
+--streaming
+--use_stateful_load_generator
+--runner=PortableRunner
+--max_cache_memory_usage_mb=256
\ No newline at end of file
diff --git a/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_small_Fanout_2.txt b/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_small_Fanout_2.txt
new file mode 100644
index 000000000000..5f66e519c31a
--- /dev/null
+++ b/.github/workflows/load-tests-pipeline-options/python_Combine_Flink_Streaming_small_Fanout_2.txt
@@ -0,0 +1,31 @@
+#  Licensed to the Apache Software Foundation (ASF) under one
+#  or more contributor license agreements.  See the NOTICE file
+#  distributed with this work for additional information
+#  regarding copyright ownership.  The ASF licenses this file
+#  to you under the Apache License, Version 2.0 (the
+#  "License"); you may not use this file except in compliance
+#  with the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+--publish_to_big_query=true
+--metrics_dataset=load_test
+--metrics_table=python_flink_streaming_combine_5
+--influx_measurement=python_streaming_combine_5
+--input_options=''{\\"num_records\\":200000,\\"key_size\\":10,\\"value_size\\":90,\\"algorithm\\":\\"lcg\\"}''
+--parallelism=16
+--job_endpoint=localhost:8099
+--environment_type=DOCKER
+--environment_config=gcr.io/apache-beam-testing/beam-sdk/beam_python3.9_sdk:latest
+--fanout=2
+--top_count=20
+--streaming
+--use_stateful_load_generator
+--runner=PortableRunner
+--max_cache_memory_usage_mb=256
\ No newline at end of file
diff --git a/.test-infra/dataproc/flink_cluster.sh b/.test-infra/dataproc/flink_cluster.sh
index 24d51ac13bde..4a97850f5ac1 100755
--- a/.test-infra/dataproc/flink_cluster.sh
+++ b/.test-infra/dataproc/flink_cluster.sh
@@ -129,13 +129,26 @@ function create_cluster() {
   local image_version=$DATAPROC_VERSION
   echo "Starting dataproc cluster. Dataproc version: $image_version"
 
-  # Docker init action restarts yarn so we need to start yarn session after this restart happens.
-  # This is why flink init action is invoked last.
-  # TODO(11/22/2024) remove --worker-machine-type and --master-machine-type once N2 CPUs quota relaxed
-  # Dataproc 2.1 uses n2-standard-2 by default but there is N2 CPUs=24 quota limit for this project
-  gcloud dataproc clusters create $CLUSTER_NAME --enable-component-gateway --region=$GCLOUD_REGION --num-workers=$FLINK_NUM_WORKERS --public-ip-address \
-  --master-machine-type=n1-standard-2 --worker-machine-type=n1-standard-2 --metadata "${metadata}", \
-  --image-version=$image_version --zone=$GCLOUD_ZONE  --optional-components=FLINK,DOCKER  --quiet
+  local worker_machine_type="n1-standard-2" # Default worker type
+  local master_machine_type="n1-standard-2" # Default master type
+
+  if [[ -n "${HIGH_MEM_MACHINE:=}" ]]; then
+      worker_machine_type="${HIGH_MEM_MACHINE}"
+      master_machine_type="${HIGH_MEM_MACHINE}"
+
+    gcloud dataproc clusters create $CLUSTER_NAME --enable-component-gateway --region=$GCLOUD_REGION --num-workers=$FLINK_NUM_WORKERS --public-ip-address \
+    --master-machine-type=${master_machine_type} --worker-machine-type=${worker_machine_type} --metadata "${metadata}", \
+    --image-version=$image_version --zone=$GCLOUD_ZONE --optional-components=FLINK,DOCKER  \
+    --properties="${HIGH_MEM_FLINK_PROPS}"
+  else
+    # Docker init action restarts yarn so we need to start yarn session after this restart happens.
+    # This is why flink init action is invoked last.
+    # TODO(11/22/2024) remove --worker-machine-type and --master-machine-type once N2 CPUs quota relaxed
+    # Dataproc 2.1 uses n2-standard-2 by default but there is N2 CPUs=24 quota limit for this project
+    gcloud dataproc clusters create $CLUSTER_NAME --enable-component-gateway --region=$GCLOUD_REGION --num-workers=$FLINK_NUM_WORKERS --public-ip-address \
+    --master-machine-type=${master_machine_type} --worker-machine-type=${worker_machine_type} --metadata "${metadata}", \
+    --image-version=$image_version --zone=$GCLOUD_ZONE --optional-components=FLINK,DOCKER  --quiet
+  fi
 }
 
 # Runs init actions for Docker, Portability framework (Beam) and Flink cluster

From 58e1625794a6c1756925d329c27ccfc0d46723ec Mon Sep 17 00:00:00 2001
From: Mattie Fu <mattiefu@google.com>
Date: Mon, 2 Dec 2024 09:51:34 -0500
Subject: [PATCH 042/135] update 2.60.0 changelog to include a fix in Bigtable
 (#33053)

* update 2.60.0 changelog to include a fix in Bigtable

* update main changelog

---------

Co-authored-by: Danny McCormick <dannymccormick@google.com>
---
 CHANGES.md                                      | 1 +
 website/www/site/content/en/blog/beam-2.60.0.md | 1 +
 2 files changed, 2 insertions(+)

diff --git a/CHANGES.md b/CHANGES.md
index a5d0cca0b559..8dd1e89aec91 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -173,6 +173,7 @@ when running on 3.8. ([#31192](https://github.com/apache/beam/issues/31192))
 * (Java) Fixed custom delimiter issues in TextIO ([#32249](https://github.com/apache/beam/issues/32249), [#32251](https://github.com/apache/beam/issues/32251)).
 * (Java, Python, Go) Fixed PeriodicSequence backlog bytes reporting, which was preventing Dataflow Runner autoscaling from functioning properly ([#32506](https://github.com/apache/beam/issues/32506)).
 * (Java) Fix improper decoding of rows with schemas containing nullable fields when encoded with a schema with equal encoding positions but modified field order. ([#32388](https://github.com/apache/beam/issues/32388)).
+* (Java) Skip close on bundles in BigtableIO.Read ([#32661](https://github.com/apache/beam/pull/32661), [#32759](https://github.com/apache/beam/pull/32759)).
 
 ## Known Issues
 
diff --git a/website/www/site/content/en/blog/beam-2.60.0.md b/website/www/site/content/en/blog/beam-2.60.0.md
index ae5e0284ccdd..e5767cff5114 100644
--- a/website/www/site/content/en/blog/beam-2.60.0.md
+++ b/website/www/site/content/en/blog/beam-2.60.0.md
@@ -67,6 +67,7 @@ when running on 3.8. ([#31192](https://github.com/apache/beam/issues/31192))
 * (Java) Fixed custom delimiter issues in TextIO ([#32249](https://github.com/apache/beam/issues/32249), [#32251](https://github.com/apache/beam/issues/32251)).
 * (Java, Python, Go) Fixed PeriodicSequence backlog bytes reporting, which was preventing Dataflow Runner autoscaling from functioning properly ([#32506](https://github.com/apache/beam/issues/32506)).
 * (Java) Fix improper decoding of rows with schemas containing nullable fields when encoded with a schema with equal encoding positions but modified field order. ([#32388](https://github.com/apache/beam/issues/32388)).
+* (Java) Skip close on bundles in BigtableIO.Read ([#32661](https://github.com/apache/beam/pull/32661), [#32759](https://github.com/apache/beam/pull/32759)).
 
 ## Known Issues
 

From 727a865c2eb55010ac8d61a4045705bed7834fb8 Mon Sep 17 00:00:00 2001
From: Danny McCormick <dannymccormick@google.com>
Date: Mon, 2 Dec 2024 09:51:51 -0500
Subject: [PATCH 043/135] Add safe to ignore category to dashboard/alerting
 (#33168)

---
 .../github/github_runs_prefetcher/code/config.yaml    | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/.test-infra/metrics/sync/github/github_runs_prefetcher/code/config.yaml b/.test-infra/metrics/sync/github/github_runs_prefetcher/code/config.yaml
index 722cc4e8f29e..eccaaa5f3b17 100644
--- a/.test-infra/metrics/sync/github/github_runs_prefetcher/code/config.yaml
+++ b/.test-infra/metrics/sync/github/github_runs_prefetcher/code/config.yaml
@@ -124,7 +124,6 @@ categories:
     - "PostCommit Java PVR Samza"
     - "PreCommit Java Tika IO Direct"
     - "PostCommit Java SingleStoreIO IT"
-    - "PostCommit Java Sickbay"
     - "PostCommit Java ValidatesRunner Direct"
     - "PreCommit Java SingleStore IO Direct"
     - "PreCommit Java InfluxDb IO Direct"
@@ -227,7 +226,6 @@ categories:
     - "PreCommit Python Transforms" 
     - "Build python source distribution and wheels" 
     - "Python tests" 
-    - "PostCommit Sickbay Python" 
     - "PreCommit Portable Python" 
     - "PreCommit Python Coverage" 
     - "PreCommit Python Docker" 
@@ -317,7 +315,6 @@ categories:
     - "PostCommit PortableJar Spark" 
     - "PreCommit Integration and Load Test Framework" 
     - "pr-bot-update-reviewers" 
-    - "Cut Release Branch" 
     - "Generate issue report" 
     - "Dask Runner Tests" 
     - "PreCommit Typescript" 
@@ -328,6 +325,12 @@ categories:
     - "Assign Milestone on issue close" 
     - "Local environment tests" 
     - "PreCommit SQL" 
-    - "LabelPrs" 
+    - "LabelPrs"
+  - name: safe_to_ignore
+    groupThreshold: 0
+    tests:
     - "build_release_candidate" 
+    - "Cut Release Branch" 
+    - "PostCommit Java Sickbay"
+    - "PostCommit Sickbay Python" 
 

From e279e55f47683bcee1c59c0b7aea2b21741fadb3 Mon Sep 17 00:00:00 2001
From: Bartosz Zablocki <bzablocki@google.com>
Date: Mon, 2 Dec 2024 15:54:16 +0000
Subject: [PATCH 044/135] SolaceIO.Read: handle occasional cases when
 finalizeCheckpoint is not executed (#32962)

* SolaceIO.Read: handle occasional cases when finalizeCheckpoint is not called

* Implement cache for storing the session service and implement an eviction strategy and close services more eagerly.

* Wrap message acknowledgment in a try-catch block, remove active AtomicBool from the reader.

* Store messages in a Queue that is referenced from the CheckpointMark
---
 .../broker/BasicAuthJcsmpSessionService.java  |  18 +--
 .../sdk/io/solace/broker/MessageReceiver.java |   7 -
 .../sdk/io/solace/broker/SessionService.java  |   7 -
 .../solace/broker/SolaceMessageReceiver.java  |  17 +--
 .../io/solace/read/SolaceCheckpointMark.java  |  46 +++---
 .../io/solace/read/UnboundedSolaceReader.java | 135 +++++++++++++-----
 .../io/solace/MockEmptySessionService.java    |   5 -
 .../sdk/io/solace/MockSessionService.java     |  10 --
 .../beam/sdk/io/solace/SolaceIOReadTest.java  |  20 +--
 9 files changed, 138 insertions(+), 127 deletions(-)

diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java
index b2196dbf1067..d4c9a3ec6210 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java
@@ -102,10 +102,7 @@ public void close() {
           if (messageReceiver != null) {
             messageReceiver.close();
           }
-          if (messageProducer != null) {
-            messageProducer.close();
-          }
-          if (!isClosed()) {
+          if (jcsmpSession != null) {
             checkStateNotNull(jcsmpSession).closeSession();
           }
           return 0;
@@ -119,8 +116,9 @@ public MessageReceiver getReceiver() {
       this.messageReceiver =
           retryCallableManager.retryCallable(
               this::createFlowReceiver, ImmutableSet.of(JCSMPException.class));
+      this.messageReceiver.start();
     }
-    return this.messageReceiver;
+    return checkStateNotNull(this.messageReceiver);
   }
 
   @Override
@@ -138,15 +136,10 @@ public java.util.Queue<PublishResult> getPublishedResultsQueue() {
     return publishedResultsQueue;
   }
 
-  @Override
-  public boolean isClosed() {
-    return jcsmpSession == null || jcsmpSession.isClosed();
-  }
-
   private MessageProducer createXMLMessageProducer(SubmissionMode submissionMode)
       throws JCSMPException, IOException {
 
-    if (isClosed()) {
+    if (jcsmpSession == null) {
       connectWriteSession(submissionMode);
     }
 
@@ -165,9 +158,6 @@ private MessageProducer createXMLMessageProducer(SubmissionMode submissionMode)
   }
 
   private MessageReceiver createFlowReceiver() throws JCSMPException, IOException {
-    if (isClosed()) {
-      connectSession();
-    }
 
     Queue queue =
         JCSMPFactory.onlyInstance()
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java
index 95f989bd1be9..017a63260678 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java
@@ -35,13 +35,6 @@ public interface MessageReceiver {
    */
   void start();
 
-  /**
-   * Returns {@literal true} if the message receiver is closed, {@literal false} otherwise.
-   *
-   * <p>A message receiver is closed when it is no longer able to receive messages.
-   */
-  boolean isClosed();
-
   /**
    * Receives a message from the broker.
    *
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java
index 84a876a9d0bc..6dcd0b652616 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java
@@ -120,13 +120,6 @@ public abstract class SessionService implements Serializable {
   /** Gracefully closes the connection to the service. */
   public abstract void close();
 
-  /**
-   * Checks whether the connection to the service is currently closed. This method is called when an
-   * `UnboundedSolaceReader` is starting to read messages - a session will be created if this
-   * returns true.
-   */
-  public abstract boolean isClosed();
-
   /**
    * Returns a MessageReceiver object for receiving messages from Solace. If it is the first time
    * this method is used, the receiver is created from the session instance, otherwise it returns
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java
index d548d2049a5b..d74f3cae89fe 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java
@@ -24,12 +24,8 @@
 import java.io.IOException;
 import org.apache.beam.sdk.io.solace.RetryCallableManager;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableSet;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 public class SolaceMessageReceiver implements MessageReceiver {
-  private static final Logger LOG = LoggerFactory.getLogger(SolaceMessageReceiver.class);
-
   public static final int DEFAULT_ADVANCE_TIMEOUT_IN_MILLIS = 100;
   private final FlowReceiver flowReceiver;
   private final RetryCallableManager retryCallableManager = RetryCallableManager.create();
@@ -52,19 +48,14 @@ private void startFlowReceiver() {
         ImmutableSet.of(JCSMPException.class));
   }
 
-  @Override
-  public boolean isClosed() {
-    return flowReceiver == null || flowReceiver.isClosed();
-  }
-
   @Override
   public BytesXMLMessage receive() throws IOException {
     try {
       return flowReceiver.receive(DEFAULT_ADVANCE_TIMEOUT_IN_MILLIS);
     } catch (StaleSessionException e) {
-      LOG.warn("SolaceIO: Caught StaleSessionException, restarting the FlowReceiver.");
       startFlowReceiver();
-      throw new IOException(e);
+      throw new IOException(
+          "SolaceIO: Caught StaleSessionException, restarting the FlowReceiver.", e);
     } catch (JCSMPException e) {
       throw new IOException(e);
     }
@@ -72,8 +63,6 @@ public BytesXMLMessage receive() throws IOException {
 
   @Override
   public void close() {
-    if (!isClosed()) {
-      this.flowReceiver.close();
-    }
+    flowReceiver.close();
   }
 }
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java
index 77f6eed8f62c..a913fd6133ea 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java
@@ -18,17 +18,16 @@
 package org.apache.beam.sdk.io.solace.read;
 
 import com.solacesystems.jcsmp.BytesXMLMessage;
-import java.util.ArrayDeque;
-import java.util.ArrayList;
-import java.util.List;
 import java.util.Objects;
-import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.Queue;
 import org.apache.beam.sdk.annotations.Internal;
 import org.apache.beam.sdk.coders.DefaultCoder;
 import org.apache.beam.sdk.extensions.avro.coders.AvroCoder;
 import org.apache.beam.sdk.io.UnboundedSource;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.annotations.VisibleForTesting;
 import org.checkerframework.checker.nullness.qual.Nullable;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 /**
  * Checkpoint for an unbounded Solace source. Consists of the Solace messages waiting to be
@@ -38,10 +37,8 @@
 @Internal
 @VisibleForTesting
 public class SolaceCheckpointMark implements UnboundedSource.CheckpointMark {
-  private transient AtomicBoolean activeReader;
-  // BytesXMLMessage is not serializable so if a job restarts from the checkpoint, we cannot retry
-  // these messages here. We relay on Solace's retry mechanism.
-  private transient ArrayDeque<BytesXMLMessage> ackQueue;
+  private static final Logger LOG = LoggerFactory.getLogger(SolaceCheckpointMark.class);
+  private transient Queue<BytesXMLMessage> safeToAck;
 
   @SuppressWarnings("initialization") // Avro will set the fields by breaking abstraction
   private SolaceCheckpointMark() {}
@@ -49,25 +46,24 @@ private SolaceCheckpointMark() {}
   /**
    * Creates a new {@link SolaceCheckpointMark}.
    *
-   * @param activeReader {@link AtomicBoolean} indicating if the related reader is active. The
-   *     reader creating the messages has to be active to acknowledge the messages.
-   * @param ackQueue {@link List} of {@link BytesXMLMessage} to be acknowledged.
+   * @param safeToAck - a queue of {@link BytesXMLMessage} to be acknowledged.
    */
-  SolaceCheckpointMark(AtomicBoolean activeReader, List<BytesXMLMessage> ackQueue) {
-    this.activeReader = activeReader;
-    this.ackQueue = new ArrayDeque<>(ackQueue);
+  SolaceCheckpointMark(Queue<BytesXMLMessage> safeToAck) {
+    this.safeToAck = safeToAck;
   }
 
   @Override
   public void finalizeCheckpoint() {
-    if (activeReader == null || !activeReader.get() || ackQueue == null) {
-      return;
-    }
-
-    while (!ackQueue.isEmpty()) {
-      BytesXMLMessage msg = ackQueue.poll();
-      if (msg != null) {
+    BytesXMLMessage msg;
+    while ((msg = safeToAck.poll()) != null) {
+      try {
         msg.ackMessage();
+      } catch (IllegalStateException e) {
+        LOG.error(
+            "SolaceIO.Read: cannot acknowledge the message with applicationMessageId={}, ackMessageId={}. It will not be retried.",
+            msg.getApplicationMessageId(),
+            msg.getAckMessageId(),
+            e);
       }
     }
   }
@@ -84,15 +80,11 @@ public boolean equals(@Nullable Object o) {
       return false;
     }
     SolaceCheckpointMark that = (SolaceCheckpointMark) o;
-    // Needed to convert to ArrayList because ArrayDeque.equals checks only for reference, not
-    // content.
-    ArrayList<BytesXMLMessage> ackList = new ArrayList<>(ackQueue);
-    ArrayList<BytesXMLMessage> thatAckList = new ArrayList<>(that.ackQueue);
-    return Objects.equals(activeReader, that.activeReader) && Objects.equals(ackList, thatAckList);
+    return Objects.equals(safeToAck, that.safeToAck);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(activeReader, ackQueue);
+    return Objects.hash(safeToAck);
   }
 }
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java
index a421970370da..dc84e0a07017 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java
@@ -22,17 +22,26 @@
 import com.solacesystems.jcsmp.BytesXMLMessage;
 import java.io.IOException;
 import java.nio.charset.StandardCharsets;
+import java.time.Duration;
 import java.util.ArrayDeque;
-import java.util.ArrayList;
-import java.util.List;
 import java.util.NoSuchElementException;
-import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.Queue;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentLinkedQueue;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.Executors;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
 import org.apache.beam.sdk.io.UnboundedSource;
 import org.apache.beam.sdk.io.UnboundedSource.UnboundedReader;
 import org.apache.beam.sdk.io.solace.broker.SempClient;
 import org.apache.beam.sdk.io.solace.broker.SessionService;
+import org.apache.beam.sdk.io.solace.broker.SessionServiceFactory;
 import org.apache.beam.sdk.transforms.windowing.BoundedWindow;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.annotations.VisibleForTesting;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.Cache;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.CacheBuilder;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.RemovalNotification;
 import org.checkerframework.checker.nullness.qual.Nullable;
 import org.joda.time.Instant;
 import org.slf4j.Logger;
@@ -46,48 +55,92 @@ class UnboundedSolaceReader<T> extends UnboundedReader<T> {
   private final UnboundedSolaceSource<T> currentSource;
   private final WatermarkPolicy<T> watermarkPolicy;
   private final SempClient sempClient;
+  private final UUID readerUuid;
+  private final SessionServiceFactory sessionServiceFactory;
   private @Nullable BytesXMLMessage solaceOriginalRecord;
   private @Nullable T solaceMappedRecord;
-  private @Nullable SessionService sessionService;
-  AtomicBoolean active = new AtomicBoolean(true);
 
   /**
-   * Queue to place advanced messages before {@link #getCheckpointMark()} be called non-concurrent
-   * queue, should only be accessed by the reader thread A given {@link UnboundedReader} object will
-   * only be accessed by a single thread at once.
+   * Queue to place advanced messages before {@link #getCheckpointMark()} is called. CAUTION:
+   * Accessed by both reader and checkpointing threads.
    */
-  private final java.util.Queue<BytesXMLMessage> elementsToCheckpoint = new ArrayDeque<>();
+  private final Queue<BytesXMLMessage> safeToAckMessages = new ConcurrentLinkedQueue<>();
+
+  /**
+   * Queue for messages that were ingested in the {@link #advance()} method, but not sent yet to a
+   * {@link SolaceCheckpointMark}.
+   */
+  private final Queue<BytesXMLMessage> receivedMessages = new ArrayDeque<>();
+
+  private static final Cache<UUID, SessionService> sessionServiceCache;
+  private static final ScheduledExecutorService cleanUpThread = Executors.newScheduledThreadPool(1);
+
+  static {
+    Duration cacheExpirationTimeout = Duration.ofMinutes(1);
+    sessionServiceCache =
+        CacheBuilder.newBuilder()
+            .expireAfterAccess(cacheExpirationTimeout)
+            .removalListener(
+                (RemovalNotification<UUID, SessionService> notification) -> {
+                  LOG.info(
+                      "SolaceIO.Read: Closing session for the reader with uuid {} as it has been idle for over {}.",
+                      notification.getKey(),
+                      cacheExpirationTimeout);
+                  SessionService sessionService = notification.getValue();
+                  if (sessionService != null) {
+                    sessionService.close();
+                  }
+                })
+            .build();
+
+    startCleanUpThread();
+  }
+
+  @SuppressWarnings("FutureReturnValueIgnored")
+  private static void startCleanUpThread() {
+    cleanUpThread.scheduleAtFixedRate(sessionServiceCache::cleanUp, 1, 1, TimeUnit.MINUTES);
+  }
 
   public UnboundedSolaceReader(UnboundedSolaceSource<T> currentSource) {
     this.currentSource = currentSource;
     this.watermarkPolicy =
         WatermarkPolicy.create(
             currentSource.getTimestampFn(), currentSource.getWatermarkIdleDurationThreshold());
-    this.sessionService = currentSource.getSessionServiceFactory().create();
+    this.sessionServiceFactory = currentSource.getSessionServiceFactory();
     this.sempClient = currentSource.getSempClientFactory().create();
+    this.readerUuid = UUID.randomUUID();
+  }
+
+  private SessionService getSessionService() {
+    try {
+      return sessionServiceCache.get(
+          readerUuid,
+          () -> {
+            LOG.info("SolaceIO.Read: creating a new session for reader with uuid {}.", readerUuid);
+            SessionService sessionService = sessionServiceFactory.create();
+            sessionService.connect();
+            sessionService.getReceiver().start();
+            return sessionService;
+          });
+    } catch (ExecutionException e) {
+      throw new RuntimeException(e);
+    }
   }
 
   @Override
   public boolean start() {
-    populateSession();
-    checkNotNull(sessionService).getReceiver().start();
+    // Create and initialize SessionService with Receiver
+    getSessionService();
     return advance();
   }
 
-  public void populateSession() {
-    if (sessionService == null) {
-      sessionService = getCurrentSource().getSessionServiceFactory().create();
-    }
-    if (sessionService.isClosed()) {
-      checkNotNull(sessionService).connect();
-    }
-  }
-
   @Override
   public boolean advance() {
+    finalizeReadyMessages();
+
     BytesXMLMessage receivedXmlMessage;
     try {
-      receivedXmlMessage = checkNotNull(sessionService).getReceiver().receive();
+      receivedXmlMessage = getSessionService().getReceiver().receive();
     } catch (IOException e) {
       LOG.warn("SolaceIO.Read: Exception when pulling messages from the broker.", e);
       return false;
@@ -96,23 +149,40 @@ public boolean advance() {
     if (receivedXmlMessage == null) {
       return false;
     }
-    elementsToCheckpoint.add(receivedXmlMessage);
     solaceOriginalRecord = receivedXmlMessage;
     solaceMappedRecord = getCurrentSource().getParseFn().apply(receivedXmlMessage);
-    watermarkPolicy.update(solaceMappedRecord);
+    receivedMessages.add(receivedXmlMessage);
+
     return true;
   }
 
   @Override
   public void close() {
-    active.set(false);
-    checkNotNull(sessionService).close();
+    finalizeReadyMessages();
+    sessionServiceCache.invalidate(readerUuid);
+  }
+
+  public void finalizeReadyMessages() {
+    BytesXMLMessage msg;
+    while ((msg = safeToAckMessages.poll()) != null) {
+      try {
+        msg.ackMessage();
+      } catch (IllegalStateException e) {
+        LOG.error(
+            "SolaceIO.Read: failed to acknowledge the message with applicationMessageId={}, ackMessageId={}. Returning the message to queue to retry.",
+            msg.getApplicationMessageId(),
+            msg.getAckMessageId(),
+            e);
+        safeToAckMessages.add(msg); // In case the error was transient, might succeed later
+        break; // Commit is only best effort
+      }
+    }
   }
 
   @Override
   public Instant getWatermark() {
     // should be only used by a test receiver
-    if (checkNotNull(sessionService).getReceiver().isEOF()) {
+    if (getSessionService().getReceiver().isEOF()) {
       return BoundedWindow.TIMESTAMP_MAX_VALUE;
     }
     return watermarkPolicy.getWatermark();
@@ -120,14 +190,9 @@ public Instant getWatermark() {
 
   @Override
   public UnboundedSource.CheckpointMark getCheckpointMark() {
-    List<BytesXMLMessage> ackQueue = new ArrayList<>();
-    while (!elementsToCheckpoint.isEmpty()) {
-      BytesXMLMessage msg = elementsToCheckpoint.poll();
-      if (msg != null) {
-        ackQueue.add(msg);
-      }
-    }
-    return new SolaceCheckpointMark(active, ackQueue);
+    safeToAckMessages.addAll(receivedMessages);
+    receivedMessages.clear();
+    return new SolaceCheckpointMark(safeToAckMessages);
   }
 
   @Override
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java
index 38b4953a5984..7631d32f63cc 100644
--- a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java
@@ -40,11 +40,6 @@ public void close() {
     throw new UnsupportedOperationException(exceptionMessage);
   }
 
-  @Override
-  public boolean isClosed() {
-    throw new UnsupportedOperationException(exceptionMessage);
-  }
-
   @Override
   public MessageReceiver getReceiver() {
     throw new UnsupportedOperationException(exceptionMessage);
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java
index bd52dee7ea86..6d28bcefc84c 100644
--- a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java
@@ -77,11 +77,6 @@ public abstract Builder mockProducerFn(
   @Override
   public void close() {}
 
-  @Override
-  public boolean isClosed() {
-    return false;
-  }
-
   @Override
   public MessageReceiver getReceiver() {
     if (messageReceiver == null) {
@@ -131,11 +126,6 @@ public MockReceiver(
     @Override
     public void start() {}
 
-    @Override
-    public boolean isClosed() {
-      return false;
-    }
-
     @Override
     public BytesXMLMessage receive() throws IOException {
       return getRecordFn.apply(counter.getAndIncrement());
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java
index c718c55e1b48..a1f80932eddf 100644
--- a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java
@@ -447,25 +447,29 @@ public void testCheckpointMarkAndFinalizeSeparately() throws Exception {
     // start the reader and move to the first record
     assertTrue(reader.start());
 
-    // consume 3 messages (NB: start already consumed the first message)
+    // consume 3 messages (NB: #start() already consumed the first message)
     for (int i = 0; i < 3; i++) {
       assertTrue(String.format("Failed at %d-th message", i), reader.advance());
     }
 
-    // create checkpoint but don't finalize yet
+    // #advance() was called, but the messages were not ready to be acknowledged.
+    assertEquals(0, countAckMessages.get());
+
+    // mark all consumed messages as ready to be acknowledged
     CheckpointMark checkpointMark = reader.getCheckpointMark();
 
-    // consume 2 more messages
-    reader.advance();
+    // consume 1 more message. This will call #ackMsg() on messages that were ready to be acked.
     reader.advance();
+    assertEquals(4, countAckMessages.get());
 
-    // check if messages are still not acknowledged
-    assertEquals(0, countAckMessages.get());
+    // consume 1 more message. No change in the acknowledged messages.
+    reader.advance();
+    assertEquals(4, countAckMessages.get());
 
     // acknowledge from the first checkpoint
     checkpointMark.finalizeCheckpoint();
-
-    // only messages from the first checkpoint are acknowledged
+    // No change in the acknowledged messages, because they were acknowledged in the #advance()
+    // method.
     assertEquals(4, countAckMessages.get());
   }
 

From 0ec76af32f4b3ebe3644d06e2634ba44ea4d3be5 Mon Sep 17 00:00:00 2001
From: Damon <damondouglas@users.noreply.github.com>
Date: Mon, 2 Dec 2024 07:55:39 -0800
Subject: [PATCH 045/135] Fix java validatesdistrolesscontainer dataflow
 workflow (#33245)

* Set testJavaVersion in each run

* Modify trigger file

* Add dockerTag
---
 ...ommit_Java_ValidatesDistrolessContainer_Dataflow.json | 2 +-
 ...Commit_Java_ValidatesDistrolessContainer_Dataflow.yml | 9 ++++++++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/.github/trigger_files/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.json b/.github/trigger_files/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.json
index e3d6056a5de9..b26833333238 100644
--- a/.github/trigger_files/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.json
+++ b/.github/trigger_files/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.json
@@ -1,4 +1,4 @@
 {
   "comment": "Modify this file in a trivial way to cause this test suite to run",
-  "modification": 1
+  "modification": 2
 }
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml b/.github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml
index 98b604be00e8..4fb236c7c991 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml
@@ -88,10 +88,17 @@ jobs:
           gcloud auth configure-docker us.gcr.io --quiet
           gcloud auth configure-docker gcr.io --quiet
           gcloud auth configure-docker us-central1-docker.pkg.dev --quiet
-      - name: run validatesDistrolessContainer script
+      - name: run validatesDistrolessContainer script (Java 17)
         uses: ./.github/actions/gradle-command-self-hosted-action
         with:
           gradle-command: :runners:google-cloud-dataflow-java:examplesJavaRunnerV2IntegrationTestDistroless
+          arguments: '-PtestJavaVersion=java17 -PdockerTag=$(date +%s)'
+          max-workers: 12
+      - name: run validatesDistrolessContainer script (Java 21)
+        uses: ./.github/actions/gradle-command-self-hosted-action
+        with:
+          gradle-command: :runners:google-cloud-dataflow-java:examplesJavaRunnerV2IntegrationTestDistroless
+          arguments: '-PtestJavaVersion=java21 -PdockerTag=$(date +%s)'
           max-workers: 12
       - name: Archive JUnit Test Results
         uses: actions/upload-artifact@v4

From 2481d4bece762507a286203cb4dbcd065273a95b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 2 Dec 2024 11:32:07 -0500
Subject: [PATCH 046/135] Bump golang.org/x/net from 0.30.0 to 0.31.0 in /sdks
 (#33111)

Bumps [golang.org/x/net](https://github.com/golang/net) from 0.30.0 to 0.31.0.
- [Commits](https://github.com/golang/net/compare/v0.30.0...v0.31.0)

---
updated-dependencies:
- dependency-name: golang.org/x/net
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod |  8 ++++----
 sdks/go.sum | 20 ++++++++++----------
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index 42f099d747bb..ed2c7402fd42 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -53,11 +53,11 @@ require (
 	github.com/xitongsys/parquet-go v1.6.2
 	github.com/xitongsys/parquet-go-source v0.0.0-20220315005136-aec0fe3e777c
 	go.mongodb.org/mongo-driver v1.17.1
-	golang.org/x/net v0.30.0
+	golang.org/x/net v0.31.0
 	golang.org/x/oauth2 v0.23.0
-	golang.org/x/sync v0.8.0
+	golang.org/x/sync v0.9.0
 	golang.org/x/sys v0.27.0
-	golang.org/x/text v0.19.0
+	golang.org/x/text v0.20.0
 	google.golang.org/api v0.203.0
 	google.golang.org/genproto v0.0.0-20241015192408-796eee8c2d53
 	google.golang.org/grpc v1.67.1
@@ -190,7 +190,7 @@ require (
 	github.com/youmark/pkcs8 v0.0.0-20240726163527-a2c0da244d78 // indirect
 	github.com/zeebo/xxh3 v1.0.2 // indirect
 	go.opencensus.io v0.24.0 // indirect
-	golang.org/x/crypto v0.28.0 // indirect
+	golang.org/x/crypto v0.29.0 // indirect
 	golang.org/x/mod v0.20.0 // indirect
 	golang.org/x/tools v0.24.0 // indirect
 	golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da // indirect
diff --git a/sdks/go.sum b/sdks/go.sum
index 5e42448c7d50..1e7713fa2b6a 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -1264,8 +1264,8 @@ golang.org/x/crypto v0.0.0-20210421170649-83a5a9bb288b/go.mod h1:T9bdIzuCu7OtxOm
 golang.org/x/crypto v0.0.0-20210513164829-c07d793c2f9a/go.mod h1:P+XmwS30IXTQdn5tA2iutPOUgjI07+tq3H3K9MVA1s8=
 golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
 golang.org/x/crypto v0.0.0-20211108221036-ceb1ce70b4fa/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
-golang.org/x/crypto v0.28.0 h1:GBDwsMXVQi34v5CCYUm2jkJvu4cbtru2U4TN2PSyQnw=
-golang.org/x/crypto v0.28.0/go.mod h1:rmgy+3RHxRZMyY0jjAJShp2zgEdOqj2AO7U0pYmeQ7U=
+golang.org/x/crypto v0.29.0 h1:L5SG1JTTXupVV3n6sUqMTeWbjAyfPwoda2DLX8J8FrQ=
+golang.org/x/crypto v0.29.0/go.mod h1:+F4F4N5hv6v38hfeYwTdx20oUvLLc+QfrE9Ax9HtgRg=
 golang.org/x/exp v0.0.0-20180321215751-8460e604b9de/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
 golang.org/x/exp v0.0.0-20180807140117-3d87b88a115f/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
 golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
@@ -1386,8 +1386,8 @@ golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs=
 golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs=
 golang.org/x/net v0.8.0/go.mod h1:QVkue5JL9kW//ek3r6jTKnTFis1tRmNAW2P1shuFdJc=
 golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns=
-golang.org/x/net v0.30.0 h1:AcW1SDZMkb8IpzCdQUaIq2sP4sZ4zw+55h6ynffypl4=
-golang.org/x/net v0.30.0/go.mod h1:2wGyMJ5iFasEhkwi13ChkO/t1ECNC4X4eBKkVFyYFlU=
+golang.org/x/net v0.31.0 h1:68CPQngjLL0r2AlUKiSxtQFKvzRVbnzLwMUn5SzcLHo=
+golang.org/x/net v0.31.0/go.mod h1:P4fl1q7dY2hnZFxEk4pPSkDHF+QqjitcnDjUQyMM+pM=
 golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U=
 golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
 golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
@@ -1435,8 +1435,8 @@ golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJ
 golang.org/x/sync v0.0.0-20220819030929-7fc1605a5dde/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20220929204114-8fcdb60fdcc0/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.1.0/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.8.0 h1:3NFvSEYkUoMifnESzZl15y791HH1qU2xm6eCJU5ZPXQ=
-golang.org/x/sync v0.8.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=
+golang.org/x/sync v0.9.0 h1:fEo0HyrW1GIgZdpbhCRO0PkJajUS5H9IFUztCgEo2jQ=
+golang.org/x/sync v0.9.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=
 golang.org/x/sys v0.0.0-20180830151530-49385e6e1522/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
 golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
 golang.org/x/sys v0.0.0-20190312061237-fead79001313/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
@@ -1534,8 +1534,8 @@ golang.org/x/term v0.4.0/go.mod h1:9P2UbLfCdcvo3p/nzKvsmas4TnlujnuoV9hGgYzW1lQ=
 golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k=
 golang.org/x/term v0.6.0/go.mod h1:m6U89DPEgQRMq3DNkDClhWw02AUbt2daBVO4cn4Hv9U=
 golang.org/x/term v0.7.0/go.mod h1:P32HKFT3hSsZrRxla30E9HqToFYAQPCMs/zFMBUFqPY=
-golang.org/x/term v0.25.0 h1:WtHI/ltw4NvSUig5KARz9h521QvRC8RmF/cuYqifU24=
-golang.org/x/term v0.25.0/go.mod h1:RPyXicDX+6vLxogjjRxjgD2TKtmAO6NZBsBRfrOLu7M=
+golang.org/x/term v0.26.0 h1:WEQa6V3Gja/BhNxg540hBip/kkaYtRg3cxg4oXSw4AU=
+golang.org/x/term v0.26.0/go.mod h1:Si5m1o57C5nBNQo5z1iq+XDijt21BDBDp2bK0QI8e3E=
 golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.1-0.20180807135948-17ff2d5776d2/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
@@ -1552,8 +1552,8 @@ golang.org/x/text v0.6.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
 golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
 golang.org/x/text v0.8.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8=
 golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8=
-golang.org/x/text v0.19.0 h1:kTxAhCbGbxhK0IwgSKiMO5awPoDQ0RpfiVYBfK860YM=
-golang.org/x/text v0.19.0/go.mod h1:BuEKDfySbSR4drPmRPG/7iBdf8hvFMuRexcpahXilzY=
+golang.org/x/text v0.20.0 h1:gK/Kv2otX8gz+wn7Rmb3vT96ZwuoxnQlY+HlJVj7Qug=
+golang.org/x/text v0.20.0/go.mod h1:D4IsuqiFMhST5bX19pQ9ikHC2GsaKyk/oF+pn3ducp4=
 golang.org/x/time v0.0.0-20181108054448-85acf8d2951c/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
 golang.org/x/time v0.0.0-20190308202827-9d24e82272b4/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
 golang.org/x/time v0.0.0-20191024005414-555d28b269f0/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=

From 2141dd7c1288898b92ecaf40129635a675295ea9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 2 Dec 2024 11:32:49 -0500
Subject: [PATCH 047/135] Bump cloud.google.com/go/spanner from 1.70.0 to
 1.73.0 in /sdks (#33126)

Bumps [cloud.google.com/go/spanner](https://github.com/googleapis/google-cloud-go) from 1.70.0 to 1.73.0.
- [Release notes](https://github.com/googleapis/google-cloud-go/releases)
- [Changelog](https://github.com/googleapis/google-cloud-go/blob/main/CHANGES.md)
- [Commits](https://github.com/googleapis/google-cloud-go/compare/spanner/v1.70.0...spanner/v1.73.0)

---
updated-dependencies:
- dependency-name: cloud.google.com/go/spanner
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 2 +-
 sdks/go.sum | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index ed2c7402fd42..fc4c60006fe1 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -28,7 +28,7 @@ require (
 	cloud.google.com/go/datastore v1.20.0
 	cloud.google.com/go/profiler v0.4.1
 	cloud.google.com/go/pubsub v1.45.1
-	cloud.google.com/go/spanner v1.70.0
+	cloud.google.com/go/spanner v1.73.0
 	cloud.google.com/go/storage v1.45.0
 	github.com/aws/aws-sdk-go-v2 v1.32.4
 	github.com/aws/aws-sdk-go-v2/config v1.28.4
diff --git a/sdks/go.sum b/sdks/go.sum
index 1e7713fa2b6a..bbc0d0d22204 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -542,8 +542,8 @@ cloud.google.com/go/shell v1.6.0/go.mod h1:oHO8QACS90luWgxP3N9iZVuEiSF84zNyLytb+
 cloud.google.com/go/spanner v1.41.0/go.mod h1:MLYDBJR/dY4Wt7ZaMIQ7rXOTLjYrmxLE/5ve9vFfWos=
 cloud.google.com/go/spanner v1.44.0/go.mod h1:G8XIgYdOK+Fbcpbs7p2fiprDw4CaZX63whnSMLVBxjk=
 cloud.google.com/go/spanner v1.45.0/go.mod h1:FIws5LowYz8YAE1J8fOS7DJup8ff7xJeetWEo5REA2M=
-cloud.google.com/go/spanner v1.70.0 h1:nj6p/GJTgMDiSQ1gQ034ItsKuJgHiMOjtOlONOg8PSo=
-cloud.google.com/go/spanner v1.70.0/go.mod h1:X5T0XftydYp0K1adeJQDJtdWpbrOeJ7wHecM4tK6FiE=
+cloud.google.com/go/spanner v1.73.0 h1:0bab8QDn6MNj9lNK6XyGAVFhMlhMU2waePPa6GZNoi8=
+cloud.google.com/go/spanner v1.73.0/go.mod h1:mw98ua5ggQXVWwp83yjwggqEmW9t8rjs9Po1ohcUGW4=
 cloud.google.com/go/speech v1.6.0/go.mod h1:79tcr4FHCimOp56lwC01xnt/WPJZc4v3gzyT7FoBkCM=
 cloud.google.com/go/speech v1.7.0/go.mod h1:KptqL+BAQIhMsj1kOP2la5DSEEerPDuOP/2mmkhHhZQ=
 cloud.google.com/go/speech v1.8.0/go.mod h1:9bYIl1/tjsAnMgKGHKmBZzXKEkGgtU+MpdDPTE9f7y0=

From 7e25649b88b1ac08e48db28f8af09978b649da17 Mon Sep 17 00:00:00 2001
From: Yi Hu <yathu@google.com>
Date: Mon, 2 Dec 2024 11:49:50 -0500
Subject: [PATCH 048/135] Revert "bump hadoop version (#33011)" (#33257)

This reverts commit 95322c69a18254a5e08f5c9259861450752b04cd.
---
 CHANGES.md                                                      | 1 -
 .../main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy  | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/CHANGES.md b/CHANGES.md
index 8dd1e89aec91..c120906fdd0d 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -63,7 +63,6 @@
 ## I/Os
 
 * Support for X source added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
-* Upgraded the default version of Hadoop dependencies to 3.4.1. Hadoop 2.10.2 is still supported (Java) ([#33011](https://github.com/apache/beam/issues/33011)).
 
 ## New Features / Improvements
 
diff --git a/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy b/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
index 2abd43a5d4cc..84c7c3ecfd4a 100644
--- a/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
+++ b/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
@@ -614,7 +614,7 @@ class BeamModulePlugin implements Plugin<Project> {
     // [bomupgrader] determined by: io.grpc:grpc-netty, consistent with: google_cloud_platform_libraries_bom
     def grpc_version = "1.67.1"
     def guava_version = "33.1.0-jre"
-    def hadoop_version = "3.4.1"
+    def hadoop_version = "2.10.2"
     def hamcrest_version = "2.1"
     def influxdb_version = "2.19"
     def httpclient_version = "4.5.13"

From 4356253a5e8124bf39152a9ead9ad26ef7267750 Mon Sep 17 00:00:00 2001
From: Bartosz Zablocki <bzablocki@google.com>
Date: Mon, 2 Dec 2024 18:18:42 +0000
Subject: [PATCH 049/135] Revert "SolaceIO.Read: handle occasional cases when
 finalizeCheckpoint is not executed (#32962)" (#33259)

This reverts commit e279e55f47683bcee1c59c0b7aea2b21741fadb3.
---
 .../broker/BasicAuthJcsmpSessionService.java  |  18 ++-
 .../sdk/io/solace/broker/MessageReceiver.java |   7 +
 .../sdk/io/solace/broker/SessionService.java  |   7 +
 .../solace/broker/SolaceMessageReceiver.java  |  17 ++-
 .../io/solace/read/SolaceCheckpointMark.java  |  46 +++---
 .../io/solace/read/UnboundedSolaceReader.java | 135 +++++-------------
 .../io/solace/MockEmptySessionService.java    |   5 +
 .../sdk/io/solace/MockSessionService.java     |  10 ++
 .../beam/sdk/io/solace/SolaceIOReadTest.java  |  20 ++-
 9 files changed, 127 insertions(+), 138 deletions(-)

diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java
index d4c9a3ec6210..b2196dbf1067 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java
@@ -102,7 +102,10 @@ public void close() {
           if (messageReceiver != null) {
             messageReceiver.close();
           }
-          if (jcsmpSession != null) {
+          if (messageProducer != null) {
+            messageProducer.close();
+          }
+          if (!isClosed()) {
             checkStateNotNull(jcsmpSession).closeSession();
           }
           return 0;
@@ -116,9 +119,8 @@ public MessageReceiver getReceiver() {
       this.messageReceiver =
           retryCallableManager.retryCallable(
               this::createFlowReceiver, ImmutableSet.of(JCSMPException.class));
-      this.messageReceiver.start();
     }
-    return checkStateNotNull(this.messageReceiver);
+    return this.messageReceiver;
   }
 
   @Override
@@ -136,10 +138,15 @@ public java.util.Queue<PublishResult> getPublishedResultsQueue() {
     return publishedResultsQueue;
   }
 
+  @Override
+  public boolean isClosed() {
+    return jcsmpSession == null || jcsmpSession.isClosed();
+  }
+
   private MessageProducer createXMLMessageProducer(SubmissionMode submissionMode)
       throws JCSMPException, IOException {
 
-    if (jcsmpSession == null) {
+    if (isClosed()) {
       connectWriteSession(submissionMode);
     }
 
@@ -158,6 +165,9 @@ private MessageProducer createXMLMessageProducer(SubmissionMode submissionMode)
   }
 
   private MessageReceiver createFlowReceiver() throws JCSMPException, IOException {
+    if (isClosed()) {
+      connectSession();
+    }
 
     Queue queue =
         JCSMPFactory.onlyInstance()
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java
index 017a63260678..95f989bd1be9 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java
@@ -35,6 +35,13 @@ public interface MessageReceiver {
    */
   void start();
 
+  /**
+   * Returns {@literal true} if the message receiver is closed, {@literal false} otherwise.
+   *
+   * <p>A message receiver is closed when it is no longer able to receive messages.
+   */
+  boolean isClosed();
+
   /**
    * Receives a message from the broker.
    *
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java
index 6dcd0b652616..84a876a9d0bc 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java
@@ -120,6 +120,13 @@ public abstract class SessionService implements Serializable {
   /** Gracefully closes the connection to the service. */
   public abstract void close();
 
+  /**
+   * Checks whether the connection to the service is currently closed. This method is called when an
+   * `UnboundedSolaceReader` is starting to read messages - a session will be created if this
+   * returns true.
+   */
+  public abstract boolean isClosed();
+
   /**
    * Returns a MessageReceiver object for receiving messages from Solace. If it is the first time
    * this method is used, the receiver is created from the session instance, otherwise it returns
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java
index d74f3cae89fe..d548d2049a5b 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java
@@ -24,8 +24,12 @@
 import java.io.IOException;
 import org.apache.beam.sdk.io.solace.RetryCallableManager;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableSet;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 public class SolaceMessageReceiver implements MessageReceiver {
+  private static final Logger LOG = LoggerFactory.getLogger(SolaceMessageReceiver.class);
+
   public static final int DEFAULT_ADVANCE_TIMEOUT_IN_MILLIS = 100;
   private final FlowReceiver flowReceiver;
   private final RetryCallableManager retryCallableManager = RetryCallableManager.create();
@@ -48,14 +52,19 @@ private void startFlowReceiver() {
         ImmutableSet.of(JCSMPException.class));
   }
 
+  @Override
+  public boolean isClosed() {
+    return flowReceiver == null || flowReceiver.isClosed();
+  }
+
   @Override
   public BytesXMLMessage receive() throws IOException {
     try {
       return flowReceiver.receive(DEFAULT_ADVANCE_TIMEOUT_IN_MILLIS);
     } catch (StaleSessionException e) {
+      LOG.warn("SolaceIO: Caught StaleSessionException, restarting the FlowReceiver.");
       startFlowReceiver();
-      throw new IOException(
-          "SolaceIO: Caught StaleSessionException, restarting the FlowReceiver.", e);
+      throw new IOException(e);
     } catch (JCSMPException e) {
       throw new IOException(e);
     }
@@ -63,6 +72,8 @@ public BytesXMLMessage receive() throws IOException {
 
   @Override
   public void close() {
-    flowReceiver.close();
+    if (!isClosed()) {
+      this.flowReceiver.close();
+    }
   }
 }
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java
index a913fd6133ea..77f6eed8f62c 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java
@@ -18,16 +18,17 @@
 package org.apache.beam.sdk.io.solace.read;
 
 import com.solacesystems.jcsmp.BytesXMLMessage;
+import java.util.ArrayDeque;
+import java.util.ArrayList;
+import java.util.List;
 import java.util.Objects;
-import java.util.Queue;
+import java.util.concurrent.atomic.AtomicBoolean;
 import org.apache.beam.sdk.annotations.Internal;
 import org.apache.beam.sdk.coders.DefaultCoder;
 import org.apache.beam.sdk.extensions.avro.coders.AvroCoder;
 import org.apache.beam.sdk.io.UnboundedSource;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.annotations.VisibleForTesting;
 import org.checkerframework.checker.nullness.qual.Nullable;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * Checkpoint for an unbounded Solace source. Consists of the Solace messages waiting to be
@@ -37,8 +38,10 @@
 @Internal
 @VisibleForTesting
 public class SolaceCheckpointMark implements UnboundedSource.CheckpointMark {
-  private static final Logger LOG = LoggerFactory.getLogger(SolaceCheckpointMark.class);
-  private transient Queue<BytesXMLMessage> safeToAck;
+  private transient AtomicBoolean activeReader;
+  // BytesXMLMessage is not serializable so if a job restarts from the checkpoint, we cannot retry
+  // these messages here. We relay on Solace's retry mechanism.
+  private transient ArrayDeque<BytesXMLMessage> ackQueue;
 
   @SuppressWarnings("initialization") // Avro will set the fields by breaking abstraction
   private SolaceCheckpointMark() {}
@@ -46,24 +49,25 @@ private SolaceCheckpointMark() {}
   /**
    * Creates a new {@link SolaceCheckpointMark}.
    *
-   * @param safeToAck - a queue of {@link BytesXMLMessage} to be acknowledged.
+   * @param activeReader {@link AtomicBoolean} indicating if the related reader is active. The
+   *     reader creating the messages has to be active to acknowledge the messages.
+   * @param ackQueue {@link List} of {@link BytesXMLMessage} to be acknowledged.
    */
-  SolaceCheckpointMark(Queue<BytesXMLMessage> safeToAck) {
-    this.safeToAck = safeToAck;
+  SolaceCheckpointMark(AtomicBoolean activeReader, List<BytesXMLMessage> ackQueue) {
+    this.activeReader = activeReader;
+    this.ackQueue = new ArrayDeque<>(ackQueue);
   }
 
   @Override
   public void finalizeCheckpoint() {
-    BytesXMLMessage msg;
-    while ((msg = safeToAck.poll()) != null) {
-      try {
+    if (activeReader == null || !activeReader.get() || ackQueue == null) {
+      return;
+    }
+
+    while (!ackQueue.isEmpty()) {
+      BytesXMLMessage msg = ackQueue.poll();
+      if (msg != null) {
         msg.ackMessage();
-      } catch (IllegalStateException e) {
-        LOG.error(
-            "SolaceIO.Read: cannot acknowledge the message with applicationMessageId={}, ackMessageId={}. It will not be retried.",
-            msg.getApplicationMessageId(),
-            msg.getAckMessageId(),
-            e);
       }
     }
   }
@@ -80,11 +84,15 @@ public boolean equals(@Nullable Object o) {
       return false;
     }
     SolaceCheckpointMark that = (SolaceCheckpointMark) o;
-    return Objects.equals(safeToAck, that.safeToAck);
+    // Needed to convert to ArrayList because ArrayDeque.equals checks only for reference, not
+    // content.
+    ArrayList<BytesXMLMessage> ackList = new ArrayList<>(ackQueue);
+    ArrayList<BytesXMLMessage> thatAckList = new ArrayList<>(that.ackQueue);
+    return Objects.equals(activeReader, that.activeReader) && Objects.equals(ackList, thatAckList);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(safeToAck);
+    return Objects.hash(activeReader, ackQueue);
   }
 }
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java
index dc84e0a07017..a421970370da 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java
@@ -22,26 +22,17 @@
 import com.solacesystems.jcsmp.BytesXMLMessage;
 import java.io.IOException;
 import java.nio.charset.StandardCharsets;
-import java.time.Duration;
 import java.util.ArrayDeque;
+import java.util.ArrayList;
+import java.util.List;
 import java.util.NoSuchElementException;
-import java.util.Queue;
-import java.util.UUID;
-import java.util.concurrent.ConcurrentLinkedQueue;
-import java.util.concurrent.ExecutionException;
-import java.util.concurrent.Executors;
-import java.util.concurrent.ScheduledExecutorService;
-import java.util.concurrent.TimeUnit;
+import java.util.concurrent.atomic.AtomicBoolean;
 import org.apache.beam.sdk.io.UnboundedSource;
 import org.apache.beam.sdk.io.UnboundedSource.UnboundedReader;
 import org.apache.beam.sdk.io.solace.broker.SempClient;
 import org.apache.beam.sdk.io.solace.broker.SessionService;
-import org.apache.beam.sdk.io.solace.broker.SessionServiceFactory;
 import org.apache.beam.sdk.transforms.windowing.BoundedWindow;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.annotations.VisibleForTesting;
-import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.Cache;
-import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.CacheBuilder;
-import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.RemovalNotification;
 import org.checkerframework.checker.nullness.qual.Nullable;
 import org.joda.time.Instant;
 import org.slf4j.Logger;
@@ -55,92 +46,48 @@ class UnboundedSolaceReader<T> extends UnboundedReader<T> {
   private final UnboundedSolaceSource<T> currentSource;
   private final WatermarkPolicy<T> watermarkPolicy;
   private final SempClient sempClient;
-  private final UUID readerUuid;
-  private final SessionServiceFactory sessionServiceFactory;
   private @Nullable BytesXMLMessage solaceOriginalRecord;
   private @Nullable T solaceMappedRecord;
+  private @Nullable SessionService sessionService;
+  AtomicBoolean active = new AtomicBoolean(true);
 
   /**
-   * Queue to place advanced messages before {@link #getCheckpointMark()} is called. CAUTION:
-   * Accessed by both reader and checkpointing threads.
+   * Queue to place advanced messages before {@link #getCheckpointMark()} be called non-concurrent
+   * queue, should only be accessed by the reader thread A given {@link UnboundedReader} object will
+   * only be accessed by a single thread at once.
    */
-  private final Queue<BytesXMLMessage> safeToAckMessages = new ConcurrentLinkedQueue<>();
-
-  /**
-   * Queue for messages that were ingested in the {@link #advance()} method, but not sent yet to a
-   * {@link SolaceCheckpointMark}.
-   */
-  private final Queue<BytesXMLMessage> receivedMessages = new ArrayDeque<>();
-
-  private static final Cache<UUID, SessionService> sessionServiceCache;
-  private static final ScheduledExecutorService cleanUpThread = Executors.newScheduledThreadPool(1);
-
-  static {
-    Duration cacheExpirationTimeout = Duration.ofMinutes(1);
-    sessionServiceCache =
-        CacheBuilder.newBuilder()
-            .expireAfterAccess(cacheExpirationTimeout)
-            .removalListener(
-                (RemovalNotification<UUID, SessionService> notification) -> {
-                  LOG.info(
-                      "SolaceIO.Read: Closing session for the reader with uuid {} as it has been idle for over {}.",
-                      notification.getKey(),
-                      cacheExpirationTimeout);
-                  SessionService sessionService = notification.getValue();
-                  if (sessionService != null) {
-                    sessionService.close();
-                  }
-                })
-            .build();
-
-    startCleanUpThread();
-  }
-
-  @SuppressWarnings("FutureReturnValueIgnored")
-  private static void startCleanUpThread() {
-    cleanUpThread.scheduleAtFixedRate(sessionServiceCache::cleanUp, 1, 1, TimeUnit.MINUTES);
-  }
+  private final java.util.Queue<BytesXMLMessage> elementsToCheckpoint = new ArrayDeque<>();
 
   public UnboundedSolaceReader(UnboundedSolaceSource<T> currentSource) {
     this.currentSource = currentSource;
     this.watermarkPolicy =
         WatermarkPolicy.create(
             currentSource.getTimestampFn(), currentSource.getWatermarkIdleDurationThreshold());
-    this.sessionServiceFactory = currentSource.getSessionServiceFactory();
+    this.sessionService = currentSource.getSessionServiceFactory().create();
     this.sempClient = currentSource.getSempClientFactory().create();
-    this.readerUuid = UUID.randomUUID();
-  }
-
-  private SessionService getSessionService() {
-    try {
-      return sessionServiceCache.get(
-          readerUuid,
-          () -> {
-            LOG.info("SolaceIO.Read: creating a new session for reader with uuid {}.", readerUuid);
-            SessionService sessionService = sessionServiceFactory.create();
-            sessionService.connect();
-            sessionService.getReceiver().start();
-            return sessionService;
-          });
-    } catch (ExecutionException e) {
-      throw new RuntimeException(e);
-    }
   }
 
   @Override
   public boolean start() {
-    // Create and initialize SessionService with Receiver
-    getSessionService();
+    populateSession();
+    checkNotNull(sessionService).getReceiver().start();
     return advance();
   }
 
+  public void populateSession() {
+    if (sessionService == null) {
+      sessionService = getCurrentSource().getSessionServiceFactory().create();
+    }
+    if (sessionService.isClosed()) {
+      checkNotNull(sessionService).connect();
+    }
+  }
+
   @Override
   public boolean advance() {
-    finalizeReadyMessages();
-
     BytesXMLMessage receivedXmlMessage;
     try {
-      receivedXmlMessage = getSessionService().getReceiver().receive();
+      receivedXmlMessage = checkNotNull(sessionService).getReceiver().receive();
     } catch (IOException e) {
       LOG.warn("SolaceIO.Read: Exception when pulling messages from the broker.", e);
       return false;
@@ -149,40 +96,23 @@ public boolean advance() {
     if (receivedXmlMessage == null) {
       return false;
     }
+    elementsToCheckpoint.add(receivedXmlMessage);
     solaceOriginalRecord = receivedXmlMessage;
     solaceMappedRecord = getCurrentSource().getParseFn().apply(receivedXmlMessage);
-    receivedMessages.add(receivedXmlMessage);
-
+    watermarkPolicy.update(solaceMappedRecord);
     return true;
   }
 
   @Override
   public void close() {
-    finalizeReadyMessages();
-    sessionServiceCache.invalidate(readerUuid);
-  }
-
-  public void finalizeReadyMessages() {
-    BytesXMLMessage msg;
-    while ((msg = safeToAckMessages.poll()) != null) {
-      try {
-        msg.ackMessage();
-      } catch (IllegalStateException e) {
-        LOG.error(
-            "SolaceIO.Read: failed to acknowledge the message with applicationMessageId={}, ackMessageId={}. Returning the message to queue to retry.",
-            msg.getApplicationMessageId(),
-            msg.getAckMessageId(),
-            e);
-        safeToAckMessages.add(msg); // In case the error was transient, might succeed later
-        break; // Commit is only best effort
-      }
-    }
+    active.set(false);
+    checkNotNull(sessionService).close();
   }
 
   @Override
   public Instant getWatermark() {
     // should be only used by a test receiver
-    if (getSessionService().getReceiver().isEOF()) {
+    if (checkNotNull(sessionService).getReceiver().isEOF()) {
       return BoundedWindow.TIMESTAMP_MAX_VALUE;
     }
     return watermarkPolicy.getWatermark();
@@ -190,9 +120,14 @@ public Instant getWatermark() {
 
   @Override
   public UnboundedSource.CheckpointMark getCheckpointMark() {
-    safeToAckMessages.addAll(receivedMessages);
-    receivedMessages.clear();
-    return new SolaceCheckpointMark(safeToAckMessages);
+    List<BytesXMLMessage> ackQueue = new ArrayList<>();
+    while (!elementsToCheckpoint.isEmpty()) {
+      BytesXMLMessage msg = elementsToCheckpoint.poll();
+      if (msg != null) {
+        ackQueue.add(msg);
+      }
+    }
+    return new SolaceCheckpointMark(active, ackQueue);
   }
 
   @Override
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java
index 7631d32f63cc..38b4953a5984 100644
--- a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java
@@ -40,6 +40,11 @@ public void close() {
     throw new UnsupportedOperationException(exceptionMessage);
   }
 
+  @Override
+  public boolean isClosed() {
+    throw new UnsupportedOperationException(exceptionMessage);
+  }
+
   @Override
   public MessageReceiver getReceiver() {
     throw new UnsupportedOperationException(exceptionMessage);
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java
index 6d28bcefc84c..bd52dee7ea86 100644
--- a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java
@@ -77,6 +77,11 @@ public abstract Builder mockProducerFn(
   @Override
   public void close() {}
 
+  @Override
+  public boolean isClosed() {
+    return false;
+  }
+
   @Override
   public MessageReceiver getReceiver() {
     if (messageReceiver == null) {
@@ -126,6 +131,11 @@ public MockReceiver(
     @Override
     public void start() {}
 
+    @Override
+    public boolean isClosed() {
+      return false;
+    }
+
     @Override
     public BytesXMLMessage receive() throws IOException {
       return getRecordFn.apply(counter.getAndIncrement());
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java
index a1f80932eddf..c718c55e1b48 100644
--- a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java
@@ -447,29 +447,25 @@ public void testCheckpointMarkAndFinalizeSeparately() throws Exception {
     // start the reader and move to the first record
     assertTrue(reader.start());
 
-    // consume 3 messages (NB: #start() already consumed the first message)
+    // consume 3 messages (NB: start already consumed the first message)
     for (int i = 0; i < 3; i++) {
       assertTrue(String.format("Failed at %d-th message", i), reader.advance());
     }
 
-    // #advance() was called, but the messages were not ready to be acknowledged.
-    assertEquals(0, countAckMessages.get());
-
-    // mark all consumed messages as ready to be acknowledged
+    // create checkpoint but don't finalize yet
     CheckpointMark checkpointMark = reader.getCheckpointMark();
 
-    // consume 1 more message. This will call #ackMsg() on messages that were ready to be acked.
+    // consume 2 more messages
     reader.advance();
-    assertEquals(4, countAckMessages.get());
-
-    // consume 1 more message. No change in the acknowledged messages.
     reader.advance();
-    assertEquals(4, countAckMessages.get());
+
+    // check if messages are still not acknowledged
+    assertEquals(0, countAckMessages.get());
 
     // acknowledge from the first checkpoint
     checkpointMark.finalizeCheckpoint();
-    // No change in the acknowledged messages, because they were acknowledged in the #advance()
-    // method.
+
+    // only messages from the first checkpoint are acknowledged
     assertEquals(4, countAckMessages.get());
   }
 

From 9f165576e24701135cf26c62e08abea55c436e23 Mon Sep 17 00:00:00 2001
From: Danny McCormick <dannymccormick@google.com>
Date: Mon, 2 Dec 2024 13:25:14 -0500
Subject: [PATCH 050/135] Clean up changelog (#33260)

---
 CHANGES.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/CHANGES.md b/CHANGES.md
index c120906fdd0d..4f56b4d49e45 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -98,7 +98,6 @@
 
 ## I/Os
 
-* Support for X source added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
 * [Managed Iceberg] Support creating tables if needed ([#32686](https://github.com/apache/beam/pull/32686))
 * [Managed Iceberg] Now available in Python SDK ([#31495](https://github.com/apache/beam/pull/31495))
 * [Managed Iceberg] Add support for TIMESTAMP, TIME, and DATE types ([#32688](https://github.com/apache/beam/pull/32688))

From afdc5eaed8c42f6d7136102829bccc00160d28af Mon Sep 17 00:00:00 2001
From: Danny McCormick <dannymccormick@google.com>
Date: Mon, 2 Dec 2024 16:11:49 -0500
Subject: [PATCH 051/135] Revert "Revert "Update vllm colab to work with
 asyncio requirements"" (#33171)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Revert "Revert "Update vllm colab to work with asyncio requirements (#33122)"…"

This reverts commit baa15911679e068db0314b4fe712ea5e97867119.

* Install triton as well
---
 .../beam-ml/run_inference_vllm.ipynb          | 30 +++++++++++++++++--
 1 file changed, 28 insertions(+), 2 deletions(-)

diff --git a/examples/notebooks/beam-ml/run_inference_vllm.ipynb b/examples/notebooks/beam-ml/run_inference_vllm.ipynb
index c4803eccebff..eaa72a613bfc 100644
--- a/examples/notebooks/beam-ml/run_inference_vllm.ipynb
+++ b/examples/notebooks/beam-ml/run_inference_vllm.ipynb
@@ -100,7 +100,9 @@
       "source": [
         "!pip install openai>=1.52.2\n",
         "!pip install vllm>=0.6.3\n",
-        "!pip install apache-beam[gcp]==2.60.0\n",
+        "!pip install triton>=3.1.0\n",
+        "!pip install apache-beam[gcp]==2.61.0\n",
+        "!pip install nest_asyncio # only needed in colab\n",
         "!pip check"
       ]
     },
@@ -109,6 +111,30 @@
       "metadata": {
         "id": "3xz8zuA7vcS4"
       },
+      "source": [
+        "## Colab only: allow nested asyncio\n",
+        "\n",
+        "The vLLM model handler logic below uses asyncio to feed vLLM records. This only works if we are not already in an asyncio event loop. Most of the time, this is fine, but colab already operates in an event loop. To work around this, we can use nest_asyncio to make things work smoothly in colab. Do not include this step outside of colab."
+      ],
+      "metadata": {
+        "id": "3xz8zuA7vcS3"
+      }
+    },
+    {
+      "cell_type": "code",
+      "source": [
+        "# This should not be necessary outside of colab.\n",
+        "import nest_asyncio\n",
+        "nest_asyncio.apply()\n"
+      ],
+      "metadata": {
+        "id": "sUqjOzw3wpI3"
+      },
+      "execution_count": null,
+      "outputs": []
+    },
+    {
+      "cell_type": "markdown",
       "source": [
         "## Run locally without Apache Beam\n",
         "\n",
@@ -315,7 +341,7 @@
         "COPY --from=apache/beam_python3.10_sdk:2.60.0 /opt/apache/beam /opt/apache/beam\n",
         "\n",
         "RUN pip install --no-cache-dir -vvv apache-beam[gcp]==2.60.0\n",
-        "RUN pip install openai>=1.52.2 vllm>=0.6.3\n",
+        "RUN pip install openai>=1.52.2 vllm>=0.6.3 triton>=3.1.0\n",
         "\n",
         "RUN apt install libcairo2-dev pkg-config python3-dev -y\n",
         "RUN pip install pycairo\n",

From ccffdbab96c1bebc18e35cd80be9b30ce0a51e9b Mon Sep 17 00:00:00 2001
From: Danny McCormick <dannymccormick@google.com>
Date: Mon, 2 Dec 2024 16:18:17 -0500
Subject: [PATCH 052/135] Remove dupe metadata (#33261)

* Remove dupe metadata

* Fix metadata
---
 examples/notebooks/beam-ml/run_inference_vllm.ipynb | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/examples/notebooks/beam-ml/run_inference_vllm.ipynb b/examples/notebooks/beam-ml/run_inference_vllm.ipynb
index eaa72a613bfc..40eff1af5155 100644
--- a/examples/notebooks/beam-ml/run_inference_vllm.ipynb
+++ b/examples/notebooks/beam-ml/run_inference_vllm.ipynb
@@ -108,9 +108,6 @@
     },
     {
       "cell_type": "markdown",
-      "metadata": {
-        "id": "3xz8zuA7vcS4"
-      },
       "source": [
         "## Colab only: allow nested asyncio\n",
         "\n",
@@ -135,6 +132,9 @@
     },
     {
       "cell_type": "markdown",
+      "metadata": {
+        "id": "sUqjOzw3wpI4"
+      },
       "source": [
         "## Run locally without Apache Beam\n",
         "\n",

From abd03feaf6ce51e987282051a1e7513a552ddde7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 2 Dec 2024 16:22:27 -0500
Subject: [PATCH 053/135] Bump org.javacc.javacc from 3.0.2 to 3.0.3 (#33139)

Bumps org.javacc.javacc from 3.0.2 to 3.0.3.

---
updated-dependencies:
- dependency-name: org.javacc.javacc
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 settings.gradle.kts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/settings.gradle.kts b/settings.gradle.kts
index ca30a5ea750a..d90bb3fb5b82 100644
--- a/settings.gradle.kts
+++ b/settings.gradle.kts
@@ -19,7 +19,7 @@ import com.gradle.enterprise.gradleplugin.internal.extension.BuildScanExtensionW
 
 pluginManagement {
   plugins {
-     id("org.javacc.javacc") version "3.0.2" // enable the JavaCC parser generator
+     id("org.javacc.javacc") version "3.0.3" // enable the JavaCC parser generator
   }
 }
 

From 160ffd53ce0f5ac2b91f917abba42dda635841d9 Mon Sep 17 00:00:00 2001
From: Robert Burke <lostluck@users.noreply.github.com>
Date: Mon, 2 Dec 2024 16:27:35 -0800
Subject: [PATCH 054/135] [CHANGES] Add prism note to 2.61 release blog and
 CHANGES.md (#33262)

* add prism note to 2.61 release blog

* Update CHANGES.md

* Update beam-2.61.0.md - style

* Update CHANGES.md - style
---
 CHANGES.md                                      | 3 ++-
 website/www/site/content/en/blog/beam-2.61.0.md | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/CHANGES.md b/CHANGES.md
index 4f56b4d49e45..3bb490cc83c4 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -109,9 +109,10 @@
 ## New Features / Improvements
 
 * Added support for read with metadata in MqttIO (Java) ([#32195](https://github.com/apache/beam/issues/32195))
-* Added support for processing events which use a global sequence to "ordered" extension (Java) [#32540](https://github.com/apache/beam/pull/32540)
+* Added support for processing events which use a global sequence to "ordered" extension (Java) ([#32540](https://github.com/apache/beam/pull/32540))
 * Add new meta-transform FlattenWith and Tee that allow one to introduce branching
   without breaking the linear/chaining style of pipeline construction.
+* Use Prism as a fallback to the Python Portable runner when running a pipeline with the Python Direct runner ([#32876](https://github.com/apache/beam/pull/32876))
 
 ## Deprecations
 
diff --git a/website/www/site/content/en/blog/beam-2.61.0.md b/website/www/site/content/en/blog/beam-2.61.0.md
index 6f0404af7846..a4c7ac0cefbd 100644
--- a/website/www/site/content/en/blog/beam-2.61.0.md
+++ b/website/www/site/content/en/blog/beam-2.61.0.md
@@ -45,9 +45,10 @@ For more information on changes in 2.61.0, check out the [detailed release notes
 ## New Features / Improvements
 
 * Added support for read with metadata in MqttIO (Java) ([#32195](https://github.com/apache/beam/issues/32195))
-* Added support for processing events which use a global sequence to "ordered" extension (Java) [#32540](https://github.com/apache/beam/pull/32540)
+* Added support for processing events which use a global sequence to "ordered" extension (Java) ([#32540](https://github.com/apache/beam/pull/32540))
 * Add new meta-transform FlattenWith and Tee that allow one to introduce branching
   without breaking the linear/chaining style of pipeline construction.
+* Use Prism as a fallback to the Python Portable runner when running a pipeline with the Python Direct runner ([#32876](https://github.com/apache/beam/pull/32876))
 
 ## Deprecations
 

From 63b8dd17d6cba28cbcc415981bab423767ad7c60 Mon Sep 17 00:00:00 2001
From: Jack McCluskey <34928439+jrmccluskey@users.noreply.github.com>
Date: Tue, 3 Dec 2024 09:57:06 -0500
Subject: [PATCH 055/135] Remove unnecessary branches on Python version in
 typehint code (#33258)

* Remove unneccessary branches on Python version in typehint code

* remove unused imports
---
 .../apache_beam/typehints/decorators.py       |   4 -
 .../apache_beam/typehints/decorators_test.py  |  10 +-
 .../typehints/native_type_compatibility.py    |  15 +-
 .../native_type_compatibility_test.py         | 195 +++++++++---------
 sdks/python/apache_beam/typehints/opcodes.py  |  12 +-
 .../typehints/typed_pipeline_test.py          |   8 +-
 .../python/apache_beam/typehints/typehints.py |   8 +-
 .../apache_beam/typehints/typehints_test.py   | 140 +++++--------
 8 files changed, 149 insertions(+), 243 deletions(-)

diff --git a/sdks/python/apache_beam/typehints/decorators.py b/sdks/python/apache_beam/typehints/decorators.py
index 9c0cc2b8af4e..7050df7016e5 100644
--- a/sdks/python/apache_beam/typehints/decorators.py
+++ b/sdks/python/apache_beam/typehints/decorators.py
@@ -82,7 +82,6 @@ def foo((a, b)):
 import inspect
 import itertools
 import logging
-import sys
 import traceback
 import types
 from typing import Any
@@ -686,9 +685,6 @@ def get_type_hints(fn: Any) -> IOTypeHints:
       # Can't add arbitrary attributes to this object,
       # but might have some restrictions anyways...
       hints = IOTypeHints.empty()
-      # Python 3.7 introduces annotations for _MethodDescriptorTypes.
-      if isinstance(fn, _MethodDescriptorType) and sys.version_info < (3, 7):
-        hints = hints.with_input_types(fn.__objclass__)  # type: ignore
       return hints
   return fn._type_hints
   # pylint: enable=protected-access
diff --git a/sdks/python/apache_beam/typehints/decorators_test.py b/sdks/python/apache_beam/typehints/decorators_test.py
index 71edc75f31a6..dd110ced5bb8 100644
--- a/sdks/python/apache_beam/typehints/decorators_test.py
+++ b/sdks/python/apache_beam/typehints/decorators_test.py
@@ -20,7 +20,6 @@
 # pytype: skip-file
 
 import functools
-import sys
 import typing
 import unittest
 
@@ -70,14 +69,7 @@ def test_from_callable_builtin(self):
   def test_from_callable_method_descriptor(self):
     # from_callable() injects an annotation in this special type of builtin.
     th = decorators.IOTypeHints.from_callable(str.strip)
-    if sys.version_info >= (3, 7):
-      self.assertEqual(th.input_types, ((str, Any), {}))
-    else:
-      self.assertEqual(
-          th.input_types,
-          ((str, decorators._ANY_VAR_POSITIONAL), {
-              '__unknown__keywords': decorators._ANY_VAR_KEYWORD
-          }))
+    self.assertEqual(th.input_types, ((str, Any), {}))
     self.assertEqual(th.output_types, ((Any, ), {}))
 
   def test_strip_iterable_not_simple_output_noop(self):
diff --git a/sdks/python/apache_beam/typehints/native_type_compatibility.py b/sdks/python/apache_beam/typehints/native_type_compatibility.py
index 621adc44507e..6f704b37a969 100644
--- a/sdks/python/apache_beam/typehints/native_type_compatibility.py
+++ b/sdks/python/apache_beam/typehints/native_type_compatibility.py
@@ -101,10 +101,7 @@ def _match_issubclass(match_against):
 
 def _match_is_exactly_mapping(user_type):
   # Avoid unintentionally catching all subtypes (e.g. strings and mappings).
-  if sys.version_info < (3, 7):
-    expected_origin = typing.Mapping
-  else:
-    expected_origin = collections.abc.Mapping
+  expected_origin = collections.abc.Mapping
   return getattr(user_type, '__origin__', None) is expected_origin
 
 
@@ -112,10 +109,7 @@ def _match_is_exactly_iterable(user_type):
   if user_type is typing.Iterable:
     return True
   # Avoid unintentionally catching all subtypes (e.g. strings and mappings).
-  if sys.version_info < (3, 7):
-    expected_origin = typing.Iterable
-  else:
-    expected_origin = collections.abc.Iterable
+  expected_origin = collections.abc.Iterable
   return getattr(user_type, '__origin__', None) is expected_origin
 
 
@@ -244,11 +238,10 @@ def convert_to_beam_type(typ):
       sys.version_info.minor >= 10) and (isinstance(typ, types.UnionType)):
     typ = typing.Union[typ]
 
-  if sys.version_info >= (3, 9) and isinstance(typ, types.GenericAlias):
+  if isinstance(typ, types.GenericAlias):
     typ = convert_builtin_to_typing(typ)
 
-  if sys.version_info >= (3, 9) and getattr(typ, '__module__',
-                                            None) == 'collections.abc':
+  if getattr(typ, '__module__', None) == 'collections.abc':
     typ = convert_collections_to_typing(typ)
 
   typ_module = getattr(typ, '__module__', None)
diff --git a/sdks/python/apache_beam/typehints/native_type_compatibility_test.py b/sdks/python/apache_beam/typehints/native_type_compatibility_test.py
index 2e6db6a7733c..ae8e1a0b2906 100644
--- a/sdks/python/apache_beam/typehints/native_type_compatibility_test.py
+++ b/sdks/python/apache_beam/typehints/native_type_compatibility_test.py
@@ -21,7 +21,6 @@
 
 import collections.abc
 import enum
-import sys
 import typing
 import unittest
 
@@ -128,105 +127,98 @@ def test_convert_to_beam_type(self):
       self.assertEqual(converted_typing_type, typing_type, description)
 
   def test_convert_to_beam_type_with_builtin_types(self):
-    if sys.version_info >= (3, 9):
-      test_cases = [
-          ('builtin dict', dict[str, int], typehints.Dict[str, int]),
-          ('builtin list', list[str], typehints.List[str]),
-          ('builtin tuple', tuple[str],
-           typehints.Tuple[str]), ('builtin set', set[str], typehints.Set[str]),
-          ('builtin frozenset', frozenset[int], typehints.FrozenSet[int]),
-          (
-              'nested builtin',
-              dict[str, list[tuple[float]]],
-              typehints.Dict[str, typehints.List[typehints.Tuple[float]]]),
-          (
-              'builtin nested tuple',
-              tuple[str, list],
-              typehints.Tuple[str, typehints.List[typehints.Any]],
-          )
-      ]
-
-      for test_case in test_cases:
-        description = test_case[0]
-        builtins_type = test_case[1]
-        expected_beam_type = test_case[2]
-        converted_beam_type = convert_to_beam_type(builtins_type)
-        self.assertEqual(converted_beam_type, expected_beam_type, description)
+    test_cases = [
+        ('builtin dict', dict[str, int], typehints.Dict[str, int]),
+        ('builtin list', list[str], typehints.List[str]),
+        ('builtin tuple', tuple[str],
+         typehints.Tuple[str]), ('builtin set', set[str], typehints.Set[str]),
+        ('builtin frozenset', frozenset[int], typehints.FrozenSet[int]),
+        (
+            'nested builtin',
+            dict[str, list[tuple[float]]],
+            typehints.Dict[str, typehints.List[typehints.Tuple[float]]]),
+        (
+            'builtin nested tuple',
+            tuple[str, list],
+            typehints.Tuple[str, typehints.List[typehints.Any]],
+        )
+    ]
+
+    for test_case in test_cases:
+      description = test_case[0]
+      builtins_type = test_case[1]
+      expected_beam_type = test_case[2]
+      converted_beam_type = convert_to_beam_type(builtins_type)
+      self.assertEqual(converted_beam_type, expected_beam_type, description)
 
   def test_convert_to_beam_type_with_collections_types(self):
-    if sys.version_info >= (3, 9):
-      test_cases = [
-          (
-              'collection iterable',
-              collections.abc.Iterable[int],
-              typehints.Iterable[int]),
-          (
-              'collection generator',
-              collections.abc.Generator[int],
-              typehints.Generator[int]),
-          (
-              'collection iterator',
-              collections.abc.Iterator[int],
-              typehints.Iterator[int]),
-          (
-              'nested iterable',
-              tuple[bytes, collections.abc.Iterable[int]],
-              typehints.Tuple[bytes, typehints.Iterable[int]]),
-          (
-              'iterable over tuple',
-              collections.abc.Iterable[tuple[str, int]],
-              typehints.Iterable[typehints.Tuple[str, int]]),
-          (
-              'mapping not caught',
-              collections.abc.Mapping[str, int],
-              collections.abc.Mapping[str, int]),
-          ('set', collections.abc.Set[str], typehints.Set[str]),
-          ('mutable set', collections.abc.MutableSet[int], typehints.Set[int]),
-          (
-              'enum set',
-              collections.abc.Set[_TestEnum],
-              typehints.Set[_TestEnum]),
-          (
-              'enum mutable set',
-              collections.abc.MutableSet[_TestEnum],
-              typehints.Set[_TestEnum]),
-          (
-              'collection enum',
-              collections.abc.Collection[_TestEnum],
-              typehints.Collection[_TestEnum]),
-          (
-              'collection of tuples',
-              collections.abc.Collection[tuple[str, int]],
-              typehints.Collection[typehints.Tuple[str, int]]),
-      ]
-
-      for test_case in test_cases:
-        description = test_case[0]
-        builtins_type = test_case[1]
-        expected_beam_type = test_case[2]
-        converted_beam_type = convert_to_beam_type(builtins_type)
-        self.assertEqual(converted_beam_type, expected_beam_type, description)
+    test_cases = [
+        (
+            'collection iterable',
+            collections.abc.Iterable[int],
+            typehints.Iterable[int]),
+        (
+            'collection generator',
+            collections.abc.Generator[int],
+            typehints.Generator[int]),
+        (
+            'collection iterator',
+            collections.abc.Iterator[int],
+            typehints.Iterator[int]),
+        (
+            'nested iterable',
+            tuple[bytes, collections.abc.Iterable[int]],
+            typehints.Tuple[bytes, typehints.Iterable[int]]),
+        (
+            'iterable over tuple',
+            collections.abc.Iterable[tuple[str, int]],
+            typehints.Iterable[typehints.Tuple[str, int]]),
+        (
+            'mapping not caught',
+            collections.abc.Mapping[str, int],
+            collections.abc.Mapping[str, int]),
+        ('set', collections.abc.Set[str], typehints.Set[str]),
+        ('mutable set', collections.abc.MutableSet[int], typehints.Set[int]),
+        ('enum set', collections.abc.Set[_TestEnum], typehints.Set[_TestEnum]),
+        (
+            'enum mutable set',
+            collections.abc.MutableSet[_TestEnum],
+            typehints.Set[_TestEnum]),
+        (
+            'collection enum',
+            collections.abc.Collection[_TestEnum],
+            typehints.Collection[_TestEnum]),
+        (
+            'collection of tuples',
+            collections.abc.Collection[tuple[str, int]],
+            typehints.Collection[typehints.Tuple[str, int]]),
+    ]
+
+    for test_case in test_cases:
+      description = test_case[0]
+      builtins_type = test_case[1]
+      expected_beam_type = test_case[2]
+      converted_beam_type = convert_to_beam_type(builtins_type)
+      self.assertEqual(converted_beam_type, expected_beam_type, description)
 
   def test_convert_builtin_to_typing(self):
-    if sys.version_info >= (3, 9):
-      test_cases = [
-          ('dict', dict[str, int], typing.Dict[str, int]),
-          ('list', list[str], typing.List[str]),
-          ('tuple', tuple[str], typing.Tuple[str]),
-          ('set', set[str], typing.Set[str]),
-          (
-              'nested',
-              dict[str, list[tuple[float]]],
-              typing.Dict[str, typing.List[typing.Tuple[float]]]),
-      ]
-
-      for test_case in test_cases:
-        description = test_case[0]
-        builtin_type = test_case[1]
-        expected_typing_type = test_case[2]
-        converted_typing_type = convert_builtin_to_typing(builtin_type)
-        self.assertEqual(
-            converted_typing_type, expected_typing_type, description)
+    test_cases = [
+        ('dict', dict[str, int], typing.Dict[str, int]),
+        ('list', list[str], typing.List[str]),
+        ('tuple', tuple[str], typing.Tuple[str]),
+        ('set', set[str], typing.Set[str]),
+        (
+            'nested',
+            dict[str, list[tuple[float]]],
+            typing.Dict[str, typing.List[typing.Tuple[float]]]),
+    ]
+
+    for test_case in test_cases:
+      description = test_case[0]
+      builtin_type = test_case[1]
+      expected_typing_type = test_case[2]
+      converted_typing_type = convert_builtin_to_typing(builtin_type)
+      self.assertEqual(converted_typing_type, expected_typing_type, description)
 
   def test_generator_converted_to_iterator(self):
     self.assertEqual(
@@ -293,14 +285,11 @@ def test_convert_bare_types(self):
             typing.Tuple[typing.Iterator],
             typehints.Tuple[typehints.Iterator[typehints.TypeVariable('T_co')]]
         ),
+        (
+            'bare generator',
+            typing.Generator,
+            typehints.Generator[typehints.TypeVariable('T_co')]),
     ]
-    if sys.version_info >= (3, 7):
-      test_cases += [
-          (
-              'bare generator',
-              typing.Generator,
-              typehints.Generator[typehints.TypeVariable('T_co')]),
-      ]
     for test_case in test_cases:
       description = test_case[0]
       typing_type = test_case[1]
diff --git a/sdks/python/apache_beam/typehints/opcodes.py b/sdks/python/apache_beam/typehints/opcodes.py
index 62c7a8fadc35..7bea621841f6 100644
--- a/sdks/python/apache_beam/typehints/opcodes.py
+++ b/sdks/python/apache_beam/typehints/opcodes.py
@@ -246,14 +246,10 @@ def set_add(state, arg):
 
 
 def map_add(state, arg):
-  if sys.version_info >= (3, 8):
-    # PEP 572 The MAP_ADD expects the value as the first element in the stack
-    # and the key as the second element.
-    new_value_type = Const.unwrap(state.stack.pop())
-    new_key_type = Const.unwrap(state.stack.pop())
-  else:
-    new_key_type = Const.unwrap(state.stack.pop())
-    new_value_type = Const.unwrap(state.stack.pop())
+  # PEP 572 The MAP_ADD expects the value as the first element in the stack
+  # and the key as the second element.
+  new_value_type = Const.unwrap(state.stack.pop())
+  new_key_type = Const.unwrap(state.stack.pop())
   state.stack[-arg] = Dict[Union[state.stack[-arg].key_type, new_key_type],
                            Union[state.stack[-arg].value_type, new_value_type]]
 
diff --git a/sdks/python/apache_beam/typehints/typed_pipeline_test.py b/sdks/python/apache_beam/typehints/typed_pipeline_test.py
index 57e7f44f6922..44318fa44a8c 100644
--- a/sdks/python/apache_beam/typehints/typed_pipeline_test.py
+++ b/sdks/python/apache_beam/typehints/typed_pipeline_test.py
@@ -19,7 +19,6 @@
 
 # pytype: skip-file
 
-import sys
 import typing
 import unittest
 
@@ -874,12 +873,7 @@ def test_flat_type_hint(self):
 class AnnotationsTest(unittest.TestCase):
   def test_pardo_wrapper_builtin_method(self):
     th = beam.ParDo(str.strip).get_type_hints()
-    if sys.version_info < (3, 7):
-      self.assertEqual(th.input_types, ((str, ), {}))
-    else:
-      # Python 3.7+ has annotations for CPython builtins
-      # (_MethodDescriptorType).
-      self.assertEqual(th.input_types, ((str, typehints.Any), {}))
+    self.assertEqual(th.input_types, ((str, typehints.Any), {}))
     self.assertEqual(th.output_types, ((typehints.Any, ), {}))
 
   def test_pardo_wrapper_builtin_type(self):
diff --git a/sdks/python/apache_beam/typehints/typehints.py b/sdks/python/apache_beam/typehints/typehints.py
index 912cb78dc095..0e18e887c2a0 100644
--- a/sdks/python/apache_beam/typehints/typehints.py
+++ b/sdks/python/apache_beam/typehints/typehints.py
@@ -391,12 +391,6 @@ def validate_composite_type_param(type_param, error_msg_prefix):
   if sys.version_info.major == 3 and sys.version_info.minor >= 10:
     if isinstance(type_param, types.UnionType):
       is_not_type_constraint = False
-  # Pre-Python 3.9 compositve type-hinting with built-in types was not
-  # supported, the typing module equivalents should be used instead.
-  if sys.version_info.major == 3 and sys.version_info.minor < 9:
-    is_not_type_constraint = is_not_type_constraint or (
-        isinstance(type_param, type) and
-        type_param in DISALLOWED_PRIMITIVE_TYPES)
 
   if is_not_type_constraint:
     raise TypeError(
@@ -1266,7 +1260,7 @@ def normalize(x, none_as_type=False):
   # Avoid circular imports
   from apache_beam.typehints import native_type_compatibility
 
-  if sys.version_info >= (3, 9) and isinstance(x, types.GenericAlias):
+  if isinstance(x, types.GenericAlias):
     x = native_type_compatibility.convert_builtin_to_typing(x)
 
   if none_as_type and x is None:
diff --git a/sdks/python/apache_beam/typehints/typehints_test.py b/sdks/python/apache_beam/typehints/typehints_test.py
index 843c1498cac5..6611dcecab01 100644
--- a/sdks/python/apache_beam/typehints/typehints_test.py
+++ b/sdks/python/apache_beam/typehints/typehints_test.py
@@ -388,15 +388,10 @@ def test_getitem_params_must_be_type_or_constraint(self):
       typehints.Tuple[5, [1, 3]]
     self.assertTrue(e.exception.args[0].startswith(expected_error_prefix))
 
-    if sys.version_info < (3, 9):
-      with self.assertRaises(TypeError) as e:
-        typehints.Tuple[list, dict]
-      self.assertTrue(e.exception.args[0].startswith(expected_error_prefix))
-    else:
-      try:
-        typehints.Tuple[list, dict]
-      except TypeError:
-        self.fail("built-in composite raised TypeError unexpectedly")
+    try:
+      typehints.Tuple[list, dict]
+    except TypeError:
+      self.fail("built-in composite raised TypeError unexpectedly")
 
   def test_compatibility_arbitrary_length(self):
     self.assertNotCompatible(
@@ -548,15 +543,13 @@ def test_type_check_invalid_composite_type_arbitrary_length(self):
         e.exception.args[0])
 
   def test_normalize_with_builtin_tuple(self):
-    if sys.version_info >= (3, 9):
-      expected_beam_type = typehints.Tuple[int, int]
-      converted_beam_type = typehints.normalize(tuple[int, int], False)
-      self.assertEqual(converted_beam_type, expected_beam_type)
+    expected_beam_type = typehints.Tuple[int, int]
+    converted_beam_type = typehints.normalize(tuple[int, int], False)
+    self.assertEqual(converted_beam_type, expected_beam_type)
 
   def test_builtin_and_type_compatibility(self):
-    if sys.version_info >= (3, 9):
-      self.assertCompatible(tuple, typing.Tuple)
-      self.assertCompatible(tuple[int, int], typing.Tuple[int, int])
+    self.assertCompatible(tuple, typing.Tuple)
+    self.assertCompatible(tuple[int, int], typing.Tuple[int, int])
 
 
 class ListHintTestCase(TypeHintTestCase):
@@ -618,22 +611,19 @@ def test_enforce_list_type_constraint_invalid_composite_type(self):
         e.exception.args[0])
 
   def test_normalize_with_builtin_list(self):
-    if sys.version_info >= (3, 9):
-      expected_beam_type = typehints.List[int]
-      converted_beam_type = typehints.normalize(list[int], False)
-      self.assertEqual(converted_beam_type, expected_beam_type)
+    expected_beam_type = typehints.List[int]
+    converted_beam_type = typehints.normalize(list[int], False)
+    self.assertEqual(converted_beam_type, expected_beam_type)
 
   def test_builtin_and_type_compatibility(self):
-    if sys.version_info >= (3, 9):
-      self.assertCompatible(list, typing.List)
-      self.assertCompatible(list[int], typing.List[int])
+    self.assertCompatible(list, typing.List)
+    self.assertCompatible(list[int], typing.List[int])
 
   def test_is_typing_generic(self):
     self.assertTrue(typehints.is_typing_generic(typing.List[str]))
 
   def test_builtin_is_typing_generic(self):
-    if sys.version_info >= (3, 9):
-      self.assertTrue(typehints.is_typing_generic(list[str]))
+    self.assertTrue(typehints.is_typing_generic(list[str]))
 
 
 class KVHintTestCase(TypeHintTestCase):
@@ -687,14 +677,10 @@ def test_getitem_param_must_have_length_2(self):
         e.exception.args[0])
 
   def test_key_type_must_be_valid_composite_param(self):
-    if sys.version_info < (3, 9):
-      with self.assertRaises(TypeError):
-        typehints.Dict[list, int]
-    else:
-      try:
-        typehints.Tuple[list, int]
-      except TypeError:
-        self.fail("built-in composite raised TypeError unexpectedly")
+    try:
+      typehints.Tuple[list, int]
+    except TypeError:
+      self.fail("built-in composite raised TypeError unexpectedly")
 
   def test_value_type_must_be_valid_composite_param(self):
     with self.assertRaises(TypeError):
@@ -777,35 +763,24 @@ def test_match_type_variables(self):
                      hint.match_type_variables(typehints.Dict[int, str]))
 
   def test_normalize_with_builtin_dict(self):
-    if sys.version_info >= (3, 9):
-      expected_beam_type = typehints.Dict[str, int]
-      converted_beam_type = typehints.normalize(dict[str, int], False)
-      self.assertEqual(converted_beam_type, expected_beam_type)
+    expected_beam_type = typehints.Dict[str, int]
+    converted_beam_type = typehints.normalize(dict[str, int], False)
+    self.assertEqual(converted_beam_type, expected_beam_type)
 
   def test_builtin_and_type_compatibility(self):
-    if sys.version_info >= (3, 9):
-      self.assertCompatible(dict, typing.Dict)
-      self.assertCompatible(dict[str, int], typing.Dict[str, int])
-      self.assertCompatible(
-          dict[str, list[int]], typing.Dict[str, typing.List[int]])
+    self.assertCompatible(dict, typing.Dict)
+    self.assertCompatible(dict[str, int], typing.Dict[str, int])
+    self.assertCompatible(
+        dict[str, list[int]], typing.Dict[str, typing.List[int]])
 
 
 class BaseSetHintTest:
   class CommonTests(TypeHintTestCase):
     def test_getitem_invalid_composite_type_param(self):
-      if sys.version_info < (3, 9):
-        with self.assertRaises(TypeError) as e:
-          self.beam_type[list]
-        self.assertEqual(
-            "Parameter to a {} hint must be a non-sequence, a "
-            "type, or a TypeConstraint. {} is an instance of "
-            "type.".format(self.string_type, list),
-            e.exception.args[0])
-      else:
-        try:
-          self.beam_type[list]
-        except TypeError:
-          self.fail("built-in composite raised TypeError unexpectedly")
+      try:
+        self.beam_type[list]
+      except TypeError:
+        self.fail("built-in composite raised TypeError unexpectedly")
 
     def test_non_typing_generic(self):
       testCase = DummyTestClass1()
@@ -855,16 +830,14 @@ class SetHintTestCase(BaseSetHintTest.CommonTests):
   string_type = 'Set'
 
   def test_builtin_compatibility(self):
-    if sys.version_info >= (3, 9):
-      self.assertCompatible(set[int], collections.abc.Set[int])
-      self.assertCompatible(set[int], collections.abc.MutableSet[int])
+    self.assertCompatible(set[int], collections.abc.Set[int])
+    self.assertCompatible(set[int], collections.abc.MutableSet[int])
 
   def test_collections_compatibility(self):
-    if sys.version_info >= (3, 9):
-      self.assertCompatible(
-          collections.abc.Set[int], collections.abc.MutableSet[int])
-      self.assertCompatible(
-          collections.abc.MutableSet[int], collections.abc.Set[int])
+    self.assertCompatible(
+        collections.abc.Set[int], collections.abc.MutableSet[int])
+    self.assertCompatible(
+        collections.abc.MutableSet[int], collections.abc.Set[int])
 
 
 class FrozenSetHintTestCase(BaseSetHintTest.CommonTests):
@@ -1416,37 +1389,16 @@ def func(a, b_c, *d):
                          func, *[Any, Any, Tuple[str, ...], int]))
 
   def test_getcallargs_forhints_builtins(self):
-    if sys.version_info < (3, 7):
-      # Signatures for builtins are not supported in 3.5 and 3.6.
-      self.assertEqual({
-          '_': str,
-          '__unknown__varargs': Tuple[Any, ...],
-          '__unknown__keywords': typehints.Dict[Any, Any]
-      },
-                       getcallargs_forhints(str.upper, str))
-      self.assertEqual({
-          '_': str,
-          '__unknown__varargs': Tuple[str, ...],
-          '__unknown__keywords': typehints.Dict[Any, Any]
-      },
-                       getcallargs_forhints(str.strip, str, str))
-      self.assertEqual({
-          '_': str,
-          '__unknown__varargs': Tuple[typehints.List[int], ...],
-          '__unknown__keywords': typehints.Dict[Any, Any]
-      },
-                       getcallargs_forhints(str.join, str, typehints.List[int]))
-    else:
-      self.assertEqual({'self': str}, getcallargs_forhints(str.upper, str))
-      # str.strip has an optional second argument.
-      self.assertEqual({
-          'self': str, 'chars': Any
-      },
-                       getcallargs_forhints(str.strip, str))
-      self.assertEqual({
-          'self': str, 'iterable': typehints.List[int]
-      },
-                       getcallargs_forhints(str.join, str, typehints.List[int]))
+    self.assertEqual({'self': str}, getcallargs_forhints(str.upper, str))
+    # str.strip has an optional second argument.
+    self.assertEqual({
+        'self': str, 'chars': Any
+    },
+                     getcallargs_forhints(str.strip, str))
+    self.assertEqual({
+        'self': str, 'iterable': typehints.List[int]
+    },
+                     getcallargs_forhints(str.join, str, typehints.List[int]))
 
 
 class TestGetYieldedType(unittest.TestCase):

From a938fa54a910446093be990e4e5cb488118ea9ab Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 3 Dec 2024 10:04:55 -0500
Subject: [PATCH 056/135] Bump github.com/aws/aws-sdk-go-v2 from 1.32.4 to
 1.32.6 in /sdks (#33264)

Bumps [github.com/aws/aws-sdk-go-v2](https://github.com/aws/aws-sdk-go-v2) from 1.32.4 to 1.32.6.
- [Release notes](https://github.com/aws/aws-sdk-go-v2/releases)
- [Commits](https://github.com/aws/aws-sdk-go-v2/compare/v1.32.4...v1.32.6)

---
updated-dependencies:
- dependency-name: github.com/aws/aws-sdk-go-v2
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 4 ++--
 sdks/go.sum | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index fc4c60006fe1..587decf4197f 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -30,12 +30,12 @@ require (
 	cloud.google.com/go/pubsub v1.45.1
 	cloud.google.com/go/spanner v1.73.0
 	cloud.google.com/go/storage v1.45.0
-	github.com/aws/aws-sdk-go-v2 v1.32.4
+	github.com/aws/aws-sdk-go-v2 v1.32.6
 	github.com/aws/aws-sdk-go-v2/config v1.28.4
 	github.com/aws/aws-sdk-go-v2/credentials v1.17.45
 	github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.38
 	github.com/aws/aws-sdk-go-v2/service/s3 v1.67.0
-	github.com/aws/smithy-go v1.22.0
+	github.com/aws/smithy-go v1.22.1
 	github.com/docker/go-connections v0.5.0
 	github.com/dustin/go-humanize v1.0.1
 	github.com/go-sql-driver/mysql v1.8.1
diff --git a/sdks/go.sum b/sdks/go.sum
index bbc0d0d22204..71dfce6e8636 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -689,8 +689,8 @@ github.com/aws/aws-sdk-go v1.30.19/go.mod h1:5zCpMtNQVjRREroY7sYe8lOMRSxkhG6MZve
 github.com/aws/aws-sdk-go v1.34.0 h1:brux2dRrlwCF5JhTL7MUT3WUwo9zfDHZZp3+g3Mvlmo=
 github.com/aws/aws-sdk-go v1.34.0/go.mod h1:5zCpMtNQVjRREroY7sYe8lOMRSxkhG6MZveU8YkpAk0=
 github.com/aws/aws-sdk-go-v2 v1.7.1/go.mod h1:L5LuPC1ZgDr2xQS7AmIec/Jlc7O/Y1u2KxJyNVab250=
-github.com/aws/aws-sdk-go-v2 v1.32.4 h1:S13INUiTxgrPueTmrm5DZ+MiAo99zYzHEFh1UNkOxNE=
-github.com/aws/aws-sdk-go-v2 v1.32.4/go.mod h1:2SK5n0a2karNTv5tbP1SjsX0uhttou00v/HpXKM1ZUo=
+github.com/aws/aws-sdk-go-v2 v1.32.6 h1:7BokKRgRPuGmKkFMhEg/jSul+tB9VvXhcViILtfG8b4=
+github.com/aws/aws-sdk-go-v2 v1.32.6/go.mod h1:P5WJBrYqqbWVaOxgH0X/FYYD47/nooaPOZPlQdmiN2U=
 github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.6 h1:pT3hpW0cOHRJx8Y0DfJUEQuqPild8jRGmSFmBgvydr0=
 github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.6/go.mod h1:j/I2++U0xX+cr44QjHay4Cvxj6FUbnxrgmqN3H1jTZA=
 github.com/aws/aws-sdk-go-v2/config v1.5.0/go.mod h1:RWlPOAW3E3tbtNAqTwvSW54Of/yP3oiZXMI0xfUdjyA=
@@ -737,8 +737,8 @@ github.com/aws/aws-sdk-go-v2/service/sts v1.6.0/go.mod h1:q7o0j7d7HrJk/vr9uUt3BV
 github.com/aws/aws-sdk-go-v2/service/sts v1.33.0 h1:s7LRgBqhwLaxcocnAniBJp7gaAB+4I4vHzqUqjH18yc=
 github.com/aws/aws-sdk-go-v2/service/sts v1.33.0/go.mod h1:9XEUty5v5UAsMiFOBJrNibZgwCeOma73jgGwwhgffa8=
 github.com/aws/smithy-go v1.6.0/go.mod h1:SObp3lf9smib00L/v3U2eAKG8FyQ7iLrJnQiAmR5n+E=
-github.com/aws/smithy-go v1.22.0 h1:uunKnWlcoL3zO7q+gG2Pk53joueEOsnNB28QdMsmiMM=
-github.com/aws/smithy-go v1.22.0/go.mod h1:irrKGvNn1InZwb2d7fkIRNucdfwR8R+Ts3wxYa/cJHg=
+github.com/aws/smithy-go v1.22.1 h1:/HPHZQ0g7f4eUeK6HKglFz8uwVfZKgoI25rb/J+dnro=
+github.com/aws/smithy-go v1.22.1/go.mod h1:irrKGvNn1InZwb2d7fkIRNucdfwR8R+Ts3wxYa/cJHg=
 github.com/boombuler/barcode v1.0.0/go.mod h1:paBWMcWSl3LHKBqUq+rly7CNSldXjb2rDl3JlRe0mD8=
 github.com/boombuler/barcode v1.0.1/go.mod h1:paBWMcWSl3LHKBqUq+rly7CNSldXjb2rDl3JlRe0mD8=
 github.com/cenkalti/backoff/v4 v4.2.1 h1:y4OZtCnogmCPw98Zjyt5a6+QwPLGkiQsYW5oUqylYbM=

From 532880aac1bc03a1d1b869c9aaa5de443bad5596 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 3 Dec 2024 10:05:24 -0500
Subject: [PATCH 057/135] Bump golang.org/x/oauth2 from 0.23.0 to 0.24.0 in
 /sdks (#33141)

Bumps [golang.org/x/oauth2](https://github.com/golang/oauth2) from 0.23.0 to 0.24.0.
- [Commits](https://github.com/golang/oauth2/compare/v0.23.0...v0.24.0)

---
updated-dependencies:
- dependency-name: golang.org/x/oauth2
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 2 +-
 sdks/go.sum | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index 587decf4197f..ef966f0dcef4 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -54,7 +54,7 @@ require (
 	github.com/xitongsys/parquet-go-source v0.0.0-20220315005136-aec0fe3e777c
 	go.mongodb.org/mongo-driver v1.17.1
 	golang.org/x/net v0.31.0
-	golang.org/x/oauth2 v0.23.0
+	golang.org/x/oauth2 v0.24.0
 	golang.org/x/sync v0.9.0
 	golang.org/x/sys v0.27.0
 	golang.org/x/text v0.20.0
diff --git a/sdks/go.sum b/sdks/go.sum
index 71dfce6e8636..5527a59f4c52 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -1417,8 +1417,8 @@ golang.org/x/oauth2 v0.4.0/go.mod h1:RznEsdpjGAINPTOF0UH/t+xJ75L18YO3Ho6Pyn+uRec
 golang.org/x/oauth2 v0.5.0/go.mod h1:9/XBHVqLaWO3/BRHs5jbpYCnOZVjj5V0ndyaAM7KB4I=
 golang.org/x/oauth2 v0.6.0/go.mod h1:ycmewcwgD4Rpr3eZJLSB4Kyyljb3qDh40vJ8STE5HKw=
 golang.org/x/oauth2 v0.7.0/go.mod h1:hPLQkd9LyjfXTiRohC/41GhcFqxisoUQ99sCUOHO9x4=
-golang.org/x/oauth2 v0.23.0 h1:PbgcYx2W7i4LvjJWEbf0ngHV6qJYr86PkAV3bXdLEbs=
-golang.org/x/oauth2 v0.23.0/go.mod h1:XYTD2NtWslqkgxebSiOHnXEap4TF09sJSc7H1sXbhtI=
+golang.org/x/oauth2 v0.24.0 h1:KTBBxWqUa0ykRPLtV69rRto9TLXcqYkeswu48x/gvNE=
+golang.org/x/oauth2 v0.24.0/go.mod h1:XYTD2NtWslqkgxebSiOHnXEap4TF09sJSc7H1sXbhtI=
 golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=

From 63d89cd047334cfbedceb20eec7d9f41e0e1d8c5 Mon Sep 17 00:00:00 2001
From: Claire McGinty <clairem@spotify.com>
Date: Tue, 3 Dec 2024 11:06:55 -0500
Subject: [PATCH 058/135] Propagate gcs-connector options to GcsUtil (#32769)

* Propagate gcs-connector options to GcsUtil

* newline

* Update CHANGES.md

* Remove Hadoop dependency

* Remove unused deps

* Drop googleCloudStorageReadOptions member variable

* add missing package

* fixup CHANGES.md
---
 CHANGES.md                                    |  1 +
 .../extensions/gcp/options/GcsOptions.java    | 10 ++++++
 .../beam/sdk/extensions/gcp/util/GcsUtil.java | 25 ++++++++++---
 .../extensions/gcp/GcpCoreApiSurfaceTest.java |  2 ++
 .../sdk/extensions/gcp/util/GcsUtilTest.java  | 35 +++++++++++++++++--
 5 files changed, 65 insertions(+), 8 deletions(-)

diff --git a/CHANGES.md b/CHANGES.md
index 3bb490cc83c4..fc32398a7a5a 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -62,6 +62,7 @@
 
 ## I/Os
 
+* gcs-connector config options can be set via GcsOptions (Java) ([#32769](https://github.com/apache/beam/pull/32769)).
 * Support for X source added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
 
 ## New Features / Improvements
diff --git a/sdks/java/extensions/google-cloud-platform-core/src/main/java/org/apache/beam/sdk/extensions/gcp/options/GcsOptions.java b/sdks/java/extensions/google-cloud-platform-core/src/main/java/org/apache/beam/sdk/extensions/gcp/options/GcsOptions.java
index 18d637254115..1285b88663e7 100644
--- a/sdks/java/extensions/google-cloud-platform-core/src/main/java/org/apache/beam/sdk/extensions/gcp/options/GcsOptions.java
+++ b/sdks/java/extensions/google-cloud-platform-core/src/main/java/org/apache/beam/sdk/extensions/gcp/options/GcsOptions.java
@@ -18,6 +18,7 @@
 package org.apache.beam.sdk.extensions.gcp.options;
 
 import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.google.cloud.hadoop.gcsio.GoogleCloudStorageReadOptions;
 import com.google.cloud.hadoop.util.AsyncWriteChannelOptions;
 import java.util.concurrent.ExecutorService;
 import org.apache.beam.sdk.extensions.gcp.storage.GcsPathValidator;
@@ -44,6 +45,15 @@ public interface GcsOptions extends ApplicationNameOptions, GcpOptions, Pipeline
 
   void setGcsUtil(GcsUtil value);
 
+  @JsonIgnore
+  @Description(
+      "The GoogleCloudStorageReadOptions instance that should be used to read from Google Cloud Storage.")
+  @Default.InstanceFactory(GcsUtil.GcsReadOptionsFactory.class)
+  @Hidden
+  GoogleCloudStorageReadOptions getGoogleCloudStorageReadOptions();
+
+  void setGoogleCloudStorageReadOptions(GoogleCloudStorageReadOptions value);
+
   /**
    * The ExecutorService instance to use to create threads, can be overridden to specify an
    * ExecutorService that is compatible with the user's environment. If unset, the default is to use
diff --git a/sdks/java/extensions/google-cloud-platform-core/src/main/java/org/apache/beam/sdk/extensions/gcp/util/GcsUtil.java b/sdks/java/extensions/google-cloud-platform-core/src/main/java/org/apache/beam/sdk/extensions/gcp/util/GcsUtil.java
index 8d3596f17b3b..d58154132a72 100644
--- a/sdks/java/extensions/google-cloud-platform-core/src/main/java/org/apache/beam/sdk/extensions/gcp/util/GcsUtil.java
+++ b/sdks/java/extensions/google-cloud-platform-core/src/main/java/org/apache/beam/sdk/extensions/gcp/util/GcsUtil.java
@@ -123,6 +123,14 @@ public static GcsCountersOptions create(
     }
   }
 
+  public static class GcsReadOptionsFactory
+      implements DefaultValueFactory<GoogleCloudStorageReadOptions> {
+    @Override
+    public GoogleCloudStorageReadOptions create(PipelineOptions options) {
+      return GoogleCloudStorageReadOptions.DEFAULT;
+    }
+  }
+
   /**
    * This is a {@link DefaultValueFactory} able to create a {@link GcsUtil} using any transport
    * flags specified on the {@link PipelineOptions}.
@@ -153,7 +161,8 @@ public GcsUtil create(PipelineOptions options) {
                   : null,
               gcsOptions.getEnableBucketWriteMetricCounter()
                   ? gcsOptions.getGcsWriteCounterPrefix()
-                  : null));
+                  : null),
+          gcsOptions.getGoogleCloudStorageReadOptions());
     }
 
     /** Returns an instance of {@link GcsUtil} based on the given parameters. */
@@ -164,7 +173,8 @@ public static GcsUtil create(
         ExecutorService executorService,
         Credentials credentials,
         @Nullable Integer uploadBufferSizeBytes,
-        GcsCountersOptions gcsCountersOptions) {
+        GcsCountersOptions gcsCountersOptions,
+        GoogleCloudStorageReadOptions gcsReadOptions) {
       return new GcsUtil(
           storageClient,
           httpRequestInitializer,
@@ -173,7 +183,8 @@ public static GcsUtil create(
           credentials,
           uploadBufferSizeBytes,
           null,
-          gcsCountersOptions);
+          gcsCountersOptions,
+          gcsReadOptions);
     }
   }
 
@@ -249,7 +260,8 @@ public static boolean isWildcard(GcsPath spec) {
       Credentials credentials,
       @Nullable Integer uploadBufferSizeBytes,
       @Nullable Integer rewriteDataOpBatchLimit,
-      GcsCountersOptions gcsCountersOptions) {
+      GcsCountersOptions gcsCountersOptions,
+      GoogleCloudStorageReadOptions gcsReadOptions) {
     this.storageClient = storageClient;
     this.httpRequestInitializer = httpRequestInitializer;
     this.uploadBufferSizeBytes = uploadBufferSizeBytes;
@@ -260,6 +272,7 @@ public static boolean isWildcard(GcsPath spec) {
     googleCloudStorageOptions =
         GoogleCloudStorageOptions.builder()
             .setAppName("Beam")
+            .setReadChannelOptions(gcsReadOptions)
             .setGrpcEnabled(shouldUseGrpc)
             .build();
     googleCloudStorage =
@@ -565,7 +578,9 @@ private SeekableByteChannel wrapInCounting(
   public SeekableByteChannel open(GcsPath path) throws IOException {
     String bucket = path.getBucket();
     SeekableByteChannel channel =
-        googleCloudStorage.open(new StorageResourceId(path.getBucket(), path.getObject()));
+        googleCloudStorage.open(
+            new StorageResourceId(path.getBucket(), path.getObject()),
+            this.googleCloudStorageOptions.getReadChannelOptions());
     return wrapInCounting(channel, bucket);
   }
 
diff --git a/sdks/java/extensions/google-cloud-platform-core/src/test/java/org/apache/beam/sdk/extensions/gcp/GcpCoreApiSurfaceTest.java b/sdks/java/extensions/google-cloud-platform-core/src/test/java/org/apache/beam/sdk/extensions/gcp/GcpCoreApiSurfaceTest.java
index f5075a3f2c55..26d98125a3af 100644
--- a/sdks/java/extensions/google-cloud-platform-core/src/test/java/org/apache/beam/sdk/extensions/gcp/GcpCoreApiSurfaceTest.java
+++ b/sdks/java/extensions/google-cloud-platform-core/src/test/java/org/apache/beam/sdk/extensions/gcp/GcpCoreApiSurfaceTest.java
@@ -55,6 +55,8 @@ public void testGcpCoreApiSurface() throws Exception {
             classesInPackage("com.google.api.services.storage"),
             classesInPackage("com.google.auth"),
             classesInPackage("com.fasterxml.jackson.annotation"),
+            classesInPackage("com.google.cloud.hadoop.gcsio"),
+            classesInPackage("com.google.common.collect"), // Via gcs-connector ReadOptions builder
             classesInPackage("java"),
             classesInPackage("javax"),
             classesInPackage("org.apache.beam.sdk"),
diff --git a/sdks/java/extensions/google-cloud-platform-core/src/test/java/org/apache/beam/sdk/extensions/gcp/util/GcsUtilTest.java b/sdks/java/extensions/google-cloud-platform-core/src/test/java/org/apache/beam/sdk/extensions/gcp/util/GcsUtilTest.java
index bd7f46ec8951..97082572ce41 100644
--- a/sdks/java/extensions/google-cloud-platform-core/src/test/java/org/apache/beam/sdk/extensions/gcp/util/GcsUtilTest.java
+++ b/sdks/java/extensions/google-cloud-platform-core/src/test/java/org/apache/beam/sdk/extensions/gcp/util/GcsUtilTest.java
@@ -177,6 +177,32 @@ public void testCreationWithGcsUtilProvided() {
     assertSame(gcsUtil, pipelineOptions.getGcsUtil());
   }
 
+  @Test
+  public void testCreationWithExplicitGoogleCloudStorageReadOptions() throws Exception {
+    GoogleCloudStorageReadOptions readOptions =
+        GoogleCloudStorageReadOptions.builder()
+            .setFadvise(GoogleCloudStorageReadOptions.Fadvise.AUTO)
+            .setSupportGzipEncoding(true)
+            .setFastFailOnNotFound(false)
+            .build();
+
+    GcsOptions pipelineOptions = PipelineOptionsFactory.as(GcsOptions.class);
+    pipelineOptions.setGoogleCloudStorageReadOptions(readOptions);
+
+    GcsUtil gcsUtil = pipelineOptions.getGcsUtil();
+    GoogleCloudStorage googleCloudStorageMock = Mockito.spy(GoogleCloudStorage.class);
+    Mockito.when(googleCloudStorageMock.open(Mockito.any(), Mockito.any()))
+        .thenReturn(Mockito.mock(SeekableByteChannel.class));
+    gcsUtil.setCloudStorageImpl(googleCloudStorageMock);
+
+    assertEquals(readOptions, pipelineOptions.getGoogleCloudStorageReadOptions());
+
+    // Assert read options are passed to GCS calls
+    pipelineOptions.getGcsUtil().open(GcsPath.fromUri("gs://bucket/path"));
+    Mockito.verify(googleCloudStorageMock, Mockito.times(1))
+        .open(StorageResourceId.fromStringPath("gs://bucket/path"), readOptions);
+  }
+
   @Test
   public void testMultipleThreadsCanCompleteOutOfOrderWithDefaultThreadPool() throws Exception {
     GcsOptions pipelineOptions = PipelineOptionsFactory.as(GcsOptions.class);
@@ -1630,7 +1656,8 @@ public static GcsUtilMock createMock(PipelineOptions options) {
                   : null,
               gcsOptions.getEnableBucketWriteMetricCounter()
                   ? gcsOptions.getGcsWriteCounterPrefix()
-                  : null));
+                  : null),
+          gcsOptions.getGoogleCloudStorageReadOptions());
     }
 
     private GcsUtilMock(
@@ -1641,7 +1668,8 @@ private GcsUtilMock(
         Credentials credentials,
         @Nullable Integer uploadBufferSizeBytes,
         @Nullable Integer rewriteDataOpBatchLimit,
-        GcsCountersOptions gcsCountersOptions) {
+        GcsCountersOptions gcsCountersOptions,
+        GoogleCloudStorageReadOptions gcsReadOptions) {
       super(
           storageClient,
           httpRequestInitializer,
@@ -1650,7 +1678,8 @@ private GcsUtilMock(
           credentials,
           uploadBufferSizeBytes,
           rewriteDataOpBatchLimit,
-          gcsCountersOptions);
+          gcsCountersOptions,
+          gcsReadOptions);
     }
 
     @Override

From 2fe725d92a0311677b3e6f5ffcd3838064ca2932 Mon Sep 17 00:00:00 2001
From: Danny McCormick <dannymccormick@google.com>
Date: Tue, 3 Dec 2024 11:44:41 -0500
Subject: [PATCH 059/135] Update republish workflow with latest beam (#33194)

---
 .github/workflows/republish_released_docker_containers.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/republish_released_docker_containers.yml b/.github/workflows/republish_released_docker_containers.yml
index d359ba2c4489..ed6e74ecf13d 100644
--- a/.github/workflows/republish_released_docker_containers.yml
+++ b/.github/workflows/republish_released_docker_containers.yml
@@ -34,8 +34,8 @@ on:
   - cron: "0 6 * * 1"
 env:
   docker_registry: gcr.io
-  release: ${{ github.event.inputs.RELEASE || "2.60.0" }}
-  rc: ${{ github.event.inputs.RC || "2" }}
+  release: ${{ github.event.inputs.RELEASE || "2.61.0" }}
+  rc: ${{ github.event.inputs.RC || "3" }}
 
 jobs:
 

From 95a08451c58cf95a1c844e17e08832532a796bd7 Mon Sep 17 00:00:00 2001
From: Ravi Magham <maghamravikiran@gmail.com>
Date: Tue, 3 Dec 2024 14:59:05 -0800
Subject: [PATCH 060/135] jdbcio write batch config changes (#33205)

* jdbcio write batch config changes

* fixup: lint fixes

* fixup: format fixes

* fixup: support batch size for yaml based pipeline

* fixup: review comments

---------

Co-authored-by: Ravi Magham <ravimagham@lyft.com>
Co-authored-by: PoojaS2010 <satuluripooja@gmail.com>
---
 .../beam/sdk/io/jdbc/JdbcSchemaIOProvider.java   |  5 +++++
 .../jdbc/JdbcWriteSchemaTransformProvider.java   | 11 +++++++++++
 .../org/apache/beam/sdk/io/jdbc/JdbcIOTest.java  | 16 ++++++++++++++++
 .../sdk/io/jdbc/JdbcSchemaIOProviderTest.java    |  2 ++
 .../JdbcWriteSchemaTransformProviderTest.java    |  1 +
 sdks/python/apache_beam/io/jdbc.py               |  9 ++++++++-
 sdks/python/apache_beam/yaml/standard_io.yaml    |  1 +
 7 files changed, 44 insertions(+), 1 deletion(-)

diff --git a/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProvider.java b/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProvider.java
index 30012465eb9e..11034aee1cdf 100644
--- a/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProvider.java
+++ b/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProvider.java
@@ -68,6 +68,7 @@ public Schema configurationSchema() {
         .addNullableField("disableAutoCommit", FieldType.BOOLEAN)
         .addNullableField("outputParallelization", FieldType.BOOLEAN)
         .addNullableField("autosharding", FieldType.BOOLEAN)
+        .addNullableField("writeBatchSize", FieldType.INT64)
         // Partitioning support. If you specify a partition column we will use that instead of
         // readQuery
         .addNullableField("partitionColumn", FieldType.STRING)
@@ -194,6 +195,10 @@ public PDone expand(PCollection<Row> input) {
           if (autosharding != null && autosharding) {
             writeRows = writeRows.withAutoSharding();
           }
+          @Nullable Long writeBatchSize = config.getInt64("writeBatchSize");
+          if (writeBatchSize != null) {
+            writeRows = writeRows.withBatchSize(writeBatchSize);
+          }
           return input.apply(writeRows);
         }
       };
diff --git a/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcWriteSchemaTransformProvider.java b/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcWriteSchemaTransformProvider.java
index a409b604b11f..1f970ba0624f 100644
--- a/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcWriteSchemaTransformProvider.java
+++ b/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcWriteSchemaTransformProvider.java
@@ -141,6 +141,12 @@ public PCollectionRowTuple expand(PCollectionRowTuple input) {
       if (autosharding != null && autosharding) {
         writeRows = writeRows.withAutoSharding();
       }
+
+      Long writeBatchSize = config.getBatchSize();
+      if (writeBatchSize != null) {
+        writeRows = writeRows.withBatchSize(writeBatchSize);
+      }
+
       PCollection<Row> postWrite =
           input
               .get("input")
@@ -205,6 +211,9 @@ public abstract static class JdbcWriteSchemaTransformConfiguration implements Se
     @Nullable
     public abstract String getDriverJars();
 
+    @Nullable
+    public abstract Long getBatchSize();
+
     public void validate() throws IllegalArgumentException {
       if (Strings.isNullOrEmpty(getJdbcUrl())) {
         throw new IllegalArgumentException("JDBC URL cannot be blank");
@@ -268,6 +277,8 @@ public abstract Builder setConnectionInitSql(
 
       public abstract Builder setDriverJars(String value);
 
+      public abstract Builder setBatchSize(Long value);
+
       public abstract JdbcWriteSchemaTransformConfiguration build();
     }
   }
diff --git a/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcIOTest.java b/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcIOTest.java
index a04f8c4e762f..8725ef4b3f78 100644
--- a/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcIOTest.java
+++ b/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcIOTest.java
@@ -549,6 +549,22 @@ public void testWrite() throws Exception {
     }
   }
 
+  @Test
+  public void testWriteWithBatchSize() throws Exception {
+    String tableName = DatabaseTestHelper.getTestTableName("UT_WRITE");
+    DatabaseTestHelper.createTable(DATA_SOURCE, tableName);
+    try {
+      ArrayList<KV<Integer, String>> data = getDataToWrite(EXPECTED_ROW_COUNT);
+      pipeline.apply(Create.of(data)).apply(getJdbcWrite(tableName).withBatchSize(10L));
+
+      pipeline.run();
+
+      assertRowCount(DATA_SOURCE, tableName, EXPECTED_ROW_COUNT);
+    } finally {
+      DatabaseTestHelper.deleteTable(DATA_SOURCE, tableName);
+    }
+  }
+
   @Test
   public void testWriteWithAutosharding() throws Exception {
     String tableName = DatabaseTestHelper.getTestTableName("UT_WRITE");
diff --git a/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProviderTest.java b/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProviderTest.java
index ed380d813625..193a1f0c3477 100644
--- a/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProviderTest.java
+++ b/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProviderTest.java
@@ -133,6 +133,7 @@ public void testAbleToReadDataSourceConfiguration() {
             .withFieldValue("connectionInitSqls", new ArrayList<>(Collections.singleton("initSql")))
             .withFieldValue("maxConnections", (short) 3)
             .withFieldValue("driverJars", "test.jar")
+            .withFieldValue("writeBatchSize", 10L)
             .build();
     JdbcSchemaIOProvider.JdbcSchemaIO schemaIO =
         provider.from(READ_TABLE_NAME, config, Schema.builder().build());
@@ -148,6 +149,7 @@ public void testAbleToReadDataSourceConfiguration() {
         Objects.requireNonNull(dataSourceConf.getConnectionInitSqls()).get());
     assertEquals(3, (int) dataSourceConf.getMaxConnections().get());
     assertEquals("test.jar", Objects.requireNonNull(dataSourceConf.getDriverJars()).get());
+    assertEquals(10L, schemaIO.config.getInt64("writeBatchSize").longValue());
   }
 
   /** Create test data that is consistent with that generated by TestRow. */
diff --git a/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcWriteSchemaTransformProviderTest.java b/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcWriteSchemaTransformProviderTest.java
index f66a143323e5..d6be4d9f89c8 100644
--- a/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcWriteSchemaTransformProviderTest.java
+++ b/sdks/java/io/jdbc/src/test/java/org/apache/beam/sdk/io/jdbc/JdbcWriteSchemaTransformProviderTest.java
@@ -175,6 +175,7 @@ public void testWriteToTable() throws SQLException {
                     .setDriverClassName(DATA_SOURCE_CONFIGURATION.getDriverClassName().get())
                     .setJdbcUrl(DATA_SOURCE_CONFIGURATION.getUrl().get())
                     .setLocation(writeTableName)
+                    .setBatchSize(1L)
                     .build()));
     pipeline.run();
     DatabaseTestHelper.assertRowCount(DATA_SOURCE, writeTableName, 2);
diff --git a/sdks/python/apache_beam/io/jdbc.py b/sdks/python/apache_beam/io/jdbc.py
index d4ece0c7bc29..11570680a2f3 100644
--- a/sdks/python/apache_beam/io/jdbc.py
+++ b/sdks/python/apache_beam/io/jdbc.py
@@ -131,7 +131,8 @@ def default_io_expansion_service(classpath=None):
      ('partition_column', typing.Optional[str]),
      ('partitions', typing.Optional[np.int16]),
      ('max_connections', typing.Optional[np.int16]),
-     ('driver_jars', typing.Optional[str])],
+     ('driver_jars', typing.Optional[str]),
+     ('write_batch_size', typing.Optional[np.int64])],
 )
 
 DEFAULT_JDBC_CLASSPATH = ['org.postgresql:postgresql:42.2.16']
@@ -187,6 +188,7 @@ def __init__(
       driver_jars=None,
       expansion_service=None,
       classpath=None,
+      write_batch_size=None,
   ):
     """
     Initializes a write operation to Jdbc.
@@ -218,6 +220,9 @@ def __init__(
                       package (e.g. "org.postgresql:postgresql:42.3.1").
                       By default, this argument includes a Postgres SQL JDBC
                       driver.
+    :param write_batch_size: sets the maximum size in number of SQL statement
+                             for the batch.
+                             default is {@link JdbcIO.DEFAULT_BATCH_SIZE}
     """
     classpath = classpath or DEFAULT_JDBC_CLASSPATH
     super().__init__(
@@ -235,6 +240,7 @@ def __init__(
                             connection_properties=connection_properties,
                             connection_init_sqls=connection_init_sqls,
                             write_statement=statement,
+                            write_batch_size=write_batch_size,
                             read_query=None,
                             fetch_size=None,
                             disable_autocommit=None,
@@ -352,6 +358,7 @@ def __init__(
                             connection_properties=connection_properties,
                             connection_init_sqls=connection_init_sqls,
                             write_statement=None,
+                            write_batch_size=None,
                             read_query=query,
                             fetch_size=fetch_size,
                             disable_autocommit=disable_autocommit,
diff --git a/sdks/python/apache_beam/yaml/standard_io.yaml b/sdks/python/apache_beam/yaml/standard_io.yaml
index 269c14e17baa..305e6877ad90 100644
--- a/sdks/python/apache_beam/yaml/standard_io.yaml
+++ b/sdks/python/apache_beam/yaml/standard_io.yaml
@@ -225,6 +225,7 @@
         driver_jars: 'driver_jars'
         connection_properties: 'connection_properties'
         connection_init_sql: 'connection_init_sql'
+        batch_size: 'batch_size'
       'ReadFromMySql': 'ReadFromJdbc'
       'WriteToMySql': 'WriteToJdbc'
       'ReadFromPostgres': 'ReadFromJdbc'

From 697a84393e932aada3947c19d61c9b34a2b1ded9 Mon Sep 17 00:00:00 2001
From: Gabija Balvociute <47227438+thread-sleep@users.noreply.github.com>
Date: Tue, 3 Dec 2024 14:59:56 -0800
Subject: [PATCH 061/135] Tour of Beam: formatting/typos (#33249)

* common transforms

* core transforms
---
 .../aggregation/count/description.md             |  4 ++--
 .../aggregation/max/description.md               |  4 ++--
 .../aggregation/min/description.md               |  6 +++---
 .../common-transforms/filter/description.md      | 12 ++----------
 .../additional-outputs/description.md            |  4 ++--
 .../core-transforms/branching/description.md     |  2 +-
 .../combine/combine-per-key/description.md       |  8 ++++----
 .../combine/simple-function/description.md       |  2 +-
 .../core-transforms/composite/description.md     |  6 +++---
 .../core-transforms/flatten/description.md       |  2 +-
 .../map/co-group-by-key/description.md           |  2 +-
 .../map/group-by-key/description.md              | 16 ++++++++--------
 .../map/map-elements/description.md              |  2 +-
 .../map/pardo-one-to-one/description.md          | 10 +++++-----
 .../core-transforms/partition/description.md     |  2 +-
 .../core-transforms/side-inputs/description.md   |  4 ++--
 .../runner-concepts/description.md               |  2 +-
 17 files changed, 40 insertions(+), 48 deletions(-)

diff --git a/learning/tour-of-beam/learning-content/common-transforms/aggregation/count/description.md b/learning/tour-of-beam/learning-content/common-transforms/aggregation/count/description.md
index 43ab5503240c..60fd0cc9f216 100644
--- a/learning/tour-of-beam/learning-content/common-transforms/aggregation/count/description.md
+++ b/learning/tour-of-beam/learning-content/common-transforms/aggregation/count/description.md
@@ -238,11 +238,11 @@ PCollection<KV<Integer, Integer>> input = pipeline.apply(
 And replace `Count.globally` with `Count.perKey` it will output the count numbers by key. It is also necessary to replace the generic type:
 
 ```
-PCollection<KV<Integer, Integer>> output = applyTransform(input);
+PCollection<KV<Integer, Long>> output = applyTransform(input);
 ```
 
 ```
-static PCollection<KV<Integer, Integer>> applyTransform(PCollection<KV<Integer, Integer>> input) {
+static PCollection<KV<Integer, Long>> applyTransform(PCollection<KV<Integer, Integer>> input) {
         return input.apply(Count.globally());
 }
 ```
diff --git a/learning/tour-of-beam/learning-content/common-transforms/aggregation/max/description.md b/learning/tour-of-beam/learning-content/common-transforms/aggregation/max/description.md
index 92a0ace73b4d..9b8cfbea8b11 100644
--- a/learning/tour-of-beam/learning-content/common-transforms/aggregation/max/description.md
+++ b/learning/tour-of-beam/learning-content/common-transforms/aggregation/max/description.md
@@ -42,11 +42,11 @@ func ApplyTransform(s beam.Scope, input beam.PCollection) beam.PCollection {
 ```
 {{end}}
 {{if (eq .Sdk "java")}}
-You can find the global maximum value from the `PCollection` by using `Max.doublesGlobally()`
+You can find the global maximum value from the `PCollection` by using `Max.integersGlobally()`
 
 ```
 PCollection<Integer> input = pipeline.apply(Create.of(1, 2, 3, 4, 5, 6, 7, 8, 9, 10));
-PCollection<Double> max = input.apply(Max.doublesGlobally());
+PCollection<Integer> max = input.apply(Max.integersGlobally());
 ```
 
 Output
diff --git a/learning/tour-of-beam/learning-content/common-transforms/aggregation/min/description.md b/learning/tour-of-beam/learning-content/common-transforms/aggregation/min/description.md
index 1343b9d8c85f..138c8aef640e 100644
--- a/learning/tour-of-beam/learning-content/common-transforms/aggregation/min/description.md
+++ b/learning/tour-of-beam/learning-content/common-transforms/aggregation/min/description.md
@@ -41,11 +41,11 @@ func ApplyTransform(s beam.Scope, input beam.PCollection) beam.PCollection {
 ```
 {{end}}
 {{if (eq .Sdk "java")}}
-You can find the global minimum value from the `PCollection` by using `Min.doublesGlobally()`
+You can find the global minimum value from the `PCollection` by using `Min.integersGlobally()`
 
 ```
 PCollection<Integer> input = pipeline.apply(Create.of(1, 2, 3, 4, 5, 6, 7, 8, 9, 10));
-PCollection<Double> min = input.apply(Min.doublesGlobally());
+PCollection<Integer> min = input.apply(Min.integersGlobally());
 ```
 
 Output
@@ -165,7 +165,7 @@ PCollection<KV<Integer, Integer>> output = applyTransform(input);
 
 ```
 static PCollection<KV<Integer, Integer>> applyTransform(PCollection<KV<Integer, Integer>> input) {
-        return input.apply(Sum.integersPerKey());
+        return input.apply(Min.integersPerKey());
     }
 ```
 {{end}}
diff --git a/learning/tour-of-beam/learning-content/common-transforms/filter/description.md b/learning/tour-of-beam/learning-content/common-transforms/filter/description.md
index 7a5b9522926d..96f4b549625b 100644
--- a/learning/tour-of-beam/learning-content/common-transforms/filter/description.md
+++ b/learning/tour-of-beam/learning-content/common-transforms/filter/description.md
@@ -51,7 +51,7 @@ world
 
 ### Built-in filters
 
-The Java SDK has several filter methods built-in, like `Filter.greaterThan` and `Filter.lessThen`  With `Filter.greaterThan`, the input `PCollection` can be filtered so that only the elements whose values are greater than the specified amount remain. Similarly, you can use `Filter.lessThen` to filter out elements of the input `PCollection` whose values are greater than the specified amount.
+The Java SDK has several filter methods built-in, like `Filter.greaterThan` and `Filter.lessThan`  With `Filter.greaterThan`, the input `PCollection` can be filtered so that only the elements whose values are greater than the specified amount remain. Similarly, you can use `Filter.lessThan` to filter out elements of the input `PCollection` whose values are greater than the specified amount.
 
 Other built-in filters are:
 
@@ -62,7 +62,7 @@ Other built-in filters are:
 * Filter.equal
 
 
-## Example 2: Filtering with a built-in methods
+## Example 2: Filtering with built-in methods
 
 ```
 // List of integers
@@ -404,11 +404,3 @@ func applyTransform(s beam.Scope, input beam.PCollection) beam.PCollection {
     })
 }
 ```
-
-### Playground exercise
-
-You can find the complete code of the above example using 'Filter' in the playground window, which you can run and experiment with.
-
-Filter transform can be used with both text and numerical collection. For example, let's try filtering the input collection that contains words so that only words that start with the letter 'a' are returned.
-
-You can also chain several filter transforms to form more complex filtering based on several simple filters or implement more complex filtering logic within a single filter transform. For example, try both approaches to filter the same list of words such that only ones that start with a letter 'a' (regardless of the case) and containing more than three symbols are returned.
diff --git a/learning/tour-of-beam/learning-content/core-transforms/additional-outputs/description.md b/learning/tour-of-beam/learning-content/core-transforms/additional-outputs/description.md
index d228e6537498..7c4922314521 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/additional-outputs/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/additional-outputs/description.md
@@ -104,7 +104,7 @@ func extractWordsFn(pn beam.PaneInfo, line string, emitWords func(string)) {
 ```
 {{end}}
 {{if (eq .Sdk "java")}}
-While `ParDo` always outputs the main output of `PCollection` (as a return value from apply), you can also force your `ParDo` to output any number of additional `PCollection` outputs. If you decide to have multiple outputs, your `ParDo` will return all the `PCollection` output (including the main output) combined. This will be useful when you are working with big data or a database that needs to be divided into different collections. You get a combined `PCollectionTuple`, you can use `TupleTag` to get a `PCollection`.
+While `ParDo` always outputs the main output of `PCollection` (as a return value from apply), you can also force your `ParDo` to output any number of additional `PCollection` outputs. If you decide to have multiple outputs, your `ParDo` will return all the `PCollection` outputs (including the main output) combined. This will be useful when you are working with big data or a database that needs to be divided into different collections. You get a combined `PCollectionTuple`, you can use `TupleTag` to get a `PCollection`.
 
 A `PCollectionTuple` is an immutable tuple of heterogeneously typed `PCollection`, "with keys" `TupleTags`. A `PCollectionTuple` can be used as input or output for `PTransform` receiving or creating multiple `PCollection` inputs or outputs, which can be of different types, for example, `ParDo` with multiple outputs.
 
@@ -202,7 +202,7 @@ tens = results[None]  # the undeclared main output
 
 You can find the full code of this example in the playground window, which you can run and experiment with.
 
-The `applyTransform()` accepts a list of integers at the output two `PCollection` one `PCollection` above 100 and second below 100.
+The `applyTransform()` accepts a list of integers and outputs two `PCollections`: one `PCollection` above 100 and second below 100.
 
 You can also work with strings:
 {{if (eq .Sdk "go")}}
diff --git a/learning/tour-of-beam/learning-content/core-transforms/branching/description.md b/learning/tour-of-beam/learning-content/core-transforms/branching/description.md
index a01022de97ab..8adff770cdd5 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/branching/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/branching/description.md
@@ -86,7 +86,7 @@ starts_with_b = input | beam.Filter(lambda x: x.startswith('B'))
 
 You can find the full code of this example in the playground window, which you can run and experiment with.
 
-Accepts a `PCollection` consisting of strings. Without modification, it returns a new "PCollection". In this case, one `PCollection` includes elements in uppercase. The other `PCollection' stores inverted elements.
+Accepts a `PCollection` consisting of strings. Without modification, it returns a new `PCollection`. In this case, one `PCollection` includes elements in uppercase. The other `PCollection` stores inverted elements.
 
 You can use a different method of branching. Since `applyTransforms` performs 2 conversions, it takes a lot of time. It is possible to convert `PCollection` separately.
 {{if (eq .Sdk "go")}}
diff --git a/learning/tour-of-beam/learning-content/core-transforms/combine/combine-per-key/description.md b/learning/tour-of-beam/learning-content/core-transforms/combine/combine-per-key/description.md
index 1f44151337dd..af6f9e7aa197 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/combine/combine-per-key/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/combine/combine-per-key/description.md
@@ -14,9 +14,9 @@ limitations under the License.
 
 # CombinePerKey
 
-CombinePerKey is a transform in Apache Beam that applies a `CombineFn` function to each key of a PCollection of key-value pairs. The `CombineFn` function can be used to aggregate, sum, or combine the values associated with each key in the input `PCollection`.
+`CombinePerKey` is a transform in Apache Beam that applies a `CombineFn` function to each key of a `PCollection` of key-value pairs. The `CombineFn` function can be used to aggregate, sum, or combine the values associated with each key in the input `PCollection`.
 
-The `CombinePerKey` transform takes in an instance of a `CombineFn` class and applies it to the input `PCollection`. The output of the transform is a new PCollection where each element is a key-value pair, where the key is the same as the input key, and the value is the result of applying the `CombineFn` function to all the values associated with that key in the input `PCollection`.
+The `CombinePerKey` transform takes in an instance of a `CombineFn` class and applies it to the input `PCollection`. The output of the transform is a new `PCollection` where each element is a key-value pair, where the key is the same as the input key, and the value is the result of applying the `CombineFn` function to all the values associated with that key in the input `PCollection`.
 
 {{if (eq .Sdk "go")}}
 ```
@@ -81,7 +81,7 @@ func applyTransform(s beam.Scope, input beam.PCollection) beam.PCollection {
 {{if (eq .Sdk "java")}}
 ```
 PCollection<KV<String, Integer>> input = pipeline
-                .apply("ParseCitiesToTimeKV", Create.of(
+                .apply(Create.of(
                         KV.of("a", "apple"),
                         KV.of("o", "orange"),
                         KV.of("a", "avocado),
@@ -93,7 +93,7 @@ static PCollection<KV<String, String>> applyTransform(PCollection<KV<String, Str
         return input.apply(Combine.perKey(new SumStringBinaryCombineFn()));
     }
 
-    static class SumIntBinaryCombineFn extends BinaryCombineFn<String> {
+    static class SumStringBinaryCombineFn extends BinaryCombineFn<String> {
 
         @Override
         public String apply(String left, String right) {
diff --git a/learning/tour-of-beam/learning-content/core-transforms/combine/simple-function/description.md b/learning/tour-of-beam/learning-content/core-transforms/combine/simple-function/description.md
index 8eda136e7931..1946265fa66c 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/combine/simple-function/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/combine/simple-function/description.md
@@ -14,7 +14,7 @@ limitations under the License.
 
 # Combine
 
-`Combine` is a Beam transform for combining collections of elements or values in your data. Combine has variants that work on entire PCollections, and some that combine the values for each key in `PCollections` of **key/value** pairs.
+`Combine` is a Beam transform for combining collections of elements or values in your data. Combine has variants that work on entire `PCollections`, and some that combine the values for each key in `PCollections` of **key/value** pairs.
 
 When you apply a `Combine` transform, you must provide the function that contains the logic for combining the elements or values. The combining function should be commutative and associative, as the function is not necessarily invoked exactly once on all values with a given key. Because the input data (including the value collection) may be distributed across multiple workers, the combining function might be called multiple times to perform partial combining on subsets of the value collection. The Beam SDK also provides some pre-built combine functions for common numeric combination operations such as sum, min, and max.
 
diff --git a/learning/tour-of-beam/learning-content/core-transforms/composite/description.md b/learning/tour-of-beam/learning-content/core-transforms/composite/description.md
index 774f5deae924..c61dcee8950b 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/composite/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/composite/description.md
@@ -195,7 +195,7 @@ func extractWords(s beam.Scope, input beam.PCollection) beam.PCollection {
 }
 ```
 
-You can use other transformations you can replace `Count` with `Filter` to output words starting with **p**:
+You can use other transformations, i.e. you can replace `Count` with `Filter` to output words starting with **p**:
 
 ```
 func applyTransform(s beam.Scope, input beam.PCollection) beam.PCollection {
@@ -224,7 +224,7 @@ PCollection<String> words = input
     }));
 ```
 
-You can use other transformations you can replace `Count` with `Filter` to output words starting with **p**:
+You can use other transformations, i.e. you can replace `Count` with `Filter` to output words starting with **p**:
 
 ```
 PCollection<String> filtered = input
@@ -252,7 +252,7 @@ PCollection<String> filtered = input
 words = input | 'ExtractWords' >> beam.FlatMap(lambda line: [word for word in line.split() if word])
 ```
 
-You can use other transformations you can replace `Count` with `Filter` to output words starting with **p**:
+You can use other transformations, i.e. you can replace `Count` with `Filter` to output words starting with **p**:
 
 ```
 filtered = (input | 'ExtractNonSpaceCharacters' >> beam.FlatMap(lambda line: [word for word in line.split() if word])
diff --git a/learning/tour-of-beam/learning-content/core-transforms/flatten/description.md b/learning/tour-of-beam/learning-content/core-transforms/flatten/description.md
index 19618f02c9e3..db9cbc31dc65 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/flatten/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/flatten/description.md
@@ -56,7 +56,7 @@ By default, the coder for the output `PCollection` is the same as the coder for
 
 When using `Flatten` to merge `PCollection` objects that have a windowing strategy applied, all of the `PCollection` objects you want to merge must use a compatible windowing strategy and window sizing. For example, all the collections you’re merging must all use (hypothetically) identical 5-minute fixed windows or 4-minute sliding windows starting every 30 seconds.
 
-If your pipeline attempts to use `Flatten` to merge `PCollection` objects with incompatible windows, Beam generates an IllegalStateException error when your pipeline is constructed.
+If your pipeline attempts to use `Flatten` to merge `PCollection` objects with incompatible windows, Beam generates an `IllegalStateException` error when your pipeline is constructed.
 
 ### Playground exercise
 
diff --git a/learning/tour-of-beam/learning-content/core-transforms/map/co-group-by-key/description.md b/learning/tour-of-beam/learning-content/core-transforms/map/co-group-by-key/description.md
index a15321cd8ea3..739f43f96201 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/map/co-group-by-key/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/map/co-group-by-key/description.md
@@ -75,7 +75,7 @@ func formatCoGBKResults(key string, emailIter, phoneIter func(*string) bool) str
 {{if (eq .Sdk "java")}}
 You can use the `CoGroupByKey` transformation for a tuple of tables. `CoGroupByKey` groups results from all tables by similar keys in `CoGbkResults`, from which results for any particular table can be accessed using the `TupleTag` tag supplied with the source table.
 
-For type safety, the Jav SDK requires you to pass each `PCollection` as part of a `KeyedPCollectionTuple`. You must declare a `TupleTag` for each input `PCollection` in the `KeyedPCollectionTuple` that you want to pass to `CoGroupByKey`. As output, `CoGroupByKey` returns a `PCollection<KV<K, CoGbkResult>>`, which groups values from all the input `PCollections` by their common keys. Each key (all of type K) will have a different `CoGbkResult`, which is a map from `TupleTag<T> to Iterable<T>`. You can access a specific collection in an `CoGbkResult` object by using the `TupleTag` that you supplied with the initial collection.
+For type safety, the Java SDK requires you to pass each `PCollection` as part of a `KeyedPCollectionTuple`. You must declare a `TupleTag` for each input `PCollection` in the `KeyedPCollectionTuple` that you want to pass to `CoGroupByKey`. As output, `CoGroupByKey` returns a `PCollection<KV<K, CoGbkResult>>`, which groups values from all the input `PCollections` by their common keys. Each key (all of type K) will have a different `CoGbkResult`, which is a map from `TupleTag<T> to Iterable<T>`. You can access a specific collection in an `CoGbkResult` object by using the `TupleTag` that you supplied with the initial collection.
 
 ```
 // Mock data
diff --git a/learning/tour-of-beam/learning-content/core-transforms/map/group-by-key/description.md b/learning/tour-of-beam/learning-content/core-transforms/map/group-by-key/description.md
index c6041905a2d8..d8c396bf3a75 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/map/group-by-key/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/map/group-by-key/description.md
@@ -11,7 +11,7 @@ limitations under the License.
 -->
 # GroupByKey
 
-`GroupByKey` is a transform that is used to group elements in a `PCollection` by key. The input to `GroupByKey` is a `PCollection` of key-value pairs, where the keys are used to group the elements. The output of `GroupByKey` is a PCollection of key-value pairs, where the keys are the same as the input, and the values are lists of all the elements with that key.
+`GroupByKey` is a transform that is used to group elements in a `PCollection` by key. The input to `GroupByKey` is a `PCollection` of key-value pairs, where the keys are used to group the elements. The output of `GroupByKey` is a `PCollection` of key-value pairs, where the keys are the same as the input, and the values are lists of all the elements with that key.
 
 Let’s examine the mechanics of `GroupByKey` with a simple example case, where our data set consists of words from a text file and the line number on which they appear. We want to group together all the line numbers (values) that share the same word (key), letting us see all the places in the text where a particular word appears.
 
@@ -30,7 +30,7 @@ cat, 9
 and, 6
 ```
 
-`GroupByKey` gathers up all the values with the same key and outputs a new pair consisting of the unique key and a collection of all of the values that were associated with that key in the input collection. If we apply GroupByKey to our input collection above, the output collection would look like this:
+`GroupByKey` gathers up all the values with the same key and outputs a new pair consisting of the unique key and a collection of all of the values that were associated with that key in the input collection. If we apply `GroupByKey` to our input collection above, the output collection would look like this:
 
 ```
 cat, [1,5,9]
@@ -61,11 +61,11 @@ PCollection<KV<String, String>> input = ...;
 
 // Apply GroupByKey to the PCollection input.
 // Save the result as the PCollection reduced.
-PCollection<KV<String, Iterable<String>>> reduced = mapped.apply(GroupByKey.<String, String>create());
+PCollection<KV<String, Iterable<String>>> reduced = input.apply(GroupByKey.<String, String>create());
 ```
 {{end}}
 {{if (eq .Sdk "python")}}
-While all SDKs have a GroupByKey transform, using GroupBy is generally more natural. The `GroupBy` transform can be parameterized by the name(s) of properties on which to group the elements of the PCollection, or a function taking the each element as input that maps to a key on which to do grouping.
+While all SDKs have a `GroupByKey` transform, using `GroupBy` is generally more natural. The `GroupBy` transform can be parameterized by the name(s) of properties on which to group the elements of the `PCollection`, or a function taking the each element as input that maps to a key on which to do grouping.
 
 ```
 input = ...
@@ -77,11 +77,11 @@ grouped_words = input | beam.GroupByKey()
 
 If you are using unbounded `PCollections`, you must use either non-global windowing or an aggregation trigger in order to perform a `GroupByKey` or `CoGroupByKey`. This is because a bounded `GroupByKey` or `CoGroupByKey` must wait for all the data with a certain key to be collected, but with unbounded collections, the data is unlimited. Windowing and/or triggers allow grouping to operate on logical, finite bundles of data within the unbounded data streams.
 
-If you do apply `GroupByKey` or `CoGroupByKey` to a group of unbounded `PCollections` without setting either a non-global windowing strategy, a trigger strategy, or both for each collection, Beam generates an IllegalStateException error at pipeline construction time.
+If you do apply `GroupByKey` or `CoGroupByKey` to a group of unbounded `PCollections` without setting either a non-global windowing strategy, a trigger strategy, or both for each collection, Beam generates an `IllegalStateException` error at pipeline construction time.
 
-When using `GroupByKey` or `CoGroupByKey` to group PCollections that have a windowing strategy applied, all of the `PCollections` you want to group must use the same windowing strategy and window sizing. For example, all the collections you are merging must use (hypothetically) identical 5-minute fixed windows, or 4-minute sliding windows starting every 30 seconds.
+When using `GroupByKey` or `CoGroupByKey` to group `PCollections` that have a windowing strategy applied, all of the `PCollections` you want to group must use the same windowing strategy and window sizing. For example, all the collections you are merging must use (hypothetically) identical 5-minute fixed windows, or 4-minute sliding windows starting every 30 seconds.
 
-If your pipeline attempts to use `GroupByKey` or `CoGroupByKey` to merge `PCollections` with incompatible windows, Beam generates an IllegalStateException error at pipeline construction time.
+If your pipeline attempts to use `GroupByKey` or `CoGroupByKey` to merge `PCollections` with incompatible windows, Beam generates an `IllegalStateException` error at pipeline construction time.
 
 
 ### Playground exercise
@@ -118,7 +118,7 @@ func applyTransform(s beam.Scope, input beam.PCollection) beam.PCollection {
 {{if (eq .Sdk "java")}}
 ```
 PCollection<KV<String, Integer>> input = pipeline
-                .apply("ParseCitiesToTimeKV", Create.of(
+                .apply(Create.of(
                         KV.of("banana", 2),
                         KV.of("apple", 4),
                         KV.of("lemon", 3),
diff --git a/learning/tour-of-beam/learning-content/core-transforms/map/map-elements/description.md b/learning/tour-of-beam/learning-content/core-transforms/map/map-elements/description.md
index 27a07e4849fb..51c38a44b771 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/map/map-elements/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/map/map-elements/description.md
@@ -28,7 +28,7 @@ PCollection<Integer> wordLengths = input.apply(
     }));
 ```
 
-If your `ParDo` performs a one-to-one mapping of input elements to output elements–that is, for each input element, it applies a function that produces exactly one output element, you can use the higher-level `MapElements` transform.MapElements can accept an anonymous Java 8 lambda function for additional brevity.
+If your `ParDo` performs a one-to-one mapping of input elements to output elements–that is, for each input element, it applies a function that produces exactly one output element, you can use the higher-level `MapElements` transform. `MapElements` can accept an anonymous Java 8 lambda function for additional brevity.
 
 Here’s the previous example using `MapElements` :
 
diff --git a/learning/tour-of-beam/learning-content/core-transforms/map/pardo-one-to-one/description.md b/learning/tour-of-beam/learning-content/core-transforms/map/pardo-one-to-one/description.md
index e7bdbc6565ed..0f3dd6f580a5 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/map/pardo-one-to-one/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/map/pardo-one-to-one/description.md
@@ -264,9 +264,9 @@ wordLengths := beam.ParDo(s, func(word string) int {
 {{if (eq .Sdk "java")}}
 ### Accessing additional parameters in your DoFn
 
-In addition to the element and the OutputReceiver, Beam will populate other parameters to your DoFn’s @ProcessElement method. Any combination of these parameters can be added to your process method in any order.
+In addition to the element and the `OutputReceiver`, Beam will populate other parameters to your DoFn’s `@ProcessElement` method. Any combination of these parameters can be added to your process method in any order.
 
-**Timestamp**: To access the timestamp of an input element, add a parameter annotated with @Timestamp of type Instant. For example:
+**Timestamp**: To access the timestamp of an input element, add a parameter annotated with `@Timestamp` of type `Instant`. For example:
 
 ```
 .of(new DoFn<String, String>() {
@@ -274,7 +274,7 @@ In addition to the element and the OutputReceiver, Beam will populate other para
   }})
 ```
 
-**Window**: To access the window an input element falls into, add a parameter of the type of the window used for the input `PCollection`. If the parameter is a window type (a subclass of BoundedWindow) that does not match the input `PCollection`, then an error will be raised. If an element falls in multiple windows (for example, this will happen when using `SlidingWindows`), then the `@ProcessElement` method will be invoked multiple time for the element, once for each window. For example, when fixed windows are being used, the window is of type `IntervalWindow`.
+**Window**: To access the window an input element falls into, add a parameter of the type of the window used for the input `PCollection`. If the parameter is a window type (a subclass of `BoundedWindow`) that does not match the input `PCollection`, then an error will be raised. If an element falls in multiple windows (for example, this will happen when using `SlidingWindows`), then the `@ProcessElement` method will be invoked multiple time for the element, once for each window. For example, when fixed windows are being used, the window is of type `IntervalWindow`.
 
 ```
 .of(new DoFn<String, String>() {
@@ -298,7 +298,7 @@ In addition to the element and the OutputReceiver, Beam will populate other para
   }})
 ```
 
-`@OnTimer` methods can also access many of these parameters. Timestamp, Window, key, `PipelineOptions`, `OutputReceiver`, and `MultiOutputReceiver` parameters can all be accessed in an @OnTimer method. In addition, an `@OnTimer` method can take a parameter of type `TimeDomain` which tells whether the timer is based on event time or processing time. Timers are explained in more detail in the Timely (and Stateful) Processing with Apache Beam blog post.
+`@OnTimer` methods can also access many of these parameters. Timestamp, Window, key, `PipelineOptions`, `OutputReceiver`, and `MultiOutputReceiver` parameters can all be accessed in an `@OnTimer` method. In addition, an `@OnTimer` method can take a parameter of type `TimeDomain` which tells whether the timer is based on event time or processing time. Timers are explained in more detail in the [Timely (and Stateful) Processing with Apache Beam blog post](https://beam.apache.org/blog/timely-processing/).
 
 
 {{end}}
@@ -401,7 +401,7 @@ class StatefulDoFn(beam.DoFn):
 
 You can find the full code of this example in the playground window, which you can run and experiment with.
 
-You can work with any type of object.For example String:
+You can work with any type of object. For example `String`:
 
 {{if (eq .Sdk "go")}}
 ```
diff --git a/learning/tour-of-beam/learning-content/core-transforms/partition/description.md b/learning/tour-of-beam/learning-content/core-transforms/partition/description.md
index 59f6ad5f5c33..e951a38c1750 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/partition/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/partition/description.md
@@ -70,7 +70,7 @@ fortieth_percentile = by_decile[4]
 
 You can find the full code of this example in the playground window, which you can run and experiment with.
 
-The `applyTransforms` returns a slice of the PCollection, you can access it by index. In this case, we have two `PCollections`, one consists of numbers that are less than 100, the second is more than 100.
+The `applyTransforms` returns a slice of the `PCollection`, you can access it by index. In this case, we have two `PCollections`, one consists of numbers that are less than 100, the second is more than 100.
 
 You can also divide other types into parts, for example: "strings" and others.
 
diff --git a/learning/tour-of-beam/learning-content/core-transforms/side-inputs/description.md b/learning/tour-of-beam/learning-content/core-transforms/side-inputs/description.md
index a64ccde52950..ae5bdffc827d 100644
--- a/learning/tour-of-beam/learning-content/core-transforms/side-inputs/description.md
+++ b/learning/tour-of-beam/learning-content/core-transforms/side-inputs/description.md
@@ -11,7 +11,7 @@ limitations under the License.
 -->
 # Side inputs
 
-In addition to the main input `PCollection`, you can provide additional inputs to a `ParDo` transform in the form of side inputs. A side input is an additional input that your `DoFn` can access each time it processes an element in the input PCollection. When you specify a side input, you create a view of some other data that can be read from within the `ParDo` transform’s `DoFn` while processing each element.
+In addition to the main input `PCollection`, you can provide additional inputs to a `ParDo` transform in the form of side inputs. A side input is an additional input that your `DoFn` can access each time it processes an element in the input `PCollection`. When you specify a side input, you create a view of some other data that can be read from within the `ParDo` transform’s `DoFn` while processing each element.
 
 Side inputs are useful if your `ParDo` needs to inject additional data when processing each element in the input `PCollection`, but the additional data needs to be determined at runtime (and not hard-coded). Such values might be determined by the input data, or depend on a different branch of your pipeline.
 {{if (eq .Sdk "go")}}
@@ -172,7 +172,7 @@ If the side input has multiple trigger firings, Beam uses the value from the lat
 
 You can find the full code of this example in the playground window, which you can run and experiment with.
 
-At the entrance we have a map whose key is the city of the country value. And we also have a `Person` structure with his name and city. We can compare cities and embed countries in `Person`.
+At the entrance we have a map whose key is the city of the country value. And we also have a `Person` structure with their name and city. We can compare cities and embed countries in `Person`.
 
 You can also use it as a variable for mathematical calculations.
 
diff --git a/learning/tour-of-beam/learning-content/introduction/introduction-concepts/runner-concepts/description.md b/learning/tour-of-beam/learning-content/introduction/introduction-concepts/runner-concepts/description.md
index 71abe616f1ad..d7c4cb4137dc 100644
--- a/learning/tour-of-beam/learning-content/introduction/introduction-concepts/runner-concepts/description.md
+++ b/learning/tour-of-beam/learning-content/introduction/introduction-concepts/runner-concepts/description.md
@@ -53,7 +53,7 @@ When using Java, you must specify your dependency on the Direct Runner in your p
 
 #### Set runner
 
-In java, you need to set runner to `args` when you start the program.
+In Java, you need to set runner to `args` when you start the program.
 
 ```
 --runner=DirectRunner

From 3201c575405eb97bf821bb138920151a3138e44e Mon Sep 17 00:00:00 2001
From: Jeffrey Kinard <jeff@thekinards.com>
Date: Fri, 8 Nov 2024 16:12:31 -0500
Subject: [PATCH 062/135] [yaml] error_handling normalization follow-up

Signed-off-by: Jeffrey Kinard <jeff@thekinards.com>
---
 sdks/python/apache_beam/yaml/generate_yaml_docs.py | 5 +++--
 sdks/python/apache_beam/yaml/yaml_errors.py        | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/sdks/python/apache_beam/yaml/generate_yaml_docs.py b/sdks/python/apache_beam/yaml/generate_yaml_docs.py
index 2123c7a9f202..e0a9f3f5e6c5 100644
--- a/sdks/python/apache_beam/yaml/generate_yaml_docs.py
+++ b/sdks/python/apache_beam/yaml/generate_yaml_docs.py
@@ -154,8 +154,9 @@ def normalize_error_handling(f):
                               PythonCallableWithSource.load_from_expression(
                                   param.type_name),
                               param.description) for param in doc.params
-                      ]))),
-          description=f.description)
+                      ])),
+              nullable=True),
+          description=f.description or doc.short_description)
     return f
 
   def lines():
diff --git a/sdks/python/apache_beam/yaml/yaml_errors.py b/sdks/python/apache_beam/yaml/yaml_errors.py
index c0d448473f42..dace44ca09f6 100644
--- a/sdks/python/apache_beam/yaml/yaml_errors.py
+++ b/sdks/python/apache_beam/yaml/yaml_errors.py
@@ -24,7 +24,7 @@
 
 
 class ErrorHandlingConfig(NamedTuple):
-  """Class to define Error Handling parameters.
+  """This option specifies whether and where to output error rows.
 
       Args:
         output (str): Name to use for the output error collection

From edd352801d1f50638f1536be9ee9e979dcb4b4d0 Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Wed, 4 Dec 2024 06:06:44 -0800
Subject: [PATCH 063/135] Add a pointer to java provider example. (#33240)

---
 website/www/site/content/en/documentation/sdks/yaml.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/website/www/site/content/en/documentation/sdks/yaml.md b/website/www/site/content/en/documentation/sdks/yaml.md
index d4829c163522..a27b47a2b415 100644
--- a/website/www/site/content/en/documentation/sdks/yaml.md
+++ b/website/www/site/content/en/documentation/sdks/yaml.md
@@ -662,6 +662,9 @@ providers:
        MyCustomTransform: "urn:registered:in:expansion:service"
 ```
 
+A full example of how to build a java provider can be found
+[here](https://github.com/Polber/beam-yaml-xlang).
+
 Arbitrary Python transforms can be provided as well, using the syntax
 
 ```

From a9a82a1c1ae7a702f25dc98fd3aaca16f50209e3 Mon Sep 17 00:00:00 2001
From: Jeff Kinard <jeff@thekinards.com>
Date: Wed, 4 Dec 2024 10:28:46 -0500
Subject: [PATCH 064/135] [yaml] remove PubSubLite from API docs (#33184)

* [yaml] remove PubSubLite from API docs

Signed-off-by: Jeffrey Kinard <jeff@thekinards.com>

* add deprecation note

Signed-off-by: Jeffrey Kinard <jeff@thekinards.com>

---------

Signed-off-by: Jeffrey Kinard <jeff@thekinards.com>
---
 .../PubsubLiteReadSchemaTransformProvider.java         |  7 +++++++
 .../PubsubLiteWriteSchemaTransformProvider.java        |  7 +++++++
 sdks/python/apache_beam/yaml/generate_yaml_docs.py     | 10 ++++------
 3 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/pubsublite/PubsubLiteReadSchemaTransformProvider.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/pubsublite/PubsubLiteReadSchemaTransformProvider.java
index 9e83619f7b8d..61b94aeee445 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/pubsublite/PubsubLiteReadSchemaTransformProvider.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/pubsublite/PubsubLiteReadSchemaTransformProvider.java
@@ -87,6 +87,13 @@ protected Class<PubsubLiteReadSchemaTransformConfiguration> configurationClass()
     return PubsubLiteReadSchemaTransformConfiguration.class;
   }
 
+  @Override
+  public String description() {
+    return "Performs a read from Google Pub/Sub Lite.\n"
+        + "\n"
+        + "**Note**: This provider is deprecated. See Pub/Sub Lite <a href=\"https://cloud.google.com/pubsub/lite/docs\">documentation</a> for more information.";
+  }
+
   public static class ErrorFn extends DoFn<SequencedMessage, Row> {
     private final SerializableFunction<byte[], Row> valueMapper;
     private final Counter errorCounter;
diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/pubsublite/PubsubLiteWriteSchemaTransformProvider.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/pubsublite/PubsubLiteWriteSchemaTransformProvider.java
index ebca921c57e1..54ed7ac495d9 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/pubsublite/PubsubLiteWriteSchemaTransformProvider.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/pubsublite/PubsubLiteWriteSchemaTransformProvider.java
@@ -82,6 +82,13 @@ protected Class<PubsubLiteWriteSchemaTransformConfiguration> configurationClass(
     return PubsubLiteWriteSchemaTransformConfiguration.class;
   }
 
+  @Override
+  public String description() {
+    return "Performs a write to Google Pub/Sub Lite.\n"
+        + "\n"
+        + "**Note**: This provider is deprecated. See Pub/Sub Lite <a href=\"https://cloud.google.com/pubsub/lite/docs\">documentation</a> for more information.";
+  }
+
   public static class ErrorCounterFn extends DoFn<Row, PubSubMessage> {
     private final SerializableFunction<Row, byte[]> toBytesFn;
     private final Counter errorCounter;
diff --git a/sdks/python/apache_beam/yaml/generate_yaml_docs.py b/sdks/python/apache_beam/yaml/generate_yaml_docs.py
index 2123c7a9f202..38a888fdebe3 100644
--- a/sdks/python/apache_beam/yaml/generate_yaml_docs.py
+++ b/sdks/python/apache_beam/yaml/generate_yaml_docs.py
@@ -189,11 +189,8 @@ def io_grouping_key(transform_name):
     return 0, transform_name
 
 
-SKIP = [
-    'Combine',
-    'Filter',
-    'MapToFields',
-]
+# Exclude providers
+SKIP = {}
 
 
 def transform_docs(transform_base, transforms, providers, extra_docs=''):
@@ -236,7 +233,8 @@ def main():
   options = parser.parse_args()
   include = re.compile(options.include).match
   exclude = (
-      re.compile(options.exclude).match if options.exclude else lambda _: False)
+      re.compile(options.exclude).match
+      if options.exclude else lambda x: x in SKIP)
 
   with subprocess_server.SubprocessServer.cache_subprocesses():
     json_config_schemas = []

From 2f788f674f377f857748c761abe98397038a8979 Mon Sep 17 00:00:00 2001
From: Ahmed Abualsaud <65791736+ahmedabu98@users.noreply.github.com>
Date: Wed, 4 Dec 2024 11:46:47 -0500
Subject: [PATCH 065/135] use standard sql (#33278)

---
 .../BigQueryDirectReadSchemaTransformProvider.java     |  2 +-
 .../io/gcp/bigquery/providers/BigQueryManagedIT.java   | 10 ++++++----
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/providers/BigQueryDirectReadSchemaTransformProvider.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/providers/BigQueryDirectReadSchemaTransformProvider.java
index 15b1b01d7f6c..073de40038b3 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/providers/BigQueryDirectReadSchemaTransformProvider.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/providers/BigQueryDirectReadSchemaTransformProvider.java
@@ -233,7 +233,7 @@ BigQueryIO.TypedRead<TableRow> createDirectReadTransform() {
           read = read.withSelectedFields(configuration.getSelectedFields());
         }
       } else {
-        read = read.fromQuery(configuration.getQuery());
+        read = read.fromQuery(configuration.getQuery()).usingStandardSql();
       }
       if (!Strings.isNullOrEmpty(configuration.getKmsKey())) {
         read = read.withKmsKey(configuration.getKmsKey());
diff --git a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/providers/BigQueryManagedIT.java b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/providers/BigQueryManagedIT.java
index 16ce2f049dcf..6a422f1832d8 100644
--- a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/providers/BigQueryManagedIT.java
+++ b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/providers/BigQueryManagedIT.java
@@ -96,8 +96,8 @@ public static void cleanup() {
   @Test
   public void testBatchFileLoadsWriteRead() {
     String table =
-        String.format("%s:%s.%s", PROJECT, BIG_QUERY_DATASET_ID, testName.getMethodName());
-    Map<String, Object> config = ImmutableMap.of("table", table);
+        String.format("%s.%s.%s", PROJECT, BIG_QUERY_DATASET_ID, testName.getMethodName());
+    Map<String, Object> writeConfig = ImmutableMap.of("table", table);
 
     // file loads requires a GCS temp location
     String tempLocation = writePipeline.getOptions().as(TestPipelineOptions.class).getTempRoot();
@@ -105,13 +105,15 @@ public void testBatchFileLoadsWriteRead() {
 
     // batch write
     PCollectionRowTuple.of("input", getInput(writePipeline, false))
-        .apply(Managed.write(Managed.BIGQUERY).withConfig(config));
+        .apply(Managed.write(Managed.BIGQUERY).withConfig(writeConfig));
     writePipeline.run().waitUntilFinish();
 
+    Map<String, Object> readConfig =
+        ImmutableMap.of("query", String.format("SELECT * FROM `%s`", table));
     // read and validate
     PCollection<Row> outputRows =
         readPipeline
-            .apply(Managed.read(Managed.BIGQUERY).withConfig(config))
+            .apply(Managed.read(Managed.BIGQUERY).withConfig(readConfig))
             .getSinglePCollection();
     PAssert.that(outputRows).containsInAnyOrder(ROWS);
     readPipeline.run().waitUntilFinish();

From 78bde63b4f4d6158584faa2362760e5260336a15 Mon Sep 17 00:00:00 2001
From: Jeff Kinard <jeff@thekinards.com>
Date: Wed, 4 Dec 2024 12:08:24 -0500
Subject: [PATCH 066/135] [yaml] Fix YAML join with upstream ReadFromPubSub
 (#33273)

---
 sdks/python/apache_beam/yaml/yaml_join.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/sdks/python/apache_beam/yaml/yaml_join.py b/sdks/python/apache_beam/yaml/yaml_join.py
index 5124ef56b49c..b22e452b27f9 100644
--- a/sdks/python/apache_beam/yaml/yaml_join.py
+++ b/sdks/python/apache_beam/yaml/yaml_join.py
@@ -62,9 +62,11 @@ def _validate_equalities(equalities, pcolls):
   error_prefix = f'Invalid value "{equalities}" for "equalities".'
 
   valid_cols = {
-      name: set(dict(pcoll.element_type._fields).keys())
-      for name,
-      pcoll in pcolls.items()
+      name: set(
+          dict(fields).keys() if fields and all(
+              isinstance(field, tuple) for field in fields) else fields)
+      for (name, pcoll) in pcolls.items()
+      for fields in [getattr(pcoll.element_type, '_fields', [])]
   }
 
   if isinstance(equalities, str):

From f080be0fbdc68dbbe629caad6bb8b730d6ff362d Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Wed, 4 Dec 2024 10:49:47 -0800
Subject: [PATCH 067/135] [YAML] Make datetime available for jinja
 templatization.

---
 CHANGES.md                                     |  1 +
 sdks/python/apache_beam/yaml/main_test.py      | 13 +++++++++++++
 sdks/python/apache_beam/yaml/yaml_transform.py |  3 ++-
 3 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/CHANGES.md b/CHANGES.md
index fc32398a7a5a..5258183140a2 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -31,6 +31,7 @@
 
 ## New Features / Improvements
 
+* The datetime module is now available for use in jinja templatization for yaml.
 * X feature added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
 
 ## Breaking Changes
diff --git a/sdks/python/apache_beam/yaml/main_test.py b/sdks/python/apache_beam/yaml/main_test.py
index 1a3da6443b72..d5fbfedc0349 100644
--- a/sdks/python/apache_beam/yaml/main_test.py
+++ b/sdks/python/apache_beam/yaml/main_test.py
@@ -15,6 +15,7 @@
 # limitations under the License.
 #
 
+import datetime
 import glob
 import logging
 import os
@@ -100,6 +101,18 @@ def test_preparse_jinja_flags(self):
             'pos_arg',
         ])
 
+  def test_jinja_datetime(self):
+    with tempfile.TemporaryDirectory() as tmpdir:
+      out_path = os.path.join(tmpdir, 'out.txt')
+      main.run([
+          '--yaml_pipeline',
+          TEST_PIPELINE.replace('PATH', out_path).replace(
+              'ELEMENT', '"{{datetime.datetime.now().strftime("%Y-%m-%d")}}"'),
+      ])
+      with open(glob.glob(out_path + '*')[0], 'rt') as fin:
+        self.assertEqual(
+            fin.read().strip(), datetime.datetime.now().strftime("%Y-%m-%d"))
+
 
 if __name__ == '__main__':
   logging.getLogger().setLevel(logging.INFO)
diff --git a/sdks/python/apache_beam/yaml/yaml_transform.py b/sdks/python/apache_beam/yaml/yaml_transform.py
index 0190fe20413f..82cd404b4ddc 100644
--- a/sdks/python/apache_beam/yaml/yaml_transform.py
+++ b/sdks/python/apache_beam/yaml/yaml_transform.py
@@ -16,6 +16,7 @@
 #
 
 import collections
+import datetime
 import functools
 import json
 import logging
@@ -992,7 +993,7 @@ def expand_jinja(
       jinja2.Environment(
           undefined=jinja2.StrictUndefined, loader=_BeamFileIOLoader())
       .from_string(jinja_template)
-      .render(**jinja_variables))
+      .render(datetime=datetime, **jinja_variables))
 
 
 class YamlTransform(beam.PTransform):

From 56d6a4670eee61c3a8186a0f5f2d9d78b9249ca4 Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Wed, 4 Dec 2024 11:03:12 -0800
Subject: [PATCH 068/135] [YAML] Document the yaml provider include syntax.

---
 .../www/site/content/en/documentation/sdks/yaml.md  | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/website/www/site/content/en/documentation/sdks/yaml.md b/website/www/site/content/en/documentation/sdks/yaml.md
index a27b47a2b415..1b68db19de3c 100644
--- a/website/www/site/content/en/documentation/sdks/yaml.md
+++ b/website/www/site/content/en/documentation/sdks/yaml.md
@@ -678,6 +678,19 @@ providers:
        MyCustomTransform: "pkg.subpkg.PTransformClassOrCallable"
 ```
 
+One can additionally reference an external listings of providers as follows
+
+```
+providers:
+  - include: "file:///path/to/local/providers.yaml"
+  - include: "gs://path/to/remote/providers.yaml"
+  - include: "https://example.com/hosted/providers.yaml"
+  ...
+```
+
+where `providers.yaml` is simply a yaml file containing a list of providers
+in the same format as those inlined in this providers block.
+
 ## Pipeline options
 
 [Pipeline options](https://beam.apache.org/documentation/programming-guide/#configuring-pipeline-options)

From 40423bce99d271250509f1e10ebee5b32f53a0a7 Mon Sep 17 00:00:00 2001
From: Ahmed Abualsaud <65791736+ahmedabu98@users.noreply.github.com>
Date: Wed, 4 Dec 2024 15:30:38 -0500
Subject: [PATCH 069/135] add iceberg gcp dependency (#33281)

---
 sdks/java/io/iceberg/build.gradle | 1 +
 1 file changed, 1 insertion(+)

diff --git a/sdks/java/io/iceberg/build.gradle b/sdks/java/io/iceberg/build.gradle
index 6754b0aecf50..a2d192b67208 100644
--- a/sdks/java/io/iceberg/build.gradle
+++ b/sdks/java/io/iceberg/build.gradle
@@ -53,6 +53,7 @@ dependencies {
     implementation "org.apache.iceberg:iceberg-api:$iceberg_version"
     implementation "org.apache.iceberg:iceberg-parquet:$iceberg_version"
     implementation "org.apache.iceberg:iceberg-orc:$iceberg_version"
+    runtimeOnly "org.apache.iceberg:iceberg-gcp:$iceberg_version"
     implementation library.java.hadoop_common
 
     testImplementation project(":sdks:java:managed")

From 122368f028ad4b6781c6da677334db21027d9edb Mon Sep 17 00:00:00 2001
From: Damon <damondouglas@users.noreply.github.com>
Date: Wed, 4 Dec 2024 13:04:40 -0800
Subject: [PATCH 070/135] Fix TypeError: 'type' object is not subscriptable
 (#33280)

Internal dataflow tests reference this code line with the error `TypeError: 'type' object is not subscriptable`.
---
 sdks/python/apache_beam/metrics/cells.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sdks/python/apache_beam/metrics/cells.py b/sdks/python/apache_beam/metrics/cells.py
index 10ac7b3a1e69..5802c6914eb2 100644
--- a/sdks/python/apache_beam/metrics/cells.py
+++ b/sdks/python/apache_beam/metrics/cells.py
@@ -570,7 +570,7 @@ def __repr__(self) -> str:
   def get_cumulative(self) -> "StringSetData":
     return StringSetData(set(self.string_set), self.string_size)
 
-  def get_result(self) -> set[str]:
+  def get_result(self) -> Set[str]:
     return set(self.string_set)
 
   def add(self, *strings):

From 2e43e29e44c2cb90c8e59a64c441cb37a0ffd44f Mon Sep 17 00:00:00 2001
From: Robert Burke <lostluck@users.noreply.github.com>
Date: Wed, 4 Dec 2024 14:04:23 -0800
Subject: [PATCH 071/135] [#32222] Actually maintain the heap invariant for
 timers. (#33270)

---
 CHANGES.md                                               | 1 +
 runners/prism/java/build.gradle                          | 9 +--------
 .../beam/runners/prism/internal/engine/elementmanager.go | 7 +++++--
 .../runners/portability/fn_api_runner/fn_runner_test.py  | 9 ++++++---
 4 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/CHANGES.md b/CHANGES.md
index fc32398a7a5a..1b943a99f8a0 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -81,6 +81,7 @@
 ## Bugfixes
 
 * Fixed X (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
+* Fixed EventTimeTimer ordering in Prism. ([#32222](https://github.com/apache/beam/issues/32222)).
 
 ## Security Fixes
 * Fixed (CVE-YYYY-NNNN)[https://www.cve.org/CVERecord?id=CVE-YYYY-NNNN] (Java/Python/Go) ([#X](https://github.com/apache/beam/issues/X)).
diff --git a/runners/prism/java/build.gradle b/runners/prism/java/build.gradle
index f2dfa2bb1a28..82eb62b9e207 100644
--- a/runners/prism/java/build.gradle
+++ b/runners/prism/java/build.gradle
@@ -178,10 +178,7 @@ def sickbayTests = [
     'org.apache.beam.sdk.transforms.ParDoTest$StateTests.testTwoRequiresTimeSortedInputWithLateData',
     'org.apache.beam.sdk.transforms.ParDoTest$StateTests.testRequiresTimeSortedInputWithLateData',
 
-    // Timer race condition/ordering issue in Prism.
-    'org.apache.beam.sdk.transforms.ParDoTest$TimerTests.testTwoTimersSettingEachOtherWithCreateAsInputUnbounded',
-
-    // Missing output due to timer skew.
+    // Missing output due to processing time timer skew.
     'org.apache.beam.sdk.transforms.ParDoTest$TimestampTests.testProcessElementSkew',
 
     // TestStream + BundleFinalization.
@@ -241,10 +238,6 @@ def createPrismValidatesRunnerTask = { name, environmentType ->
        excludeCategories 'org.apache.beam.sdk.testing.UsesMultimapState'
     }
     filter {
-      // Hangs forever with prism. Put here instead of sickbay to allow sickbay runs to terminate.
-      // https://github.com/apache/beam/issues/32222
-      excludeTestsMatching 'org.apache.beam.sdk.transforms.ParDoTest$TimerTests.testEventTimeTimerOrderingWithCreate'
-
       for (String test : sickbayTests) {
           excludeTestsMatching test
       }
diff --git a/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go b/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go
index 3cfde4701a8f..1739efdb742a 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go
@@ -1159,7 +1159,7 @@ func (ss *stageState) AddPending(newPending []element) int {
 				}
 				ss.pendingByKeys[string(e.keyBytes)] = dnt
 			}
-			dnt.elements.Push(e)
+			heap.Push(&dnt.elements, e)
 
 			if e.IsTimer() {
 				if lastSet, ok := dnt.timers[timerKey{family: e.family, tag: e.tag, window: e.window}]; ok {
@@ -1576,6 +1576,8 @@ func (ss *stageState) updateWatermarks(em *ElementManager) set[string] {
 		// They'll never be read in again.
 		for _, wins := range ss.sideInputs {
 			for win := range wins {
+				// TODO(#https://github.com/apache/beam/issues/31438):
+				// Adjust with AllowedLateness
 				// Clear out anything we've already used.
 				if win.MaxTimestamp() < newOut {
 					delete(wins, win)
@@ -1584,7 +1586,8 @@ func (ss *stageState) updateWatermarks(em *ElementManager) set[string] {
 		}
 		for _, wins := range ss.state {
 			for win := range wins {
-				// Clear out anything we've already used.
+				// TODO(#https://github.com/apache/beam/issues/31438):
+				// Adjust with AllowedLateness
 				if win.MaxTimestamp() < newOut {
 					delete(wins, win)
 				}
diff --git a/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py b/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
index 4a737feaf288..1309e7c74abc 100644
--- a/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
+++ b/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
@@ -776,7 +776,8 @@ def process(
           state.clear()
           yield buffer
         else:
-          timer.set(ts + 1)
+          # Set the timer to fire within it's window.
+          timer.set(ts + (1 - timestamp.Duration(micros=1000)))
 
       @userstate.on_timer(timer_spec)
       def process_timer(self, state=beam.DoFn.StateParam(state_spec)):
@@ -790,8 +791,10 @@ def is_buffered_correctly(actual):
       # Acutal should be a grouping of the inputs into batches of size
       # at most buffer_size, but the actual batching is nondeterministic
       # based on ordering and trigger firing timing.
-      self.assertEqual(sorted(sum((list(b) for b in actual), [])), elements)
-      self.assertEqual(max(len(list(buffer)) for buffer in actual), buffer_size)
+      self.assertEqual(
+          sorted(sum((list(b) for b in actual), [])), elements, actual)
+      self.assertEqual(
+          max(len(list(buffer)) for buffer in actual), buffer_size, actual)
       if windowed:
         # Elements were assigned to windows based on their parity.
         # Assert that each grouping consists of elements belonging to the

From 7ef6d36d70dc61c6e997fb31166364bd587a2941 Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Wed, 4 Dec 2024 16:01:24 -0800
Subject: [PATCH 072/135] [YAML] Document jinja templatization features.

This resolves #32873.
---
 .../content/en/documentation/sdks/yaml.md     | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/website/www/site/content/en/documentation/sdks/yaml.md b/website/www/site/content/en/documentation/sdks/yaml.md
index a27b47a2b415..4f9ee4081439 100644
--- a/website/www/site/content/en/documentation/sdks/yaml.md
+++ b/website/www/site/content/en/documentation/sdks/yaml.md
@@ -708,6 +708,49 @@ options:
   streaming: true
 ```
 
+## Jinja Templatization
+
+It is a common to want to run a single Beam pipeline in different contexts
+and/or with different configurations.
+When running a YAML pipeline either locally or via the gcloud,
+the yaml file can be parameterized with externally provided variables using
+the [jinja variable syntax](https://jinja.palletsprojects.com/en/stable/templates/#variables).
+The values are then passed via a `--jinja_variables` command line flag.
+
+For example, one could start a pipeline with
+
+```
+pipeline:
+  transforms:
+    - type: ReadFromCsv
+      config:
+        path: {{input_pattern}}
+```
+
+and then run it with
+
+```sh
+python -m apache_beam.yaml.main \
+    --yaml_pipeline_file=pipeline.yaml \
+    --jinja_variables='{"input_pattern": "gs://path/to/this/runs/files*.csv"}'
+```
+
+Arbitrary [jinja control structures](https://jinja.palletsprojects.com/en/stable/templates/#list-of-control-structures),
+such as looping and conditionals, can be used as well if desired as long as the
+output results in a valid Beam YAML pipeline.
+
+We also expose the [`datetime`](https://docs.python.org/3/library/datetime.html)
+module as a variable by default, which can be particularly useful in reading
+or writing dated sources and sinks, e.g.
+
+```
+- type: WriteToJson
+  config:
+    path: "gs://path/to/{{ datetime.datetime.now().strftime('%Y/%m/%d') }}/dated-output.json"
+```
+
+would write to files like `gs://path/to/2016/08/04/dated-output*.json`.
+
 ## Other Resources
 
 * [Example pipeline](https://github.com/apache/beam/tree/master/sdks/python/apache_beam/yaml/examples)

From 2bdbbdcfdd324b9316306ab44508b41cb1bb356f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 4 Dec 2024 21:15:27 -0800
Subject: [PATCH 073/135] Bump cloud.google.com/go/pubsub from 1.45.1 to 1.45.3
 in /sdks (#33289)

Bumps [cloud.google.com/go/pubsub](https://github.com/googleapis/google-cloud-go) from 1.45.1 to 1.45.3.
- [Release notes](https://github.com/googleapis/google-cloud-go/releases)
- [Changelog](https://github.com/googleapis/google-cloud-go/blob/main/CHANGES.md)
- [Commits](https://github.com/googleapis/google-cloud-go/compare/pubsub/v1.45.1...pubsub/v1.45.3)

---
updated-dependencies:
- dependency-name: cloud.google.com/go/pubsub
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 24 ++++++++++----------
 sdks/go.sum | 64 ++++++++++++++++++++++++++---------------------------
 2 files changed, 44 insertions(+), 44 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index ef966f0dcef4..acf52d7a62cb 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -27,7 +27,7 @@ require (
 	cloud.google.com/go/bigtable v1.33.0
 	cloud.google.com/go/datastore v1.20.0
 	cloud.google.com/go/profiler v0.4.1
-	cloud.google.com/go/pubsub v1.45.1
+	cloud.google.com/go/pubsub v1.45.3
 	cloud.google.com/go/spanner v1.73.0
 	cloud.google.com/go/storage v1.45.0
 	github.com/aws/aws-sdk-go-v2 v1.32.6
@@ -58,8 +58,8 @@ require (
 	golang.org/x/sync v0.9.0
 	golang.org/x/sys v0.27.0
 	golang.org/x/text v0.20.0
-	google.golang.org/api v0.203.0
-	google.golang.org/genproto v0.0.0-20241015192408-796eee8c2d53
+	google.golang.org/api v0.210.0
+	google.golang.org/genproto v0.0.0-20241118233622-e639e219e697
 	google.golang.org/grpc v1.67.1
 	google.golang.org/protobuf v1.35.2
 	gopkg.in/yaml.v2 v2.4.0
@@ -75,9 +75,9 @@ require (
 
 require (
 	cel.dev/expr v0.16.1 // indirect
-	cloud.google.com/go/auth v0.9.9 // indirect
-	cloud.google.com/go/auth/oauth2adapt v0.2.4 // indirect
-	cloud.google.com/go/monitoring v1.21.1 // indirect
+	cloud.google.com/go/auth v0.11.0 // indirect
+	cloud.google.com/go/auth/oauth2adapt v0.2.6 // indirect
+	cloud.google.com/go/monitoring v1.21.2 // indirect
 	dario.cat/mergo v1.0.0 // indirect
 	filippo.io/edwards25519 v1.1.0 // indirect
 	github.com/AdaLogics/go-fuzz-headers v0.0.0-20230811130428-ced1acdcaa24 // indirect
@@ -117,15 +117,15 @@ require (
 	go.opentelemetry.io/otel/sdk v1.29.0 // indirect
 	go.opentelemetry.io/otel/sdk/metric v1.29.0 // indirect
 	go.opentelemetry.io/otel/trace v1.29.0 // indirect
-	golang.org/x/time v0.7.0 // indirect
+	golang.org/x/time v0.8.0 // indirect
 	google.golang.org/grpc/stats/opentelemetry v0.0.0-20240907200651-3ffb98b2c93a // indirect
 )
 
 require (
 	cloud.google.com/go v0.116.0 // indirect
 	cloud.google.com/go/compute/metadata v0.5.2 // indirect
-	cloud.google.com/go/iam v1.2.1 // indirect
-	cloud.google.com/go/longrunning v0.6.1 // indirect
+	cloud.google.com/go/iam v1.2.2 // indirect
+	cloud.google.com/go/longrunning v0.6.2 // indirect
 	github.com/Azure/go-ansiterm v0.0.0-20210617225240-d185dfc1b5a1 // indirect
 	github.com/Microsoft/go-winio v0.6.2 // indirect
 	github.com/apache/arrow/go/arrow v0.0.0-20200730104253-651201b0f516 // indirect
@@ -163,7 +163,7 @@ require (
 	github.com/google/renameio/v2 v2.0.0 // indirect
 	github.com/google/s2a-go v0.1.8 // indirect
 	github.com/googleapis/enterprise-certificate-proxy v0.3.4 // indirect
-	github.com/googleapis/gax-go/v2 v2.13.0 // indirect
+	github.com/googleapis/gax-go/v2 v2.14.0 // indirect
 	github.com/gorilla/handlers v1.5.2 // indirect
 	github.com/gorilla/mux v1.8.1 // indirect
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
@@ -194,6 +194,6 @@ require (
 	golang.org/x/mod v0.20.0 // indirect
 	golang.org/x/tools v0.24.0 // indirect
 	golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da // indirect
-	google.golang.org/genproto/googleapis/api v0.0.0-20241007155032-5fefd90f89a9 // indirect
-	google.golang.org/genproto/googleapis/rpc v0.0.0-20241015192408-796eee8c2d53 // indirect
+	google.golang.org/genproto/googleapis/api v0.0.0-20241113202542-65e8d215514f // indirect
+	google.golang.org/genproto/googleapis/rpc v0.0.0-20241118233622-e639e219e697 // indirect
 )
diff --git a/sdks/go.sum b/sdks/go.sum
index 5527a59f4c52..d8eb73149c76 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -101,10 +101,10 @@ cloud.google.com/go/assuredworkloads v1.7.0/go.mod h1:z/736/oNmtGAyU47reJgGN+KVo
 cloud.google.com/go/assuredworkloads v1.8.0/go.mod h1:AsX2cqyNCOvEQC8RMPnoc0yEarXQk6WEKkxYfL6kGIo=
 cloud.google.com/go/assuredworkloads v1.9.0/go.mod h1:kFuI1P78bplYtT77Tb1hi0FMxM0vVpRC7VVoJC3ZoT0=
 cloud.google.com/go/assuredworkloads v1.10.0/go.mod h1:kwdUQuXcedVdsIaKgKTp9t0UJkE5+PAVNhdQm4ZVq2E=
-cloud.google.com/go/auth v0.9.9 h1:BmtbpNQozo8ZwW2t7QJjnrQtdganSdmqeIBxHxNkEZQ=
-cloud.google.com/go/auth v0.9.9/go.mod h1:xxA5AqpDrvS+Gkmo9RqrGGRh6WSNKKOXhY3zNOr38tI=
-cloud.google.com/go/auth/oauth2adapt v0.2.4 h1:0GWE/FUsXhf6C+jAkWgYm7X9tK8cuEIfy19DBn6B6bY=
-cloud.google.com/go/auth/oauth2adapt v0.2.4/go.mod h1:jC/jOpwFP6JBxhB3P5Rr0a9HLMC/Pe3eaL4NmdvqPtc=
+cloud.google.com/go/auth v0.11.0 h1:Ic5SZz2lsvbYcWT5dfjNWgw6tTlGi2Wc8hyQSC9BstA=
+cloud.google.com/go/auth v0.11.0/go.mod h1:xxA5AqpDrvS+Gkmo9RqrGGRh6WSNKKOXhY3zNOr38tI=
+cloud.google.com/go/auth/oauth2adapt v0.2.6 h1:V6a6XDu2lTwPZWOawrAa9HUK+DB2zfJyTuciBG5hFkU=
+cloud.google.com/go/auth/oauth2adapt v0.2.6/go.mod h1:AlmsELtlEBnaNTL7jCj8VQFLy6mbZv0s4Q7NGBeQ5E8=
 cloud.google.com/go/automl v1.5.0/go.mod h1:34EjfoFGMZ5sgJ9EoLsRtdPSNZLcfflJR39VbVNS2M0=
 cloud.google.com/go/automl v1.6.0/go.mod h1:ugf8a6Fx+zP0D59WLhqgTDsQI9w07o64uf/Is3Nh5p8=
 cloud.google.com/go/automl v1.7.0/go.mod h1:RL9MYCCsJEOmt0Wf3z9uzG0a7adTT1fe+aObgSpkCt8=
@@ -210,8 +210,8 @@ cloud.google.com/go/datacatalog v1.8.0/go.mod h1:KYuoVOv9BM8EYz/4eMFxrr4DUKhGIOX
 cloud.google.com/go/datacatalog v1.8.1/go.mod h1:RJ58z4rMp3gvETA465Vg+ag8BGgBdnRPEMMSTr5Uv+M=
 cloud.google.com/go/datacatalog v1.12.0/go.mod h1:CWae8rFkfp6LzLumKOnmVh4+Zle4A3NXLzVJ1d1mRm0=
 cloud.google.com/go/datacatalog v1.13.0/go.mod h1:E4Rj9a5ZtAxcQJlEBTLgMTphfP11/lNaAshpoBgemX8=
-cloud.google.com/go/datacatalog v1.22.1 h1:i0DyKb/o7j+0vgaFtimcRFjYsD6wFw1jpnODYUyiYRs=
-cloud.google.com/go/datacatalog v1.22.1/go.mod h1:MscnJl9B2lpYlFoxRjicw19kFTwEke8ReKL5Y/6TWg8=
+cloud.google.com/go/datacatalog v1.23.0 h1:9F2zIbWNNmtrSkPIyGRQNsIugG5VgVVFip6+tXSdWLg=
+cloud.google.com/go/datacatalog v1.23.0/go.mod h1:9Wamq8TDfL2680Sav7q3zEhBJSPBrDxJU8WtPJ25dBM=
 cloud.google.com/go/dataflow v0.6.0/go.mod h1:9QwV89cGoxjjSR9/r7eFDqqjtvbKxAK2BaYU6PVk9UM=
 cloud.google.com/go/dataflow v0.7.0/go.mod h1:PX526vb4ijFMesO1o202EaUmouZKBpjHsTlCtB4parQ=
 cloud.google.com/go/dataflow v0.8.0/go.mod h1:Rcf5YgTKPtQyYz8bLYhFoIV/vP39eL7fWNcSOyFfLJE=
@@ -327,8 +327,8 @@ cloud.google.com/go/iam v0.8.0/go.mod h1:lga0/y3iH6CX7sYqypWJ33hf7kkfXJag67naqGE
 cloud.google.com/go/iam v0.11.0/go.mod h1:9PiLDanza5D+oWFZiH1uG+RnRCfEGKoyl6yo4cgWZGY=
 cloud.google.com/go/iam v0.12.0/go.mod h1:knyHGviacl11zrtZUoDuYpDgLjvr28sLQaG0YB2GYAY=
 cloud.google.com/go/iam v0.13.0/go.mod h1:ljOg+rcNfzZ5d6f1nAUJ8ZIxOaZUVoS14bKCtaLZ/D0=
-cloud.google.com/go/iam v1.2.1 h1:QFct02HRb7H12J/3utj0qf5tobFh9V4vR6h9eX5EBRU=
-cloud.google.com/go/iam v1.2.1/go.mod h1:3VUIJDPpwT6p/amXRC5GY8fCCh70lxPygguVtI0Z4/g=
+cloud.google.com/go/iam v1.2.2 h1:ozUSofHUGf/F4tCNy/mu9tHLTaxZFLOUiKzjcgWHGIA=
+cloud.google.com/go/iam v1.2.2/go.mod h1:0Ys8ccaZHdI1dEUilwzqng/6ps2YB6vRsjIe00/+6JY=
 cloud.google.com/go/iap v1.4.0/go.mod h1:RGFwRJdihTINIe4wZ2iCP0zF/qu18ZwyKxrhMhygBEc=
 cloud.google.com/go/iap v1.5.0/go.mod h1:UH/CGgKd4KyohZL5Pt0jSKE4m3FR51qg6FKQ/z/Ix9A=
 cloud.google.com/go/iap v1.6.0/go.mod h1:NSuvI9C/j7UdjGjIde7t7HBz+QTwBcapPE07+sSRcLk=
@@ -348,8 +348,8 @@ cloud.google.com/go/kms v1.8.0/go.mod h1:4xFEhYFqvW+4VMELtZyxomGSYtSQKzM178ylFW4
 cloud.google.com/go/kms v1.9.0/go.mod h1:qb1tPTgfF9RQP8e1wq4cLFErVuTJv7UsSC915J8dh3w=
 cloud.google.com/go/kms v1.10.0/go.mod h1:ng3KTUtQQU9bPX3+QGLsflZIHlkbn8amFAMY63m8d24=
 cloud.google.com/go/kms v1.10.1/go.mod h1:rIWk/TryCkR59GMC3YtHtXeLzd634lBbKenvyySAyYI=
-cloud.google.com/go/kms v1.20.0 h1:uKUvjGqbBlI96xGE669hcVnEMw1Px/Mvfa62dhM5UrY=
-cloud.google.com/go/kms v1.20.0/go.mod h1:/dMbFF1tLLFnQV44AoI2GlotbjowyUfgVwezxW291fM=
+cloud.google.com/go/kms v1.20.1 h1:og29Wv59uf2FVaZlesaiDAqHFzHaoUyHI3HYp9VUHVg=
+cloud.google.com/go/kms v1.20.1/go.mod h1:LywpNiVCvzYNJWS9JUcGJSVTNSwPwi0vBAotzDqn2nc=
 cloud.google.com/go/language v1.4.0/go.mod h1:F9dRpNFQmJbkaop6g0JhSBXCNlO90e1KWx5iDdxbWic=
 cloud.google.com/go/language v1.6.0/go.mod h1:6dJ8t3B+lUYfStgls25GusK04NLh3eDLQnWM3mdEbhI=
 cloud.google.com/go/language v1.7.0/go.mod h1:DJ6dYN/W+SQOjF8e1hLQXMF21AkH2w9wiPzPCJa2MIE=
@@ -360,13 +360,13 @@ cloud.google.com/go/lifesciences v0.6.0/go.mod h1:ddj6tSX/7BOnhxCSd3ZcETvtNr8NZ6
 cloud.google.com/go/lifesciences v0.8.0/go.mod h1:lFxiEOMqII6XggGbOnKiyZ7IBwoIqA84ClvoezaA/bo=
 cloud.google.com/go/logging v1.6.1/go.mod h1:5ZO0mHHbvm8gEmeEUHrmDlTDSu5imF6MUP9OfilNXBw=
 cloud.google.com/go/logging v1.7.0/go.mod h1:3xjP2CjkM3ZkO73aj4ASA5wRPGGCRrPIAeNqVNkzY8M=
-cloud.google.com/go/logging v1.11.0 h1:v3ktVzXMV7CwHq1MBF65wcqLMA7i+z3YxbUsoK7mOKs=
-cloud.google.com/go/logging v1.11.0/go.mod h1:5LDiJC/RxTt+fHc1LAt20R9TKiUTReDg6RuuFOZ67+A=
+cloud.google.com/go/logging v1.12.0 h1:ex1igYcGFd4S/RZWOCU51StlIEuey5bjqwH9ZYjHibk=
+cloud.google.com/go/logging v1.12.0/go.mod h1:wwYBt5HlYP1InnrtYI0wtwttpVU1rifnMT7RejksUAM=
 cloud.google.com/go/longrunning v0.1.1/go.mod h1:UUFxuDWkv22EuY93jjmDMFT5GPQKeFVJBIF6QlTqdsE=
 cloud.google.com/go/longrunning v0.3.0/go.mod h1:qth9Y41RRSUE69rDcOn6DdK3HfQfsUI0YSmW3iIlLJc=
 cloud.google.com/go/longrunning v0.4.1/go.mod h1:4iWDqhBZ70CvZ6BfETbvam3T8FMvLK+eFj0E6AaRQTo=
-cloud.google.com/go/longrunning v0.6.1 h1:lOLTFxYpr8hcRtcwWir5ITh1PAKUD/sG2lKrTSYjyMc=
-cloud.google.com/go/longrunning v0.6.1/go.mod h1:nHISoOZpBcmlwbJmiVk5oDRz0qG/ZxPynEGs1iZ79s0=
+cloud.google.com/go/longrunning v0.6.2 h1:xjDfh1pQcWPEvnfjZmwjKQEcHnpz6lHjfy7Fo0MK+hc=
+cloud.google.com/go/longrunning v0.6.2/go.mod h1:k/vIs83RN4bE3YCswdXC5PFfWVILjm3hpEUlSko4PiI=
 cloud.google.com/go/managedidentities v1.3.0/go.mod h1:UzlW3cBOiPrzucO5qWkNkh0w33KFtBJU281hacNvsdE=
 cloud.google.com/go/managedidentities v1.4.0/go.mod h1:NWSBYbEMgqmbZsLIyKvxrYbtqOsxY1ZrGM+9RgDqInM=
 cloud.google.com/go/managedidentities v1.5.0/go.mod h1:+dWcZ0JlUmpuxpIDfyP5pP5y0bLdRwOS4Lp7gMni/LA=
@@ -390,8 +390,8 @@ cloud.google.com/go/monitoring v1.7.0/go.mod h1:HpYse6kkGo//7p6sT0wsIC6IBDET0RhI
 cloud.google.com/go/monitoring v1.8.0/go.mod h1:E7PtoMJ1kQXWxPjB6mv2fhC5/15jInuulFdYYtlcvT4=
 cloud.google.com/go/monitoring v1.12.0/go.mod h1:yx8Jj2fZNEkL/GYZyTLS4ZtZEZN8WtDEiEqG4kLK50w=
 cloud.google.com/go/monitoring v1.13.0/go.mod h1:k2yMBAB1H9JT/QETjNkgdCGD9bPF712XiLTVr+cBrpw=
-cloud.google.com/go/monitoring v1.21.1 h1:zWtbIoBMnU5LP9A/fz8LmWMGHpk4skdfeiaa66QdFGc=
-cloud.google.com/go/monitoring v1.21.1/go.mod h1:Rj++LKrlht9uBi8+Eb530dIrzG/cU/lB8mt+lbeFK1c=
+cloud.google.com/go/monitoring v1.21.2 h1:FChwVtClH19E7pJ+e0xUhJPGksctZNVOk2UhMmblmdU=
+cloud.google.com/go/monitoring v1.21.2/go.mod h1:hS3pXvaG8KgWTSz+dAdyzPrGUYmi2Q+WFX8g2hqVEZU=
 cloud.google.com/go/networkconnectivity v1.4.0/go.mod h1:nOl7YL8odKyAOtzNX73/M5/mGZgqqMeryi6UPZTk/rA=
 cloud.google.com/go/networkconnectivity v1.5.0/go.mod h1:3GzqJx7uhtlM3kln0+x5wyFvuVH1pIBJjhCpjzSt75o=
 cloud.google.com/go/networkconnectivity v1.6.0/go.mod h1:OJOoEXW+0LAxHh89nXd64uGG+FbQoeH8DtxCHVOMlaM=
@@ -451,8 +451,8 @@ cloud.google.com/go/pubsub v1.26.0/go.mod h1:QgBH3U/jdJy/ftjPhTkyXNj543Tin1pRYcd
 cloud.google.com/go/pubsub v1.27.1/go.mod h1:hQN39ymbV9geqBnfQq6Xf63yNhUAhv9CZhzp5O6qsW0=
 cloud.google.com/go/pubsub v1.28.0/go.mod h1:vuXFpwaVoIPQMGXqRyUQigu/AX1S3IWugR9xznmcXX8=
 cloud.google.com/go/pubsub v1.30.0/go.mod h1:qWi1OPS0B+b5L+Sg6Gmc9zD1Y+HaM0MdUr7LsupY1P4=
-cloud.google.com/go/pubsub v1.45.1 h1:ZC/UzYcrmK12THWn1P72z+Pnp2vu/zCZRXyhAfP1hJY=
-cloud.google.com/go/pubsub v1.45.1/go.mod h1:3bn7fTmzZFwaUjllitv1WlsNMkqBgGUb3UdMhI54eCc=
+cloud.google.com/go/pubsub v1.45.3 h1:prYj8EEAAAwkp6WNoGTE4ahe0DgHoyJd5Pbop931zow=
+cloud.google.com/go/pubsub v1.45.3/go.mod h1:cGyloK/hXC4at7smAtxFnXprKEFTqmMXNNd9w+bd94Q=
 cloud.google.com/go/pubsublite v1.5.0/go.mod h1:xapqNQ1CuLfGi23Yda/9l4bBCKz/wC3KIJ5gKcxveZg=
 cloud.google.com/go/pubsublite v1.6.0/go.mod h1:1eFCS0U11xlOuMFV/0iBqw3zP12kddMeCbj/F3FSj9k=
 cloud.google.com/go/pubsublite v1.7.0/go.mod h1:8hVMwRXfDfvGm3fahVbtDbiLePT3gpoiJYJY+vxWxVM=
@@ -582,8 +582,8 @@ cloud.google.com/go/trace v1.3.0/go.mod h1:FFUE83d9Ca57C+K8rDl/Ih8LwOzWIV1krKgxg
 cloud.google.com/go/trace v1.4.0/go.mod h1:UG0v8UBqzusp+z63o7FK74SdFE+AXpCLdFb1rshXG+Y=
 cloud.google.com/go/trace v1.8.0/go.mod h1:zH7vcsbAhklH8hWFig58HvxcxyQbaIqMarMg9hn5ECA=
 cloud.google.com/go/trace v1.9.0/go.mod h1:lOQqpE5IaWY0Ixg7/r2SjixMuc6lfTFeO4QGM4dQWOk=
-cloud.google.com/go/trace v1.11.1 h1:UNqdP+HYYtnm6lb91aNA5JQ0X14GnxkABGlfz2PzPew=
-cloud.google.com/go/trace v1.11.1/go.mod h1:IQKNQuBzH72EGaXEodKlNJrWykGZxet2zgjtS60OtjA=
+cloud.google.com/go/trace v1.11.2 h1:4ZmaBdL8Ng/ajrgKqY5jfvzqMXbrDcBsUGXOT9aqTtI=
+cloud.google.com/go/trace v1.11.2/go.mod h1:bn7OwXd4pd5rFuAnTrzBuoZ4ax2XQeG3qNgYmfCy0Io=
 cloud.google.com/go/translate v1.3.0/go.mod h1:gzMUwRjvOqj5i69y/LYLd8RrNQk+hOmIXTi9+nb3Djs=
 cloud.google.com/go/translate v1.4.0/go.mod h1:06Dn/ppvLD6WvA5Rhdp029IX2Mi3Mn7fpMRLPvXT5Wg=
 cloud.google.com/go/translate v1.5.0/go.mod h1:29YDSYveqqpA1CQFD7NQuP49xymq17RXNaUDdc0mNu0=
@@ -978,8 +978,8 @@ github.com/googleapis/gax-go/v2 v2.5.1/go.mod h1:h6B0KMMFNtI2ddbGJn3T3ZbwkeT6yqE
 github.com/googleapis/gax-go/v2 v2.6.0/go.mod h1:1mjbznJAPHFpesgE5ucqfYEscaz5kMdcIDwU/6+DDoY=
 github.com/googleapis/gax-go/v2 v2.7.0/go.mod h1:TEop28CZZQ2y+c0VxMUmu1lV+fQx57QpBWsYpwqHJx8=
 github.com/googleapis/gax-go/v2 v2.7.1/go.mod h1:4orTrqY6hXxxaUL4LHIPl6lGo8vAE38/qKbhSAKP6QI=
-github.com/googleapis/gax-go/v2 v2.13.0 h1:yitjD5f7jQHhyDsnhKEBU52NdvvdSeGzlAnDPT0hH1s=
-github.com/googleapis/gax-go/v2 v2.13.0/go.mod h1:Z/fvTZXF8/uw7Xu5GuslPw+bplx6SS338j1Is2S+B7A=
+github.com/googleapis/gax-go/v2 v2.14.0 h1:f+jMrjBPl+DL9nI4IQzLUxMq7XrAqFYB7hBPqMNIe8o=
+github.com/googleapis/gax-go/v2 v2.14.0/go.mod h1:lhBCnjdLrWRaPvLWhmc8IS24m9mr07qSYnHncrgo+zk=
 github.com/googleapis/go-type-adapters v1.0.0/go.mod h1:zHW75FOG2aur7gAO2B+MLby+cLsWGBF62rFAi7WjWO4=
 github.com/googleapis/google-cloud-go-testing v0.0.0-20200911160855-bcd43fbb19e8/go.mod h1:dvDLG8qkwmyD9a/MJJN3XJcT3xFxOKAvTZGvuZmac9g=
 github.com/gorilla/handlers v1.5.2 h1:cLTUSsNkgcwhgRqvCNmdbRWG0A3N4F+M2nWKdScwyEE=
@@ -1560,8 +1560,8 @@ golang.org/x/time v0.0.0-20191024005414-555d28b269f0/go.mod h1:tRJNPiyCQ0inRvYxb
 golang.org/x/time v0.0.0-20220922220347-f3bd1da661af/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
 golang.org/x/time v0.1.0/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
 golang.org/x/time v0.3.0/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
-golang.org/x/time v0.7.0 h1:ntUhktv3OPE6TgYxXWv9vKvUSJyIFJlyohwbkEwPrKQ=
-golang.org/x/time v0.7.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM=
+golang.org/x/time v0.8.0 h1:9i3RxcPv3PZnitoVGMPDKZSq1xW1gK1Xy3ArNOGZfEg=
+golang.org/x/time v0.8.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM=
 golang.org/x/tools v0.0.0-20180525024113-a5b4c53f6e8b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
 golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
 golang.org/x/tools v0.0.0-20190114222345-bf090417da8b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
@@ -1705,8 +1705,8 @@ google.golang.org/api v0.108.0/go.mod h1:2Ts0XTHNVWxypznxWOYUeI4g3WdP9Pk2Qk58+a/
 google.golang.org/api v0.110.0/go.mod h1:7FC4Vvx1Mooxh8C5HWjzZHcavuS2f6pmJpZx60ca7iI=
 google.golang.org/api v0.111.0/go.mod h1:qtFHvU9mhgTJegR31csQ+rwxyUTHOKFqCKWp1J0fdw0=
 google.golang.org/api v0.114.0/go.mod h1:ifYI2ZsFK6/uGddGfAD5BMxlnkBqCmqHSDUVi45N5Yg=
-google.golang.org/api v0.203.0 h1:SrEeuwU3S11Wlscsn+LA1kb/Y5xT8uggJSkIhD08NAU=
-google.golang.org/api v0.203.0/go.mod h1:BuOVyCSYEPwJb3npWvDnNmFI92f3GeRnHNkETneT3SI=
+google.golang.org/api v0.210.0 h1:HMNffZ57OoZCRYSbdWVRoqOa8V8NIHLL0CzdBPLztWk=
+google.golang.org/api v0.210.0/go.mod h1:B9XDZGnx2NtyjzVkOVTGrFSAVZgPcbedzKg/gTLwqBs=
 google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM=
 google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4=
 google.golang.org/appengine v1.5.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4=
@@ -1846,12 +1846,12 @@ google.golang.org/genproto v0.0.0-20230323212658-478b75c54725/go.mod h1:UUQDJDOl
 google.golang.org/genproto v0.0.0-20230330154414-c0448cd141ea/go.mod h1:UUQDJDOlWu4KYeJZffbWgBkS1YFobzKbLVfK69pe0Ak=
 google.golang.org/genproto v0.0.0-20230331144136-dcfb400f0633/go.mod h1:UUQDJDOlWu4KYeJZffbWgBkS1YFobzKbLVfK69pe0Ak=
 google.golang.org/genproto v0.0.0-20230410155749-daa745c078e1/go.mod h1:nKE/iIaLqn2bQwXBg8f1g2Ylh6r5MN5CmZvuzZCgsCU=
-google.golang.org/genproto v0.0.0-20241015192408-796eee8c2d53 h1:Df6WuGvthPzc+JiQ/G+m+sNX24kc0aTBqoDN/0yyykE=
-google.golang.org/genproto v0.0.0-20241015192408-796eee8c2d53/go.mod h1:fheguH3Am2dGp1LfXkrvwqC/KlFq8F0nLq3LryOMrrE=
-google.golang.org/genproto/googleapis/api v0.0.0-20241007155032-5fefd90f89a9 h1:T6rh4haD3GVYsgEfWExoCZA2o2FmbNyKpTuAxbEFPTg=
-google.golang.org/genproto/googleapis/api v0.0.0-20241007155032-5fefd90f89a9/go.mod h1:wp2WsuBYj6j8wUdo3ToZsdxxixbvQNAHqVJrTgi5E5M=
-google.golang.org/genproto/googleapis/rpc v0.0.0-20241015192408-796eee8c2d53 h1:X58yt85/IXCx0Y3ZwN6sEIKZzQtDEYaBWrDvErdXrRE=
-google.golang.org/genproto/googleapis/rpc v0.0.0-20241015192408-796eee8c2d53/go.mod h1:GX3210XPVPUjJbTUbvwI8f2IpZDMZuPJWDzDuebbviI=
+google.golang.org/genproto v0.0.0-20241118233622-e639e219e697 h1:ToEetK57OidYuqD4Q5w+vfEnPvPpuTwedCNVohYJfNk=
+google.golang.org/genproto v0.0.0-20241118233622-e639e219e697/go.mod h1:JJrvXBWRZaFMxBufik1a4RpFw4HhgVtBBWQeQgUj2cc=
+google.golang.org/genproto/googleapis/api v0.0.0-20241113202542-65e8d215514f h1:M65LEviCfuZTfrfzwwEoxVtgvfkFkBUbFnRbxCXuXhU=
+google.golang.org/genproto/googleapis/api v0.0.0-20241113202542-65e8d215514f/go.mod h1:Yo94eF2nj7igQt+TiJ49KxjIH8ndLYPZMIRSiRcEbg0=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20241118233622-e639e219e697 h1:LWZqQOEjDyONlF1H6afSWpAL/znlREo2tHfLoe+8LMA=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20241118233622-e639e219e697/go.mod h1:5uTbfoYQed2U9p3KIj2/Zzm02PYhndfdmML0qC3q3FU=
 google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c=
 google.golang.org/grpc v1.20.1/go.mod h1:10oTOabMzJvdu6/UiuZezV6QK5dSlG84ov/aaiqXj38=
 google.golang.org/grpc v1.21.1/go.mod h1:oYelfM1adQP15Ek0mdvEgi9Df8B9CZIaU1084ijfRaM=

From d24d838bd838427a545592ad21d9623fb1272fb0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 4 Dec 2024 21:47:44 -0800
Subject: [PATCH 074/135] Bump cloud.google.com/go/storage from 1.45.0 to
 1.47.0 in /sdks (#33266)

Bumps [cloud.google.com/go/storage](https://github.com/googleapis/google-cloud-go) from 1.45.0 to 1.47.0.
- [Release notes](https://github.com/googleapis/google-cloud-go/releases)
- [Changelog](https://github.com/googleapis/google-cloud-go/blob/main/CHANGES.md)
- [Commits](https://github.com/googleapis/google-cloud-go/compare/pubsub/v1.45.0...spanner/v1.47.0)

---
updated-dependencies:
- dependency-name: cloud.google.com/go/storage
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 2 +-
 sdks/go.sum | 6 ++++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index acf52d7a62cb..5ea567825135 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -29,7 +29,7 @@ require (
 	cloud.google.com/go/profiler v0.4.1
 	cloud.google.com/go/pubsub v1.45.3
 	cloud.google.com/go/spanner v1.73.0
-	cloud.google.com/go/storage v1.45.0
+	cloud.google.com/go/storage v1.47.0
 	github.com/aws/aws-sdk-go-v2 v1.32.6
 	github.com/aws/aws-sdk-go-v2/config v1.28.4
 	github.com/aws/aws-sdk-go-v2/credentials v1.17.45
diff --git a/sdks/go.sum b/sdks/go.sum
index d8eb73149c76..d5747e210a5a 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -561,8 +561,8 @@ cloud.google.com/go/storage v1.23.0/go.mod h1:vOEEDNFnciUMhBeT6hsJIn3ieU5cFRmzeL
 cloud.google.com/go/storage v1.27.0/go.mod h1:x9DOL8TK/ygDUMieqwfhdpQryTeEkhGKMi80i/iqR2s=
 cloud.google.com/go/storage v1.28.1/go.mod h1:Qnisd4CqDdo6BGs2AD5LLnEsmSQ80wQ5ogcBBKhU86Y=
 cloud.google.com/go/storage v1.29.0/go.mod h1:4puEjyTKnku6gfKoTfNOU/W+a9JyuVNxjpS5GBrB8h4=
-cloud.google.com/go/storage v1.45.0 h1:5av0QcIVj77t+44mV4gffFC/LscFRUhto6UBMB5SimM=
-cloud.google.com/go/storage v1.45.0/go.mod h1:wpPblkIuMP5jCB/E48Pz9zIo2S/zD8g+ITmxKkPCITE=
+cloud.google.com/go/storage v1.47.0 h1:ajqgt30fnOMmLfWfu1PWcb+V9Dxz6n+9WKjdNg5R4HM=
+cloud.google.com/go/storage v1.47.0/go.mod h1:Ks0vP374w0PW6jOUameJbapbQKXqkjGd/OJRp2fb9IQ=
 cloud.google.com/go/storagetransfer v1.5.0/go.mod h1:dxNzUopWy7RQevYFHewchb29POFv3/AaBgnhqzqiK0w=
 cloud.google.com/go/storagetransfer v1.6.0/go.mod h1:y77xm4CQV/ZhFZH75PLEXY0ROiS7Gh6pSKrM8dJyg6I=
 cloud.google.com/go/storagetransfer v1.7.0/go.mod h1:8Giuj1QNb1kfLAiWM1bN6dHzfdlDAVC9rv9abHot2W4=
@@ -1239,6 +1239,8 @@ go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.19.0 h1:Mne5On7VWdx7omSrSSZ
 go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.19.0/go.mod h1:IPtUMKL4O3tH5y+iXVyAXqpAwMuzC1IrxVS81rummfE=
 go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.19.0 h1:IeMeyr1aBvBiPVYihXIaeIZba6b8E1bYp7lbdxK8CQg=
 go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.19.0/go.mod h1:oVdCUtjq9MK9BlS7TtucsQwUcXcymNiEDjgDD2jMtZU=
+go.opentelemetry.io/otel/exporters/stdout/stdoutmetric v1.29.0 h1:WDdP9acbMYjbKIyJUhTvtzj601sVJOqgWdUxSdR/Ysc=
+go.opentelemetry.io/otel/exporters/stdout/stdoutmetric v1.29.0/go.mod h1:BLbf7zbNIONBLPwvFnwNHGj4zge8uTCM/UPIVW1Mq2I=
 go.opentelemetry.io/otel/metric v1.29.0 h1:vPf/HFWTNkPu1aYeIsc98l4ktOQaL6LeSoeV2g+8YLc=
 go.opentelemetry.io/otel/metric v1.29.0/go.mod h1:auu/QWieFVWx+DmQOUMgj0F8LHWdgalxXqvp7BII/W8=
 go.opentelemetry.io/otel/sdk v1.29.0 h1:vkqKjk7gwhS8VaWb0POZKmIEDimRCMsopNYnriHyryo=

From 68e3c0de9c570ea8e137e1c4f1a2296397ad855e Mon Sep 17 00:00:00 2001
From: Danny McCormick <dannymccormick@google.com>
Date: Thu, 5 Dec 2024 14:32:28 -0500
Subject: [PATCH 075/135] Small string fix for error message (#33295)

---
 sdks/python/apache_beam/yaml/yaml_transform.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sdks/python/apache_beam/yaml/yaml_transform.py b/sdks/python/apache_beam/yaml/yaml_transform.py
index 0190fe20413f..b8e49e81c579 100644
--- a/sdks/python/apache_beam/yaml/yaml_transform.py
+++ b/sdks/python/apache_beam/yaml/yaml_transform.py
@@ -493,7 +493,7 @@ def expand_leaf_transform(spec, scope):
       outputs = inputs | scope.unique_name(spec, ptransform) >> ptransform
   except Exception as exn:
     raise ValueError(
-        f"Error apply transform {identify_object(spec)}: {exn}") from exn
+        f"Error applying transform {identify_object(spec)}: {exn}") from exn
   if isinstance(outputs, dict):
     # TODO: Handle (or at least reject) nested case.
     return outputs

From 2344fdc4cb8608fad8bb42d2ce5b2e910e6c8098 Mon Sep 17 00:00:00 2001
From: Robert Burke <lostluck@users.noreply.github.com>
Date: Thu, 5 Dec 2024 12:47:05 -0800
Subject: [PATCH 076/135] [#32211] Fail job on SDK worker disconnect. (#33298)

Co-authored-by: lostluck <13907733+lostluck@users.noreply.github.com>
---
 .../runners/prism/internal/worker/bundle.go   | 28 ++++++++--
 .../runners/prism/internal/worker/worker.go   | 53 +++++++++++++++----
 2 files changed, 66 insertions(+), 15 deletions(-)

diff --git a/sdks/go/pkg/beam/runners/prism/internal/worker/bundle.go b/sdks/go/pkg/beam/runners/prism/internal/worker/bundle.go
index 55cdb97f258c..83ad1bda9841 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/worker/bundle.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/worker/bundle.go
@@ -126,7 +126,7 @@ func (b *B) ProcessOn(ctx context.Context, wk *W) <-chan struct{} {
 	slog.Debug("processing", "bundle", b, "worker", wk)
 
 	// Tell the SDK to start processing the bundle.
-	wk.InstReqs <- &fnpb.InstructionRequest{
+	req := &fnpb.InstructionRequest{
 		InstructionId: b.InstID,
 		Request: &fnpb.InstructionRequest_ProcessBundle{
 			ProcessBundle: &fnpb.ProcessBundleRequest{
@@ -134,6 +134,18 @@ func (b *B) ProcessOn(ctx context.Context, wk *W) <-chan struct{} {
 			},
 		},
 	}
+	select {
+	case <-wk.StoppedChan:
+		// The worker was stopped before req was sent.
+		// Quit to avoid sending on a closed channel.
+		outCap := b.OutputCount + len(b.HasTimers)
+		for i := 0; i < outCap; i++ {
+			b.DataOrTimerDone()
+		}
+		return b.DataWait
+	case wk.InstReqs <- req:
+		// desired outcome
+	}
 
 	// TODO: make batching decisions on the maxium to send per elements block, to reduce processing time overhead.
 	for _, block := range b.Input {
@@ -163,10 +175,13 @@ func (b *B) ProcessOn(ctx context.Context, wk *W) <-chan struct{} {
 		}
 
 		select {
-		case wk.DataReqs <- elms:
+		case <-wk.StoppedChan:
+			b.DataOrTimerDone()
+			return b.DataWait
 		case <-ctx.Done():
 			b.DataOrTimerDone()
 			return b.DataWait
+		case wk.DataReqs <- elms:
 		}
 	}
 
@@ -181,6 +196,12 @@ func (b *B) ProcessOn(ctx context.Context, wk *W) <-chan struct{} {
 		})
 	}
 	select {
+	case <-wk.StoppedChan:
+		b.DataOrTimerDone()
+		return b.DataWait
+	case <-ctx.Done():
+		b.DataOrTimerDone()
+		return b.DataWait
 	case wk.DataReqs <- &fnpb.Elements{
 		Timers: timers,
 		Data: []*fnpb.Elements_Data{
@@ -191,9 +212,6 @@ func (b *B) ProcessOn(ctx context.Context, wk *W) <-chan struct{} {
 			},
 		},
 	}:
-	case <-ctx.Done():
-		b.DataOrTimerDone()
-		return b.DataWait
 	}
 
 	return b.DataWait
diff --git a/sdks/go/pkg/beam/runners/prism/internal/worker/worker.go b/sdks/go/pkg/beam/runners/prism/internal/worker/worker.go
index 1f129595abef..c2c988aa097f 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/worker/worker.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/worker/worker.go
@@ -68,6 +68,7 @@ type W struct {
 	// These are the ID sources
 	inst               uint64
 	connected, stopped atomic.Bool
+	StoppedChan        chan struct{} // Channel to Broadcast stopped state.
 
 	InstReqs chan *fnpb.InstructionRequest
 	DataReqs chan *fnpb.Elements
@@ -96,8 +97,9 @@ func New(id, env string) *W {
 		lis:    lis,
 		server: grpc.NewServer(opts...),
 
-		InstReqs: make(chan *fnpb.InstructionRequest, 10),
-		DataReqs: make(chan *fnpb.Elements, 10),
+		InstReqs:    make(chan *fnpb.InstructionRequest, 10),
+		DataReqs:    make(chan *fnpb.Elements, 10),
+		StoppedChan: make(chan struct{}),
 
 		activeInstructions: make(map[string]controlResponder),
 		Descriptors:        make(map[string]*fnpb.ProcessBundleDescriptor),
@@ -132,12 +134,26 @@ func (wk *W) LogValue() slog.Value {
 	)
 }
 
+// shutdown safely closes channels, and can be called in the event of SDK crashes.
+//
+// Splitting this logic from the GRPC server Stop is necessary, since a worker
+// crash would be handled in a streaming RPC context, which will block GRPC
+// stop calls.
+func (wk *W) shutdown() {
+	// If this is the first call to "stop" this worker, also close the channels.
+	if wk.stopped.CompareAndSwap(false, true) {
+		slog.Debug("shutdown", "worker", wk, "firstTime", true)
+		close(wk.StoppedChan)
+		close(wk.InstReqs)
+		close(wk.DataReqs)
+	} else {
+		slog.Debug("shutdown", "worker", wk, "firstTime", false)
+	}
+}
+
 // Stop the GRPC server.
 func (wk *W) Stop() {
-	slog.Debug("stopping", "worker", wk)
-	wk.stopped.Store(true)
-	close(wk.InstReqs)
-	close(wk.DataReqs)
+	wk.shutdown()
 
 	// Give the SDK side 5 seconds to gracefully stop, before
 	// hard stopping all RPCs.
@@ -331,17 +347,21 @@ func (wk *W) Control(ctrl fnpb.BeamFnControl_ControlServer) error {
 		case <-ctrl.Context().Done():
 			wk.mu.Lock()
 			// Fail extant instructions
-			slog.Debug("SDK Disconnected", "worker", wk, "ctx_error", ctrl.Context().Err(), "outstanding_instructions", len(wk.activeInstructions))
+			err := context.Cause(ctrl.Context())
+			slog.Debug("SDK Disconnected", "worker", wk, "ctx_error", err, "outstanding_instructions", len(wk.activeInstructions))
 
-			msg := fmt.Sprintf("SDK worker disconnected: %v, %v active instructions", wk.String(), len(wk.activeInstructions))
+			msg := fmt.Sprintf("SDK worker disconnected: %v, %v active instructions, error: %v", wk.String(), len(wk.activeInstructions), err)
 			for instID, b := range wk.activeInstructions {
 				b.Respond(&fnpb.InstructionResponse{
 					InstructionId: instID,
 					Error:         msg,
 				})
 			}
+			// Soft shutdown to prevent GRPC shutdown from being blocked by this
+			// streaming call.
+			wk.shutdown()
 			wk.mu.Unlock()
-			return context.Cause(ctrl.Context())
+			return err
 		case err := <-done:
 			if err != nil {
 				slog.Warn("Control done", "error", err, "worker", wk)
@@ -639,9 +659,22 @@ func (wk *W) sendInstruction(ctx context.Context, req *fnpb.InstructionRequest)
 	if wk.Stopped() {
 		return nil
 	}
-	wk.InstReqs <- req
+	select {
+	case <-wk.StoppedChan:
+		return &fnpb.InstructionResponse{
+			InstructionId: progInst,
+			Error:         "worker stopped before send",
+		}
+	case wk.InstReqs <- req:
+		// desired outcome
+	}
 
 	select {
+	case <-wk.StoppedChan:
+		return &fnpb.InstructionResponse{
+			InstructionId: progInst,
+			Error:         "worker stopped before receive",
+		}
 	case <-ctx.Done():
 		return &fnpb.InstructionResponse{
 			InstructionId: progInst,

From e509e703a504d74da778ce16541d3ee6f918a646 Mon Sep 17 00:00:00 2001
From: Damon <damondouglas@users.noreply.github.com>
Date: Thu, 5 Dec 2024 13:00:54 -0800
Subject: [PATCH 077/135] Synchronize JdbcSchemaIO provider and Python
 transform configuration field order (#33288)

* Move order of write_batch_size

* Reorder Java schema instead

* Revert jdbc.py changes
---
 .github/trigger_files/beam_PostCommit_Python.json               | 2 +-
 .../java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProvider.java  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/trigger_files/beam_PostCommit_Python.json b/.github/trigger_files/beam_PostCommit_Python.json
index 2d7af65a3815..00bd9e035648 100644
--- a/.github/trigger_files/beam_PostCommit_Python.json
+++ b/.github/trigger_files/beam_PostCommit_Python.json
@@ -1,5 +1,5 @@
 {
   "comment": "Modify this file in a trivial way to cause this test suite to run.",
-  "modification": 5
+  "modification": 6
 }
 
diff --git a/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProvider.java b/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProvider.java
index 11034aee1cdf..23221042938b 100644
--- a/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProvider.java
+++ b/sdks/java/io/jdbc/src/main/java/org/apache/beam/sdk/io/jdbc/JdbcSchemaIOProvider.java
@@ -68,13 +68,13 @@ public Schema configurationSchema() {
         .addNullableField("disableAutoCommit", FieldType.BOOLEAN)
         .addNullableField("outputParallelization", FieldType.BOOLEAN)
         .addNullableField("autosharding", FieldType.BOOLEAN)
-        .addNullableField("writeBatchSize", FieldType.INT64)
         // Partitioning support. If you specify a partition column we will use that instead of
         // readQuery
         .addNullableField("partitionColumn", FieldType.STRING)
         .addNullableField("partitions", FieldType.INT16)
         .addNullableField("maxConnections", FieldType.INT16)
         .addNullableField("driverJars", FieldType.STRING)
+        .addNullableField("writeBatchSize", FieldType.INT64)
         .build();
   }
 

From 7df49a520b5660aadfe8ee6edfa26076277cb072 Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Thu, 5 Dec 2024 13:46:15 -0800
Subject: [PATCH 078/135] Clarificaiton on yaml invocation.

---
 website/www/site/content/en/documentation/sdks/yaml.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/www/site/content/en/documentation/sdks/yaml.md b/website/www/site/content/en/documentation/sdks/yaml.md
index 4f9ee4081439..3559a18076ba 100644
--- a/website/www/site/content/en/documentation/sdks/yaml.md
+++ b/website/www/site/content/en/documentation/sdks/yaml.md
@@ -712,7 +712,7 @@ options:
 
 It is a common to want to run a single Beam pipeline in different contexts
 and/or with different configurations.
-When running a YAML pipeline either locally or via the gcloud,
+When running a YAML pipeline using `apache_beam.yaml.main` or via gcloud,
 the yaml file can be parameterized with externally provided variables using
 the [jinja variable syntax](https://jinja.palletsprojects.com/en/stable/templates/#variables).
 The values are then passed via a `--jinja_variables` command line flag.

From d379968e7ee8a108b2f019702ffb4525f153e070 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 5 Dec 2024 21:32:14 -0800
Subject: [PATCH 079/135] Bump github.com/aws/aws-sdk-go-v2/credentials in
 /sdks (#33304)

Bumps [github.com/aws/aws-sdk-go-v2/credentials](https://github.com/aws/aws-sdk-go-v2) from 1.17.45 to 1.17.47.
- [Release notes](https://github.com/aws/aws-sdk-go-v2/releases)
- [Commits](https://github.com/aws/aws-sdk-go-v2/compare/credentials/v1.17.45...credentials/v1.17.47)

---
updated-dependencies:
- dependency-name: github.com/aws/aws-sdk-go-v2/credentials
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 18 +++++++++---------
 sdks/go.sum | 36 ++++++++++++++++++------------------
 2 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index 5ea567825135..dc380debf3ed 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -32,7 +32,7 @@ require (
 	cloud.google.com/go/storage v1.47.0
 	github.com/aws/aws-sdk-go-v2 v1.32.6
 	github.com/aws/aws-sdk-go-v2/config v1.28.4
-	github.com/aws/aws-sdk-go-v2/credentials v1.17.45
+	github.com/aws/aws-sdk-go-v2/credentials v1.17.47
 	github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.38
 	github.com/aws/aws-sdk-go-v2/service/s3 v1.67.0
 	github.com/aws/smithy-go v1.22.1
@@ -132,18 +132,18 @@ require (
 	github.com/apache/thrift v0.17.0 // indirect
 	github.com/aws/aws-sdk-go v1.34.0 // indirect
 	github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.6 // indirect
-	github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.19 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.23 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.23 // indirect
+	github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.21 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.25 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.25 // indirect
 	github.com/aws/aws-sdk-go-v2/internal/ini v1.8.1 // indirect
 	github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.23 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.0 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.1 // indirect
 	github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.4 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.4 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.6 // indirect
 	github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.4 // indirect
-	github.com/aws/aws-sdk-go-v2/service/sso v1.24.5 // indirect
-	github.com/aws/aws-sdk-go-v2/service/ssooidc v1.28.4 // indirect
-	github.com/aws/aws-sdk-go-v2/service/sts v1.33.0 // indirect
+	github.com/aws/aws-sdk-go-v2/service/sso v1.24.7 // indirect
+	github.com/aws/aws-sdk-go-v2/service/ssooidc v1.28.6 // indirect
+	github.com/aws/aws-sdk-go-v2/service/sts v1.33.2 // indirect
 	github.com/cenkalti/backoff/v4 v4.2.1 // indirect
 	github.com/census-instrumentation/opencensus-proto v0.4.1 // indirect
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
diff --git a/sdks/go.sum b/sdks/go.sum
index d5747e210a5a..eae2e9ad22b6 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -697,31 +697,31 @@ github.com/aws/aws-sdk-go-v2/config v1.5.0/go.mod h1:RWlPOAW3E3tbtNAqTwvSW54Of/y
 github.com/aws/aws-sdk-go-v2/config v1.28.4 h1:qgD0MKmkIzZR2DrAjWJcI9UkndjR+8f6sjUQvXh0mb0=
 github.com/aws/aws-sdk-go-v2/config v1.28.4/go.mod h1:LgnWnNzHZw4MLplSyEGia0WgJ/kCGD86zGCjvNpehJs=
 github.com/aws/aws-sdk-go-v2/credentials v1.3.1/go.mod h1:r0n73xwsIVagq8RsxmZbGSRQFj9As3je72C2WzUIToc=
-github.com/aws/aws-sdk-go-v2/credentials v1.17.45 h1:DUgm5lFso57E7150RBgu1JpVQoF8fAPretiDStIuVjg=
-github.com/aws/aws-sdk-go-v2/credentials v1.17.45/go.mod h1:dnBpENcPC1ekZrGpSWspX+ZRGzhkvqngT2Qp5xBR1dY=
+github.com/aws/aws-sdk-go-v2/credentials v1.17.47 h1:48bA+3/fCdi2yAwVt+3COvmatZ6jUDNkDTIsqDiMUdw=
+github.com/aws/aws-sdk-go-v2/credentials v1.17.47/go.mod h1:+KdckOejLW3Ks3b0E3b5rHsr2f9yuORBum0WPnE5o5w=
 github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.3.0/go.mod h1:2LAuqPx1I6jNfaGDucWfA2zqQCYCOMCDHiCOciALyNw=
-github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.19 h1:woXadbf0c7enQ2UGCi8gW/WuKmE0xIzxBF/eD94jMKQ=
-github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.19/go.mod h1:zminj5ucw7w0r65bP6nhyOd3xL6veAUMc3ElGMoLVb4=
+github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.21 h1:AmoU1pziydclFT/xRV+xXE/Vb8fttJCLRPv8oAkprc0=
+github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.21/go.mod h1:AjUdLYe4Tgs6kpH4Bv7uMZo7pottoyHMn4eTcIcneaY=
 github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.3.2/go.mod h1:qaqQiHSrOUVOfKe6fhgQ6UzhxjwqVW8aHNegd6Ws4w4=
 github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.38 h1:xN0PViSptTHJ7QIKyWeWntuTCZoejutTPfhsZIoMDy0=
 github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.38/go.mod h1:orUzUoWBICDyc+hz49KpySb3sa2Tw3c0IaFqrH4c4dg=
-github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.23 h1:A2w6m6Tmr+BNXjDsr7M90zkWjsu4JXHwrzPg235STs4=
-github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.23/go.mod h1:35EVp9wyeANdujZruvHiQUAo9E3vbhnIO1mTCAxMlY0=
-github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.23 h1:pgYW9FCabt2M25MoHYCfMrVY2ghiiBKYWUVXfwZs+sU=
-github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.23/go.mod h1:c48kLgzO19wAu3CPkDWC28JbaJ+hfQlsdl7I2+oqIbk=
+github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.25 h1:s/fF4+yDQDoElYhfIVvSNyeCydfbuTKzhxSXDXCPasU=
+github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.25/go.mod h1:IgPfDv5jqFIzQSNbUEMoitNooSMXjRSDkhXv8jiROvU=
+github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.25 h1:ZntTCl5EsYnhN/IygQEUugpdwbhdkom9uHcbCftiGgA=
+github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.25/go.mod h1:DBdPrgeocww+CSl1C8cEV8PN1mHMBhuCDLpXezyvWkE=
 github.com/aws/aws-sdk-go-v2/internal/ini v1.1.1/go.mod h1:Zy8smImhTdOETZqfyn01iNOe0CNggVbPjCajyaz6Gvg=
 github.com/aws/aws-sdk-go-v2/internal/ini v1.8.1 h1:VaRN3TlFdd6KxX1x3ILT5ynH6HvKgqdiXoTxAF4HQcQ=
 github.com/aws/aws-sdk-go-v2/internal/ini v1.8.1/go.mod h1:FbtygfRFze9usAadmnGJNc8KsP346kEe+y2/oyhGAGc=
 github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.23 h1:1SZBDiRzzs3sNhOMVApyWPduWYGAX0imGy06XiBnCAM=
 github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.23/go.mod h1:i9TkxgbZmHVh2S0La6CAXtnyFhlCX/pJ0JsOvBAS6Mk=
 github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.2.1/go.mod h1:v33JQ57i2nekYTA70Mb+O18KeH4KqhdqxTJZNK1zdRE=
-github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.0 h1:TToQNkvGguu209puTojY/ozlqy2d/SFNcoLIqTFi42g=
-github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.0/go.mod h1:0jp+ltwkf+SwG2fm/PKo8t4y8pJSgOCO4D8Lz3k0aHQ=
+github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.1 h1:iXtILhvDxB6kPvEXgsDhGaZCSC6LQET5ZHSdJozeI0Y=
+github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.1/go.mod h1:9nu0fVANtYiAePIBh2/pFUSwtJ402hLnp854CNoDOeE=
 github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.4 h1:aaPpoG15S2qHkWm4KlEyF01zovK1nW4BBbyXuHNSE90=
 github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.4/go.mod h1:eD9gS2EARTKgGr/W5xwgY/ik9z/zqpW+m/xOQbVxrMk=
 github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.2.1/go.mod h1:zceowr5Z1Nh2WVP8bf/3ikB41IZW59E4yIYbg+pC6mw=
-github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.4 h1:tHxQi/XHPK0ctd/wdOw0t7Xrc2OxcRCnVzv8lwWPu0c=
-github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.4/go.mod h1:4GQbF1vJzG60poZqWatZlhP31y8PGCCVTvIGPdaaYJ0=
+github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.6 h1:50+XsN70RS7dwJ2CkVNXzj7U2L1HKP8nqTd3XWEXBN4=
+github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.6/go.mod h1:WqgLmwY7so32kG01zD8CPTJWVWM+TzJoOVHwTg4aPug=
 github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.5.1/go.mod h1:6EQZIwNNvHpq/2/QSJnp4+ECvqIy55w95Ofs0ze+nGQ=
 github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.4 h1:E5ZAVOmI2apR8ADb72Q63KqwwwdW1XcMeXIlrZ1Psjg=
 github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.4/go.mod h1:wezzqVUOVVdk+2Z/JzQT4NxAU0NbhRe5W8pIE72jsWI=
@@ -729,13 +729,13 @@ github.com/aws/aws-sdk-go-v2/service/s3 v1.11.1/go.mod h1:XLAGFrEjbvMCLvAtWLLP32
 github.com/aws/aws-sdk-go-v2/service/s3 v1.67.0 h1:SwaJ0w0MOp0pBTIKTamLVeTKD+iOWyNJRdJ2KCQRg6Q=
 github.com/aws/aws-sdk-go-v2/service/s3 v1.67.0/go.mod h1:TMhLIyRIyoGVlaEMAt+ITMbwskSTpcGsCPDq91/ihY0=
 github.com/aws/aws-sdk-go-v2/service/sso v1.3.1/go.mod h1:J3A3RGUvuCZjvSuZEcOpHDnzZP/sKbhDWV2T1EOzFIM=
-github.com/aws/aws-sdk-go-v2/service/sso v1.24.5 h1:HJwZwRt2Z2Tdec+m+fPjvdmkq2s9Ra+VR0hjF7V2o40=
-github.com/aws/aws-sdk-go-v2/service/sso v1.24.5/go.mod h1:wrMCEwjFPms+V86TCQQeOxQF/If4vT44FGIOFiMC2ck=
-github.com/aws/aws-sdk-go-v2/service/ssooidc v1.28.4 h1:zcx9LiGWZ6i6pjdcoE9oXAB6mUdeyC36Ia/QEiIvYdg=
-github.com/aws/aws-sdk-go-v2/service/ssooidc v1.28.4/go.mod h1:Tp/ly1cTjRLGBBmNccFumbZ8oqpZlpdhFf80SrRh4is=
+github.com/aws/aws-sdk-go-v2/service/sso v1.24.7 h1:rLnYAfXQ3YAccocshIH5mzNNwZBkBo+bP6EhIxak6Hw=
+github.com/aws/aws-sdk-go-v2/service/sso v1.24.7/go.mod h1:ZHtuQJ6t9A/+YDuxOLnbryAmITtr8UysSny3qcyvJTc=
+github.com/aws/aws-sdk-go-v2/service/ssooidc v1.28.6 h1:JnhTZR3PiYDNKlXy50/pNeix9aGMo6lLpXwJ1mw8MD4=
+github.com/aws/aws-sdk-go-v2/service/ssooidc v1.28.6/go.mod h1:URronUEGfXZN1VpdktPSD1EkAL9mfrV+2F4sjH38qOY=
 github.com/aws/aws-sdk-go-v2/service/sts v1.6.0/go.mod h1:q7o0j7d7HrJk/vr9uUt3BVRASvcU7gYZB9PUgPiByXg=
-github.com/aws/aws-sdk-go-v2/service/sts v1.33.0 h1:s7LRgBqhwLaxcocnAniBJp7gaAB+4I4vHzqUqjH18yc=
-github.com/aws/aws-sdk-go-v2/service/sts v1.33.0/go.mod h1:9XEUty5v5UAsMiFOBJrNibZgwCeOma73jgGwwhgffa8=
+github.com/aws/aws-sdk-go-v2/service/sts v1.33.2 h1:s4074ZO1Hk8qv65GqNXqDjmkf4HSQqJukaLuuW0TpDA=
+github.com/aws/aws-sdk-go-v2/service/sts v1.33.2/go.mod h1:mVggCnIWoM09jP71Wh+ea7+5gAp53q+49wDFs1SW5z8=
 github.com/aws/smithy-go v1.6.0/go.mod h1:SObp3lf9smib00L/v3U2eAKG8FyQ7iLrJnQiAmR5n+E=
 github.com/aws/smithy-go v1.22.1 h1:/HPHZQ0g7f4eUeK6HKglFz8uwVfZKgoI25rb/J+dnro=
 github.com/aws/smithy-go v1.22.1/go.mod h1:irrKGvNn1InZwb2d7fkIRNucdfwR8R+Ts3wxYa/cJHg=

From 222086bf7448caf268b2c44bcf5d51ec4a156394 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 6 Dec 2024 10:38:30 -0500
Subject: [PATCH 080/135] Bump golang.org/x/text from 0.20.0 to 0.21.0 in /sdks
 (#33305)

Bumps [golang.org/x/text](https://github.com/golang/text) from 0.20.0 to 0.21.0.
- [Release notes](https://github.com/golang/text/releases)
- [Commits](https://github.com/golang/text/compare/v0.20.0...v0.21.0)

---
updated-dependencies:
- dependency-name: golang.org/x/text
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 4 ++--
 sdks/go.sum | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index dc380debf3ed..9e259d8ede9d 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -55,9 +55,9 @@ require (
 	go.mongodb.org/mongo-driver v1.17.1
 	golang.org/x/net v0.31.0
 	golang.org/x/oauth2 v0.24.0
-	golang.org/x/sync v0.9.0
+	golang.org/x/sync v0.10.0
 	golang.org/x/sys v0.27.0
-	golang.org/x/text v0.20.0
+	golang.org/x/text v0.21.0
 	google.golang.org/api v0.210.0
 	google.golang.org/genproto v0.0.0-20241118233622-e639e219e697
 	google.golang.org/grpc v1.67.1
diff --git a/sdks/go.sum b/sdks/go.sum
index eae2e9ad22b6..bf0bfe08db1b 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -1437,8 +1437,8 @@ golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJ
 golang.org/x/sync v0.0.0-20220819030929-7fc1605a5dde/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20220929204114-8fcdb60fdcc0/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.1.0/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.9.0 h1:fEo0HyrW1GIgZdpbhCRO0PkJajUS5H9IFUztCgEo2jQ=
-golang.org/x/sync v0.9.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=
+golang.org/x/sync v0.10.0 h1:3NQrjDixjgGwUOCaF8w2+VYHv0Ve/vGYSbdkTa98gmQ=
+golang.org/x/sync v0.10.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=
 golang.org/x/sys v0.0.0-20180830151530-49385e6e1522/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
 golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
 golang.org/x/sys v0.0.0-20190312061237-fead79001313/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
@@ -1554,8 +1554,8 @@ golang.org/x/text v0.6.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
 golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
 golang.org/x/text v0.8.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8=
 golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8=
-golang.org/x/text v0.20.0 h1:gK/Kv2otX8gz+wn7Rmb3vT96ZwuoxnQlY+HlJVj7Qug=
-golang.org/x/text v0.20.0/go.mod h1:D4IsuqiFMhST5bX19pQ9ikHC2GsaKyk/oF+pn3ducp4=
+golang.org/x/text v0.21.0 h1:zyQAAkrwaneQ066sspRyJaG9VNi/YJ1NfzcGB3hZ/qo=
+golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ=
 golang.org/x/time v0.0.0-20181108054448-85acf8d2951c/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
 golang.org/x/time v0.0.0-20190308202827-9d24e82272b4/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
 golang.org/x/time v0.0.0-20191024005414-555d28b269f0/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=

From 288c1569d1eca4e8e431255ab74c1ffb3d9b05fd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 6 Dec 2024 10:39:03 -0500
Subject: [PATCH 081/135] Bump github.com/aws/aws-sdk-go-v2/feature/s3/manager
 in /sdks (#33303)

Bumps [github.com/aws/aws-sdk-go-v2/feature/s3/manager](https://github.com/aws/aws-sdk-go-v2) from 1.17.38 to 1.17.43.
- [Release notes](https://github.com/aws/aws-sdk-go-v2/releases)
- [Commits](https://github.com/aws/aws-sdk-go-v2/compare/credentials/v1.17.38...credentials/v1.17.43)

---
updated-dependencies:
- dependency-name: github.com/aws/aws-sdk-go-v2/feature/s3/manager
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 14 +++++++-------
 sdks/go.sum | 28 ++++++++++++++--------------
 2 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index 9e259d8ede9d..a73cd530325f 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -31,10 +31,10 @@ require (
 	cloud.google.com/go/spanner v1.73.0
 	cloud.google.com/go/storage v1.47.0
 	github.com/aws/aws-sdk-go-v2 v1.32.6
-	github.com/aws/aws-sdk-go-v2/config v1.28.4
+	github.com/aws/aws-sdk-go-v2/config v1.28.6
 	github.com/aws/aws-sdk-go-v2/credentials v1.17.47
-	github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.38
-	github.com/aws/aws-sdk-go-v2/service/s3 v1.67.0
+	github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.43
+	github.com/aws/aws-sdk-go-v2/service/s3 v1.71.0
 	github.com/aws/smithy-go v1.22.1
 	github.com/docker/go-connections v0.5.0
 	github.com/dustin/go-humanize v1.0.1
@@ -131,16 +131,16 @@ require (
 	github.com/apache/arrow/go/arrow v0.0.0-20200730104253-651201b0f516 // indirect
 	github.com/apache/thrift v0.17.0 // indirect
 	github.com/aws/aws-sdk-go v1.34.0 // indirect
-	github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.6 // indirect
+	github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.7 // indirect
 	github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.21 // indirect
 	github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.25 // indirect
 	github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.25 // indirect
 	github.com/aws/aws-sdk-go-v2/internal/ini v1.8.1 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.23 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.25 // indirect
 	github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.1 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.4 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.6 // indirect
 	github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.6 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.4 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.6 // indirect
 	github.com/aws/aws-sdk-go-v2/service/sso v1.24.7 // indirect
 	github.com/aws/aws-sdk-go-v2/service/ssooidc v1.28.6 // indirect
 	github.com/aws/aws-sdk-go-v2/service/sts v1.33.2 // indirect
diff --git a/sdks/go.sum b/sdks/go.sum
index bf0bfe08db1b..a0f784b9789e 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -691,11 +691,11 @@ github.com/aws/aws-sdk-go v1.34.0/go.mod h1:5zCpMtNQVjRREroY7sYe8lOMRSxkhG6MZveU
 github.com/aws/aws-sdk-go-v2 v1.7.1/go.mod h1:L5LuPC1ZgDr2xQS7AmIec/Jlc7O/Y1u2KxJyNVab250=
 github.com/aws/aws-sdk-go-v2 v1.32.6 h1:7BokKRgRPuGmKkFMhEg/jSul+tB9VvXhcViILtfG8b4=
 github.com/aws/aws-sdk-go-v2 v1.32.6/go.mod h1:P5WJBrYqqbWVaOxgH0X/FYYD47/nooaPOZPlQdmiN2U=
-github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.6 h1:pT3hpW0cOHRJx8Y0DfJUEQuqPild8jRGmSFmBgvydr0=
-github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.6/go.mod h1:j/I2++U0xX+cr44QjHay4Cvxj6FUbnxrgmqN3H1jTZA=
+github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.7 h1:lL7IfaFzngfx0ZwUGOZdsFFnQ5uLvR0hWqqhyE7Q9M8=
+github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.7/go.mod h1:QraP0UcVlQJsmHfioCrveWOC1nbiWUl3ej08h4mXWoc=
 github.com/aws/aws-sdk-go-v2/config v1.5.0/go.mod h1:RWlPOAW3E3tbtNAqTwvSW54Of/yP3oiZXMI0xfUdjyA=
-github.com/aws/aws-sdk-go-v2/config v1.28.4 h1:qgD0MKmkIzZR2DrAjWJcI9UkndjR+8f6sjUQvXh0mb0=
-github.com/aws/aws-sdk-go-v2/config v1.28.4/go.mod h1:LgnWnNzHZw4MLplSyEGia0WgJ/kCGD86zGCjvNpehJs=
+github.com/aws/aws-sdk-go-v2/config v1.28.6 h1:D89IKtGrs/I3QXOLNTH93NJYtDhm8SYa9Q5CsPShmyo=
+github.com/aws/aws-sdk-go-v2/config v1.28.6/go.mod h1:GDzxJ5wyyFSCoLkS+UhGB0dArhb9mI+Co4dHtoTxbko=
 github.com/aws/aws-sdk-go-v2/credentials v1.3.1/go.mod h1:r0n73xwsIVagq8RsxmZbGSRQFj9As3je72C2WzUIToc=
 github.com/aws/aws-sdk-go-v2/credentials v1.17.47 h1:48bA+3/fCdi2yAwVt+3COvmatZ6jUDNkDTIsqDiMUdw=
 github.com/aws/aws-sdk-go-v2/credentials v1.17.47/go.mod h1:+KdckOejLW3Ks3b0E3b5rHsr2f9yuORBum0WPnE5o5w=
@@ -703,8 +703,8 @@ github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.3.0/go.mod h1:2LAuqPx1I6jNfaGDu
 github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.21 h1:AmoU1pziydclFT/xRV+xXE/Vb8fttJCLRPv8oAkprc0=
 github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.21/go.mod h1:AjUdLYe4Tgs6kpH4Bv7uMZo7pottoyHMn4eTcIcneaY=
 github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.3.2/go.mod h1:qaqQiHSrOUVOfKe6fhgQ6UzhxjwqVW8aHNegd6Ws4w4=
-github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.38 h1:xN0PViSptTHJ7QIKyWeWntuTCZoejutTPfhsZIoMDy0=
-github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.38/go.mod h1:orUzUoWBICDyc+hz49KpySb3sa2Tw3c0IaFqrH4c4dg=
+github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.43 h1:iLdpkYZ4cXIQMO7ud+cqMWR1xK5ESbt1rvN77tRi1BY=
+github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.43/go.mod h1:OgbsKPAswXDd5kxnR4vZov69p3oYjbvUyIRBAAV0y9o=
 github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.25 h1:s/fF4+yDQDoElYhfIVvSNyeCydfbuTKzhxSXDXCPasU=
 github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.25/go.mod h1:IgPfDv5jqFIzQSNbUEMoitNooSMXjRSDkhXv8jiROvU=
 github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.25 h1:ZntTCl5EsYnhN/IygQEUugpdwbhdkom9uHcbCftiGgA=
@@ -712,22 +712,22 @@ github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.25/go.mod h1:DBdPrgeocww
 github.com/aws/aws-sdk-go-v2/internal/ini v1.1.1/go.mod h1:Zy8smImhTdOETZqfyn01iNOe0CNggVbPjCajyaz6Gvg=
 github.com/aws/aws-sdk-go-v2/internal/ini v1.8.1 h1:VaRN3TlFdd6KxX1x3ILT5ynH6HvKgqdiXoTxAF4HQcQ=
 github.com/aws/aws-sdk-go-v2/internal/ini v1.8.1/go.mod h1:FbtygfRFze9usAadmnGJNc8KsP346kEe+y2/oyhGAGc=
-github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.23 h1:1SZBDiRzzs3sNhOMVApyWPduWYGAX0imGy06XiBnCAM=
-github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.23/go.mod h1:i9TkxgbZmHVh2S0La6CAXtnyFhlCX/pJ0JsOvBAS6Mk=
+github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.25 h1:r67ps7oHCYnflpgDy2LZU0MAQtQbYIOqNNnqGO6xQkE=
+github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.25/go.mod h1:GrGY+Q4fIokYLtjCVB/aFfCVL6hhGUFl8inD18fDalE=
 github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.2.1/go.mod h1:v33JQ57i2nekYTA70Mb+O18KeH4KqhdqxTJZNK1zdRE=
 github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.1 h1:iXtILhvDxB6kPvEXgsDhGaZCSC6LQET5ZHSdJozeI0Y=
 github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.1/go.mod h1:9nu0fVANtYiAePIBh2/pFUSwtJ402hLnp854CNoDOeE=
-github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.4 h1:aaPpoG15S2qHkWm4KlEyF01zovK1nW4BBbyXuHNSE90=
-github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.4/go.mod h1:eD9gS2EARTKgGr/W5xwgY/ik9z/zqpW+m/xOQbVxrMk=
+github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.6 h1:HCpPsWqmYQieU7SS6E9HXfdAMSud0pteVXieJmcpIRI=
+github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.6/go.mod h1:ngUiVRCco++u+soRRVBIvBZxSMMvOVMXA4PJ36JLfSw=
 github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.2.1/go.mod h1:zceowr5Z1Nh2WVP8bf/3ikB41IZW59E4yIYbg+pC6mw=
 github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.6 h1:50+XsN70RS7dwJ2CkVNXzj7U2L1HKP8nqTd3XWEXBN4=
 github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.6/go.mod h1:WqgLmwY7so32kG01zD8CPTJWVWM+TzJoOVHwTg4aPug=
 github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.5.1/go.mod h1:6EQZIwNNvHpq/2/QSJnp4+ECvqIy55w95Ofs0ze+nGQ=
-github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.4 h1:E5ZAVOmI2apR8ADb72Q63KqwwwdW1XcMeXIlrZ1Psjg=
-github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.4/go.mod h1:wezzqVUOVVdk+2Z/JzQT4NxAU0NbhRe5W8pIE72jsWI=
+github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.6 h1:BbGDtTi0T1DYlmjBiCr/le3wzhA37O8QTC5/Ab8+EXk=
+github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.6/go.mod h1:hLMJt7Q8ePgViKupeymbqI0la+t9/iYFBjxQCFwuAwI=
 github.com/aws/aws-sdk-go-v2/service/s3 v1.11.1/go.mod h1:XLAGFrEjbvMCLvAtWLLP32yTv8GpBquCApZEycDLunI=
-github.com/aws/aws-sdk-go-v2/service/s3 v1.67.0 h1:SwaJ0w0MOp0pBTIKTamLVeTKD+iOWyNJRdJ2KCQRg6Q=
-github.com/aws/aws-sdk-go-v2/service/s3 v1.67.0/go.mod h1:TMhLIyRIyoGVlaEMAt+ITMbwskSTpcGsCPDq91/ihY0=
+github.com/aws/aws-sdk-go-v2/service/s3 v1.71.0 h1:nyuzXooUNJexRT0Oy0UQY6AhOzxPxhtt4DcBIHyCnmw=
+github.com/aws/aws-sdk-go-v2/service/s3 v1.71.0/go.mod h1:sT/iQz8JK3u/5gZkT+Hmr7GzVZehUMkRZpOaAwYXeGY=
 github.com/aws/aws-sdk-go-v2/service/sso v1.3.1/go.mod h1:J3A3RGUvuCZjvSuZEcOpHDnzZP/sKbhDWV2T1EOzFIM=
 github.com/aws/aws-sdk-go-v2/service/sso v1.24.7 h1:rLnYAfXQ3YAccocshIH5mzNNwZBkBo+bP6EhIxak6Hw=
 github.com/aws/aws-sdk-go-v2/service/sso v1.24.7/go.mod h1:ZHtuQJ6t9A/+YDuxOLnbryAmITtr8UysSny3qcyvJTc=

From cd02853f7fcf085136909353d5b6fc1c3cbe9879 Mon Sep 17 00:00:00 2001
From: Jan Lukavsky <je.ik@seznam.cz>
Date: Thu, 5 Dec 2024 16:16:16 +0100
Subject: [PATCH 082/135] [infra] #33309 automatically apply spotless

---
 build.gradle.kts                  | 16 ++++++++++++++++
 runners/flink/flink_runner.gradle |  5 +++++
 2 files changed, 21 insertions(+)

diff --git a/build.gradle.kts b/build.gradle.kts
index d96e77a4c78c..0adb29058479 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -647,6 +647,22 @@ tasks.register("checkSetup") {
   dependsOn(":examples:java:wordCount")
 }
 
+// if not disabled make spotlessApply dependency of compileJava and compileTestJava
+val disableSpotlessCheck: String by project
+val isSpotlessDisabled = project.hasProperty("disableSpotlessCheck") &&
+        disableSpotlessCheck == "true"
+if (!isSpotlessDisabled) {
+  subprojects {
+    afterEvaluate {
+      tasks.findByName("spotlessApply")?.let {
+        listOf("compileJava", "compileTestJava").forEach {
+          t -> tasks.findByName(t)?.let { f -> f.dependsOn("spotlessApply") }
+        }
+      }
+    }
+  }
+}
+
 // Generates external transform config
 project.tasks.register("generateExternalTransformsConfig") {
   dependsOn(":sdks:python:generateExternalTransformsConfig")
diff --git a/runners/flink/flink_runner.gradle b/runners/flink/flink_runner.gradle
index d13e1c5faf6e..be39d4e0b012 100644
--- a/runners/flink/flink_runner.gradle
+++ b/runners/flink/flink_runner.gradle
@@ -422,3 +422,8 @@ createPipelineOptionsTableTask('Python')
 // Update the pipeline options documentation before running the tests
 test.dependsOn(generatePipelineOptionsTableJava)
 test.dependsOn(generatePipelineOptionsTablePython)
+
+// delegate spotlessApply to :runners:flink:spotlessApply
+tasks.named("spotlessApply") {
+  dependsOn ":runners:flink:spotlessApply"
+}

From 89ae2c104dfba9ddbf79315857c96e1c121254fa Mon Sep 17 00:00:00 2001
From: Ahmed Abualsaud <65791736+ahmedabu98@users.noreply.github.com>
Date: Fri, 6 Dec 2024 14:05:29 -0500
Subject: [PATCH 083/135] Enable managed service in Python tests (#33190)

* enable managed service

* format fix

* trigger xlang tests
---
 ...m_PostCommit_Python_Xlang_IO_Dataflow.json |  2 +-
 ...eam_PostCommit_Python_Xlang_IO_Direct.json |  2 +-
 .../transforms/managed_iceberg_it_test.py     | 30 ++++++++-----------
 3 files changed, 15 insertions(+), 19 deletions(-)

diff --git a/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Dataflow.json b/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Dataflow.json
index c537844dc84a..b26833333238 100644
--- a/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Dataflow.json
+++ b/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Dataflow.json
@@ -1,4 +1,4 @@
 {
   "comment": "Modify this file in a trivial way to cause this test suite to run",
-  "modification": 3
+  "modification": 2
 }
diff --git a/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json b/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json
index b26833333238..c537844dc84a 100644
--- a/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json
+++ b/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json
@@ -1,4 +1,4 @@
 {
   "comment": "Modify this file in a trivial way to cause this test suite to run",
-  "modification": 2
+  "modification": 3
 }
diff --git a/sdks/python/apache_beam/transforms/managed_iceberg_it_test.py b/sdks/python/apache_beam/transforms/managed_iceberg_it_test.py
index 0dfa2aa19c51..a09203f313eb 100644
--- a/sdks/python/apache_beam/transforms/managed_iceberg_it_test.py
+++ b/sdks/python/apache_beam/transforms/managed_iceberg_it_test.py
@@ -16,15 +16,13 @@
 #
 
 import os
-import secrets
-import shutil
-import tempfile
 import time
 import unittest
 
 import pytest
 
 import apache_beam as beam
+from apache_beam.testing.test_pipeline import TestPipeline
 from apache_beam.testing.util import assert_that
 from apache_beam.testing.util import equal_to
 
@@ -35,17 +33,15 @@
     "EXPANSION_JARS environment var is not provided, "
     "indicating that jars have not been built")
 class ManagedIcebergIT(unittest.TestCase):
-  def setUp(self):
-    self._tempdir = tempfile.mkdtemp()
-    if not os.path.exists(self._tempdir):
-      os.mkdir(self._tempdir)
-    test_warehouse_name = 'test_warehouse_%d_%s' % (
-        int(time.time()), secrets.token_hex(3))
-    self.warehouse_path = os.path.join(self._tempdir, test_warehouse_name)
-    os.mkdir(self.warehouse_path)
+  WAREHOUSE = "gs://temp-storage-for-end-to-end-tests/xlang-python-using-java"
 
-  def tearDown(self):
-    shutil.rmtree(self._tempdir, ignore_errors=False)
+  def setUp(self):
+    self.test_pipeline = TestPipeline(is_integration_test=True)
+    self.args = self.test_pipeline.get_full_options_as_args()
+    self.args.extend([
+        '--experiments=enable_managed_transforms',
+        '--dataflow_endpoint=https://dataflow-staging.sandbox.googleapis.com',
+    ])
 
   def _create_row(self, num: int):
     return beam.Row(
@@ -57,24 +53,24 @@ def _create_row(self, num: int):
 
   def test_write_read_pipeline(self):
     iceberg_config = {
-        "table": "test.write_read",
+        "table": "test_iceberg_write_read.test_" + str(int(time.time())),
         "catalog_name": "default",
         "catalog_properties": {
             "type": "hadoop",
-            "warehouse": f"file://{self.warehouse_path}",
+            "warehouse": self.WAREHOUSE,
         }
     }
 
     rows = [self._create_row(i) for i in range(100)]
     expected_dicts = [row.as_dict() for row in rows]
 
-    with beam.Pipeline() as write_pipeline:
+    with beam.Pipeline(argv=self.args) as write_pipeline:
       _ = (
           write_pipeline
           | beam.Create(rows)
           | beam.managed.Write(beam.managed.ICEBERG, config=iceberg_config))
 
-    with beam.Pipeline() as read_pipeline:
+    with beam.Pipeline(argv=self.args) as read_pipeline:
       output_dicts = (
           read_pipeline
           | beam.managed.Read(beam.managed.ICEBERG, config=iceberg_config)

From 0bf6f69c8bb1670795d86cd3fdfa5b2a402f963e Mon Sep 17 00:00:00 2001
From: Jeff Kinard <jeff@thekinards.com>
Date: Fri, 6 Dec 2024 15:49:47 -0500
Subject: [PATCH 084/135] [yaml] various inline provider doc fixes (#33296)

* [yaml] various inline provider doc fixes

Signed-off-by: Jeffrey Kinard <jeff@thekinards.com>

* Update yaml_combine.py

---------

Signed-off-by: Jeffrey Kinard <jeff@thekinards.com>
Co-authored-by: Robert Bradshaw <robertwb@gmail.com>
---
 sdks/python/apache_beam/yaml/yaml_combine.py |  6 ++++
 sdks/python/apache_beam/yaml/yaml_mapping.py | 29 +++++++++++---------
 2 files changed, 22 insertions(+), 13 deletions(-)

diff --git a/sdks/python/apache_beam/yaml/yaml_combine.py b/sdks/python/apache_beam/yaml/yaml_combine.py
index a28bef52ea31..b7499f3b0c7a 100644
--- a/sdks/python/apache_beam/yaml/yaml_combine.py
+++ b/sdks/python/apache_beam/yaml/yaml_combine.py
@@ -94,6 +94,12 @@ class PyJsYamlCombine(beam.PTransform):
 
   See also the documentation on
   [YAML Aggregation](https://beam.apache.org/documentation/sdks/yaml-combine/).
+
+  Args:
+    group_by: The field(s) to aggregate on.
+    combine: The aggregation function to use.
+    language: The language used to define (and execute) the
+      custom callables in `combine`. Defaults to generic.
   """
   def __init__(
       self,
diff --git a/sdks/python/apache_beam/yaml/yaml_mapping.py b/sdks/python/apache_beam/yaml/yaml_mapping.py
index 9f92f59f42b6..8f4a2118c236 100644
--- a/sdks/python/apache_beam/yaml/yaml_mapping.py
+++ b/sdks/python/apache_beam/yaml/yaml_mapping.py
@@ -428,19 +428,19 @@ class _StripErrorMetadata(beam.PTransform):
 
   For example, in the following pipeline snippet::
 
-    - name: MyMappingTransform
-      type: MapToFields
-      input: SomeInput
-      config:
-        language: python
-        fields:
-          ...
-        error_handling:
-          output: errors
-
-    - name: RecoverOriginalElements
-      type: StripErrorMetadata
-      input: MyMappingTransform.errors
+      - name: MyMappingTransform
+        type: MapToFields
+        input: SomeInput
+        config:
+          language: python
+          fields:
+            ...
+          error_handling:
+            output: errors
+
+      - name: RecoverOriginalElements
+        type: StripErrorMetadata
+        input: MyMappingTransform.errors
 
   the output of `RecoverOriginalElements` will contain exactly those elements
   from SomeInput that failed to processes (whereas `MyMappingTransform.errors`
@@ -453,6 +453,9 @@ class _StripErrorMetadata(beam.PTransform):
 
   _ERROR_FIELD_NAMES = ('failed_row', 'element', 'record')
 
+  def __init__(self):
+    super().__init__(label=None)
+
   def expand(self, pcoll):
     try:
       existing_fields = {

From d138b7501022fb63b9dde427c42eeabddd5c2243 Mon Sep 17 00:00:00 2001
From: Danny McCormick <dannymccormick@google.com>
Date: Fri, 6 Dec 2024 16:20:50 -0500
Subject: [PATCH 085/135] Add throttling metrics and retries to vertex
 embeddings (#33311)

* Add throttling metrics and retries to vertex embeddings

* Format + run postcommits

* fix + lint
---
 .../trigger_files/beam_PostCommit_Python.json |   2 +-
 .../ml/transforms/embeddings/vertex_ai.py     | 103 +++++++++++++++++-
 2 files changed, 101 insertions(+), 4 deletions(-)

diff --git a/.github/trigger_files/beam_PostCommit_Python.json b/.github/trigger_files/beam_PostCommit_Python.json
index 00bd9e035648..9c7a70ceed74 100644
--- a/.github/trigger_files/beam_PostCommit_Python.json
+++ b/.github/trigger_files/beam_PostCommit_Python.json
@@ -1,5 +1,5 @@
 {
   "comment": "Modify this file in a trivial way to cause this test suite to run.",
-  "modification": 6
+  "modification": 7
 }
 
diff --git a/sdks/python/apache_beam/ml/transforms/embeddings/vertex_ai.py b/sdks/python/apache_beam/ml/transforms/embeddings/vertex_ai.py
index 6fe8320e758b..6df505508ae9 100644
--- a/sdks/python/apache_beam/ml/transforms/embeddings/vertex_ai.py
+++ b/sdks/python/apache_beam/ml/transforms/embeddings/vertex_ai.py
@@ -19,20 +19,27 @@
 # Follow https://cloud.google.com/vertex-ai/docs/python-sdk/use-vertex-ai-python-sdk # pylint: disable=line-too-long
 # to install Vertex AI Python SDK.
 
+import logging
+import time
 from collections.abc import Iterable
 from collections.abc import Sequence
 from typing import Any
 from typing import Optional
 
+from google.api_core.exceptions import ServerError
+from google.api_core.exceptions import TooManyRequests
 from google.auth.credentials import Credentials
 
 import apache_beam as beam
 import vertexai
+from apache_beam.io.components.adaptive_throttler import AdaptiveThrottler
+from apache_beam.metrics.metric import Metrics
 from apache_beam.ml.inference.base import ModelHandler
 from apache_beam.ml.inference.base import RunInference
 from apache_beam.ml.transforms.base import EmbeddingsManager
 from apache_beam.ml.transforms.base import _ImageEmbeddingHandler
 from apache_beam.ml.transforms.base import _TextEmbeddingHandler
+from apache_beam.utils import retry
 from vertexai.language_models import TextEmbeddingInput
 from vertexai.language_models import TextEmbeddingModel
 from vertexai.vision_models import Image
@@ -51,6 +58,26 @@
     "CLUSTERING"
 ]
 _BATCH_SIZE = 5  # Vertex AI limits requests to 5 at a time.
+_MSEC_TO_SEC = 1000
+
+LOGGER = logging.getLogger("VertexAIEmbeddings")
+
+
+def _retry_on_appropriate_gcp_error(exception):
+  """
+  Retry filter that returns True if a returned HTTP error code is 5xx or 429.
+  This is used to retry remote requests that fail, most notably 429
+  (TooManyRequests.)
+
+  Args:
+    exception: the returned exception encountered during the request/response
+      loop.
+
+  Returns:
+    boolean indication whether or not the exception is a Server Error (5xx) or
+      a TooManyRequests (429) error.
+  """
+  return isinstance(exception, (TooManyRequests, ServerError))
 
 
 class _VertexAITextEmbeddingHandler(ModelHandler):
@@ -74,6 +101,41 @@ def __init__(
     self.task_type = task_type
     self.title = title
 
+    # Configure AdaptiveThrottler and throttling metrics for client-side
+    # throttling behavior.
+    # See https://docs.google.com/document/d/1ePorJGZnLbNCmLD9mR7iFYOdPsyDA1rDnTpYnbdrzSU/edit?usp=sharing
+    # for more details.
+    self.throttled_secs = Metrics.counter(
+        VertexAIImageEmbeddings, "cumulativeThrottlingSeconds")
+    self.throttler = AdaptiveThrottler(
+        window_ms=1, bucket_ms=1, overload_ratio=2)
+
+  @retry.with_exponential_backoff(
+      num_retries=5, retry_filter=_retry_on_appropriate_gcp_error)
+  def get_request(
+      self,
+      text_batch: Sequence[TextEmbeddingInput],
+      model: MultiModalEmbeddingModel,
+      throttle_delay_secs: int):
+    while self.throttler.throttle_request(time.time() * _MSEC_TO_SEC):
+      LOGGER.info(
+          "Delaying request for %d seconds due to previous failures",
+          throttle_delay_secs)
+      time.sleep(throttle_delay_secs)
+      self.throttled_secs.inc(throttle_delay_secs)
+
+    try:
+      req_time = time.time()
+      prediction = model.get_embeddings(text_batch)
+      self.throttler.successful_request(req_time * _MSEC_TO_SEC)
+      return prediction
+    except TooManyRequests as e:
+      LOGGER.warning("request was limited by the service with code %i", e.code)
+      raise
+    except Exception as e:
+      LOGGER.error("unexpected exception raised as part of request, got %s", e)
+      raise
+
   def run_inference(
       self,
       batch: Sequence[str],
@@ -89,7 +151,8 @@ def run_inference(
               text=text, title=self.title, task_type=self.task_type)
           for text in text_batch
       ]
-      embeddings_batch = model.get_embeddings(text_batch)
+      embeddings_batch = self.get_request(
+          text_batch=text_batch, model=model, throttle_delay_secs=5)
       embeddings.extend([el.values for el in embeddings_batch])
     return embeddings
 
@@ -173,6 +236,41 @@ def __init__(
     self.model_name = model_name
     self.dimension = dimension
 
+    # Configure AdaptiveThrottler and throttling metrics for client-side
+    # throttling behavior.
+    # See https://docs.google.com/document/d/1ePorJGZnLbNCmLD9mR7iFYOdPsyDA1rDnTpYnbdrzSU/edit?usp=sharing
+    # for more details.
+    self.throttled_secs = Metrics.counter(
+        VertexAIImageEmbeddings, "cumulativeThrottlingSeconds")
+    self.throttler = AdaptiveThrottler(
+        window_ms=1, bucket_ms=1, overload_ratio=2)
+
+  @retry.with_exponential_backoff(
+      num_retries=5, retry_filter=_retry_on_appropriate_gcp_error)
+  def get_request(
+      self,
+      img: Image,
+      model: MultiModalEmbeddingModel,
+      throttle_delay_secs: int):
+    while self.throttler.throttle_request(time.time() * _MSEC_TO_SEC):
+      LOGGER.info(
+          "Delaying request for %d seconds due to previous failures",
+          throttle_delay_secs)
+      time.sleep(throttle_delay_secs)
+      self.throttled_secs.inc(throttle_delay_secs)
+
+    try:
+      req_time = time.time()
+      prediction = model.get_embeddings(image=img, dimension=self.dimension)
+      self.throttler.successful_request(req_time * _MSEC_TO_SEC)
+      return prediction
+    except TooManyRequests as e:
+      LOGGER.warning("request was limited by the service with code %i", e.code)
+      raise
+    except Exception as e:
+      LOGGER.error("unexpected exception raised as part of request, got %s", e)
+      raise
+
   def run_inference(
       self,
       batch: Sequence[Image],
@@ -182,8 +280,7 @@ def run_inference(
     embeddings = []
     # Maximum request size for muli-model embedding models is 1.
     for img in batch:
-      embedding_response = model.get_embeddings(
-          image=img, dimension=self.dimension)
+      embedding_response = self.get_request(img, model, throttle_delay_secs=5)
       embeddings.append(embedding_response.image_embedding)
     return embeddings
 

From 17129643d307e55670de28ec6f07ad326d666b77 Mon Sep 17 00:00:00 2001
From: Hai Joey Tran <joey.tran@schrodinger.com>
Date: Fri, 6 Dec 2024 17:03:32 -0500
Subject: [PATCH 086/135] Fix FlatMapTuple typehint bug (#33307)

* create unit test

* minimize to not using flatmaptuple

* fix by adding a tuple conersion in flatmaptuple

* add comment referring to ticket

* remove extra pipeline

* manually isort

* retrigger builder

* retrigger builder

* isort?

* try manually isorting again

* Revert "try manually isorting again"

This reverts commit a0fac321a15a07169fb27e217b61be3edc73d157.

* manually fix isort
---
 sdks/python/apache_beam/transforms/core.py     |  2 +-
 .../typehints/typed_pipeline_test.py           | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/sdks/python/apache_beam/transforms/core.py b/sdks/python/apache_beam/transforms/core.py
index 9c798d3ce6dc..4d1678d72a69 100644
--- a/sdks/python/apache_beam/transforms/core.py
+++ b/sdks/python/apache_beam/transforms/core.py
@@ -2238,7 +2238,7 @@ def FlatMapTuple(fn, *args, **kwargs):  # pylint: disable=invalid-name
   if defaults or args or kwargs:
     wrapper = lambda x, *args, **kwargs: fn(*(tuple(x) + args), **kwargs)
   else:
-    wrapper = lambda x: fn(*x)
+    wrapper = lambda x: fn(*tuple(x))
 
   # Proxy the type-hint information from the original function to this new
   # wrapped function.
diff --git a/sdks/python/apache_beam/typehints/typed_pipeline_test.py b/sdks/python/apache_beam/typehints/typed_pipeline_test.py
index 44318fa44a8c..820f78fa9ef5 100644
--- a/sdks/python/apache_beam/typehints/typed_pipeline_test.py
+++ b/sdks/python/apache_beam/typehints/typed_pipeline_test.py
@@ -21,6 +21,7 @@
 
 import typing
 import unittest
+from typing import Tuple
 
 import apache_beam as beam
 from apache_beam import pvalue
@@ -999,5 +1000,22 @@ def filter_fn(element: int) -> bool:
     self.assertEqual(th.output_types, ((int, ), {}))
 
 
+class TestFlatMapTuple(unittest.TestCase):
+  def test_flatmaptuple(self):
+    # Regression test. See
+    # https://github.com/apache/beam/issues/33014
+
+    def identity(x: Tuple[str, int]) -> Tuple[str, int]:
+      return x
+
+    with beam.Pipeline() as p:
+      # Just checking that this doesn't raise an exception.
+      (
+          p
+          | "Generate input" >> beam.Create([('P1', [2])])
+          | "Flat" >> beam.FlatMapTuple(lambda k, vs: [(k, v) for v in vs])
+          | "Identity" >> beam.Map(identity))
+
+
 if __name__ == '__main__':
   unittest.main()

From 0dae9c99427bfe484c26c138854d71ff9bfdeea3 Mon Sep 17 00:00:00 2001
From: Hai Joey Tran <joey.tran@schrodinger.com>
Date: Fri, 6 Dec 2024 20:56:38 -0500
Subject: [PATCH 087/135] Polish FlatMapTuple and MapTuple docstrings (#33316)

---
 sdks/python/apache_beam/transforms/core.py | 16 ++++------------
 1 file changed, 4 insertions(+), 12 deletions(-)

diff --git a/sdks/python/apache_beam/transforms/core.py b/sdks/python/apache_beam/transforms/core.py
index 4d1678d72a69..b420d1d66d09 100644
--- a/sdks/python/apache_beam/transforms/core.py
+++ b/sdks/python/apache_beam/transforms/core.py
@@ -2117,15 +2117,13 @@ def MapTuple(fn, *args, **kwargs):  # pylint: disable=invalid-name
   r""":func:`MapTuple` is like :func:`Map` but expects tuple inputs and
   flattens them into multiple input arguments.
 
-      beam.MapTuple(lambda a, b, ...: ...)
-
   In other words
 
-      beam.MapTuple(fn)
+      "SwapKV" >> beam.Map(lambda kv: (kv[1], kv[0]))
 
   is equivalent to
 
-      beam.Map(lambda element, ...: fn(\*element, ...))
+      "SwapKV" >> beam.MapTuple(lambda k, v: (v, k))
 
   This can be useful when processing a PCollection of tuples
   (e.g. key-value pairs).
@@ -2191,19 +2189,13 @@ def FlatMapTuple(fn, *args, **kwargs):  # pylint: disable=invalid-name
   r""":func:`FlatMapTuple` is like :func:`FlatMap` but expects tuple inputs and
   flattens them into multiple input arguments.
 
-      beam.FlatMapTuple(lambda a, b, ...: ...)
-
-  is equivalent to Python 2
-
-      beam.FlatMap(lambda (a, b, ...), ...: ...)
-
   In other words
 
-      beam.FlatMapTuple(fn)
+      beam.FlatMap(lambda start_end: range(start_end[0], start_end[1]))
 
   is equivalent to
 
-      beam.FlatMap(lambda element, ...: fn(\*element, ...))
+      beam.FlatMapTuple(lambda start, end: range(start, end))
 
   This can be useful when processing a PCollection of tuples
   (e.g. key-value pairs).

From 85bff0d2c1adb743c4738f51428c88fb74532021 Mon Sep 17 00:00:00 2001
From: Yi Hu <yathu@google.com>
Date: Mon, 9 Dec 2024 11:59:38 -0500
Subject: [PATCH 088/135] Reapply "bump hadoop version (#33011)" (#33312)

* Reapply "bump hadoop version (#33011)" (#33257)

This reverts commit 7e25649b88b1ac08e48db28f8af09978b649da17.

* Fix hbase and hcatalog test dependencies

* Add missing pinned hadoop dependency version for compat test target
---
 .../beam_PostCommit_Java_Hadoop_Versions.json          |  2 +-
 .../beam_PreCommit_Java_HBase_IO_Direct.json           |  1 +
 CHANGES.md                                             |  1 +
 .../org/apache/beam/gradle/BeamModulePlugin.groovy     |  2 +-
 sdks/java/io/hadoop-common/build.gradle                |  2 +-
 sdks/java/io/hadoop-file-system/build.gradle           |  2 +-
 sdks/java/io/hadoop-format/build.gradle                |  2 +-
 sdks/java/io/hbase/build.gradle                        |  9 ++-------
 sdks/java/io/hcatalog/build.gradle                     | 10 +++++++++-
 sdks/java/io/iceberg/build.gradle                      |  8 ++++++++
 10 files changed, 26 insertions(+), 13 deletions(-)
 create mode 100644 .github/trigger_files/beam_PreCommit_Java_HBase_IO_Direct.json

diff --git a/.github/trigger_files/beam_PostCommit_Java_Hadoop_Versions.json b/.github/trigger_files/beam_PostCommit_Java_Hadoop_Versions.json
index 920c8d132e4a..8784d0786c02 100644
--- a/.github/trigger_files/beam_PostCommit_Java_Hadoop_Versions.json
+++ b/.github/trigger_files/beam_PostCommit_Java_Hadoop_Versions.json
@@ -1,4 +1,4 @@
 {
   "comment": "Modify this file in a trivial way to cause this test suite to run",
-  "modification": 1
+  "modification": 2
 }
\ No newline at end of file
diff --git a/.github/trigger_files/beam_PreCommit_Java_HBase_IO_Direct.json b/.github/trigger_files/beam_PreCommit_Java_HBase_IO_Direct.json
new file mode 100644
index 000000000000..0967ef424bce
--- /dev/null
+++ b/.github/trigger_files/beam_PreCommit_Java_HBase_IO_Direct.json
@@ -0,0 +1 @@
+{}
diff --git a/CHANGES.md b/CHANGES.md
index 1b943a99f8a0..dbadd588ae3f 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -64,6 +64,7 @@
 
 * gcs-connector config options can be set via GcsOptions (Java) ([#32769](https://github.com/apache/beam/pull/32769)).
 * Support for X source added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
+* Upgraded the default version of Hadoop dependencies to 3.4.1. Hadoop 2.10.2 is still supported (Java) ([#33011](https://github.com/apache/beam/issues/33011)).
 
 ## New Features / Improvements
 
diff --git a/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy b/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
index 84c7c3ecfd4a..2abd43a5d4cc 100644
--- a/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
+++ b/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
@@ -614,7 +614,7 @@ class BeamModulePlugin implements Plugin<Project> {
     // [bomupgrader] determined by: io.grpc:grpc-netty, consistent with: google_cloud_platform_libraries_bom
     def grpc_version = "1.67.1"
     def guava_version = "33.1.0-jre"
-    def hadoop_version = "2.10.2"
+    def hadoop_version = "3.4.1"
     def hamcrest_version = "2.1"
     def influxdb_version = "2.19"
     def httpclient_version = "4.5.13"
diff --git a/sdks/java/io/hadoop-common/build.gradle b/sdks/java/io/hadoop-common/build.gradle
index b0303d29ff98..4375001ffa81 100644
--- a/sdks/java/io/hadoop-common/build.gradle
+++ b/sdks/java/io/hadoop-common/build.gradle
@@ -28,7 +28,7 @@ def hadoopVersions = [
     "2102": "2.10.2",
     "324": "3.2.4",
     "336": "3.3.6",
-    "341": "3.4.1",
+    // "341": "3.4.1", // tests already exercised on the default version
 ]
 
 hadoopVersions.each {kv -> configurations.create("hadoopVersion$kv.key")}
diff --git a/sdks/java/io/hadoop-file-system/build.gradle b/sdks/java/io/hadoop-file-system/build.gradle
index fafa8b5c7e34..b4ebbfa08c5e 100644
--- a/sdks/java/io/hadoop-file-system/build.gradle
+++ b/sdks/java/io/hadoop-file-system/build.gradle
@@ -29,7 +29,7 @@ def hadoopVersions = [
     "2102": "2.10.2",
     "324": "3.2.4",
     "336": "3.3.6",
-    "341": "3.4.1",
+    // "341": "3.4.1", // tests already exercised on the default version
 ]
 
 hadoopVersions.each {kv -> configurations.create("hadoopVersion$kv.key")}
diff --git a/sdks/java/io/hadoop-format/build.gradle b/sdks/java/io/hadoop-format/build.gradle
index 4664005a1fc8..73fc44a0f311 100644
--- a/sdks/java/io/hadoop-format/build.gradle
+++ b/sdks/java/io/hadoop-format/build.gradle
@@ -33,7 +33,7 @@ def hadoopVersions = [
     "2102": "2.10.2",
     "324": "3.2.4",
     "336": "3.3.6",
-    "341": "3.4.1",
+    // "341": "3.4.1", // tests already exercised on the default version
 ]
 
 hadoopVersions.each {kv -> configurations.create("hadoopVersion$kv.key")}
diff --git a/sdks/java/io/hbase/build.gradle b/sdks/java/io/hbase/build.gradle
index d85c0fc610bb..07014f2d5e3b 100644
--- a/sdks/java/io/hbase/build.gradle
+++ b/sdks/java/io/hbase/build.gradle
@@ -34,7 +34,7 @@ test {
   jvmArgs "-Dtest.build.data.basedirectory=build/test-data"
 }
 
-def hbase_version = "2.5.5"
+def hbase_version = "2.6.1-hadoop3"
 
 dependencies {
   implementation library.java.vendored_guava_32_1_2_jre
@@ -46,12 +46,7 @@ dependencies {
   testImplementation project(path: ":sdks:java:core", configuration: "shadowTest")
   testImplementation library.java.junit
   testImplementation library.java.hamcrest
-  testImplementation library.java.hadoop_minicluster
-  testImplementation library.java.hadoop_hdfs
-  testImplementation library.java.hadoop_common
+  // shaded-testing-utils has shaded all Hadoop/HBase dependencies
   testImplementation("org.apache.hbase:hbase-shaded-testing-util:$hbase_version")
-  testImplementation "org.apache.hbase:hbase-hadoop-compat:$hbase_version:tests"
-  testImplementation "org.apache.hbase:hbase-hadoop2-compat:$hbase_version:tests"
   testRuntimeOnly project(path: ":runners:direct-java", configuration: "shadow")
 }
-
diff --git a/sdks/java/io/hcatalog/build.gradle b/sdks/java/io/hcatalog/build.gradle
index 364c10fa738b..d07904f3465e 100644
--- a/sdks/java/io/hcatalog/build.gradle
+++ b/sdks/java/io/hcatalog/build.gradle
@@ -33,7 +33,7 @@ def hadoopVersions = [
     "2102": "2.10.2",
     "324": "3.2.4",
     "336": "3.3.6",
-    "341": "3.4.1",
+    // "341": "3.4.1", // tests already exercised on the default version
 ]
 
 hadoopVersions.each {kv -> configurations.create("hadoopVersion$kv.key")}
@@ -71,13 +71,21 @@ dependencies {
   testRuntimeOnly project(path: ":runners:direct-java", configuration: "shadow")
   hadoopVersions.each {kv ->
     "hadoopVersion$kv.key" "org.apache.hadoop:hadoop-common:$kv.value"
+    "hadoopVersion$kv.key" "org.apache.hadoop:hadoop-hdfs:$kv.value"
+    "hadoopVersion$kv.key" "org.apache.hadoop:hadoop-hdfs-client:$kv.value"
+    "hadoopVersion$kv.key" "org.apache.hadoop:hadoop-mapreduce-client-core:$kv.value"
   }
 }
 
 hadoopVersions.each {kv ->
   configurations."hadoopVersion$kv.key" {
     resolutionStrategy {
+      force "org.apache.hadoop:hadoop-client:$kv.value"
       force "org.apache.hadoop:hadoop-common:$kv.value"
+      force "org.apache.hadoop:hadoop-mapreduce-client-core:$kv.value"
+      force "org.apache.hadoop:hadoop-minicluster:$kv.value"
+      force "org.apache.hadoop:hadoop-hdfs:$kv.value"
+      force "org.apache.hadoop:hadoop-hdfs-client:$kv.value"
     }
   }
 }
diff --git a/sdks/java/io/iceberg/build.gradle b/sdks/java/io/iceberg/build.gradle
index a2d192b67208..fa1e2426ce69 100644
--- a/sdks/java/io/iceberg/build.gradle
+++ b/sdks/java/io/iceberg/build.gradle
@@ -71,6 +71,9 @@ dependencies {
     testRuntimeOnly project(path: ":runners:google-cloud-dataflow-java")
     hadoopVersions.each {kv ->
         "hadoopVersion$kv.key" "org.apache.hadoop:hadoop-client:$kv.value"
+        "hadoopVersion$kv.key" "org.apache.hadoop:hadoop-minicluster:$kv.value"
+        "hadoopVersion$kv.key" "org.apache.hadoop:hadoop-hdfs-client:$kv.value"
+        "hadoopVersion$kv.key" "org.apache.hadoop:hadoop-mapreduce-client-core:$kv.value"
     }
 }
 
@@ -78,6 +81,11 @@ hadoopVersions.each {kv ->
     configurations."hadoopVersion$kv.key" {
         resolutionStrategy {
             force "org.apache.hadoop:hadoop-client:$kv.value"
+            force "org.apache.hadoop:hadoop-common:$kv.value"
+            force "org.apache.hadoop:hadoop-mapreduce-client-core:$kv.value"
+            force "org.apache.hadoop:hadoop-minicluster:$kv.value"
+            force "org.apache.hadoop:hadoop-hdfs:$kv.value"
+            force "org.apache.hadoop:hadoop-hdfs-client:$kv.value"
         }
     }
 }

From a806c0ed3a9ead3b7738ae94bf323865abbd5e73 Mon Sep 17 00:00:00 2001
From: Jack McCluskey <34928439+jrmccluskey@users.noreply.github.com>
Date: Mon, 9 Dec 2024 13:20:12 -0500
Subject: [PATCH 089/135] Add Dataflow Cost Benchmark framework to Beam Python
 (#33297)

* initial benchmark framework code

* Implement Dataflow cost benchmark framework + add wordcount example

* formatting

* move to base wordcount instead

* add comment for pipeline execution in wordcount
---
 ...rdcount_Python_Cost_Benchmark_Dataflow.yml |  91 ++++++++++++++
 .../python_wordcount.txt                      |  28 +++++
 sdks/python/apache_beam/examples/wordcount.py |  39 +++---
 .../testing/benchmarks/wordcount/__init__.py  |  16 +++
 .../testing/benchmarks/wordcount/wordcount.py |  39 ++++++
 .../load_tests/dataflow_cost_benchmark.py     | 113 ++++++++++++++++++
 .../load_tests/dataflow_cost_consts.py        |  59 +++++++++
 7 files changed, 368 insertions(+), 17 deletions(-)
 create mode 100644 .github/workflows/beam_Wordcount_Python_Cost_Benchmark_Dataflow.yml
 create mode 100644 .github/workflows/cost-benchmarks-pipeline-options/python_wordcount.txt
 create mode 100644 sdks/python/apache_beam/testing/benchmarks/wordcount/__init__.py
 create mode 100644 sdks/python/apache_beam/testing/benchmarks/wordcount/wordcount.py
 create mode 100644 sdks/python/apache_beam/testing/load_tests/dataflow_cost_benchmark.py
 create mode 100644 sdks/python/apache_beam/testing/load_tests/dataflow_cost_consts.py

diff --git a/.github/workflows/beam_Wordcount_Python_Cost_Benchmark_Dataflow.yml b/.github/workflows/beam_Wordcount_Python_Cost_Benchmark_Dataflow.yml
new file mode 100644
index 000000000000..51d1005affbc
--- /dev/null
+++ b/.github/workflows/beam_Wordcount_Python_Cost_Benchmark_Dataflow.yml
@@ -0,0 +1,91 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Wordcount Python Cost Benchmarks Dataflow
+
+on:
+  workflow_dispatch:
+
+#Setting explicit permissions for the action to avoid the default permissions which are `write-all` in case of pull_request_target event
+permissions:
+  actions: write
+  pull-requests: read
+  checks: read
+  contents: read
+  deployments: read
+  id-token: none
+  issues: read
+  discussions: read
+  packages: read
+  pages: read
+  repository-projects: read
+  security-events: read
+  statuses: read
+
+# This allows a subsequently queued workflow run to interrupt previous runs
+concurrency:
+  group: '${{ github.workflow }} @ ${{ github.event.issue.number || github.sha || github.head_ref || github.ref }}-${{ github.event.schedule || github.event.comment.id || github.event.sender.login }}'
+  cancel-in-progress: true
+
+env:
+  DEVELOCITY_ACCESS_KEY: ${{ secrets.GE_ACCESS_TOKEN }}
+  GRADLE_ENTERPRISE_CACHE_USERNAME: ${{ secrets.GE_CACHE_USERNAME }}
+  GRADLE_ENTERPRISE_CACHE_PASSWORD: ${{ secrets.GE_CACHE_PASSWORD }}
+  INFLUXDB_USER: ${{ secrets.INFLUXDB_USER }}
+  INFLUXDB_USER_PASSWORD: ${{ secrets.INFLUXDB_USER_PASSWORD }}
+
+jobs:
+  beam_Inference_Python_Benchmarks_Dataflow:
+    if: |
+      github.event_name == 'workflow_dispatch'
+    runs-on: [self-hosted, ubuntu-20.04, main]
+    timeout-minutes: 900
+    name: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
+    strategy:
+      matrix:
+        job_name: ["beam_Wordcount_Python_Cost_Benchmarks_Dataflow"]
+        job_phrase: ["Run Wordcount Cost Benchmark"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup repository
+        uses: ./.github/actions/setup-action
+        with:
+          comment_phrase: ${{ matrix.job_phrase }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          github_job: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
+      - name: Setup Python environment
+        uses: ./.github/actions/setup-environment-action
+        with:
+          python-version: '3.10'
+      - name: Prepare test arguments
+        uses: ./.github/actions/test-arguments-action
+        with:
+          test-type: load
+          test-language: python
+          argument-file-paths: |
+            ${{ github.workspace }}/.github/workflows/cost-benchmarks-pipeline-options/python_wordcount.txt
+      # The env variables are created and populated in the test-arguments-action as "<github.job>_test_arguments_<argument_file_paths_index>"
+      - name: get current time
+        run: echo "NOW_UTC=$(date '+%m%d%H%M%S' --utc)" >> $GITHUB_ENV
+      - name: run wordcount on Dataflow Python
+        uses: ./.github/actions/gradle-command-self-hosted-action
+        timeout-minutes: 30
+        with:
+          gradle-command: :sdks:python:apache_beam:testing:load_tests:run
+          arguments: |
+            -PloadTest.mainClass=apache_beam.testing.benchmarks.wordcount.wordcount \
+            -Prunner=DataflowRunner \
+            -PpythonVersion=3.10 \
+            '-PloadTest.args=${{ env.beam_Inference_Python_Benchmarks_Dataflow_test_arguments_1 }} --job_name=benchmark-tests-wordcount-python-${{env.NOW_UTC}} --output=gs://temp-storage-for-end-to-end-tests/wordcount/result_wordcount-${{env.NOW_UTC}}.txt' \
\ No newline at end of file
diff --git a/.github/workflows/cost-benchmarks-pipeline-options/python_wordcount.txt b/.github/workflows/cost-benchmarks-pipeline-options/python_wordcount.txt
new file mode 100644
index 000000000000..424936ddad97
--- /dev/null
+++ b/.github/workflows/cost-benchmarks-pipeline-options/python_wordcount.txt
@@ -0,0 +1,28 @@
+#  Licensed to the Apache Software Foundation (ASF) under one
+#  or more contributor license agreements.  See the NOTICE file
+#  distributed with this work for additional information
+#  regarding copyright ownership.  The ASF licenses this file
+#  to you under the Apache License, Version 2.0 (the
+#  "License"); you may not use this file except in compliance
+#  with the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+--region=us-central1
+--machine_type=n1-standard-2
+--num_workers=1
+--disk_size_gb=50
+--autoscaling_algorithm=NONE
+--input_options={}
+--staging_location=gs://temp-storage-for-perf-tests/loadtests
+--temp_location=gs://temp-storage-for-perf-tests/loadtests
+--publish_to_big_query=true
+--metrics_dataset=beam_run_inference
+--metrics_table=python_wordcount
+--runner=DataflowRunner
\ No newline at end of file
diff --git a/sdks/python/apache_beam/examples/wordcount.py b/sdks/python/apache_beam/examples/wordcount.py
index 31407aec6c40..a9138647581c 100644
--- a/sdks/python/apache_beam/examples/wordcount.py
+++ b/sdks/python/apache_beam/examples/wordcount.py
@@ -45,6 +45,7 @@
 from apache_beam.io import WriteToText
 from apache_beam.options.pipeline_options import PipelineOptions
 from apache_beam.options.pipeline_options import SetupOptions
+from apache_beam.runners.runner import PipelineResult
 
 
 class WordExtractingDoFn(beam.DoFn):
@@ -63,7 +64,7 @@ def process(self, element):
     return re.findall(r'[\w\']+', element, re.UNICODE)
 
 
-def run(argv=None, save_main_session=True):
+def run(argv=None, save_main_session=True) -> PipelineResult:
   """Main entry point; defines and runs the wordcount pipeline."""
   parser = argparse.ArgumentParser()
   parser.add_argument(
@@ -83,27 +84,31 @@ def run(argv=None, save_main_session=True):
   pipeline_options = PipelineOptions(pipeline_args)
   pipeline_options.view_as(SetupOptions).save_main_session = save_main_session
 
-  # The pipeline will be run on exiting the with block.
-  with beam.Pipeline(options=pipeline_options) as p:
+  pipeline = beam.Pipeline(options=pipeline_options)
 
-    # Read the text file[pattern] into a PCollection.
-    lines = p | 'Read' >> ReadFromText(known_args.input)
+  # Read the text file[pattern] into a PCollection.
+  lines = pipeline | 'Read' >> ReadFromText(known_args.input)
 
-    counts = (
-        lines
-        | 'Split' >> (beam.ParDo(WordExtractingDoFn()).with_output_types(str))
-        | 'PairWithOne' >> beam.Map(lambda x: (x, 1))
-        | 'GroupAndSum' >> beam.CombinePerKey(sum))
+  counts = (
+      lines
+      | 'Split' >> (beam.ParDo(WordExtractingDoFn()).with_output_types(str))
+      | 'PairWithOne' >> beam.Map(lambda x: (x, 1))
+      | 'GroupAndSum' >> beam.CombinePerKey(sum))
 
-    # Format the counts into a PCollection of strings.
-    def format_result(word, count):
-      return '%s: %d' % (word, count)
+  # Format the counts into a PCollection of strings.
+  def format_result(word, count):
+    return '%s: %d' % (word, count)
 
-    output = counts | 'Format' >> beam.MapTuple(format_result)
+  output = counts | 'Format' >> beam.MapTuple(format_result)
 
-    # Write the output using a "Write" transform that has side effects.
-    # pylint: disable=expression-not-assigned
-    output | 'Write' >> WriteToText(known_args.output)
+  # Write the output using a "Write" transform that has side effects.
+  # pylint: disable=expression-not-assigned
+  output | 'Write' >> WriteToText(known_args.output)
+
+  # Execute the pipeline and return the result.
+  result = pipeline.run()
+  result.wait_until_finish()
+  return result
 
 
 if __name__ == '__main__':
diff --git a/sdks/python/apache_beam/testing/benchmarks/wordcount/__init__.py b/sdks/python/apache_beam/testing/benchmarks/wordcount/__init__.py
new file mode 100644
index 000000000000..cce3acad34a4
--- /dev/null
+++ b/sdks/python/apache_beam/testing/benchmarks/wordcount/__init__.py
@@ -0,0 +1,16 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
diff --git a/sdks/python/apache_beam/testing/benchmarks/wordcount/wordcount.py b/sdks/python/apache_beam/testing/benchmarks/wordcount/wordcount.py
new file mode 100644
index 000000000000..513ede47e80a
--- /dev/null
+++ b/sdks/python/apache_beam/testing/benchmarks/wordcount/wordcount.py
@@ -0,0 +1,39 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# pytype: skip-file
+
+import logging
+
+from apache_beam.examples import wordcount
+from apache_beam.testing.load_tests.dataflow_cost_benchmark import DataflowCostBenchmark
+
+
+class WordcountCostBenchmark(DataflowCostBenchmark):
+  def __init__(self):
+    super().__init__()
+
+  def test(self):
+    extra_opts = {}
+    extra_opts['output'] = self.pipeline.get_option('output_file')
+    self.result = wordcount.run(
+        self.pipeline.get_full_options_as_args(**extra_opts),
+        save_main_session=False)
+
+
+if __name__ == '__main__':
+  logging.basicConfig(level=logging.INFO)
+  WordcountCostBenchmark().run()
diff --git a/sdks/python/apache_beam/testing/load_tests/dataflow_cost_benchmark.py b/sdks/python/apache_beam/testing/load_tests/dataflow_cost_benchmark.py
new file mode 100644
index 000000000000..b60af1249756
--- /dev/null
+++ b/sdks/python/apache_beam/testing/load_tests/dataflow_cost_benchmark.py
@@ -0,0 +1,113 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# pytype: skip-file
+
+import logging
+import time
+from typing import Any
+from typing import Optional
+
+import apache_beam.testing.load_tests.dataflow_cost_consts as costs
+from apache_beam.metrics.execution import MetricResult
+from apache_beam.runners.dataflow.dataflow_runner import DataflowPipelineResult
+from apache_beam.runners.runner import PipelineState
+from apache_beam.testing.load_tests.load_test import LoadTest
+
+
+class DataflowCostBenchmark(LoadTest):
+  """Base class for Dataflow performance tests which export metrics to
+  external databases: BigQuery or/and InfluxDB. Calculates the expected cost
+  for running the job on Dataflow in region us-central1.
+
+  Refer to :class:`~apache_beam.testing.load_tests.LoadTestOptions` for more
+  information on the required pipeline options.
+
+  If using InfluxDB with Basic HTTP authentication enabled, provide the
+  following environment options: `INFLUXDB_USER` and `INFLUXDB_USER_PASSWORD`.
+
+  If the hardware configuration for the job includes use of a GPU, please 
+  specify the version in use with the Accelerator enumeration. This is used to
+  calculate the cost of the job later, as different accelerators have different
+  billing rates per hour of use.
+  """
+  def __init__(
+      self,
+      metrics_namespace: Optional[str] = None,
+      is_streaming: bool = False,
+      gpu: Optional[costs.Accelerator] = None):
+    self.is_streaming = is_streaming
+    self.gpu = gpu
+    super().__init__(metrics_namespace=metrics_namespace)
+
+  def run(self):
+    try:
+      self.test()
+      if not hasattr(self, 'result'):
+        self.result = self.pipeline.run()
+        # Defaults to waiting forever unless timeout has been set
+        state = self.result.wait_until_finish(duration=self.timeout_ms)
+        assert state != PipelineState.FAILED
+      logging.info(
+          'Pipeline complete, sleeping for 4 minutes to allow resource '
+          'metrics to populate.')
+      time.sleep(240)
+      self.extra_metrics = self._retrieve_cost_metrics(self.result)
+      self._metrics_monitor.publish_metrics(self.result, self.extra_metrics)
+    finally:
+      self.cleanup()
+
+  def _retrieve_cost_metrics(self,
+                             result: DataflowPipelineResult) -> dict[str, Any]:
+    job_id = result.job_id()
+    metrics = result.metrics().all_metrics(job_id)
+    metrics_dict = self._process_metrics_list(metrics)
+    logging.info(metrics_dict)
+    cost = 0.0
+    if (self.is_streaming):
+      cost += metrics_dict.get(
+          "TotalVcpuTime", 0.0) / 3600 * costs.VCPU_PER_HR_STREAMING
+      cost += (
+          metrics_dict.get("TotalMemoryUsage", 0.0) /
+          1000) / 3600 * costs.MEM_PER_GB_HR_STREAMING
+      cost += metrics_dict.get(
+          "TotalStreamingDataProcessed", 0.0) * costs.SHUFFLE_PER_GB_STREAMING
+    else:
+      cost += metrics_dict.get(
+          "TotalVcpuTime", 0.0) / 3600 * costs.VCPU_PER_HR_BATCH
+      cost += (
+          metrics_dict.get("TotalMemoryUsage", 0.0) /
+          1000) / 3600 * costs.MEM_PER_GB_HR_BATCH
+      cost += metrics_dict.get(
+          "TotalStreamingDataProcessed", 0.0) * costs.SHUFFLE_PER_GB_BATCH
+    if (self.gpu):
+      rate = costs.ACCELERATOR_TO_COST[self.gpu]
+      cost += metrics_dict.get("TotalGpuTime", 0.0) / 3600 * rate
+    cost += metrics_dict.get("TotalPdUsage", 0.0) / 3600 * costs.PD_PER_GB_HR
+    cost += metrics_dict.get(
+        "TotalSsdUsage", 0.0) / 3600 * costs.PD_SSD_PER_GB_HR
+    metrics_dict["EstimatedCost"] = cost
+    return metrics_dict
+
+  def _process_metrics_list(self,
+                            metrics: list[MetricResult]) -> dict[str, Any]:
+    system_metrics = {}
+    for entry in metrics:
+      metric_key = entry.key
+      metric = metric_key.metric
+      if metric_key.step == '' and metric.namespace == 'dataflow/v1b3':
+        system_metrics[metric.name] = entry.committed
+    return system_metrics
diff --git a/sdks/python/apache_beam/testing/load_tests/dataflow_cost_consts.py b/sdks/python/apache_beam/testing/load_tests/dataflow_cost_consts.py
new file mode 100644
index 000000000000..f291991b48bb
--- /dev/null
+++ b/sdks/python/apache_beam/testing/load_tests/dataflow_cost_consts.py
@@ -0,0 +1,59 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# These values are Dataflow costs for running jobs in us-central1.
+# The cost values are found at https://cloud.google.com/dataflow/pricing
+
+from enum import Enum
+
+VCPU_PER_HR_BATCH = 0.056
+VCPU_PER_HR_STREAMING = 0.069
+MEM_PER_GB_HR_BATCH = 0.003557
+MEM_PER_GB_HR_STREAMING = 0.0035557
+PD_PER_GB_HR = 0.000054
+PD_SSD_PER_GB_HR = 0.000298
+SHUFFLE_PER_GB_BATCH = 0.011
+SHUFFLE_PER_GB_STREAMING = 0.018
+
+# GPU Resource Pricing
+P100_PER_GPU_PER_HOUR = 1.752
+V100_PER_GPU_PER_HOUR = 2.976
+T4_PER_GPU_PER_HOUR = 0.42
+P4_PER_GPU_PER_HOUR = 0.72
+L4_PER_GPU_PER_HOUR = 0.672
+A100_40GB_PER_GPU_PER_HOUR = 3.72
+A100_80GB_PER_GPU_PER_HOUR = 4.7137
+
+
+class Accelerator(Enum):
+  P100 = 1
+  V100 = 2
+  T4 = 3
+  P4 = 4
+  L4 = 5
+  A100_40GB = 6
+  A100_80GB = 7
+
+
+ACCELERATOR_TO_COST: dict[Accelerator, float] = {
+    Accelerator.P100: P100_PER_GPU_PER_HOUR,
+    Accelerator.V100: V100_PER_GPU_PER_HOUR,
+    Accelerator.T4: T4_PER_GPU_PER_HOUR,
+    Accelerator.P4: P4_PER_GPU_PER_HOUR,
+    Accelerator.L4: L4_PER_GPU_PER_HOUR,
+    Accelerator.A100_40GB: A100_40GB_PER_GPU_PER_HOUR,
+    Accelerator.A100_80GB: A100_80GB_PER_GPU_PER_HOUR,
+}

From 354e8e312e331d836309906dd5d8b6256499caf8 Mon Sep 17 00:00:00 2001
From: Jack McCluskey <34928439+jrmccluskey@users.noreply.github.com>
Date: Tue, 10 Dec 2024 09:58:30 -0500
Subject: [PATCH 090/135] Replace None metric values with 0.0 in Dataflow Cost
 Benchmark (#33336)

---
 .../apache_beam/testing/load_tests/dataflow_cost_benchmark.py   | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/sdks/python/apache_beam/testing/load_tests/dataflow_cost_benchmark.py b/sdks/python/apache_beam/testing/load_tests/dataflow_cost_benchmark.py
index b60af1249756..96a1cd31e298 100644
--- a/sdks/python/apache_beam/testing/load_tests/dataflow_cost_benchmark.py
+++ b/sdks/python/apache_beam/testing/load_tests/dataflow_cost_benchmark.py
@@ -109,5 +109,7 @@ def _process_metrics_list(self,
       metric_key = entry.key
       metric = metric_key.metric
       if metric_key.step == '' and metric.namespace == 'dataflow/v1b3':
+        if entry.committed is None:
+          entry.committed = 0.0
         system_metrics[metric.name] = entry.committed
     return system_metrics

From 6d8e02e262951f26e8a4e835df462a219155bc11 Mon Sep 17 00:00:00 2001
From: Michel Davit <michel@davit.fr>
Date: Tue, 10 Dec 2024 18:36:44 +0100
Subject: [PATCH 091/135] [java] BQ: add missing avro conversions to BQ
 TableRow (#33221)

* [java] BQ: add missing avro conversions to BQ TableRow

Avro float fields can be used to write BQ FLOAT columns.
Add TableRow conversion for such field.

Adding conversion for aveo 1.10+ logical types local-timestamp-millis
and local-timestam-micros.

* Rework tests

* Add map and fixed types conversion

* Fix checkstyle

* Use valid parameters

* Test record nullable field
---
 .../io/gcp/bigquery/BigQueryAvroUtils.java    |  112 +-
 .../gcp/bigquery/BigQueryAvroUtilsTest.java   | 1037 +++++++++++------
 2 files changed, 746 insertions(+), 403 deletions(-)

diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryAvroUtils.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryAvroUtils.java
index cddde05b194c..1af44ba7a012 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryAvroUtils.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryAvroUtils.java
@@ -34,6 +34,8 @@
 import java.util.ArrayList;
 import java.util.HashSet;
 import java.util.List;
+import java.util.Map;
+import java.util.Optional;
 import java.util.Set;
 import org.apache.avro.Conversions;
 import org.apache.avro.LogicalType;
@@ -50,14 +52,14 @@
 import org.joda.time.format.DateTimeFormat;
 import org.joda.time.format.DateTimeFormatter;
 
-/**
- * A set of utilities for working with Avro files.
- *
- * <p>These utilities are based on the <a href="https://avro.apache.org/docs/1.8.1/spec.html">Avro
- * 1.8.1</a> specification.
- */
+/** A set of utilities for working with Avro files. */
 class BigQueryAvroUtils {
 
+  private static final String VERSION_AVRO =
+      Optional.ofNullable(Schema.class.getPackage())
+          .map(Package::getImplementationVersion)
+          .orElse("");
+
   // org.apache.avro.LogicalType
   static class DateTimeLogicalType extends LogicalType {
     public DateTimeLogicalType() {
@@ -74,6 +76,8 @@ public DateTimeLogicalType() {
    *     export</a>
    * @see <a href=https://cloud.google.com/bigquery/docs/reference/storage#avro_schema_details>BQ
    *     avro storage</a>
+   * @see <a href=https://cloud.google.com/bigquery/docs/loading-data-cloud-storage-avro>BQ avro
+   *     load</a>
    */
   static Schema getPrimitiveType(TableFieldSchema schema, Boolean useAvroLogicalTypes) {
     String bqType = schema.getType();
@@ -116,6 +120,9 @@ static Schema getPrimitiveType(TableFieldSchema schema, Boolean useAvroLogicalTy
         }
       case "DATETIME":
         if (useAvroLogicalTypes) {
+          // BQ export uses a custom logical type
+          // TODO for load/storage use
+          // LogicalTypes.date().addToSchema(SchemaBuilder.builder().intType())
           return DATETIME_LOGICAL_TYPE.addToSchema(SchemaBuilder.builder().stringType());
         } else {
           return SchemaBuilder.builder().stringBuilder().prop("sqlType", bqType).endString();
@@ -158,6 +165,12 @@ static Schema getPrimitiveType(TableFieldSchema schema, Boolean useAvroLogicalTy
 
   @VisibleForTesting
   static String formatTimestamp(Long timestampMicro) {
+    String dateTime = formatDatetime(timestampMicro);
+    return dateTime + " UTC";
+  }
+
+  @VisibleForTesting
+  static String formatDatetime(Long timestampMicro) {
     // timestampMicro is in "microseconds since epoch" format,
     // e.g., 1452062291123456L means "2016-01-06 06:38:11.123456 UTC".
     // Separate into seconds and microseconds.
@@ -168,11 +181,13 @@ static String formatTimestamp(Long timestampMicro) {
       timestampSec -= 1;
     }
     String dayAndTime = DATE_AND_SECONDS_FORMATTER.print(timestampSec * 1000);
-
     if (micros == 0) {
-      return String.format("%s UTC", dayAndTime);
+      return dayAndTime;
+    } else if (micros % 1000 == 0) {
+      return String.format("%s.%03d", dayAndTime, micros / 1000);
+    } else {
+      return String.format("%s.%06d", dayAndTime, micros);
     }
-    return String.format("%s.%06d UTC", dayAndTime, micros);
   }
 
   /**
@@ -274,8 +289,7 @@ static TableRow convertGenericRecordToTableRow(GenericRecord record) {
       case UNION:
         return convertNullableField(name, schema, v);
       case MAP:
-        throw new UnsupportedOperationException(
-            String.format("Unexpected Avro field schema type %s for field named %s", type, name));
+        return convertMapField(name, schema, v);
       default:
         return convertRequiredField(name, schema, v);
     }
@@ -296,6 +310,26 @@ private static List<Object> convertRepeatedField(String name, Schema elementType
     return values;
   }
 
+  private static List<TableRow> convertMapField(String name, Schema map, Object v) {
+    // Avro maps are represented as key/value RECORD.
+    if (v == null) {
+      // Handle the case of an empty map.
+      return new ArrayList<>();
+    }
+
+    Schema type = map.getValueType();
+    Map<String, Object> elements = (Map<String, Object>) v;
+    ArrayList<TableRow> values = new ArrayList<>();
+    for (Map.Entry<String, Object> element : elements.entrySet()) {
+      TableRow row =
+          new TableRow()
+              .set("key", element.getKey())
+              .set("value", convertRequiredField(name, type, element.getValue()));
+      values.add(row);
+    }
+    return values;
+  }
+
   private static Object convertRequiredField(String name, Schema schema, Object v) {
     // REQUIRED fields are represented as the corresponding Avro types. For example, a BigQuery
     // INTEGER type maps to an Avro LONG type.
@@ -305,45 +339,83 @@ private static Object convertRequiredField(String name, Schema schema, Object v)
     LogicalType logicalType = schema.getLogicalType();
     switch (type) {
       case BOOLEAN:
-        // SQL types BOOL, BOOLEAN
+        // SQL type BOOL (BOOLEAN)
         return v;
       case INT:
         if (logicalType instanceof LogicalTypes.Date) {
-          // SQL types DATE
+          // SQL type DATE
+          // ideally LocalDate but TableRowJsonCoder encodes as String
           return formatDate((Integer) v);
+        } else if (logicalType instanceof LogicalTypes.TimeMillis) {
+          // Write only: SQL type TIME
+          // ideally LocalTime but TableRowJsonCoder encodes as String
+          return formatTime(((Integer) v) * 1000L);
         } else {
-          throw new UnsupportedOperationException(
-              String.format("Unexpected Avro field schema type %s for field named %s", type, name));
+          // Write only: SQL type INT64 (INT, SMALLINT, INTEGER, BIGINT, TINYINT, BYTEINT)
+          // ideally Integer but keep consistency with BQ JSON export that uses String
+          return ((Integer) v).toString();
         }
       case LONG:
         if (logicalType instanceof LogicalTypes.TimeMicros) {
-          // SQL types TIME
+          // SQL type TIME
+          // ideally LocalTime but TableRowJsonCoder encodes as String
           return formatTime((Long) v);
+        } else if (logicalType instanceof LogicalTypes.TimestampMillis) {
+          // Write only: SQL type TIMESTAMP
+          // ideally Instant but TableRowJsonCoder encodes as String
+          return formatTimestamp((Long) v * 1000L);
         } else if (logicalType instanceof LogicalTypes.TimestampMicros) {
-          // SQL types TIMESTAMP
+          // SQL type TIMESTAMP
+          // ideally Instant but TableRowJsonCoder encodes as String
           return formatTimestamp((Long) v);
+        } else if (!(VERSION_AVRO.startsWith("1.8") || VERSION_AVRO.startsWith("1.9"))
+            && logicalType instanceof LogicalTypes.LocalTimestampMillis) {
+          // Write only: SQL type DATETIME
+          // ideally LocalDateTime but TableRowJsonCoder encodes as String
+          return formatDatetime(((Long) v) * 1000);
+        } else if (!(VERSION_AVRO.startsWith("1.8") || VERSION_AVRO.startsWith("1.9"))
+            && logicalType instanceof LogicalTypes.LocalTimestampMicros) {
+          // Write only: SQL type DATETIME
+          // ideally LocalDateTime but TableRowJsonCoder encodes as String
+          return formatDatetime((Long) v);
         } else {
-          // SQL types INT64 (INT, SMALLINT, INTEGER, BIGINT, TINYINT, BYTEINT)
+          // SQL type INT64 (INT, SMALLINT, INTEGER, BIGINT, TINYINT, BYTEINT)
+          // ideally Long if in [2^53+1, 2^53-1] but keep consistency with BQ JSON export that uses
+          // String
           return ((Long) v).toString();
         }
+      case FLOAT:
+        // Write only: SQL type FLOAT64
+        // ideally Float but TableRowJsonCoder decodes as Double
+        return Double.valueOf(v.toString());
       case DOUBLE:
-        // SQL types FLOAT64
+        // SQL type FLOAT64
         return v;
       case BYTES:
         if (logicalType instanceof LogicalTypes.Decimal) {
           // SQL tpe NUMERIC, BIGNUMERIC
+          // ideally BigDecimal but TableRowJsonCoder encodes as String
           return new Conversions.DecimalConversion()
               .fromBytes((ByteBuffer) v, schema, logicalType)
               .toString();
         } else {
-          // SQL types BYTES
+          // SQL type BYTES
+          // ideally byte[] but TableRowJsonCoder encodes as String
           return BaseEncoding.base64().encode(((ByteBuffer) v).array());
         }
       case STRING:
         // SQL types STRING, DATETIME, GEOGRAPHY, JSON
         // when not using logical type DATE, TIME too
         return v.toString();
+      case ENUM:
+        // SQL types STRING
+        return v.toString();
+      case FIXED:
+        // SQL type BYTES
+        // ideally byte[] but TableRowJsonCoder encodes as String
+        return BaseEncoding.base64().encode(((ByteBuffer) v).array());
       case RECORD:
+        // SQL types RECORD
         return convertGenericRecordToTableRow((GenericRecord) v);
       default:
         throw new UnsupportedOperationException(
diff --git a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryAvroUtilsTest.java b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryAvroUtilsTest.java
index 662f2658eb6b..2333278a11f5 100644
--- a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryAvroUtilsTest.java
+++ b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryAvroUtilsTest.java
@@ -28,23 +28,23 @@
 import java.math.BigDecimal;
 import java.nio.ByteBuffer;
 import java.nio.charset.StandardCharsets;
-import java.time.Instant;
-import java.util.ArrayList;
-import java.util.List;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.time.ZoneOffset;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.UUID;
+import java.util.function.Function;
 import org.apache.avro.Conversions;
 import org.apache.avro.LogicalType;
 import org.apache.avro.LogicalTypes;
 import org.apache.avro.Schema;
-import org.apache.avro.Schema.Field;
-import org.apache.avro.Schema.Type;
+import org.apache.avro.SchemaBuilder;
 import org.apache.avro.generic.GenericData;
 import org.apache.avro.generic.GenericRecord;
-import org.apache.avro.reflect.AvroSchema;
-import org.apache.avro.reflect.Nullable;
-import org.apache.avro.reflect.ReflectData;
+import org.apache.avro.generic.GenericRecordBuilder;
 import org.apache.avro.util.Utf8;
-import org.apache.beam.sdk.extensions.avro.coders.AvroCoder;
-import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableList;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.Lists;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.io.BaseEncoding;
 import org.junit.Test;
@@ -54,363 +54,678 @@
 /** Tests for {@link BigQueryAvroUtils}. */
 @RunWith(JUnit4.class)
 public class BigQueryAvroUtilsTest {
-  private List<TableFieldSchema> subFields =
-      Lists.newArrayList(
-          new TableFieldSchema().setName("species").setType("STRING").setMode("NULLABLE"));
-  /*
-   * Note that the quality and quantity fields do not have their mode set, so they should default
-   * to NULLABLE. This is an important test of BigQuery semantics.
-   *
-   * All the other fields we set in this function are required on the Schema response.
-   *
-   * See https://cloud.google.com/bigquery/docs/reference/v2/tables#schema
-   */
-  private List<TableFieldSchema> fields =
-      Lists.newArrayList(
-          new TableFieldSchema().setName("number").setType("INTEGER").setMode("REQUIRED"),
-          new TableFieldSchema().setName("species").setType("STRING").setMode("NULLABLE"),
-          new TableFieldSchema().setName("quality").setType("FLOAT") /* default to NULLABLE */,
-          new TableFieldSchema().setName("quantity").setType("INTEGER") /* default to NULLABLE */,
-          new TableFieldSchema().setName("birthday").setType("TIMESTAMP").setMode("NULLABLE"),
-          new TableFieldSchema().setName("birthdayMoney").setType("NUMERIC").setMode("NULLABLE"),
-          new TableFieldSchema()
-              .setName("lotteryWinnings")
-              .setType("BIGNUMERIC")
-              .setMode("NULLABLE"),
-          new TableFieldSchema().setName("flighted").setType("BOOLEAN").setMode("NULLABLE"),
-          new TableFieldSchema().setName("sound").setType("BYTES").setMode("NULLABLE"),
-          new TableFieldSchema().setName("anniversaryDate").setType("DATE").setMode("NULLABLE"),
-          new TableFieldSchema()
-              .setName("anniversaryDatetime")
-              .setType("DATETIME")
-              .setMode("NULLABLE"),
-          new TableFieldSchema().setName("anniversaryTime").setType("TIME").setMode("NULLABLE"),
-          new TableFieldSchema()
-              .setName("scion")
-              .setType("RECORD")
-              .setMode("NULLABLE")
-              .setFields(subFields),
-          new TableFieldSchema()
-              .setName("associates")
-              .setType("RECORD")
-              .setMode("REPEATED")
-              .setFields(subFields),
-          new TableFieldSchema().setName("geoPositions").setType("GEOGRAPHY").setMode("NULLABLE"));
-
-  private ByteBuffer convertToBytes(BigDecimal bigDecimal, int precision, int scale) {
-    LogicalType bigDecimalLogicalType = LogicalTypes.decimal(precision, scale);
-    return new Conversions.DecimalConversion().toBytes(bigDecimal, null, bigDecimalLogicalType);
+
+  private TableSchema tableSchema(Function<TableFieldSchema, TableFieldSchema> fn) {
+    TableFieldSchema column = new TableFieldSchema().setName("value");
+    TableSchema tableSchema = new TableSchema();
+    tableSchema.setFields(Lists.newArrayList(fn.apply(column)));
+    return tableSchema;
+  }
+
+  private Schema avroSchema(
+      Function<SchemaBuilder.FieldBuilder<Schema>, SchemaBuilder.FieldAssembler<Schema>> fn) {
+    return fn.apply(
+            SchemaBuilder.record("root")
+                .namespace("org.apache.beam.sdk.io.gcp.bigquery")
+                .doc("Translated Avro Schema for root")
+                .fields()
+                .name("value"))
+        .endRecord();
   }
 
+  @SuppressWarnings("JavaInstantGetSecondsGetNano")
   @Test
-  public void testConvertGenericRecordToTableRow() throws Exception {
-    BigDecimal numeric = new BigDecimal("123456789.123456789");
-    ByteBuffer numericBytes = convertToBytes(numeric, 38, 9);
-    BigDecimal bigNumeric =
-        new BigDecimal(
-            "578960446186580977117854925043439539266.34992332820282019728792003956564819967");
-    ByteBuffer bigNumericBytes = convertToBytes(bigNumeric, 77, 38);
-    Schema avroSchema = ReflectData.get().getSchema(Bird.class);
-
-    {
-      // Test nullable fields.
-      GenericRecord record = new GenericData.Record(avroSchema);
-      record.put("number", 5L);
-      TableRow convertedRow = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
-      TableRow row = new TableRow().set("number", "5").set("associates", new ArrayList<TableRow>());
-      assertEquals(row, convertedRow);
-      TableRow clonedRow = convertedRow.clone();
-      assertEquals(convertedRow, clonedRow);
-    }
-    {
-      // Test type conversion for:
-      // INTEGER, FLOAT, NUMERIC, TIMESTAMP, BOOLEAN, BYTES, DATE, DATETIME, TIME.
-      GenericRecord record = new GenericData.Record(avroSchema);
-      byte[] soundBytes = "chirp,chirp".getBytes(StandardCharsets.UTF_8);
-      ByteBuffer soundByteBuffer = ByteBuffer.wrap(soundBytes);
-      soundByteBuffer.rewind();
-      record.put("number", 5L);
-      record.put("quality", 5.0);
-      record.put("birthday", 5L);
-      record.put("birthdayMoney", numericBytes);
-      record.put("lotteryWinnings", bigNumericBytes);
-      record.put("flighted", Boolean.TRUE);
-      record.put("sound", soundByteBuffer);
-      record.put("anniversaryDate", new Utf8("2000-01-01"));
-      record.put("anniversaryDatetime", new String("2000-01-01 00:00:00.000005"));
-      record.put("anniversaryTime", new Utf8("00:00:00.000005"));
-      record.put("geoPositions", new String("LINESTRING(1 2, 3 4, 5 6, 7 8)"));
-      TableRow convertedRow = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
-      TableRow row =
-          new TableRow()
-              .set("number", "5")
-              .set("birthday", "1970-01-01 00:00:00.000005 UTC")
-              .set("birthdayMoney", numeric.toString())
-              .set("lotteryWinnings", bigNumeric.toString())
-              .set("quality", 5.0)
-              .set("associates", new ArrayList<TableRow>())
-              .set("flighted", Boolean.TRUE)
-              .set("sound", BaseEncoding.base64().encode(soundBytes))
-              .set("anniversaryDate", "2000-01-01")
-              .set("anniversaryDatetime", "2000-01-01 00:00:00.000005")
-              .set("anniversaryTime", "00:00:00.000005")
-              .set("geoPositions", "LINESTRING(1 2, 3 4, 5 6, 7 8)");
-      TableRow clonedRow = convertedRow.clone();
-      assertEquals(convertedRow, clonedRow);
-      assertEquals(row, convertedRow);
-    }
-    {
-      // Test repeated fields.
-      Schema subBirdSchema = AvroCoder.of(Bird.SubBird.class).getSchema();
-      GenericRecord nestedRecord = new GenericData.Record(subBirdSchema);
-      nestedRecord.put("species", "other");
-      GenericRecord record = new GenericData.Record(avroSchema);
-      record.put("number", 5L);
-      record.put("associates", Lists.newArrayList(nestedRecord));
-      record.put("birthdayMoney", numericBytes);
-      record.put("lotteryWinnings", bigNumericBytes);
-      TableRow convertedRow = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
-      TableRow row =
+  public void testConvertGenericRecordToTableRow() {
+    {
+      // bool
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type().booleanType().noDefault()))
+              .set("value", false)
+              .build();
+      TableRow expected = new TableRow().set("value", false);
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // int
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type().intType().noDefault()))
+              .set("value", 5)
+              .build();
+      TableRow expected = new TableRow().set("value", "5");
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // long
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type().longType().noDefault()))
+              .set("value", 5L)
+              .build();
+      TableRow expected = new TableRow().set("value", "5");
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // float
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type().floatType().noDefault()))
+              .set("value", 5.5f)
+              .build();
+      TableRow expected = new TableRow().set("value", 5.5);
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // double
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type().doubleType().noDefault()))
+              .set("value", 5.55)
+              .build();
+      TableRow expected = new TableRow().set("value", 5.55);
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // bytes
+      byte[] bytes = "chirp,chirp".getBytes(StandardCharsets.UTF_8);
+      ByteBuffer bb = ByteBuffer.wrap(bytes);
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type().bytesType().noDefault()))
+              .set("value", bb)
+              .build();
+      TableRow expected = new TableRow().set("value", BaseEncoding.base64().encode(bytes));
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // string
+      Schema schema = avroSchema(f -> f.type().stringType().noDefault());
+      GenericRecord record = new GenericRecordBuilder(schema).set("value", "test").build();
+      GenericRecord utf8Record =
+          new GenericRecordBuilder(schema).set("value", new Utf8("test")).build();
+      TableRow expected = new TableRow().set("value", "test");
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+      TableRow utf8Row = BigQueryAvroUtils.convertGenericRecordToTableRow(utf8Record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+      assertEquals(expected, utf8Row);
+      assertEquals(expected, utf8Row.clone());
+    }
+
+    {
+      // decimal
+      LogicalType lt = LogicalTypes.decimal(38, 9);
+      Schema decimalType = lt.addToSchema(SchemaBuilder.builder().bytesType());
+      BigDecimal bd = new BigDecimal("123456789.123456789");
+      ByteBuffer bytes = new Conversions.DecimalConversion().toBytes(bd, null, lt);
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type(decimalType).noDefault()))
+              .set("value", bytes)
+              .build();
+      TableRow expected = new TableRow().set("value", bd.toString());
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // date
+      LogicalType lt = LogicalTypes.date();
+      Schema dateType = lt.addToSchema(SchemaBuilder.builder().intType());
+      LocalDate date = LocalDate.of(2000, 1, 1);
+      int days = (int) date.toEpochDay();
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type(dateType).noDefault()))
+              .set("value", days)
+              .build();
+      TableRow expected = new TableRow().set("value", "2000-01-01");
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // time-millis
+      LogicalType lt = LogicalTypes.timeMillis();
+      Schema timeType = lt.addToSchema(SchemaBuilder.builder().intType());
+      LocalTime time = LocalTime.of(1, 2, 3, 123456789);
+      int millis = (int) (time.toNanoOfDay() / 1000000);
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type(timeType).noDefault()))
+              .set("value", millis)
+              .build();
+      TableRow expected = new TableRow().set("value", "01:02:03.123");
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // time-micros
+      LogicalType lt = LogicalTypes.timeMicros();
+      Schema timeType = lt.addToSchema(SchemaBuilder.builder().longType());
+      LocalTime time = LocalTime.of(1, 2, 3, 123456789);
+      long micros = time.toNanoOfDay() / 1000;
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type(timeType).noDefault()))
+              .set("value", micros)
+              .build();
+      TableRow expected = new TableRow().set("value", "01:02:03.123456");
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // local-timestamp-millis
+      LogicalType lt = LogicalTypes.localTimestampMillis();
+      Schema timestampType = lt.addToSchema(SchemaBuilder.builder().longType());
+      LocalDate date = LocalDate.of(2000, 1, 1);
+      LocalTime time = LocalTime.of(1, 2, 3, 123456789);
+      LocalDateTime ts = LocalDateTime.of(date, time);
+      long millis = ts.toInstant(ZoneOffset.UTC).toEpochMilli();
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type(timestampType).noDefault()))
+              .set("value", millis)
+              .build();
+      TableRow expected = new TableRow().set("value", "2000-01-01 01:02:03.123");
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // local-timestamp-micros
+      LogicalType lt = LogicalTypes.localTimestampMicros();
+      Schema timestampType = lt.addToSchema(SchemaBuilder.builder().longType());
+      LocalDate date = LocalDate.of(2000, 1, 1);
+      LocalTime time = LocalTime.of(1, 2, 3, 123456789);
+      LocalDateTime ts = LocalDateTime.of(date, time);
+      long seconds = ts.toInstant(ZoneOffset.UTC).getEpochSecond();
+      int nanos = ts.toInstant(ZoneOffset.UTC).getNano();
+      long micros = seconds * 1000000 + (nanos / 1000);
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type(timestampType).noDefault()))
+              .set("value", micros)
+              .build();
+      TableRow expected = new TableRow().set("value", "2000-01-01 01:02:03.123456");
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // timestamp-micros
+      LogicalType lt = LogicalTypes.timestampMillis();
+      Schema timestampType = lt.addToSchema(SchemaBuilder.builder().longType());
+      LocalDate date = LocalDate.of(2000, 1, 1);
+      LocalTime time = LocalTime.of(1, 2, 3, 123456789);
+      LocalDateTime ts = LocalDateTime.of(date, time);
+      long millis = ts.toInstant(ZoneOffset.UTC).toEpochMilli();
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type(timestampType).noDefault()))
+              .set("value", millis)
+              .build();
+      TableRow expected = new TableRow().set("value", "2000-01-01 01:02:03.123 UTC");
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // timestamp-millis
+      LogicalType lt = LogicalTypes.timestampMicros();
+      Schema timestampType = lt.addToSchema(SchemaBuilder.builder().longType());
+      LocalDate date = LocalDate.of(2000, 1, 1);
+      LocalTime time = LocalTime.of(1, 2, 3, 123456789);
+      LocalDateTime ts = LocalDateTime.of(date, time);
+      long seconds = ts.toInstant(ZoneOffset.UTC).getEpochSecond();
+      int nanos = ts.toInstant(ZoneOffset.UTC).getNano();
+      long micros = seconds * 1000000 + (nanos / 1000);
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type(timestampType).noDefault()))
+              .set("value", micros)
+              .build();
+      TableRow expected = new TableRow().set("value", "2000-01-01 01:02:03.123456 UTC");
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // enum
+      Schema enumSchema = SchemaBuilder.enumeration("color").symbols("red", "green", "blue");
+      GenericData.EnumSymbol symbol = new GenericData.EnumSymbol(enumSchema, "RED");
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type(enumSchema).noDefault()))
+              .set("value", symbol)
+              .build();
+      TableRow expected = new TableRow().set("value", "RED");
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // fixed
+      UUID uuid = UUID.randomUUID();
+      ByteBuffer bb = ByteBuffer.allocate(16);
+      bb.putLong(uuid.getMostSignificantBits());
+      bb.putLong(uuid.getLeastSignificantBits());
+      bb.rewind();
+      byte[] bytes = bb.array();
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type().fixed("uuid").size(16).noDefault()))
+              .set("value", bb)
+              .build();
+      TableRow expected = new TableRow().set("value", BaseEncoding.base64().encode(bytes));
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // null
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type().optional().booleanType())).build();
+      TableRow expected = new TableRow();
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // array
+      GenericRecord record =
+          new GenericRecordBuilder(
+                  avroSchema(f -> f.type().array().items().booleanType().noDefault()))
+              .set("value", Lists.newArrayList(true, false))
+              .build();
+      TableRow expected = new TableRow().set("value", Lists.newArrayList(true, false));
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // map
+      Map<String, Integer> map = new HashMap<>();
+      map.put("left", 1);
+      map.put("right", -1);
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type().map().values().intType().noDefault()))
+              .set("value", map)
+              .build();
+      TableRow expected =
           new TableRow()
-              .set("associates", Lists.newArrayList(new TableRow().set("species", "other")))
-              .set("number", "5")
-              .set("birthdayMoney", numeric.toString())
-              .set("lotteryWinnings", bigNumeric.toString());
-      assertEquals(row, convertedRow);
-      TableRow clonedRow = convertedRow.clone();
-      assertEquals(convertedRow, clonedRow);
+              .set(
+                  "value",
+                  Lists.newArrayList(
+                      new TableRow().set("key", "left").set("value", "1"),
+                      new TableRow().set("key", "right").set("value", "-1")));
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
+    }
+
+    {
+      // record
+      Schema subSchema =
+          SchemaBuilder.builder()
+              .record("record")
+              .fields()
+              .name("int")
+              .type()
+              .intType()
+              .noDefault()
+              .name("float")
+              .type()
+              .floatType()
+              .noDefault()
+              .endRecord();
+      GenericRecord subRecord =
+          new GenericRecordBuilder(subSchema).set("int", 5).set("float", 5.5f).build();
+      GenericRecord record =
+          new GenericRecordBuilder(avroSchema(f -> f.type(subSchema).noDefault()))
+              .set("value", subRecord)
+              .build();
+      TableRow expected =
+          new TableRow().set("value", new TableRow().set("int", "5").set("float", 5.5));
+      TableRow row = BigQueryAvroUtils.convertGenericRecordToTableRow(record);
+
+      assertEquals(expected, row);
+      assertEquals(expected, row.clone());
     }
   }
 
   @Test
   public void testConvertBigQuerySchemaToAvroSchema() {
-    TableSchema tableSchema = new TableSchema();
-    tableSchema.setFields(fields);
-    Schema avroSchema = BigQueryAvroUtils.toGenericAvroSchema(tableSchema);
+    {
+      // REQUIRED
+      TableSchema tableSchema = tableSchema(f -> f.setType("BOOLEAN").setMode("REQUIRED"));
+      Schema expected = avroSchema(f -> f.type().booleanType().noDefault());
 
-    assertThat(avroSchema.getField("number").schema(), equalTo(Schema.create(Type.LONG)));
-    assertThat(
-        avroSchema.getField("species").schema(),
-        equalTo(Schema.createUnion(Schema.create(Type.NULL), Schema.create(Type.STRING))));
-    assertThat(
-        avroSchema.getField("quality").schema(),
-        equalTo(Schema.createUnion(Schema.create(Type.NULL), Schema.create(Type.DOUBLE))));
-    assertThat(
-        avroSchema.getField("quantity").schema(),
-        equalTo(Schema.createUnion(Schema.create(Type.NULL), Schema.create(Type.LONG))));
-    assertThat(
-        avroSchema.getField("birthday").schema(),
-        equalTo(
-            Schema.createUnion(
-                Schema.create(Type.NULL),
-                LogicalTypes.timestampMicros().addToSchema(Schema.create(Type.LONG)))));
-    assertThat(
-        avroSchema.getField("birthdayMoney").schema(),
-        equalTo(
-            Schema.createUnion(
-                Schema.create(Type.NULL),
-                LogicalTypes.decimal(38, 9).addToSchema(Schema.create(Type.BYTES)))));
-    assertThat(
-        avroSchema.getField("lotteryWinnings").schema(),
-        equalTo(
-            Schema.createUnion(
-                Schema.create(Type.NULL),
-                LogicalTypes.decimal(77, 38).addToSchema(Schema.create(Type.BYTES)))));
-    assertThat(
-        avroSchema.getField("flighted").schema(),
-        equalTo(Schema.createUnion(Schema.create(Type.NULL), Schema.create(Type.BOOLEAN))));
-    assertThat(
-        avroSchema.getField("sound").schema(),
-        equalTo(Schema.createUnion(Schema.create(Type.NULL), Schema.create(Type.BYTES))));
-    Schema dateSchema = Schema.create(Type.INT);
-    LogicalTypes.date().addToSchema(dateSchema);
-    assertThat(
-        avroSchema.getField("anniversaryDate").schema(),
-        equalTo(Schema.createUnion(Schema.create(Type.NULL), dateSchema)));
-    Schema dateTimeSchema = Schema.create(Type.STRING);
-    BigQueryAvroUtils.DATETIME_LOGICAL_TYPE.addToSchema(dateTimeSchema);
-    assertThat(
-        avroSchema.getField("anniversaryDatetime").schema(),
-        equalTo(Schema.createUnion(Schema.create(Type.NULL), dateTimeSchema)));
-    Schema timeSchema = Schema.create(Type.LONG);
-    LogicalTypes.timeMicros().addToSchema(timeSchema);
-    assertThat(
-        avroSchema.getField("anniversaryTime").schema(),
-        equalTo(Schema.createUnion(Schema.create(Type.NULL), timeSchema)));
-    Schema geoSchema = Schema.create(Type.STRING);
-    geoSchema.addProp("sqlType", "GEOGRAPHY");
-    assertThat(
-        avroSchema.getField("geoPositions").schema(),
-        equalTo(Schema.createUnion(Schema.create(Type.NULL), geoSchema)));
-    assertThat(
-        avroSchema.getField("scion").schema(),
-        equalTo(
-            Schema.createUnion(
-                Schema.create(Type.NULL),
-                Schema.createRecord(
-                    "scion",
-                    "Translated Avro Schema for scion",
-                    "org.apache.beam.sdk.io.gcp.bigquery",
-                    false,
-                    ImmutableList.of(
-                        new Field(
-                            "species",
-                            Schema.createUnion(
-                                Schema.create(Type.NULL), Schema.create(Type.STRING)),
-                            null,
-                            (Object) null))))));
-    assertThat(
-        avroSchema.getField("associates").schema(),
-        equalTo(
-            Schema.createArray(
-                Schema.createRecord(
-                    "associates",
-                    "Translated Avro Schema for associates",
-                    "org.apache.beam.sdk.io.gcp.bigquery",
-                    false,
-                    ImmutableList.of(
-                        new Field(
-                            "species",
-                            Schema.createUnion(
-                                Schema.create(Type.NULL), Schema.create(Type.STRING)),
-                            null,
-                            (Object) null))))));
-  }
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+    }
 
-  @Test
-  public void testConvertBigQuerySchemaToAvroSchemaWithoutLogicalTypes() {
-    TableSchema tableSchema = new TableSchema();
-    tableSchema.setFields(fields);
-    Schema avroSchema = BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false);
+    {
+      // NULLABLE
+      TableSchema tableSchema = tableSchema(f -> f.setType("BOOLEAN").setMode("NULLABLE"));
+      Schema expected =
+          avroSchema(f -> f.type().unionOf().nullType().and().booleanType().endUnion().noDefault());
 
-    assertThat(avroSchema.getField("number").schema(), equalTo(Schema.create(Schema.Type.LONG)));
-    assertThat(
-        avroSchema.getField("species").schema(),
-        equalTo(
-            Schema.createUnion(
-                Schema.create(Schema.Type.NULL), Schema.create(Schema.Type.STRING))));
-    assertThat(
-        avroSchema.getField("quality").schema(),
-        equalTo(
-            Schema.createUnion(
-                Schema.create(Schema.Type.NULL), Schema.create(Schema.Type.DOUBLE))));
-    assertThat(
-        avroSchema.getField("quantity").schema(),
-        equalTo(
-            Schema.createUnion(Schema.create(Schema.Type.NULL), Schema.create(Schema.Type.LONG))));
-    assertThat(
-        avroSchema.getField("birthday").schema(),
-        equalTo(
-            Schema.createUnion(
-                Schema.create(Schema.Type.NULL),
-                LogicalTypes.timestampMicros().addToSchema(Schema.create(Schema.Type.LONG)))));
-    assertThat(
-        avroSchema.getField("birthdayMoney").schema(),
-        equalTo(
-            Schema.createUnion(
-                Schema.create(Schema.Type.NULL),
-                LogicalTypes.decimal(38, 9).addToSchema(Schema.create(Schema.Type.BYTES)))));
-    assertThat(
-        avroSchema.getField("lotteryWinnings").schema(),
-        equalTo(
-            Schema.createUnion(
-                Schema.create(Schema.Type.NULL),
-                LogicalTypes.decimal(77, 38).addToSchema(Schema.create(Schema.Type.BYTES)))));
-    assertThat(
-        avroSchema.getField("flighted").schema(),
-        equalTo(
-            Schema.createUnion(
-                Schema.create(Schema.Type.NULL), Schema.create(Schema.Type.BOOLEAN))));
-    assertThat(
-        avroSchema.getField("sound").schema(),
-        equalTo(
-            Schema.createUnion(Schema.create(Schema.Type.NULL), Schema.create(Schema.Type.BYTES))));
-    Schema dateSchema = Schema.create(Schema.Type.STRING);
-    dateSchema.addProp("sqlType", "DATE");
-    assertThat(
-        avroSchema.getField("anniversaryDate").schema(),
-        equalTo(Schema.createUnion(Schema.create(Schema.Type.NULL), dateSchema)));
-    Schema dateTimeSchema = Schema.create(Schema.Type.STRING);
-    dateTimeSchema.addProp("sqlType", "DATETIME");
-    assertThat(
-        avroSchema.getField("anniversaryDatetime").schema(),
-        equalTo(Schema.createUnion(Schema.create(Schema.Type.NULL), dateTimeSchema)));
-    Schema timeSchema = Schema.create(Schema.Type.STRING);
-    timeSchema.addProp("sqlType", "TIME");
-    assertThat(
-        avroSchema.getField("anniversaryTime").schema(),
-        equalTo(Schema.createUnion(Schema.create(Schema.Type.NULL), timeSchema)));
-    Schema geoSchema = Schema.create(Type.STRING);
-    geoSchema.addProp("sqlType", "GEOGRAPHY");
-    assertThat(
-        avroSchema.getField("geoPositions").schema(),
-        equalTo(Schema.createUnion(Schema.create(Schema.Type.NULL), geoSchema)));
-    assertThat(
-        avroSchema.getField("scion").schema(),
-        equalTo(
-            Schema.createUnion(
-                Schema.create(Schema.Type.NULL),
-                Schema.createRecord(
-                    "scion",
-                    "Translated Avro Schema for scion",
-                    "org.apache.beam.sdk.io.gcp.bigquery",
-                    false,
-                    ImmutableList.of(
-                        new Schema.Field(
-                            "species",
-                            Schema.createUnion(
-                                Schema.create(Schema.Type.NULL), Schema.create(Schema.Type.STRING)),
-                            null,
-                            (Object) null))))));
-    assertThat(
-        avroSchema.getField("associates").schema(),
-        equalTo(
-            Schema.createArray(
-                Schema.createRecord(
-                    "associates",
-                    "Translated Avro Schema for associates",
-                    "org.apache.beam.sdk.io.gcp.bigquery",
-                    false,
-                    ImmutableList.of(
-                        new Schema.Field(
-                            "species",
-                            Schema.createUnion(
-                                Schema.create(Schema.Type.NULL), Schema.create(Schema.Type.STRING)),
-                            null,
-                            (Object) null))))));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+    }
+
+    {
+      // default mode -> NULLABLE
+      TableSchema tableSchema = tableSchema(f -> f.setType("BOOLEAN"));
+      Schema expected =
+          avroSchema(f -> f.type().unionOf().nullType().and().booleanType().endUnion().noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+    }
+
+    {
+      // REPEATED
+      TableSchema tableSchema = tableSchema(f -> f.setType("BOOLEAN").setMode("REPEATED"));
+      Schema expected = avroSchema(f -> f.type().array().items().booleanType().noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+    }
+
+    {
+      // INTEGER
+      TableSchema tableSchema = tableSchema(f -> f.setType("INTEGER").setMode("REQUIRED"));
+      Schema expected = avroSchema(f -> f.type().longType().noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+    }
+
+    {
+      // FLOAT
+      TableSchema tableSchema = tableSchema(f -> f.setType("FLOAT").setMode("REQUIRED"));
+      Schema expected = avroSchema(f -> f.type().doubleType().noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // BYTES
+      TableSchema tableSchema = tableSchema(f -> f.setType("BYTES").setMode("REQUIRED"));
+      Schema expected = avroSchema(f -> f.type().bytesType().noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // STRING
+      TableSchema tableSchema = tableSchema(f -> f.setType("STRING").setMode("REQUIRED"));
+      Schema expected = avroSchema(f -> f.type().stringType().noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // NUMERIC
+      TableSchema tableSchema = tableSchema(f -> f.setType("NUMERIC").setMode("REQUIRED"));
+      Schema decimalType =
+          LogicalTypes.decimal(38, 9).addToSchema(SchemaBuilder.builder().bytesType());
+      Schema expected = avroSchema(f -> f.type(decimalType).noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // NUMERIC with precision
+      TableSchema tableSchema =
+          tableSchema(f -> f.setType("NUMERIC").setPrecision(29L).setMode("REQUIRED"));
+      Schema decimalType =
+          LogicalTypes.decimal(29, 0).addToSchema(SchemaBuilder.builder().bytesType());
+      Schema expected = avroSchema(f -> f.type(decimalType).noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // NUMERIC with precision and scale
+      TableSchema tableSchema =
+          tableSchema(f -> f.setType("NUMERIC").setPrecision(10L).setScale(9L).setMode("REQUIRED"));
+      Schema decimalType =
+          LogicalTypes.decimal(10, 9).addToSchema(SchemaBuilder.builder().bytesType());
+      Schema expected = avroSchema(f -> f.type(decimalType).noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // BIGNUMERIC
+      TableSchema tableSchema = tableSchema(f -> f.setType("BIGNUMERIC").setMode("REQUIRED"));
+      Schema decimalType =
+          LogicalTypes.decimal(77, 38).addToSchema(SchemaBuilder.builder().bytesType());
+      Schema expected = avroSchema(f -> f.type(decimalType).noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // BIGNUMERIC with precision
+      TableSchema tableSchema =
+          tableSchema(f -> f.setType("BIGNUMERIC").setPrecision(38L).setMode("REQUIRED"));
+      Schema decimalType =
+          LogicalTypes.decimal(38, 0).addToSchema(SchemaBuilder.builder().bytesType());
+      Schema expected = avroSchema(f -> f.type(decimalType).noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // BIGNUMERIC with precision and scale
+      TableSchema tableSchema =
+          tableSchema(
+              f -> f.setType("BIGNUMERIC").setPrecision(39L).setScale(38L).setMode("REQUIRED"));
+      Schema decimalType =
+          LogicalTypes.decimal(39, 38).addToSchema(SchemaBuilder.builder().bytesType());
+      Schema expected = avroSchema(f -> f.type(decimalType).noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // DATE
+      TableSchema tableSchema = tableSchema(f -> f.setType("DATE").setMode("REQUIRED"));
+      Schema dateType = LogicalTypes.date().addToSchema(SchemaBuilder.builder().intType());
+      Schema expected = avroSchema(f -> f.type(dateType).noDefault());
+      Schema expectedExport =
+          avroSchema(f -> f.type().stringBuilder().prop("sqlType", "DATE").endString().noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expectedExport, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // TIME
+      TableSchema tableSchema = tableSchema(f -> f.setType("TIME").setMode("REQUIRED"));
+      Schema timeType = LogicalTypes.timeMicros().addToSchema(SchemaBuilder.builder().longType());
+      Schema expected = avroSchema(f -> f.type(timeType).noDefault());
+      Schema expectedExport =
+          avroSchema(f -> f.type().stringBuilder().prop("sqlType", "TIME").endString().noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expectedExport, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // DATETIME
+      TableSchema tableSchema = tableSchema(f -> f.setType("DATETIME").setMode("REQUIRED"));
+      Schema timeType =
+          BigQueryAvroUtils.DATETIME_LOGICAL_TYPE.addToSchema(SchemaBuilder.builder().stringType());
+      Schema expected = avroSchema(f -> f.type(timeType).noDefault());
+      Schema expectedExport =
+          avroSchema(
+              f -> f.type().stringBuilder().prop("sqlType", "DATETIME").endString().noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expectedExport, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // TIMESTAMP
+      TableSchema tableSchema = tableSchema(f -> f.setType("TIMESTAMP").setMode("REQUIRED"));
+      Schema timestampType =
+          LogicalTypes.timestampMicros().addToSchema(SchemaBuilder.builder().longType());
+      Schema expected = avroSchema(f -> f.type(timestampType).noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // GEOGRAPHY
+      TableSchema tableSchema = tableSchema(f -> f.setType("GEOGRAPHY").setMode("REQUIRED"));
+      Schema expected =
+          avroSchema(
+              f -> f.type().stringBuilder().prop("sqlType", "GEOGRAPHY").endString().noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // JSON
+      TableSchema tableSchema = tableSchema(f -> f.setType("JSON").setMode("REQUIRED"));
+      Schema expected =
+          avroSchema(f -> f.type().stringBuilder().prop("sqlType", "JSON").endString().noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(tableSchema, false));
+    }
+
+    {
+      // STRUCT/RECORD
+      TableFieldSchema subInteger =
+          new TableFieldSchema().setName("int").setType("INTEGER").setMode("NULLABLE");
+      TableFieldSchema subFloat =
+          new TableFieldSchema().setName("float").setType("FLOAT").setMode("REQUIRED");
+      TableSchema structTableSchema =
+          tableSchema(
+              f ->
+                  f.setType("STRUCT")
+                      .setMode("REQUIRED")
+                      .setFields(Lists.newArrayList(subInteger, subFloat)));
+      TableSchema recordTableSchema =
+          tableSchema(
+              f ->
+                  f.setType("RECORD")
+                      .setMode("REQUIRED")
+                      .setFields(Lists.newArrayList(subInteger, subFloat)));
+
+      Schema expected =
+          avroSchema(
+              f ->
+                  f.type()
+                      .record("value")
+                      .fields()
+                      .name("int")
+                      .type()
+                      .unionOf()
+                      .nullType()
+                      .and()
+                      .longType()
+                      .endUnion()
+                      .noDefault()
+                      .name("float")
+                      .type()
+                      .doubleType()
+                      .noDefault()
+                      .endRecord()
+                      .noDefault());
+
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(structTableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(structTableSchema, false));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(recordTableSchema));
+      assertEquals(expected, BigQueryAvroUtils.toGenericAvroSchema(recordTableSchema, false));
+    }
   }
 
   @Test
   public void testFormatTimestamp() {
-    assertThat(
-        BigQueryAvroUtils.formatTimestamp(1452062291123456L),
-        equalTo("2016-01-06 06:38:11.123456 UTC"));
+    long micros = 1452062291123456L;
+    String expected = "2016-01-06 06:38:11.123456";
+    assertThat(BigQueryAvroUtils.formatDatetime(micros), equalTo(expected));
+    assertThat(BigQueryAvroUtils.formatTimestamp(micros), equalTo(expected + " UTC"));
   }
 
   @Test
-  public void testFormatTimestampLeadingZeroesOnMicros() {
-    assertThat(
-        BigQueryAvroUtils.formatTimestamp(1452062291000456L),
-        equalTo("2016-01-06 06:38:11.000456 UTC"));
+  public void testFormatTimestampMillis() {
+    long millis = 1452062291123L;
+    long micros = millis * 1000L;
+    String expected = "2016-01-06 06:38:11.123";
+    assertThat(BigQueryAvroUtils.formatDatetime(micros), equalTo(expected));
+    assertThat(BigQueryAvroUtils.formatTimestamp(micros), equalTo(expected + " UTC"));
   }
 
   @Test
-  public void testFormatTimestampTrailingZeroesOnMicros() {
-    assertThat(
-        BigQueryAvroUtils.formatTimestamp(1452062291123000L),
-        equalTo("2016-01-06 06:38:11.123000 UTC"));
+  public void testFormatTimestampSeconds() {
+    long seconds = 1452062291L;
+    long micros = seconds * 1000L * 1000L;
+    String expected = "2016-01-06 06:38:11";
+    assertThat(BigQueryAvroUtils.formatDatetime(micros), equalTo(expected));
+    assertThat(BigQueryAvroUtils.formatTimestamp(micros), equalTo(expected + " UTC"));
   }
 
   @Test
   public void testFormatTimestampNegative() {
-    assertThat(BigQueryAvroUtils.formatTimestamp(-1L), equalTo("1969-12-31 23:59:59.999999 UTC"));
-    assertThat(
-        BigQueryAvroUtils.formatTimestamp(-100_000L), equalTo("1969-12-31 23:59:59.900000 UTC"));
-    assertThat(BigQueryAvroUtils.formatTimestamp(-1_000_000L), equalTo("1969-12-31 23:59:59 UTC"));
+    assertThat(BigQueryAvroUtils.formatDatetime(-1L), equalTo("1969-12-31 23:59:59.999999"));
+    assertThat(BigQueryAvroUtils.formatDatetime(-100_000L), equalTo("1969-12-31 23:59:59.900"));
+    assertThat(BigQueryAvroUtils.formatDatetime(-1_000_000L), equalTo("1969-12-31 23:59:59"));
     // No leap seconds before 1972. 477 leap years from 1 through 1969.
     assertThat(
-        BigQueryAvroUtils.formatTimestamp(-(1969L * 365 + 477) * 86400 * 1_000_000),
-        equalTo("0001-01-01 00:00:00 UTC"));
+        BigQueryAvroUtils.formatDatetime(-(1969L * 365 + 477) * 86400 * 1_000_000),
+        equalTo("0001-01-01 00:00:00"));
   }
 
   @Test
@@ -501,48 +816,4 @@ public void testSchemaCollisionsInAvroConversion() {
     String output = BigQueryAvroUtils.toGenericAvroSchema(schema, false).toString();
     assertThat(output.length(), greaterThan(0));
   }
-
-  /** Pojo class used as the record type in tests. */
-  @SuppressWarnings("unused") // Used by Avro reflection.
-  static class Bird {
-    long number;
-    @Nullable String species;
-    @Nullable Double quality;
-    @Nullable Long quantity;
-
-    @AvroSchema(value = "[\"null\", {\"type\": \"long\", \"logicalType\": \"timestamp-micros\"}]")
-    Instant birthday;
-
-    @AvroSchema(
-        value =
-            "[\"null\", {\"type\": \"bytes\", \"logicalType\": \"decimal\", \"precision\": 38, \"scale\": 9}]")
-    BigDecimal birthdayMoney;
-
-    @AvroSchema(
-        value =
-            "[\"null\", {\"type\": \"bytes\", \"logicalType\": \"decimal\", \"precision\": 77, \"scale\": 38}]")
-    BigDecimal lotteryWinnings;
-
-    @AvroSchema(value = "[\"null\", {\"type\": \"string\", \"sqlType\": \"GEOGRAPHY\"}]")
-    String geoPositions;
-
-    @Nullable Boolean flighted;
-    @Nullable ByteBuffer sound;
-    @Nullable Utf8 anniversaryDate;
-    @Nullable String anniversaryDatetime;
-    @Nullable Utf8 anniversaryTime;
-    @Nullable SubBird scion;
-    SubBird[] associates;
-
-    static class SubBird {
-      @Nullable String species;
-
-      public SubBird() {}
-    }
-
-    public Bird() {
-      associates = new SubBird[1];
-      associates[0] = new SubBird();
-    }
-  }
 }

From 76bcec0086cf0137d2ea6c6259eadc15456e96bc Mon Sep 17 00:00:00 2001
From: Damon <damondouglas@users.noreply.github.com>
Date: Tue, 10 Dec 2024 09:50:51 -0800
Subject: [PATCH 092/135] Remove the use of google-github-actions/auth@v1
 (#33338)

* Remove use of google-github-actions/auth step.

* Create beam_PostCommit_Java_IO_Performance_Tests.json
---
 .../beam_PostCommit_Java_IO_Performance_Tests.json           | 4 ++++
 .../workflows/beam_PostCommit_Java_IO_Performance_Tests.yml  | 5 -----
 2 files changed, 4 insertions(+), 5 deletions(-)
 create mode 100644 .github/trigger_files/beam_PostCommit_Java_IO_Performance_Tests.json

diff --git a/.github/trigger_files/beam_PostCommit_Java_IO_Performance_Tests.json b/.github/trigger_files/beam_PostCommit_Java_IO_Performance_Tests.json
new file mode 100644
index 000000000000..b26833333238
--- /dev/null
+++ b/.github/trigger_files/beam_PostCommit_Java_IO_Performance_Tests.json
@@ -0,0 +1,4 @@
+{
+  "comment": "Modify this file in a trivial way to cause this test suite to run",
+  "modification": 2
+}
diff --git a/.github/workflows/beam_PostCommit_Java_IO_Performance_Tests.yml b/.github/workflows/beam_PostCommit_Java_IO_Performance_Tests.yml
index a6a2749c8d82..c6d9dc2236d3 100644
--- a/.github/workflows/beam_PostCommit_Java_IO_Performance_Tests.yml
+++ b/.github/workflows/beam_PostCommit_Java_IO_Performance_Tests.yml
@@ -88,11 +88,6 @@ jobs:
       uses: ./.github/actions/setup-environment-action
       with:
         java-version: default
-    - name: Authenticate on GCP
-      uses: google-github-actions/auth@v1
-      with:
-        credentials_json: ${{ secrets.GCP_SA_KEY }}
-        project_id: ${{ secrets.GCP_PROJECT_ID }}
     - name: run scheduled javaPostcommitIOPerformanceTests script
       if: github.event_name == 'schedule' #This ensures only scheduled runs publish metrics publicly by changing which exportTable is configured
       uses: ./.github/actions/gradle-command-self-hosted-action

From b4fbf8957e9a39ec018ace9aec284a7af3144f2d Mon Sep 17 00:00:00 2001
From: Ahmed Abualsaud <65791736+ahmedabu98@users.noreply.github.com>
Date: Tue, 10 Dec 2024 17:14:43 -0500
Subject: [PATCH 093/135] Add hadoop-auth (#33342)

* add hadoop auth

* trigger xlang tests

* place dep in expansion service
---
 .../trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json  | 2 +-
 .../main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy | 1 +
 sdks/java/io/expansion-service/build.gradle                    | 1 +
 sdks/java/io/iceberg/build.gradle                              | 3 +--
 4 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json b/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json
index c537844dc84a..b26833333238 100644
--- a/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json
+++ b/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json
@@ -1,4 +1,4 @@
 {
   "comment": "Modify this file in a trivial way to cause this test suite to run",
-  "modification": 3
+  "modification": 2
 }
diff --git a/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy b/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
index 2abd43a5d4cc..a59c1d7630b0 100644
--- a/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
+++ b/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
@@ -795,6 +795,7 @@ class BeamModulePlugin implements Plugin<Project> {
         grpc_xds                                    : "io.grpc:grpc-xds", // google_cloud_platform_libraries_bom sets version
         guava                                       : "com.google.guava:guava:$guava_version",
         guava_testlib                               : "com.google.guava:guava-testlib:$guava_version",
+        hadoop_auth                                 : "org.apache.hadoop:hadoop-auth:$hadoop_version",
         hadoop_client                               : "org.apache.hadoop:hadoop-client:$hadoop_version",
         hadoop_common                               : "org.apache.hadoop:hadoop-common:$hadoop_version",
         hadoop_mapreduce_client_core                : "org.apache.hadoop:hadoop-mapreduce-client-core:$hadoop_version",
diff --git a/sdks/java/io/expansion-service/build.gradle b/sdks/java/io/expansion-service/build.gradle
index cc8eccf98997..421719b8f986 100644
--- a/sdks/java/io/expansion-service/build.gradle
+++ b/sdks/java/io/expansion-service/build.gradle
@@ -54,6 +54,7 @@ dependencies {
   permitUnusedDeclared project(":sdks:java:io:kafka:upgrade") // BEAM-11761
 
   // **** IcebergIO runtime dependencies ****
+  runtimeOnly library.java.hadoop_auth
   runtimeOnly library.java.hadoop_client
   // Needed when using GCS as the warehouse location.
   runtimeOnly library.java.bigdataoss_gcs_connector
diff --git a/sdks/java/io/iceberg/build.gradle b/sdks/java/io/iceberg/build.gradle
index fa1e2426ce69..0cfa8da4eb7d 100644
--- a/sdks/java/io/iceberg/build.gradle
+++ b/sdks/java/io/iceberg/build.gradle
@@ -53,15 +53,14 @@ dependencies {
     implementation "org.apache.iceberg:iceberg-api:$iceberg_version"
     implementation "org.apache.iceberg:iceberg-parquet:$iceberg_version"
     implementation "org.apache.iceberg:iceberg-orc:$iceberg_version"
-    runtimeOnly "org.apache.iceberg:iceberg-gcp:$iceberg_version"
     implementation library.java.hadoop_common
+    runtimeOnly "org.apache.iceberg:iceberg-gcp:$iceberg_version"
 
     testImplementation project(":sdks:java:managed")
     testImplementation library.java.hadoop_client
     testImplementation library.java.bigdataoss_gcsio
     testImplementation library.java.bigdataoss_gcs_connector
     testImplementation library.java.bigdataoss_util_hadoop
-    testImplementation "org.apache.iceberg:iceberg-gcp:$iceberg_version"
     testImplementation "org.apache.iceberg:iceberg-data:$iceberg_version"
     testImplementation project(path: ":sdks:java:core", configuration: "shadowTest")
     testImplementation project(":sdks:java:extensions:google-cloud-platform-core")

From 7a94b6192332c49e9a39fe6bb316f4c3bec62929 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 10 Dec 2024 16:43:29 -0800
Subject: [PATCH 094/135] Bump golang.org/x/net from 0.31.0 to 0.32.0 in /sdks
 (#33326)

Bumps [golang.org/x/net](https://github.com/golang/net) from 0.31.0 to 0.32.0.
- [Commits](https://github.com/golang/net/compare/v0.31.0...v0.32.0)

---
updated-dependencies:
- dependency-name: golang.org/x/net
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod |  6 +++---
 sdks/go.sum | 16 ++++++++--------
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index a73cd530325f..0a09ee59c805 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -53,10 +53,10 @@ require (
 	github.com/xitongsys/parquet-go v1.6.2
 	github.com/xitongsys/parquet-go-source v0.0.0-20220315005136-aec0fe3e777c
 	go.mongodb.org/mongo-driver v1.17.1
-	golang.org/x/net v0.31.0
+	golang.org/x/net v0.32.0
 	golang.org/x/oauth2 v0.24.0
 	golang.org/x/sync v0.10.0
-	golang.org/x/sys v0.27.0
+	golang.org/x/sys v0.28.0
 	golang.org/x/text v0.21.0
 	google.golang.org/api v0.210.0
 	google.golang.org/genproto v0.0.0-20241118233622-e639e219e697
@@ -190,7 +190,7 @@ require (
 	github.com/youmark/pkcs8 v0.0.0-20240726163527-a2c0da244d78 // indirect
 	github.com/zeebo/xxh3 v1.0.2 // indirect
 	go.opencensus.io v0.24.0 // indirect
-	golang.org/x/crypto v0.29.0 // indirect
+	golang.org/x/crypto v0.30.0 // indirect
 	golang.org/x/mod v0.20.0 // indirect
 	golang.org/x/tools v0.24.0 // indirect
 	golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da // indirect
diff --git a/sdks/go.sum b/sdks/go.sum
index a0f784b9789e..bf2a9478a787 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -1266,8 +1266,8 @@ golang.org/x/crypto v0.0.0-20210421170649-83a5a9bb288b/go.mod h1:T9bdIzuCu7OtxOm
 golang.org/x/crypto v0.0.0-20210513164829-c07d793c2f9a/go.mod h1:P+XmwS30IXTQdn5tA2iutPOUgjI07+tq3H3K9MVA1s8=
 golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
 golang.org/x/crypto v0.0.0-20211108221036-ceb1ce70b4fa/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
-golang.org/x/crypto v0.29.0 h1:L5SG1JTTXupVV3n6sUqMTeWbjAyfPwoda2DLX8J8FrQ=
-golang.org/x/crypto v0.29.0/go.mod h1:+F4F4N5hv6v38hfeYwTdx20oUvLLc+QfrE9Ax9HtgRg=
+golang.org/x/crypto v0.30.0 h1:RwoQn3GkWiMkzlX562cLB7OxWvjH1L8xutO2WoJcRoY=
+golang.org/x/crypto v0.30.0/go.mod h1:kDsLvtWBEx7MV9tJOj9bnXsPbxwJQ6csT/x4KIN4Ssk=
 golang.org/x/exp v0.0.0-20180321215751-8460e604b9de/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
 golang.org/x/exp v0.0.0-20180807140117-3d87b88a115f/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
 golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
@@ -1388,8 +1388,8 @@ golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs=
 golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs=
 golang.org/x/net v0.8.0/go.mod h1:QVkue5JL9kW//ek3r6jTKnTFis1tRmNAW2P1shuFdJc=
 golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns=
-golang.org/x/net v0.31.0 h1:68CPQngjLL0r2AlUKiSxtQFKvzRVbnzLwMUn5SzcLHo=
-golang.org/x/net v0.31.0/go.mod h1:P4fl1q7dY2hnZFxEk4pPSkDHF+QqjitcnDjUQyMM+pM=
+golang.org/x/net v0.32.0 h1:ZqPmj8Kzc+Y6e0+skZsuACbx+wzMgo5MQsJh9Qd6aYI=
+golang.org/x/net v0.32.0/go.mod h1:CwU0IoeOlnQQWJ6ioyFrfRuomB8GKF6KbYXZVyeXNfs=
 golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U=
 golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
 golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
@@ -1526,8 +1526,8 @@ golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.11.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.15.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
 golang.org/x/sys v0.21.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
-golang.org/x/sys v0.27.0 h1:wBqf8DvsY9Y/2P8gAfPDEYNuS30J4lPHJxXSb/nJZ+s=
-golang.org/x/sys v0.27.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
+golang.org/x/sys v0.28.0 h1:Fksou7UEQUWlKvIdsqzJmUmCX3cZuD2+P3XyyzwMhlA=
+golang.org/x/sys v0.28.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
 golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
 golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
 golang.org/x/term v0.2.0/go.mod h1:TVmDHMZPmdnySmBfhjOoOdhjzdE1h4u1VwSiw2l1Nuc=
@@ -1536,8 +1536,8 @@ golang.org/x/term v0.4.0/go.mod h1:9P2UbLfCdcvo3p/nzKvsmas4TnlujnuoV9hGgYzW1lQ=
 golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k=
 golang.org/x/term v0.6.0/go.mod h1:m6U89DPEgQRMq3DNkDClhWw02AUbt2daBVO4cn4Hv9U=
 golang.org/x/term v0.7.0/go.mod h1:P32HKFT3hSsZrRxla30E9HqToFYAQPCMs/zFMBUFqPY=
-golang.org/x/term v0.26.0 h1:WEQa6V3Gja/BhNxg540hBip/kkaYtRg3cxg4oXSw4AU=
-golang.org/x/term v0.26.0/go.mod h1:Si5m1o57C5nBNQo5z1iq+XDijt21BDBDp2bK0QI8e3E=
+golang.org/x/term v0.27.0 h1:WP60Sv1nlK1T6SupCHbXzSaN0b9wUmsPoRS9b61A23Q=
+golang.org/x/term v0.27.0/go.mod h1:iMsnZpn0cago0GOrHO2+Y7u7JPn5AylBrcoWkElMTSM=
 golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.1-0.20180807135948-17ff2d5776d2/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=

From 04b059ff2e40dfd1ef295e35610f8db4a5ec4613 Mon Sep 17 00:00:00 2001
From: Yi Hu <yathu@google.com>
Date: Tue, 10 Dec 2024 22:32:26 -0500
Subject: [PATCH 095/135] Remove mandatory beam-sdks-io-kafka dependency for
 dataflow worker jar (#33302)

---
 .../worker/build.gradle                       |  1 -
 ...icsToPerStepNamespaceMetricsConverter.java |  6 ++--
 .../worker/StreamingDataflowWorker.java       |  5 ---
 .../dataflow/worker/streaming/StageInfo.java  |  5 ++-
 .../beam/sdk/io/kafka/KafkaIOInitializer.java | 34 +++++++++++++++++++
 5 files changed, 40 insertions(+), 11 deletions(-)
 create mode 100644 sdks/java/io/kafka/src/main/java/org/apache/beam/sdk/io/kafka/KafkaIOInitializer.java

diff --git a/runners/google-cloud-dataflow-java/worker/build.gradle b/runners/google-cloud-dataflow-java/worker/build.gradle
index 92beccd067e2..b7e6e981effe 100644
--- a/runners/google-cloud-dataflow-java/worker/build.gradle
+++ b/runners/google-cloud-dataflow-java/worker/build.gradle
@@ -54,7 +54,6 @@ def sdk_provided_project_dependencies = [
         ":runners:google-cloud-dataflow-java",
         ":sdks:java:extensions:avro",
         ":sdks:java:extensions:google-cloud-platform-core",
-        ":sdks:java:io:kafka", // For metric propagation into worker
         ":sdks:java:io:google-cloud-platform",
 ]
 
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/MetricsToPerStepNamespaceMetricsConverter.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/MetricsToPerStepNamespaceMetricsConverter.java
index 77f867793ae2..91baefa0be4c 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/MetricsToPerStepNamespaceMetricsConverter.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/MetricsToPerStepNamespaceMetricsConverter.java
@@ -32,7 +32,6 @@
 import java.util.Map.Entry;
 import java.util.Optional;
 import org.apache.beam.sdk.io.gcp.bigquery.BigQuerySinkMetrics;
-import org.apache.beam.sdk.io.kafka.KafkaSinkMetrics;
 import org.apache.beam.sdk.metrics.LabeledMetricNameUtils;
 import org.apache.beam.sdk.metrics.MetricName;
 import org.apache.beam.sdk.util.HistogramData;
@@ -43,6 +42,9 @@
  * converter.
  */
 public class MetricsToPerStepNamespaceMetricsConverter {
+  // Avoids to introduce mandatory kafka-io dependency to Dataflow worker
+  // keep in sync with org.apache.beam.sdk.io.kafka.KafkaSinkMetrics.METRICS_NAMESPACE
+  public static String KAFKA_SINK_METRICS_NAMESPACE = "KafkaSink";
 
   private static Optional<LabeledMetricNameUtils.ParsedMetricName> getParsedMetricName(
       MetricName metricName,
@@ -70,7 +72,7 @@ private static Optional<MetricValue> convertCounterToMetricValue(
 
     if (value == 0
         || (!metricName.getNamespace().equals(BigQuerySinkMetrics.METRICS_NAMESPACE)
-            && !metricName.getNamespace().equals(KafkaSinkMetrics.METRICS_NAMESPACE))) {
+            && !metricName.getNamespace().equals(KAFKA_SINK_METRICS_NAMESPACE))) {
       return Optional.empty();
     }
 
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorker.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorker.java
index 088a28e9b2db..0112ab4af80a 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorker.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/StreamingDataflowWorker.java
@@ -110,7 +110,6 @@
 import org.apache.beam.sdk.fn.JvmInitializers;
 import org.apache.beam.sdk.io.FileSystems;
 import org.apache.beam.sdk.io.gcp.bigquery.BigQuerySinkMetrics;
-import org.apache.beam.sdk.io.kafka.KafkaSinkMetrics;
 import org.apache.beam.sdk.metrics.MetricsEnvironment;
 import org.apache.beam.sdk.util.construction.CoderTranslation;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.annotations.VisibleForTesting;
@@ -835,10 +834,6 @@ public static void main(String[] args) throws Exception {
       enableBigQueryMetrics();
     }
 
-    if (DataflowRunner.hasExperiment(options, "enable_kafka_metrics")) {
-      KafkaSinkMetrics.setSupportKafkaMetrics(true);
-    }
-
     JvmInitializers.runBeforeProcessing(options);
     worker.startStatusPages();
     worker.start();
diff --git a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/StageInfo.java b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/StageInfo.java
index 525464ef2e1f..d9fe95f3421b 100644
--- a/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/StageInfo.java
+++ b/runners/google-cloud-dataflow-java/worker/src/main/java/org/apache/beam/runners/dataflow/worker/streaming/StageInfo.java
@@ -17,6 +17,7 @@
  */
 package org.apache.beam.runners.dataflow.worker.streaming;
 
+import static org.apache.beam.runners.dataflow.worker.MetricsToPerStepNamespaceMetricsConverter.KAFKA_SINK_METRICS_NAMESPACE;
 import static org.apache.beam.sdk.metrics.Metrics.THROTTLE_TIME_COUNTER_NAME;
 
 import com.google.api.services.dataflow.model.CounterStructuredName;
@@ -35,7 +36,6 @@
 import org.apache.beam.runners.dataflow.worker.counters.DataflowCounterUpdateExtractor;
 import org.apache.beam.runners.dataflow.worker.counters.NameContext;
 import org.apache.beam.sdk.io.gcp.bigquery.BigQuerySinkMetrics;
-import org.apache.beam.sdk.io.kafka.KafkaSinkMetrics;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.Iterables;
 
 /** Contains a few of the stage specific fields. E.g. metrics container registry, counters etc. */
@@ -120,8 +120,7 @@ private void translateKnownPerWorkerCounters(List<PerStepNamespaceMetrics> metri
     for (PerStepNamespaceMetrics perStepnamespaceMetrics : metrics) {
       if (!BigQuerySinkMetrics.METRICS_NAMESPACE.equals(
               perStepnamespaceMetrics.getMetricsNamespace())
-          && !KafkaSinkMetrics.METRICS_NAMESPACE.equals(
-              perStepnamespaceMetrics.getMetricsNamespace())) {
+          && !KAFKA_SINK_METRICS_NAMESPACE.equals(perStepnamespaceMetrics.getMetricsNamespace())) {
         continue;
       }
       for (MetricValue metric : perStepnamespaceMetrics.getMetricValues()) {
diff --git a/sdks/java/io/kafka/src/main/java/org/apache/beam/sdk/io/kafka/KafkaIOInitializer.java b/sdks/java/io/kafka/src/main/java/org/apache/beam/sdk/io/kafka/KafkaIOInitializer.java
new file mode 100644
index 000000000000..3dfb31715ced
--- /dev/null
+++ b/sdks/java/io/kafka/src/main/java/org/apache/beam/sdk/io/kafka/KafkaIOInitializer.java
@@ -0,0 +1,34 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.beam.sdk.io.kafka;
+
+import com.google.auto.service.AutoService;
+import org.apache.beam.sdk.harness.JvmInitializer;
+import org.apache.beam.sdk.options.ExperimentalOptions;
+import org.apache.beam.sdk.options.PipelineOptions;
+
+/** Initialize KafkaIO feature flags on worker. */
+@AutoService(JvmInitializer.class)
+public class KafkaIOInitializer implements JvmInitializer {
+  @Override
+  public void beforeProcessing(PipelineOptions options) {
+    if (ExperimentalOptions.hasExperiment(options, "enable_kafka_metrics")) {
+      KafkaSinkMetrics.setSupportKafkaMetrics(true);
+    }
+  }
+}

From b26e2fad761bc85832192dfa0abf335ae5c31111 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 11 Dec 2024 07:51:05 -0800
Subject: [PATCH 096/135] Bump github.com/nats-io/nats-server/v2 from 2.10.22
 to 2.10.23 in /sdks (#33352)

Bumps [github.com/nats-io/nats-server/v2](https://github.com/nats-io/nats-server) from 2.10.22 to 2.10.23.
- [Release notes](https://github.com/nats-io/nats-server/releases)
- [Changelog](https://github.com/nats-io/nats-server/blob/main/.goreleaser.yml)
- [Commits](https://github.com/nats-io/nats-server/compare/v2.10.22...v2.10.23)

---
updated-dependencies:
- dependency-name: github.com/nats-io/nats-server/v2
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 4 ++--
 sdks/go.sum | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index 0a09ee59c805..5406c2b70cbc 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -44,7 +44,7 @@ require (
 	github.com/johannesboyne/gofakes3 v0.0.0-20221110173912-32fb85c5aed6
 	github.com/lib/pq v1.10.9
 	github.com/linkedin/goavro/v2 v2.13.0
-	github.com/nats-io/nats-server/v2 v2.10.22
+	github.com/nats-io/nats-server/v2 v2.10.23
 	github.com/nats-io/nats.go v1.37.0
 	github.com/proullon/ramsql v0.1.4
 	github.com/spf13/cobra v1.8.1
@@ -98,7 +98,7 @@ require (
 	github.com/moby/sys/user v0.1.0 // indirect
 	github.com/moby/sys/userns v0.1.0 // indirect
 	github.com/nats-io/jwt/v2 v2.5.8 // indirect
-	github.com/nats-io/nkeys v0.4.7 // indirect
+	github.com/nats-io/nkeys v0.4.8 // indirect
 	github.com/nats-io/nuid v1.0.1 // indirect
 	github.com/planetscale/vtprotobuf v0.6.1-0.20240319094008-0393e58bdf10 // indirect
 	github.com/power-devops/perfstat v0.0.0-20210106213030-5aafc221ea8c // indirect
diff --git a/sdks/go.sum b/sdks/go.sum
index bf2a9478a787..bb96c54af087 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -1085,12 +1085,12 @@ github.com/morikuni/aec v1.0.0 h1:nP9CBfwrvYnBRgY6qfDQkygYDmYwOilePFkwzv4dU8A=
 github.com/morikuni/aec v1.0.0/go.mod h1:BbKIizmSmc5MMPqRYbxO4ZU0S0+P200+tUnFx7PXmsc=
 github.com/nats-io/jwt/v2 v2.5.8 h1:uvdSzwWiEGWGXf+0Q+70qv6AQdvcvxrv9hPM0RiPamE=
 github.com/nats-io/jwt/v2 v2.5.8/go.mod h1:ZdWS1nZa6WMZfFwwgpEaqBV8EPGVgOTDHN/wTbz0Y5A=
-github.com/nats-io/nats-server/v2 v2.10.22 h1:Yt63BGu2c3DdMoBZNcR6pjGQwk/asrKU7VX846ibxDA=
-github.com/nats-io/nats-server/v2 v2.10.22/go.mod h1:X/m1ye9NYansUXYFrbcDwUi/blHkrgHh2rgCJaakonk=
+github.com/nats-io/nats-server/v2 v2.10.23 h1:jvfb9cEi5h8UG6HkZgJGdn9f1UPaX3Dohk0PohEekJI=
+github.com/nats-io/nats-server/v2 v2.10.23/go.mod h1:hMFnpDT2XUXsvHglABlFl/uroQCCOcW6X/0esW6GpBk=
 github.com/nats-io/nats.go v1.37.0 h1:07rauXbVnnJvv1gfIyghFEo6lUcYRY0WXc3x7x0vUxE=
 github.com/nats-io/nats.go v1.37.0/go.mod h1:Ubdu4Nh9exXdSz0RVWRFBbRfrbSxOYd26oF0wkWclB8=
-github.com/nats-io/nkeys v0.4.7 h1:RwNJbbIdYCoClSDNY7QVKZlyb/wfT6ugvFCiKy6vDvI=
-github.com/nats-io/nkeys v0.4.7/go.mod h1:kqXRgRDPlGy7nGaEDMuYzmiJCIAAWDK0IMBtDmGD0nc=
+github.com/nats-io/nkeys v0.4.8 h1:+wee30071y3vCZAYRsnrmIPaOe47A/SkK/UBDPdIV70=
+github.com/nats-io/nkeys v0.4.8/go.mod h1:kqXRgRDPlGy7nGaEDMuYzmiJCIAAWDK0IMBtDmGD0nc=
 github.com/nats-io/nuid v1.0.1 h1:5iA8DT8V7q8WK2EScv2padNa/rTESc1KdnPw4TC2paw=
 github.com/nats-io/nuid v1.0.1/go.mod h1:19wcPz3Ph3q0Jbyiqsd0kePYG7A95tJPxeL+1OSON2c=
 github.com/ncw/swift v1.0.52/go.mod h1:23YIA4yWVnGwv2dQlN4bB7egfYX6YLn0Yo/S6zZO/ZM=

From 00ec6cc2d1a24af27defc3f19c77c51cda637104 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rados=C5=82aw=20Stankiewicz?= <radoslaws@google.com>
Date: Wed, 11 Dec 2024 17:51:20 +0100
Subject: [PATCH 097/135] fix Error processing result file: CData section too
 big found in publish-int-test-result-action #29966 (#33353)

---
 .github/workflows/IO_Iceberg_Unit_Tests.yml                    | 1 +
 .../workflows/beam_LoadTests_Java_CoGBK_Dataflow_Streaming.yml | 3 ++-
 .../beam_PerformanceTests_BigQueryIO_Batch_Java_Avro.yml       | 3 ++-
 .../beam_PerformanceTests_BigQueryIO_Batch_Java_Json.yml       | 3 ++-
 .../beam_PerformanceTests_BigQueryIO_Streaming_Java.yml        | 3 ++-
 .../beam_PerformanceTests_SQLBigQueryIO_Batch_Java.yml         | 3 ++-
 .../beam_PerformanceTests_WordCountIT_PythonVersions.yml       | 3 ++-
 .github/workflows/beam_PostCommit_Java.yml                     | 3 ++-
 .github/workflows/beam_PostCommit_Java_Avro_Versions.yml       | 3 ++-
 .../workflows/beam_PostCommit_Java_BigQueryEarlyRollout.yml    | 1 +
 .github/workflows/beam_PostCommit_Java_DataflowV1.yml          | 3 ++-
 .github/workflows/beam_PostCommit_Java_DataflowV2.yml          | 3 ++-
 .github/workflows/beam_PostCommit_Java_Examples_Dataflow.yml   | 3 ++-
 .../workflows/beam_PostCommit_Java_Examples_Dataflow_ARM.yml   | 1 +
 .../workflows/beam_PostCommit_Java_Examples_Dataflow_Java.yml  | 3 ++-
 .../workflows/beam_PostCommit_Java_Examples_Dataflow_V2.yml    | 3 ++-
 .../beam_PostCommit_Java_Examples_Dataflow_V2_Java.yml         | 3 ++-
 .github/workflows/beam_PostCommit_Java_Examples_Direct.yml     | 3 ++-
 .github/workflows/beam_PostCommit_Java_Examples_Flink.yml      | 1 +
 .github/workflows/beam_PostCommit_Java_Examples_Spark.yml      | 3 ++-
 .github/workflows/beam_PostCommit_Java_Hadoop_Versions.yml     | 3 ++-
 .../workflows/beam_PostCommit_Java_IO_Performance_Tests.yml    | 1 +
 .../workflows/beam_PostCommit_Java_Jpms_Dataflow_Java11.yml    | 3 ++-
 .../workflows/beam_PostCommit_Java_Jpms_Dataflow_Java17.yml    | 3 ++-
 .github/workflows/beam_PostCommit_Java_Jpms_Direct_Java11.yml  | 3 ++-
 .github/workflows/beam_PostCommit_Java_Jpms_Direct_Java17.yml  | 3 ++-
 .github/workflows/beam_PostCommit_Java_Jpms_Direct_Java21.yml  | 3 ++-
 .github/workflows/beam_PostCommit_Java_Jpms_Flink_Java11.yml   | 3 ++-
 .github/workflows/beam_PostCommit_Java_Jpms_Spark_Java11.yml   | 3 ++-
 .github/workflows/beam_PostCommit_Java_PVR_Flink_Streaming.yml | 1 +
 .github/workflows/beam_PostCommit_Java_PVR_Samza.yml           | 3 ++-
 .../workflows/beam_PostCommit_Java_PVR_Spark3_Streaming.yml    | 3 ++-
 ...m_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml | 1 +
 .../beam_PostCommit_Java_ValidatesRunner_Dataflow.yml          | 3 ++-
 ...m_PostCommit_Java_ValidatesRunner_Dataflow_JavaVersions.yml | 3 ++-
 ...beam_PostCommit_Java_ValidatesRunner_Dataflow_Streaming.yml | 3 ++-
 .../beam_PostCommit_Java_ValidatesRunner_Dataflow_V2.yml       | 3 ++-
 ...m_PostCommit_Java_ValidatesRunner_Dataflow_V2_Streaming.yml | 3 ++-
 .../workflows/beam_PostCommit_Java_ValidatesRunner_Direct.yml  | 3 ++-
 ...eam_PostCommit_Java_ValidatesRunner_Direct_JavaVersions.yml | 3 ++-
 .../workflows/beam_PostCommit_Java_ValidatesRunner_Flink.yml   | 1 +
 .../beam_PostCommit_Java_ValidatesRunner_Flink_Java8.yml       | 1 +
 .../workflows/beam_PostCommit_Java_ValidatesRunner_Samza.yml   | 3 ++-
 .../workflows/beam_PostCommit_Java_ValidatesRunner_Spark.yml   | 3 ++-
 ...ostCommit_Java_ValidatesRunner_SparkStructuredStreaming.yml | 3 ++-
 .../beam_PostCommit_Java_ValidatesRunner_Spark_Java8.yml       | 3 ++-
 .../beam_PostCommit_Java_ValidatesRunner_Twister2.yml          | 3 ++-
 .github/workflows/beam_PostCommit_Java_ValidatesRunner_ULR.yml | 3 ++-
 .github/workflows/beam_PostCommit_PortableJar_Flink.yml        | 3 ++-
 .github/workflows/beam_PostCommit_PortableJar_Spark.yml        | 3 ++-
 .github/workflows/beam_PostCommit_Python.yml                   | 3 ++-
 .github/workflows/beam_PostCommit_Python_Arm.yml               | 3 ++-
 .github/workflows/beam_PostCommit_Python_Dependency.yml        | 1 +
 .github/workflows/beam_PostCommit_Python_Examples_Dataflow.yml | 3 ++-
 .github/workflows/beam_PostCommit_Python_Examples_Direct.yml   | 3 ++-
 .github/workflows/beam_PostCommit_Python_Examples_Flink.yml    | 1 +
 .github/workflows/beam_PostCommit_Python_Examples_Spark.yml    | 3 ++-
 .github/workflows/beam_PostCommit_Python_MongoDBIO_IT.yml      | 3 ++-
 .../beam_PostCommit_Python_ValidatesContainer_Dataflow.yml     | 1 +
 ...m_PostCommit_Python_ValidatesContainer_Dataflow_With_RC.yml | 3 ++-
 ...PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml | 1 +
 .../beam_PostCommit_Python_ValidatesRunner_Dataflow.yml        | 3 ++-
 .../workflows/beam_PostCommit_Python_ValidatesRunner_Flink.yml | 3 ++-
 .../workflows/beam_PostCommit_Python_ValidatesRunner_Samza.yml | 3 ++-
 .../workflows/beam_PostCommit_Python_ValidatesRunner_Spark.yml | 3 ++-
 .../workflows/beam_PostCommit_Python_Xlang_Gcp_Dataflow.yml    | 3 ++-
 .github/workflows/beam_PostCommit_Python_Xlang_Gcp_Direct.yml  | 3 ++-
 .github/workflows/beam_PostCommit_Python_Xlang_IO_Dataflow.yml | 3 ++-
 .github/workflows/beam_PostCommit_Python_Xlang_IO_Direct.yml   | 3 ++-
 .github/workflows/beam_PostCommit_SQL.yml                      | 1 +
 .github/workflows/beam_PostCommit_TransformService_Direct.yml  | 3 ++-
 .github/workflows/beam_PostCommit_XVR_Direct.yml               | 3 ++-
 .github/workflows/beam_PostCommit_XVR_Flink.yml                | 1 +
 .github/workflows/beam_PostCommit_XVR_GoUsingJava_Dataflow.yml | 1 +
 .../workflows/beam_PostCommit_XVR_JavaUsingPython_Dataflow.yml | 3 ++-
 .../beam_PostCommit_XVR_PythonUsingJavaSQL_Dataflow.yml        | 3 ++-
 .../workflows/beam_PostCommit_XVR_PythonUsingJava_Dataflow.yml | 3 ++-
 .github/workflows/beam_PostCommit_XVR_Samza.yml                | 3 ++-
 .github/workflows/beam_PostCommit_XVR_Spark3.yml               | 3 ++-
 .github/workflows/beam_PreCommit_ItFramework.yml               | 3 ++-
 .github/workflows/beam_PreCommit_Java.yml                      | 1 +
 .../beam_PreCommit_Java_Amazon-Web-Services2_IO_Direct.yml     | 1 +
 .../beam_PreCommit_Java_Amazon-Web-Services_IO_Direct.yml      | 1 +
 .github/workflows/beam_PreCommit_Java_Azure_IO_Direct.yml      | 1 +
 .github/workflows/beam_PreCommit_Java_Cassandra_IO_Direct.yml  | 1 +
 .github/workflows/beam_PreCommit_Java_Cdap_IO_Direct.yml       | 1 +
 .github/workflows/beam_PreCommit_Java_Clickhouse_IO_Direct.yml | 1 +
 .github/workflows/beam_PreCommit_Java_Csv_IO_Direct.yml        | 1 +
 .github/workflows/beam_PreCommit_Java_Debezium_IO_Direct.yml   | 1 +
 .../workflows/beam_PreCommit_Java_ElasticSearch_IO_Direct.yml  | 1 +
 .github/workflows/beam_PreCommit_Java_Examples_Dataflow.yml    | 3 ++-
 .../workflows/beam_PreCommit_Java_Examples_Dataflow_Java21.yml | 1 +
 .../beam_PreCommit_Java_File-schema-transform_IO_Direct.yml    | 1 +
 .github/workflows/beam_PreCommit_Java_Flink_Versions.yml       | 3 ++-
 .github/workflows/beam_PreCommit_Java_GCP_IO_Direct.yml        | 1 +
 .github/workflows/beam_PreCommit_Java_Google-ads_IO_Direct.yml | 1 +
 .github/workflows/beam_PreCommit_Java_HBase_IO_Direct.yml      | 1 +
 .github/workflows/beam_PreCommit_Java_HCatalog_IO_Direct.yml   | 1 +
 .github/workflows/beam_PreCommit_Java_Hadoop_IO_Direct.yml     | 1 +
 .github/workflows/beam_PreCommit_Java_IOs_Direct.yml           | 1 +
 .github/workflows/beam_PreCommit_Java_InfluxDb_IO_Direct.yml   | 1 +
 .github/workflows/beam_PreCommit_Java_JDBC_IO_Direct.yml       | 1 +
 .github/workflows/beam_PreCommit_Java_Jms_IO_Direct.yml        | 1 +
 .github/workflows/beam_PreCommit_Java_Kafka_IO_Direct.yml      | 1 +
 .github/workflows/beam_PreCommit_Java_Kinesis_IO_Direct.yml    | 1 +
 .github/workflows/beam_PreCommit_Java_Kudu_IO_Direct.yml       | 1 +
 .github/workflows/beam_PreCommit_Java_MongoDb_IO_Direct.yml    | 1 +
 .github/workflows/beam_PreCommit_Java_Mqtt_IO_Direct.yml       | 1 +
 .github/workflows/beam_PreCommit_Java_Neo4j_IO_Direct.yml      | 1 +
 .github/workflows/beam_PreCommit_Java_PVR_Flink_Docker.yml     | 1 +
 .github/workflows/beam_PreCommit_Java_Parquet_IO_Direct.yml    | 1 +
 .github/workflows/beam_PreCommit_Java_Pulsar_IO_Direct.yml     | 1 +
 .github/workflows/beam_PreCommit_Java_RabbitMq_IO_Direct.yml   | 1 +
 .github/workflows/beam_PreCommit_Java_Redis_IO_Direct.yml      | 1 +
 .../beam_PreCommit_Java_RequestResponse_IO_Direct.yml          | 1 +
 .../workflows/beam_PreCommit_Java_SingleStore_IO_Direct.yml    | 1 +
 .github/workflows/beam_PreCommit_Java_Snowflake_IO_Direct.yml  | 1 +
 .github/workflows/beam_PreCommit_Java_Solace_IO_Direct.yml     | 1 +
 .github/workflows/beam_PreCommit_Java_Solr_IO_Direct.yml       | 1 +
 .github/workflows/beam_PreCommit_Java_Spark3_Versions.yml      | 3 ++-
 .github/workflows/beam_PreCommit_Java_Splunk_IO_Direct.yml     | 1 +
 .github/workflows/beam_PreCommit_Java_Thrift_IO_Direct.yml     | 1 +
 .github/workflows/beam_PreCommit_Java_Tika_IO_Direct.yml       | 1 +
 .github/workflows/beam_PreCommit_Python.yml                    | 3 ++-
 .github/workflows/beam_PreCommit_Python_Coverage.yml           | 3 ++-
 .github/workflows/beam_PreCommit_Python_Dataframes.yml         | 3 ++-
 .github/workflows/beam_PreCommit_Python_Examples.yml           | 3 ++-
 .github/workflows/beam_PreCommit_Python_Integration.yml        | 3 ++-
 .github/workflows/beam_PreCommit_Python_ML.yml                 | 3 ++-
 .github/workflows/beam_PreCommit_Python_PVR_Flink.yml          | 3 ++-
 .github/workflows/beam_PreCommit_Python_Runners.yml            | 3 ++-
 .github/workflows/beam_PreCommit_Python_Transforms.yml         | 3 ++-
 .github/workflows/beam_PreCommit_SQL.yml                       | 1 +
 .github/workflows/beam_PreCommit_SQL_Java17.yml                | 1 +
 .github/workflows/beam_PreCommit_SQL_Java8.yml                 | 1 +
 .github/workflows/beam_PreCommit_Yaml_Xlang_Direct.yml         | 1 +
 136 files changed, 212 insertions(+), 76 deletions(-)

diff --git a/.github/workflows/IO_Iceberg_Unit_Tests.yml b/.github/workflows/IO_Iceberg_Unit_Tests.yml
index 0d72b0da8597..d063f6ac71db 100644
--- a/.github/workflows/IO_Iceberg_Unit_Tests.yml
+++ b/.github/workflows/IO_Iceberg_Unit_Tests.yml
@@ -111,6 +111,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_LoadTests_Java_CoGBK_Dataflow_Streaming.yml b/.github/workflows/beam_LoadTests_Java_CoGBK_Dataflow_Streaming.yml
index 2b631d2f7664..659c85b002df 100644
--- a/.github/workflows/beam_LoadTests_Java_CoGBK_Dataflow_Streaming.yml
+++ b/.github/workflows/beam_LoadTests_Java_CoGBK_Dataflow_Streaming.yml
@@ -124,4 +124,5 @@ jobs:
         uses: EnricoMi/publish-unit-test-result-action@v2
         if: always()
         with:
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PerformanceTests_BigQueryIO_Batch_Java_Avro.yml b/.github/workflows/beam_PerformanceTests_BigQueryIO_Batch_Java_Avro.yml
index af0569f4784a..74932079fe4c 100644
--- a/.github/workflows/beam_PerformanceTests_BigQueryIO_Batch_Java_Avro.yml
+++ b/.github/workflows/beam_PerformanceTests_BigQueryIO_Batch_Java_Avro.yml
@@ -102,4 +102,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PerformanceTests_BigQueryIO_Batch_Java_Json.yml b/.github/workflows/beam_PerformanceTests_BigQueryIO_Batch_Java_Json.yml
index 9e3962e2576e..05e5369a6384 100644
--- a/.github/workflows/beam_PerformanceTests_BigQueryIO_Batch_Java_Json.yml
+++ b/.github/workflows/beam_PerformanceTests_BigQueryIO_Batch_Java_Json.yml
@@ -102,4 +102,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PerformanceTests_BigQueryIO_Streaming_Java.yml b/.github/workflows/beam_PerformanceTests_BigQueryIO_Streaming_Java.yml
index 7514bd5cacb3..32db2cff6cbc 100644
--- a/.github/workflows/beam_PerformanceTests_BigQueryIO_Streaming_Java.yml
+++ b/.github/workflows/beam_PerformanceTests_BigQueryIO_Streaming_Java.yml
@@ -102,4 +102,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PerformanceTests_SQLBigQueryIO_Batch_Java.yml b/.github/workflows/beam_PerformanceTests_SQLBigQueryIO_Batch_Java.yml
index 6ac07a1bd76c..d04a6e63c800 100644
--- a/.github/workflows/beam_PerformanceTests_SQLBigQueryIO_Batch_Java.yml
+++ b/.github/workflows/beam_PerformanceTests_SQLBigQueryIO_Batch_Java.yml
@@ -101,4 +101,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PerformanceTests_WordCountIT_PythonVersions.yml b/.github/workflows/beam_PerformanceTests_WordCountIT_PythonVersions.yml
index e9ef9cd1716a..756ecb5a58c2 100644
--- a/.github/workflows/beam_PerformanceTests_WordCountIT_PythonVersions.yml
+++ b/.github/workflows/beam_PerformanceTests_WordCountIT_PythonVersions.yml
@@ -115,4 +115,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java.yml b/.github/workflows/beam_PostCommit_Java.yml
index 3428551cb8f9..4fafa3b2a993 100644
--- a/.github/workflows/beam_PostCommit_Java.yml
+++ b/.github/workflows/beam_PostCommit_Java.yml
@@ -90,4 +90,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Avro_Versions.yml b/.github/workflows/beam_PostCommit_Java_Avro_Versions.yml
index e3a9db23ed67..8ffcc4a28a71 100644
--- a/.github/workflows/beam_PostCommit_Java_Avro_Versions.yml
+++ b/.github/workflows/beam_PostCommit_Java_Avro_Versions.yml
@@ -90,4 +90,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_BigQueryEarlyRollout.yml b/.github/workflows/beam_PostCommit_Java_BigQueryEarlyRollout.yml
index 1a6f7c14db50..8707b515e10b 100644
--- a/.github/workflows/beam_PostCommit_Java_BigQueryEarlyRollout.yml
+++ b/.github/workflows/beam_PostCommit_Java_BigQueryEarlyRollout.yml
@@ -110,3 +110,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_Java_DataflowV1.yml b/.github/workflows/beam_PostCommit_Java_DataflowV1.yml
index e7c2aa6fe7e2..752b15936b5f 100644
--- a/.github/workflows/beam_PostCommit_Java_DataflowV1.yml
+++ b/.github/workflows/beam_PostCommit_Java_DataflowV1.yml
@@ -94,4 +94,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_DataflowV2.yml b/.github/workflows/beam_PostCommit_Java_DataflowV2.yml
index 3c0a46d6bb40..cb107572b621 100644
--- a/.github/workflows/beam_PostCommit_Java_DataflowV2.yml
+++ b/.github/workflows/beam_PostCommit_Java_DataflowV2.yml
@@ -90,4 +90,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Examples_Dataflow.yml b/.github/workflows/beam_PostCommit_Java_Examples_Dataflow.yml
index 469d7e31f173..81725c4005af 100644
--- a/.github/workflows/beam_PostCommit_Java_Examples_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_Java_Examples_Dataflow.yml
@@ -89,4 +89,5 @@ jobs:
       uses: EnricoMi/publish-unit-test-result-action@v2
       if: always()
       with:
-        files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+        files: '**/build/test-results/**/*.xml'
+        large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_ARM.yml b/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_ARM.yml
index 9fd84daef63b..eacdfe5a5c23 100644
--- a/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_ARM.yml
+++ b/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_ARM.yml
@@ -119,3 +119,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_Java.yml b/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_Java.yml
index 13ab05f8f173..efb926681cbf 100644
--- a/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_Java.yml
+++ b/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_Java.yml
@@ -97,4 +97,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_V2.yml b/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_V2.yml
index 9be8a34f3732..1882cdf1d76b 100644
--- a/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_V2.yml
+++ b/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_V2.yml
@@ -91,4 +91,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_V2_Java.yml b/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_V2_Java.yml
index cd2486ae8e10..05b28ac93658 100644
--- a/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_V2_Java.yml
+++ b/.github/workflows/beam_PostCommit_Java_Examples_Dataflow_V2_Java.yml
@@ -104,4 +104,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Examples_Direct.yml b/.github/workflows/beam_PostCommit_Java_Examples_Direct.yml
index ca06e72877c7..a746acb4333f 100644
--- a/.github/workflows/beam_PostCommit_Java_Examples_Direct.yml
+++ b/.github/workflows/beam_PostCommit_Java_Examples_Direct.yml
@@ -92,4 +92,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Examples_Flink.yml b/.github/workflows/beam_PostCommit_Java_Examples_Flink.yml
index e42d6a88b8df..f72910bd15bc 100644
--- a/.github/workflows/beam_PostCommit_Java_Examples_Flink.yml
+++ b/.github/workflows/beam_PostCommit_Java_Examples_Flink.yml
@@ -94,3 +94,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_Java_Examples_Spark.yml b/.github/workflows/beam_PostCommit_Java_Examples_Spark.yml
index 8008daf4584f..c3620e46fac9 100644
--- a/.github/workflows/beam_PostCommit_Java_Examples_Spark.yml
+++ b/.github/workflows/beam_PostCommit_Java_Examples_Spark.yml
@@ -92,4 +92,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Hadoop_Versions.yml b/.github/workflows/beam_PostCommit_Java_Hadoop_Versions.yml
index 67a48b105955..1202ecc0e27f 100644
--- a/.github/workflows/beam_PostCommit_Java_Hadoop_Versions.yml
+++ b/.github/workflows/beam_PostCommit_Java_Hadoop_Versions.yml
@@ -100,4 +100,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_IO_Performance_Tests.yml b/.github/workflows/beam_PostCommit_Java_IO_Performance_Tests.yml
index c6d9dc2236d3..6023a895a458 100644
--- a/.github/workflows/beam_PostCommit_Java_IO_Performance_Tests.yml
+++ b/.github/workflows/beam_PostCommit_Java_IO_Performance_Tests.yml
@@ -117,3 +117,4 @@ jobs:
         commit: '${{ env.prsha || env.GITHUB_SHA }}'
         comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
         files: '**/build/test-results/**/*.xml'
+        large_files: true
diff --git a/.github/workflows/beam_PostCommit_Java_Jpms_Dataflow_Java11.yml b/.github/workflows/beam_PostCommit_Java_Jpms_Dataflow_Java11.yml
index 37f784770477..323f85b9851a 100644
--- a/.github/workflows/beam_PostCommit_Java_Jpms_Dataflow_Java11.yml
+++ b/.github/workflows/beam_PostCommit_Java_Jpms_Dataflow_Java11.yml
@@ -91,4 +91,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Jpms_Dataflow_Java17.yml b/.github/workflows/beam_PostCommit_Java_Jpms_Dataflow_Java17.yml
index 377602ad08dd..1ccb26f5aa1f 100644
--- a/.github/workflows/beam_PostCommit_Java_Jpms_Dataflow_Java17.yml
+++ b/.github/workflows/beam_PostCommit_Java_Jpms_Dataflow_Java17.yml
@@ -96,4 +96,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java11.yml b/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java11.yml
index 80406cf4eb0c..02ac93135957 100644
--- a/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java11.yml
+++ b/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java11.yml
@@ -91,4 +91,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java17.yml b/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java17.yml
index 3cbc317317c2..2cbf60a48d2e 100644
--- a/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java17.yml
+++ b/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java17.yml
@@ -96,4 +96,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java21.yml b/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java21.yml
index 97fd1fb4913e..6a7058ef566d 100644
--- a/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java21.yml
+++ b/.github/workflows/beam_PostCommit_Java_Jpms_Direct_Java21.yml
@@ -97,4 +97,5 @@ jobs:
       with:
         commit: '${{ env.prsha || env.GITHUB_SHA }}'
         comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-        files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+        files: '**/build/test-results/**/*.xml'
+        large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Jpms_Flink_Java11.yml b/.github/workflows/beam_PostCommit_Java_Jpms_Flink_Java11.yml
index 1a7405836f69..1559061634d3 100644
--- a/.github/workflows/beam_PostCommit_Java_Jpms_Flink_Java11.yml
+++ b/.github/workflows/beam_PostCommit_Java_Jpms_Flink_Java11.yml
@@ -91,4 +91,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_Jpms_Spark_Java11.yml b/.github/workflows/beam_PostCommit_Java_Jpms_Spark_Java11.yml
index eec4867a997b..1b4f8c5bcce5 100644
--- a/.github/workflows/beam_PostCommit_Java_Jpms_Spark_Java11.yml
+++ b/.github/workflows/beam_PostCommit_Java_Jpms_Spark_Java11.yml
@@ -91,4 +91,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_PVR_Flink_Streaming.yml b/.github/workflows/beam_PostCommit_Java_PVR_Flink_Streaming.yml
index 987be7789b29..8c5fcb1acff4 100644
--- a/.github/workflows/beam_PostCommit_Java_PVR_Flink_Streaming.yml
+++ b/.github/workflows/beam_PostCommit_Java_PVR_Flink_Streaming.yml
@@ -91,3 +91,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_Java_PVR_Samza.yml b/.github/workflows/beam_PostCommit_Java_PVR_Samza.yml
index 7cc48ebd4b0e..c1a22b9c871d 100644
--- a/.github/workflows/beam_PostCommit_Java_PVR_Samza.yml
+++ b/.github/workflows/beam_PostCommit_Java_PVR_Samza.yml
@@ -100,4 +100,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_PVR_Spark3_Streaming.yml b/.github/workflows/beam_PostCommit_Java_PVR_Spark3_Streaming.yml
index ad10bfc684d8..76ab560f15ec 100644
--- a/.github/workflows/beam_PostCommit_Java_PVR_Spark3_Streaming.yml
+++ b/.github/workflows/beam_PostCommit_Java_PVR_Spark3_Streaming.yml
@@ -90,4 +90,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml b/.github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml
index 4fb236c7c991..73fd6f0b78fa 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesDistrolessContainer_Dataflow.yml
@@ -113,3 +113,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow.yml
index d66381393725..c85c0b8468dc 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow.yml
@@ -93,4 +93,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_JavaVersions.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_JavaVersions.yml
index da2ba2f88465..5963a33007e0 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_JavaVersions.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_JavaVersions.yml
@@ -111,4 +111,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_Streaming.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_Streaming.yml
index edb055321c87..2e8227fb84a6 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_Streaming.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_Streaming.yml
@@ -93,4 +93,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_V2.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_V2.yml
index 8957ce7de053..2abc081e6ae5 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_V2.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_V2.yml
@@ -93,4 +93,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_V2_Streaming.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_V2_Streaming.yml
index 2a98746a0b84..fde10e0898e9 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_V2_Streaming.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Dataflow_V2_Streaming.yml
@@ -93,4 +93,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Direct.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Direct.yml
index 3f48bb921805..f439be9ec58e 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Direct.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Direct.yml
@@ -90,4 +90,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Direct_JavaVersions.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Direct_JavaVersions.yml
index 75ebbda93f80..eb70a654c93d 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Direct_JavaVersions.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Direct_JavaVersions.yml
@@ -106,4 +106,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink.yml
index f79ca8747828..1442f5ffafc0 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink.yml
@@ -93,3 +93,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink_Java8.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink_Java8.yml
index c51c39987236..0f12ce6f90ef 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink_Java8.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink_Java8.yml
@@ -110,3 +110,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Samza.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Samza.yml
index 794308d3a85e..edcb45303fd4 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Samza.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Samza.yml
@@ -96,4 +96,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Spark.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Spark.yml
index d1f264aaac01..d05963263931 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Spark.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Spark.yml
@@ -90,4 +90,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_SparkStructuredStreaming.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_SparkStructuredStreaming.yml
index 15863d4c8c9b..da04582a7caa 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_SparkStructuredStreaming.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_SparkStructuredStreaming.yml
@@ -90,4 +90,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Spark_Java8.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Spark_Java8.yml
index c05284186617..8d531c120dd6 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Spark_Java8.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Spark_Java8.yml
@@ -108,4 +108,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Twister2.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Twister2.yml
index 522cb300c687..8310e5ed8bb2 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Twister2.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Twister2.yml
@@ -90,4 +90,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_ULR.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_ULR.yml
index 36fc06aea421..3b130b6d290f 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_ULR.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_ULR.yml
@@ -89,4 +89,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_PortableJar_Flink.yml b/.github/workflows/beam_PostCommit_PortableJar_Flink.yml
index 37bfe68d9b20..318b5104c39c 100644
--- a/.github/workflows/beam_PostCommit_PortableJar_Flink.yml
+++ b/.github/workflows/beam_PostCommit_PortableJar_Flink.yml
@@ -94,4 +94,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_PortableJar_Spark.yml b/.github/workflows/beam_PostCommit_PortableJar_Spark.yml
index ce7be60133d7..0712dfb255b7 100644
--- a/.github/workflows/beam_PostCommit_PortableJar_Spark.yml
+++ b/.github/workflows/beam_PostCommit_PortableJar_Spark.yml
@@ -94,4 +94,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python.yml b/.github/workflows/beam_PostCommit_Python.yml
index 4770515c75fb..93b85a318487 100644
--- a/.github/workflows/beam_PostCommit_Python.yml
+++ b/.github/workflows/beam_PostCommit_Python.yml
@@ -109,4 +109,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_Arm.yml b/.github/workflows/beam_PostCommit_Python_Arm.yml
index 48fb00b1bb9d..352b95e6747a 100644
--- a/.github/workflows/beam_PostCommit_Python_Arm.yml
+++ b/.github/workflows/beam_PostCommit_Python_Arm.yml
@@ -124,4 +124,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_Dependency.yml b/.github/workflows/beam_PostCommit_Python_Dependency.yml
index 6e7c4ddbd3eb..80e1bbc290c9 100644
--- a/.github/workflows/beam_PostCommit_Python_Dependency.yml
+++ b/.github/workflows/beam_PostCommit_Python_Dependency.yml
@@ -96,3 +96,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/pytest*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_Python_Examples_Dataflow.yml b/.github/workflows/beam_PostCommit_Python_Examples_Dataflow.yml
index 4ce3b1893215..bf8330a2ae58 100644
--- a/.github/workflows/beam_PostCommit_Python_Examples_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_Python_Examples_Dataflow.yml
@@ -94,4 +94,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_Examples_Direct.yml b/.github/workflows/beam_PostCommit_Python_Examples_Direct.yml
index a6bb49f4e444..e271b7da9a7b 100644
--- a/.github/workflows/beam_PostCommit_Python_Examples_Direct.yml
+++ b/.github/workflows/beam_PostCommit_Python_Examples_Direct.yml
@@ -101,4 +101,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_Examples_Flink.yml b/.github/workflows/beam_PostCommit_Python_Examples_Flink.yml
index f23674a2c70a..28fd13c181b3 100644
--- a/.github/workflows/beam_PostCommit_Python_Examples_Flink.yml
+++ b/.github/workflows/beam_PostCommit_Python_Examples_Flink.yml
@@ -102,3 +102,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/pytest*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_Python_Examples_Spark.yml b/.github/workflows/beam_PostCommit_Python_Examples_Spark.yml
index d866d412507b..5df6bcf8c01c 100644
--- a/.github/workflows/beam_PostCommit_Python_Examples_Spark.yml
+++ b/.github/workflows/beam_PostCommit_Python_Examples_Spark.yml
@@ -101,4 +101,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_MongoDBIO_IT.yml b/.github/workflows/beam_PostCommit_Python_MongoDBIO_IT.yml
index 578775a9d3ed..0d334b679dc5 100644
--- a/.github/workflows/beam_PostCommit_Python_MongoDBIO_IT.yml
+++ b/.github/workflows/beam_PostCommit_Python_MongoDBIO_IT.yml
@@ -93,4 +93,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_ValidatesContainer_Dataflow.yml b/.github/workflows/beam_PostCommit_Python_ValidatesContainer_Dataflow.yml
index bcd936324124..6e16f43476b2 100644
--- a/.github/workflows/beam_PostCommit_Python_ValidatesContainer_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_Python_ValidatesContainer_Dataflow.yml
@@ -108,3 +108,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/pytest*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_Python_ValidatesContainer_Dataflow_With_RC.yml b/.github/workflows/beam_PostCommit_Python_ValidatesContainer_Dataflow_With_RC.yml
index f2eba045722c..3ab7257f8a9d 100644
--- a/.github/workflows/beam_PostCommit_Python_ValidatesContainer_Dataflow_With_RC.yml
+++ b/.github/workflows/beam_PostCommit_Python_ValidatesContainer_Dataflow_With_RC.yml
@@ -106,4 +106,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml b/.github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml
index 6f8a7bdd0631..c294dd3c9068 100644
--- a/.github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_Python_ValidatesDistrolessContainer_Dataflow.yml
@@ -118,3 +118,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/pytest*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Dataflow.yml b/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Dataflow.yml
index 1876950c7a93..f8daa1a96634 100644
--- a/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Dataflow.yml
@@ -109,4 +109,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Flink.yml b/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Flink.yml
index f837c7476e12..9277bd68fc01 100644
--- a/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Flink.yml
+++ b/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Flink.yml
@@ -103,4 +103,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Samza.yml b/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Samza.yml
index 91c249adf338..e058724cd2ac 100644
--- a/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Samza.yml
+++ b/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Samza.yml
@@ -102,4 +102,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Spark.yml b/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Spark.yml
index 7e87aaff22cc..a47f758ed410 100644
--- a/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Spark.yml
+++ b/.github/workflows/beam_PostCommit_Python_ValidatesRunner_Spark.yml
@@ -101,4 +101,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_Xlang_Gcp_Dataflow.yml b/.github/workflows/beam_PostCommit_Python_Xlang_Gcp_Dataflow.yml
index b3f37c6b39f0..bd266cf6fdab 100644
--- a/.github/workflows/beam_PostCommit_Python_Xlang_Gcp_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_Python_Xlang_Gcp_Dataflow.yml
@@ -93,4 +93,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_Xlang_Gcp_Direct.yml b/.github/workflows/beam_PostCommit_Python_Xlang_Gcp_Direct.yml
index 137d7bc13d2f..6d26d1c46012 100644
--- a/.github/workflows/beam_PostCommit_Python_Xlang_Gcp_Direct.yml
+++ b/.github/workflows/beam_PostCommit_Python_Xlang_Gcp_Direct.yml
@@ -92,4 +92,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_Xlang_IO_Dataflow.yml b/.github/workflows/beam_PostCommit_Python_Xlang_IO_Dataflow.yml
index 8fc0db189078..08e99fa0fe0f 100644
--- a/.github/workflows/beam_PostCommit_Python_Xlang_IO_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_Python_Xlang_IO_Dataflow.yml
@@ -95,4 +95,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_Python_Xlang_IO_Direct.yml b/.github/workflows/beam_PostCommit_Python_Xlang_IO_Direct.yml
index 5092a1981154..a7643c795af4 100644
--- a/.github/workflows/beam_PostCommit_Python_Xlang_IO_Direct.yml
+++ b/.github/workflows/beam_PostCommit_Python_Xlang_IO_Direct.yml
@@ -93,4 +93,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_SQL.yml b/.github/workflows/beam_PostCommit_SQL.yml
index c7d0b6dc98b9..aebea2b0564b 100644
--- a/.github/workflows/beam_PostCommit_SQL.yml
+++ b/.github/workflows/beam_PostCommit_SQL.yml
@@ -91,3 +91,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_TransformService_Direct.yml b/.github/workflows/beam_PostCommit_TransformService_Direct.yml
index cb339eb9fb40..d0d72f3df13c 100644
--- a/.github/workflows/beam_PostCommit_TransformService_Direct.yml
+++ b/.github/workflows/beam_PostCommit_TransformService_Direct.yml
@@ -98,4 +98,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_XVR_Direct.yml b/.github/workflows/beam_PostCommit_XVR_Direct.yml
index 023ae4f8cd31..af8b7fb1bf54 100644
--- a/.github/workflows/beam_PostCommit_XVR_Direct.yml
+++ b/.github/workflows/beam_PostCommit_XVR_Direct.yml
@@ -109,4 +109,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_XVR_Flink.yml b/.github/workflows/beam_PostCommit_XVR_Flink.yml
index 1f1d7d863b7e..fe4404247448 100644
--- a/.github/workflows/beam_PostCommit_XVR_Flink.yml
+++ b/.github/workflows/beam_PostCommit_XVR_Flink.yml
@@ -111,3 +111,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_XVR_GoUsingJava_Dataflow.yml b/.github/workflows/beam_PostCommit_XVR_GoUsingJava_Dataflow.yml
index 228f10b90cd0..0620023ce7d2 100644
--- a/.github/workflows/beam_PostCommit_XVR_GoUsingJava_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_XVR_GoUsingJava_Dataflow.yml
@@ -102,3 +102,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PostCommit_XVR_JavaUsingPython_Dataflow.yml b/.github/workflows/beam_PostCommit_XVR_JavaUsingPython_Dataflow.yml
index 66770c9a1683..11a8a5c5f4f7 100644
--- a/.github/workflows/beam_PostCommit_XVR_JavaUsingPython_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_XVR_JavaUsingPython_Dataflow.yml
@@ -95,4 +95,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_XVR_PythonUsingJavaSQL_Dataflow.yml b/.github/workflows/beam_PostCommit_XVR_PythonUsingJavaSQL_Dataflow.yml
index bfb602f89daf..c393a4113589 100644
--- a/.github/workflows/beam_PostCommit_XVR_PythonUsingJavaSQL_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_XVR_PythonUsingJavaSQL_Dataflow.yml
@@ -92,4 +92,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_XVR_PythonUsingJava_Dataflow.yml b/.github/workflows/beam_PostCommit_XVR_PythonUsingJava_Dataflow.yml
index f1269a0ddd09..082aeb3f2ab2 100644
--- a/.github/workflows/beam_PostCommit_XVR_PythonUsingJava_Dataflow.yml
+++ b/.github/workflows/beam_PostCommit_XVR_PythonUsingJava_Dataflow.yml
@@ -95,4 +95,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_XVR_Samza.yml b/.github/workflows/beam_PostCommit_XVR_Samza.yml
index 2d26c9131839..7e2dca61d41d 100644
--- a/.github/workflows/beam_PostCommit_XVR_Samza.yml
+++ b/.github/workflows/beam_PostCommit_XVR_Samza.yml
@@ -111,4 +111,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PostCommit_XVR_Spark3.yml b/.github/workflows/beam_PostCommit_XVR_Spark3.yml
index c1880e01292b..17fb58d9dd73 100644
--- a/.github/workflows/beam_PostCommit_XVR_Spark3.yml
+++ b/.github/workflows/beam_PostCommit_XVR_Spark3.yml
@@ -109,4 +109,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_ItFramework.yml b/.github/workflows/beam_PreCommit_ItFramework.yml
index e078d4645757..e803fc023c67 100644
--- a/.github/workflows/beam_PreCommit_ItFramework.yml
+++ b/.github/workflows/beam_PreCommit_ItFramework.yml
@@ -101,4 +101,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Java.yml b/.github/workflows/beam_PreCommit_Java.yml
index 20dafca72a57..bc25fb94f8f0 100644
--- a/.github/workflows/beam_PreCommit_Java.yml
+++ b/.github/workflows/beam_PreCommit_Java.yml
@@ -198,6 +198,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Amazon-Web-Services2_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Amazon-Web-Services2_IO_Direct.yml
index ecbc85ca1b1d..cf0d0b660782 100644
--- a/.github/workflows/beam_PreCommit_Java_Amazon-Web-Services2_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Amazon-Web-Services2_IO_Direct.yml
@@ -130,6 +130,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Amazon-Web-Services_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Amazon-Web-Services_IO_Direct.yml
index 55935251e6d9..9053bb730371 100644
--- a/.github/workflows/beam_PreCommit_Java_Amazon-Web-Services_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Amazon-Web-Services_IO_Direct.yml
@@ -130,6 +130,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Azure_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Azure_IO_Direct.yml
index 4fbacecde4a4..8c0bb07e1acb 100644
--- a/.github/workflows/beam_PreCommit_Java_Azure_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Azure_IO_Direct.yml
@@ -123,6 +123,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Cassandra_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Cassandra_IO_Direct.yml
index e37bc5c56e2e..317b2e1f2ec1 100644
--- a/.github/workflows/beam_PreCommit_Java_Cassandra_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Cassandra_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Cdap_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Cdap_IO_Direct.yml
index 68ebe3c28fb3..3e0208b758cc 100644
--- a/.github/workflows/beam_PreCommit_Java_Cdap_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Cdap_IO_Direct.yml
@@ -109,6 +109,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Clickhouse_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Clickhouse_IO_Direct.yml
index 5c0b169b0ba1..2be7607b5bc7 100644
--- a/.github/workflows/beam_PreCommit_Java_Clickhouse_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Clickhouse_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Csv_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Csv_IO_Direct.yml
index ce91551c1121..6901e56c0bbb 100644
--- a/.github/workflows/beam_PreCommit_Java_Csv_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Csv_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Debezium_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Debezium_IO_Direct.yml
index b6a0e6b999bd..6f32c3844b1a 100644
--- a/.github/workflows/beam_PreCommit_Java_Debezium_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Debezium_IO_Direct.yml
@@ -114,6 +114,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_ElasticSearch_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_ElasticSearch_IO_Direct.yml
index 78ab882d4774..11a95cf476c7 100644
--- a/.github/workflows/beam_PreCommit_Java_ElasticSearch_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_ElasticSearch_IO_Direct.yml
@@ -117,6 +117,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Examples_Dataflow.yml b/.github/workflows/beam_PreCommit_Java_Examples_Dataflow.yml
index 4bfb20a28e7c..8e22318bdcb9 100644
--- a/.github/workflows/beam_PreCommit_Java_Examples_Dataflow.yml
+++ b/.github/workflows/beam_PreCommit_Java_Examples_Dataflow.yml
@@ -117,4 +117,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Java_Examples_Dataflow_Java21.yml b/.github/workflows/beam_PreCommit_Java_Examples_Dataflow_Java21.yml
index 72fc945018f6..763de153b137 100644
--- a/.github/workflows/beam_PreCommit_Java_Examples_Dataflow_Java21.yml
+++ b/.github/workflows/beam_PreCommit_Java_Examples_Dataflow_Java21.yml
@@ -133,6 +133,7 @@ jobs:
         commit: '${{ env.prsha || env.GITHUB_SHA }}'
         comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
         files: '**/build/test-results/**/*.xml'
+        large_files: true
     - name: Archive SpotBugs Results
       uses: actions/upload-artifact@v4
       with:
diff --git a/.github/workflows/beam_PreCommit_Java_File-schema-transform_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_File-schema-transform_IO_Direct.yml
index e96dc7c883bf..e121fe1e53a2 100644
--- a/.github/workflows/beam_PreCommit_Java_File-schema-transform_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_File-schema-transform_IO_Direct.yml
@@ -106,6 +106,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Flink_Versions.yml b/.github/workflows/beam_PreCommit_Java_Flink_Versions.yml
index 19b0d56a8051..09bf906e5a38 100644
--- a/.github/workflows/beam_PreCommit_Java_Flink_Versions.yml
+++ b/.github/workflows/beam_PreCommit_Java_Flink_Versions.yml
@@ -104,4 +104,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Java_GCP_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_GCP_IO_Direct.yml
index 2256d0a91cb8..ee5bea3d3ab3 100644
--- a/.github/workflows/beam_PreCommit_Java_GCP_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_GCP_IO_Direct.yml
@@ -127,6 +127,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Google-ads_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Google-ads_IO_Direct.yml
index c481251bef03..0e6bd11e7f1e 100644
--- a/.github/workflows/beam_PreCommit_Java_Google-ads_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Google-ads_IO_Direct.yml
@@ -103,6 +103,7 @@ jobs:
         commit: '${{ env.prsha || env.GITHUB_SHA }}'
         comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
         files: '**/build/test-results/**/*.xml'
+        large_files: true
     - name: Archive SpotBugs Results
       uses: actions/upload-artifact@v4
       if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_HBase_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_HBase_IO_Direct.yml
index 3b99e30bfbac..c334edd7f32d 100644
--- a/.github/workflows/beam_PreCommit_Java_HBase_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_HBase_IO_Direct.yml
@@ -107,6 +107,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_HCatalog_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_HCatalog_IO_Direct.yml
index 6d45ba82aa49..ed079c1e9dd1 100644
--- a/.github/workflows/beam_PreCommit_Java_HCatalog_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_HCatalog_IO_Direct.yml
@@ -122,6 +122,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Hadoop_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Hadoop_IO_Direct.yml
index c2beaa3c1099..442085586a3c 100644
--- a/.github/workflows/beam_PreCommit_Java_Hadoop_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Hadoop_IO_Direct.yml
@@ -145,6 +145,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_IOs_Direct.yml b/.github/workflows/beam_PreCommit_Java_IOs_Direct.yml
index 4e19a56dde0c..cd73d402c7ea 100644
--- a/.github/workflows/beam_PreCommit_Java_IOs_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_IOs_Direct.yml
@@ -122,6 +122,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_InfluxDb_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_InfluxDb_IO_Direct.yml
index 903a7cd73526..977781de506f 100644
--- a/.github/workflows/beam_PreCommit_Java_InfluxDb_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_InfluxDb_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_JDBC_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_JDBC_IO_Direct.yml
index 071cdb3bda3e..4759d48d979f 100644
--- a/.github/workflows/beam_PreCommit_Java_JDBC_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_JDBC_IO_Direct.yml
@@ -112,6 +112,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Jms_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Jms_IO_Direct.yml
index 650036345274..935315463358 100644
--- a/.github/workflows/beam_PreCommit_Java_Jms_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Jms_IO_Direct.yml
@@ -112,6 +112,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Kafka_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Kafka_IO_Direct.yml
index 0ede01376ce7..f177ec85fada 100644
--- a/.github/workflows/beam_PreCommit_Java_Kafka_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Kafka_IO_Direct.yml
@@ -114,6 +114,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Kinesis_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Kinesis_IO_Direct.yml
index 494a738abf45..785748e793e9 100644
--- a/.github/workflows/beam_PreCommit_Java_Kinesis_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Kinesis_IO_Direct.yml
@@ -137,6 +137,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Kudu_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Kudu_IO_Direct.yml
index e38c9a761dee..853e52db14db 100644
--- a/.github/workflows/beam_PreCommit_Java_Kudu_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Kudu_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_MongoDb_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_MongoDb_IO_Direct.yml
index 11be57c05759..b3292ac5f29b 100644
--- a/.github/workflows/beam_PreCommit_Java_MongoDb_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_MongoDb_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Mqtt_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Mqtt_IO_Direct.yml
index ac8800f55cdf..ed0189d8006b 100644
--- a/.github/workflows/beam_PreCommit_Java_Mqtt_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Mqtt_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Neo4j_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Neo4j_IO_Direct.yml
index 553300f1889c..62429a611f2a 100644
--- a/.github/workflows/beam_PreCommit_Java_Neo4j_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Neo4j_IO_Direct.yml
@@ -114,6 +114,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_PVR_Flink_Docker.yml b/.github/workflows/beam_PreCommit_Java_PVR_Flink_Docker.yml
index 5feb0270c68c..48f165f4e59f 100644
--- a/.github/workflows/beam_PreCommit_Java_PVR_Flink_Docker.yml
+++ b/.github/workflows/beam_PreCommit_Java_PVR_Flink_Docker.yml
@@ -115,3 +115,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
diff --git a/.github/workflows/beam_PreCommit_Java_Parquet_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Parquet_IO_Direct.yml
index 0bec073fc37b..d217f0e88c39 100644
--- a/.github/workflows/beam_PreCommit_Java_Parquet_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Parquet_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Pulsar_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Pulsar_IO_Direct.yml
index e25b4ff6fa94..3a9d62fb64c6 100644
--- a/.github/workflows/beam_PreCommit_Java_Pulsar_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Pulsar_IO_Direct.yml
@@ -123,6 +123,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_RabbitMq_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_RabbitMq_IO_Direct.yml
index eb343f193395..c72b04bc108d 100644
--- a/.github/workflows/beam_PreCommit_Java_RabbitMq_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_RabbitMq_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Redis_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Redis_IO_Direct.yml
index 13b9c26b4b81..cd4ddc387ffc 100644
--- a/.github/workflows/beam_PreCommit_Java_Redis_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Redis_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_RequestResponse_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_RequestResponse_IO_Direct.yml
index f1e8c3699aa6..1037ab972447 100644
--- a/.github/workflows/beam_PreCommit_Java_RequestResponse_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_RequestResponse_IO_Direct.yml
@@ -103,6 +103,7 @@ jobs:
         commit: '${{ env.prsha || env.GITHUB_SHA }}'
         comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
         files: '**/build/test-results/**/*.xml'
+        large_files: true
     - name: Archive SpotBugs Results
       uses: actions/upload-artifact@v4
       if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_SingleStore_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_SingleStore_IO_Direct.yml
index 4d289882353e..478dad9989b9 100644
--- a/.github/workflows/beam_PreCommit_Java_SingleStore_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_SingleStore_IO_Direct.yml
@@ -107,6 +107,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Snowflake_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Snowflake_IO_Direct.yml
index 03577eff2860..403c26ac0ab0 100644
--- a/.github/workflows/beam_PreCommit_Java_Snowflake_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Snowflake_IO_Direct.yml
@@ -116,6 +116,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Solace_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Solace_IO_Direct.yml
index 5aeaaec11dec..ca05b44875cb 100644
--- a/.github/workflows/beam_PreCommit_Java_Solace_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Solace_IO_Direct.yml
@@ -112,6 +112,7 @@ jobs:
         commit: '${{ env.prsha || env.GITHUB_SHA }}'
         comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
         files: '**/build/test-results/**/*.xml'
+        large_files: true
     - name: Archive SpotBugs Results
       uses: actions/upload-artifact@v4
       if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Solr_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Solr_IO_Direct.yml
index e6138a0c10d9..80cd5e492992 100644
--- a/.github/workflows/beam_PreCommit_Java_Solr_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Solr_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Spark3_Versions.yml b/.github/workflows/beam_PreCommit_Java_Spark3_Versions.yml
index 18f5a6c0c86e..c6b2d7e57128 100644
--- a/.github/workflows/beam_PreCommit_Java_Spark3_Versions.yml
+++ b/.github/workflows/beam_PreCommit_Java_Spark3_Versions.yml
@@ -112,4 +112,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/build/test-results/**/*.xml'
\ No newline at end of file
+          files: '**/build/test-results/**/*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Java_Splunk_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Splunk_IO_Direct.yml
index 73a1a0b5cdb2..53f3c4327739 100644
--- a/.github/workflows/beam_PreCommit_Java_Splunk_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Splunk_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Thrift_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Thrift_IO_Direct.yml
index 4cddfa728cc1..b5336537c556 100644
--- a/.github/workflows/beam_PreCommit_Java_Thrift_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Thrift_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Java_Tika_IO_Direct.yml b/.github/workflows/beam_PreCommit_Java_Tika_IO_Direct.yml
index e08b5048b359..195e9aa1f168 100644
--- a/.github/workflows/beam_PreCommit_Java_Tika_IO_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Java_Tika_IO_Direct.yml
@@ -105,6 +105,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Python.yml b/.github/workflows/beam_PreCommit_Python.yml
index fb1c6c80873a..68c69ae953a4 100644
--- a/.github/workflows/beam_PreCommit_Python.yml
+++ b/.github/workflows/beam_PreCommit_Python.yml
@@ -109,4 +109,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Python_Coverage.yml b/.github/workflows/beam_PreCommit_Python_Coverage.yml
index 0e295250817d..3c7c3b05d8bc 100644
--- a/.github/workflows/beam_PreCommit_Python_Coverage.yml
+++ b/.github/workflows/beam_PreCommit_Python_Coverage.yml
@@ -104,4 +104,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Python_Dataframes.yml b/.github/workflows/beam_PreCommit_Python_Dataframes.yml
index f045842e061d..ecbb1a30e5f7 100644
--- a/.github/workflows/beam_PreCommit_Python_Dataframes.yml
+++ b/.github/workflows/beam_PreCommit_Python_Dataframes.yml
@@ -109,4 +109,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Python_Examples.yml b/.github/workflows/beam_PreCommit_Python_Examples.yml
index 09d46217d6d6..44329f63014d 100644
--- a/.github/workflows/beam_PreCommit_Python_Examples.yml
+++ b/.github/workflows/beam_PreCommit_Python_Examples.yml
@@ -109,4 +109,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Python_Integration.yml b/.github/workflows/beam_PreCommit_Python_Integration.yml
index 20aade431f6d..3a709c70f077 100644
--- a/.github/workflows/beam_PreCommit_Python_Integration.yml
+++ b/.github/workflows/beam_PreCommit_Python_Integration.yml
@@ -116,4 +116,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Python_ML.yml b/.github/workflows/beam_PreCommit_Python_ML.yml
index 714eceef5f6b..3b3a2150ac28 100644
--- a/.github/workflows/beam_PreCommit_Python_ML.yml
+++ b/.github/workflows/beam_PreCommit_Python_ML.yml
@@ -109,4 +109,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Python_PVR_Flink.yml b/.github/workflows/beam_PreCommit_Python_PVR_Flink.yml
index dbc1264fcc04..5dd12d49ccd9 100644
--- a/.github/workflows/beam_PreCommit_Python_PVR_Flink.yml
+++ b/.github/workflows/beam_PreCommit_Python_PVR_Flink.yml
@@ -125,4 +125,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Python_Runners.yml b/.github/workflows/beam_PreCommit_Python_Runners.yml
index 5db6e94be781..689d9b2c3c3f 100644
--- a/.github/workflows/beam_PreCommit_Python_Runners.yml
+++ b/.github/workflows/beam_PreCommit_Python_Runners.yml
@@ -109,4 +109,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_Python_Transforms.yml b/.github/workflows/beam_PreCommit_Python_Transforms.yml
index 820ca3e26df6..431b82c02fb7 100644
--- a/.github/workflows/beam_PreCommit_Python_Transforms.yml
+++ b/.github/workflows/beam_PreCommit_Python_Transforms.yml
@@ -109,4 +109,5 @@ jobs:
         with:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
-          files: '**/pytest*.xml'
\ No newline at end of file
+          files: '**/pytest*.xml'
+          large_files: true
\ No newline at end of file
diff --git a/.github/workflows/beam_PreCommit_SQL.yml b/.github/workflows/beam_PreCommit_SQL.yml
index b4002fcc2a79..5bc8bb581955 100644
--- a/.github/workflows/beam_PreCommit_SQL.yml
+++ b/.github/workflows/beam_PreCommit_SQL.yml
@@ -103,6 +103,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_SQL_Java17.yml b/.github/workflows/beam_PreCommit_SQL_Java17.yml
index 0e5dcc87d16f..1cfd7502389d 100644
--- a/.github/workflows/beam_PreCommit_SQL_Java17.yml
+++ b/.github/workflows/beam_PreCommit_SQL_Java17.yml
@@ -110,6 +110,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_SQL_Java8.yml b/.github/workflows/beam_PreCommit_SQL_Java8.yml
index 23938821b2e8..6b59739dd72d 100644
--- a/.github/workflows/beam_PreCommit_SQL_Java8.yml
+++ b/.github/workflows/beam_PreCommit_SQL_Java8.yml
@@ -114,6 +114,7 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
+          large_files: true
       - name: Archive SpotBugs Results
         uses: actions/upload-artifact@v4
         if: always()
diff --git a/.github/workflows/beam_PreCommit_Yaml_Xlang_Direct.yml b/.github/workflows/beam_PreCommit_Yaml_Xlang_Direct.yml
index b17913946a7e..b9e310a7a133 100644
--- a/.github/workflows/beam_PreCommit_Yaml_Xlang_Direct.yml
+++ b/.github/workflows/beam_PreCommit_Yaml_Xlang_Direct.yml
@@ -105,3 +105,4 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/pytest*.xml'
+          large_files: true

From e2ff659c98c245df7fa8b833b297b8c75895f804 Mon Sep 17 00:00:00 2001
From: Bartosz Zablocki <bzablocki@google.com>
Date: Wed, 11 Dec 2024 17:11:05 +0000
Subject: [PATCH 098/135] Reapply "SolaceIO.Read: handle occasional cases when
 finalizeCheckpoint is not executed (#32962)" (#33259) (#33269)

This reverts commit 4356253a5e8124bf39152a9ead9ad26ef7267750.
---
 .../broker/BasicAuthJcsmpSessionService.java  |  18 +--
 .../sdk/io/solace/broker/MessageReceiver.java |   7 -
 .../sdk/io/solace/broker/SessionService.java  |   7 -
 .../solace/broker/SolaceMessageReceiver.java  |  17 +--
 .../io/solace/read/SolaceCheckpointMark.java  |  46 +++---
 .../io/solace/read/UnboundedSolaceReader.java | 135 +++++++++++++-----
 .../io/solace/MockEmptySessionService.java    |   5 -
 .../sdk/io/solace/MockSessionService.java     |  10 --
 .../beam/sdk/io/solace/SolaceIOReadTest.java  |  20 +--
 9 files changed, 138 insertions(+), 127 deletions(-)

diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java
index b2196dbf1067..d4c9a3ec6210 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/BasicAuthJcsmpSessionService.java
@@ -102,10 +102,7 @@ public void close() {
           if (messageReceiver != null) {
             messageReceiver.close();
           }
-          if (messageProducer != null) {
-            messageProducer.close();
-          }
-          if (!isClosed()) {
+          if (jcsmpSession != null) {
             checkStateNotNull(jcsmpSession).closeSession();
           }
           return 0;
@@ -119,8 +116,9 @@ public MessageReceiver getReceiver() {
       this.messageReceiver =
           retryCallableManager.retryCallable(
               this::createFlowReceiver, ImmutableSet.of(JCSMPException.class));
+      this.messageReceiver.start();
     }
-    return this.messageReceiver;
+    return checkStateNotNull(this.messageReceiver);
   }
 
   @Override
@@ -138,15 +136,10 @@ public java.util.Queue<PublishResult> getPublishedResultsQueue() {
     return publishedResultsQueue;
   }
 
-  @Override
-  public boolean isClosed() {
-    return jcsmpSession == null || jcsmpSession.isClosed();
-  }
-
   private MessageProducer createXMLMessageProducer(SubmissionMode submissionMode)
       throws JCSMPException, IOException {
 
-    if (isClosed()) {
+    if (jcsmpSession == null) {
       connectWriteSession(submissionMode);
     }
 
@@ -165,9 +158,6 @@ private MessageProducer createXMLMessageProducer(SubmissionMode submissionMode)
   }
 
   private MessageReceiver createFlowReceiver() throws JCSMPException, IOException {
-    if (isClosed()) {
-      connectSession();
-    }
 
     Queue queue =
         JCSMPFactory.onlyInstance()
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java
index 95f989bd1be9..017a63260678 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/MessageReceiver.java
@@ -35,13 +35,6 @@ public interface MessageReceiver {
    */
   void start();
 
-  /**
-   * Returns {@literal true} if the message receiver is closed, {@literal false} otherwise.
-   *
-   * <p>A message receiver is closed when it is no longer able to receive messages.
-   */
-  boolean isClosed();
-
   /**
    * Receives a message from the broker.
    *
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java
index 84a876a9d0bc..6dcd0b652616 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SessionService.java
@@ -120,13 +120,6 @@ public abstract class SessionService implements Serializable {
   /** Gracefully closes the connection to the service. */
   public abstract void close();
 
-  /**
-   * Checks whether the connection to the service is currently closed. This method is called when an
-   * `UnboundedSolaceReader` is starting to read messages - a session will be created if this
-   * returns true.
-   */
-  public abstract boolean isClosed();
-
   /**
    * Returns a MessageReceiver object for receiving messages from Solace. If it is the first time
    * this method is used, the receiver is created from the session instance, otherwise it returns
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java
index d548d2049a5b..d74f3cae89fe 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/broker/SolaceMessageReceiver.java
@@ -24,12 +24,8 @@
 import java.io.IOException;
 import org.apache.beam.sdk.io.solace.RetryCallableManager;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableSet;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 public class SolaceMessageReceiver implements MessageReceiver {
-  private static final Logger LOG = LoggerFactory.getLogger(SolaceMessageReceiver.class);
-
   public static final int DEFAULT_ADVANCE_TIMEOUT_IN_MILLIS = 100;
   private final FlowReceiver flowReceiver;
   private final RetryCallableManager retryCallableManager = RetryCallableManager.create();
@@ -52,19 +48,14 @@ private void startFlowReceiver() {
         ImmutableSet.of(JCSMPException.class));
   }
 
-  @Override
-  public boolean isClosed() {
-    return flowReceiver == null || flowReceiver.isClosed();
-  }
-
   @Override
   public BytesXMLMessage receive() throws IOException {
     try {
       return flowReceiver.receive(DEFAULT_ADVANCE_TIMEOUT_IN_MILLIS);
     } catch (StaleSessionException e) {
-      LOG.warn("SolaceIO: Caught StaleSessionException, restarting the FlowReceiver.");
       startFlowReceiver();
-      throw new IOException(e);
+      throw new IOException(
+          "SolaceIO: Caught StaleSessionException, restarting the FlowReceiver.", e);
     } catch (JCSMPException e) {
       throw new IOException(e);
     }
@@ -72,8 +63,6 @@ public BytesXMLMessage receive() throws IOException {
 
   @Override
   public void close() {
-    if (!isClosed()) {
-      this.flowReceiver.close();
-    }
+    flowReceiver.close();
   }
 }
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java
index 77f6eed8f62c..a913fd6133ea 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/SolaceCheckpointMark.java
@@ -18,17 +18,16 @@
 package org.apache.beam.sdk.io.solace.read;
 
 import com.solacesystems.jcsmp.BytesXMLMessage;
-import java.util.ArrayDeque;
-import java.util.ArrayList;
-import java.util.List;
 import java.util.Objects;
-import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.Queue;
 import org.apache.beam.sdk.annotations.Internal;
 import org.apache.beam.sdk.coders.DefaultCoder;
 import org.apache.beam.sdk.extensions.avro.coders.AvroCoder;
 import org.apache.beam.sdk.io.UnboundedSource;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.annotations.VisibleForTesting;
 import org.checkerframework.checker.nullness.qual.Nullable;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 /**
  * Checkpoint for an unbounded Solace source. Consists of the Solace messages waiting to be
@@ -38,10 +37,8 @@
 @Internal
 @VisibleForTesting
 public class SolaceCheckpointMark implements UnboundedSource.CheckpointMark {
-  private transient AtomicBoolean activeReader;
-  // BytesXMLMessage is not serializable so if a job restarts from the checkpoint, we cannot retry
-  // these messages here. We relay on Solace's retry mechanism.
-  private transient ArrayDeque<BytesXMLMessage> ackQueue;
+  private static final Logger LOG = LoggerFactory.getLogger(SolaceCheckpointMark.class);
+  private transient Queue<BytesXMLMessage> safeToAck;
 
   @SuppressWarnings("initialization") // Avro will set the fields by breaking abstraction
   private SolaceCheckpointMark() {}
@@ -49,25 +46,24 @@ private SolaceCheckpointMark() {}
   /**
    * Creates a new {@link SolaceCheckpointMark}.
    *
-   * @param activeReader {@link AtomicBoolean} indicating if the related reader is active. The
-   *     reader creating the messages has to be active to acknowledge the messages.
-   * @param ackQueue {@link List} of {@link BytesXMLMessage} to be acknowledged.
+   * @param safeToAck - a queue of {@link BytesXMLMessage} to be acknowledged.
    */
-  SolaceCheckpointMark(AtomicBoolean activeReader, List<BytesXMLMessage> ackQueue) {
-    this.activeReader = activeReader;
-    this.ackQueue = new ArrayDeque<>(ackQueue);
+  SolaceCheckpointMark(Queue<BytesXMLMessage> safeToAck) {
+    this.safeToAck = safeToAck;
   }
 
   @Override
   public void finalizeCheckpoint() {
-    if (activeReader == null || !activeReader.get() || ackQueue == null) {
-      return;
-    }
-
-    while (!ackQueue.isEmpty()) {
-      BytesXMLMessage msg = ackQueue.poll();
-      if (msg != null) {
+    BytesXMLMessage msg;
+    while ((msg = safeToAck.poll()) != null) {
+      try {
         msg.ackMessage();
+      } catch (IllegalStateException e) {
+        LOG.error(
+            "SolaceIO.Read: cannot acknowledge the message with applicationMessageId={}, ackMessageId={}. It will not be retried.",
+            msg.getApplicationMessageId(),
+            msg.getAckMessageId(),
+            e);
       }
     }
   }
@@ -84,15 +80,11 @@ public boolean equals(@Nullable Object o) {
       return false;
     }
     SolaceCheckpointMark that = (SolaceCheckpointMark) o;
-    // Needed to convert to ArrayList because ArrayDeque.equals checks only for reference, not
-    // content.
-    ArrayList<BytesXMLMessage> ackList = new ArrayList<>(ackQueue);
-    ArrayList<BytesXMLMessage> thatAckList = new ArrayList<>(that.ackQueue);
-    return Objects.equals(activeReader, that.activeReader) && Objects.equals(ackList, thatAckList);
+    return Objects.equals(safeToAck, that.safeToAck);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(activeReader, ackQueue);
+    return Objects.hash(safeToAck);
   }
 }
diff --git a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java
index a421970370da..dc84e0a07017 100644
--- a/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java
+++ b/sdks/java/io/solace/src/main/java/org/apache/beam/sdk/io/solace/read/UnboundedSolaceReader.java
@@ -22,17 +22,26 @@
 import com.solacesystems.jcsmp.BytesXMLMessage;
 import java.io.IOException;
 import java.nio.charset.StandardCharsets;
+import java.time.Duration;
 import java.util.ArrayDeque;
-import java.util.ArrayList;
-import java.util.List;
 import java.util.NoSuchElementException;
-import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.Queue;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentLinkedQueue;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.Executors;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
 import org.apache.beam.sdk.io.UnboundedSource;
 import org.apache.beam.sdk.io.UnboundedSource.UnboundedReader;
 import org.apache.beam.sdk.io.solace.broker.SempClient;
 import org.apache.beam.sdk.io.solace.broker.SessionService;
+import org.apache.beam.sdk.io.solace.broker.SessionServiceFactory;
 import org.apache.beam.sdk.transforms.windowing.BoundedWindow;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.annotations.VisibleForTesting;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.Cache;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.CacheBuilder;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.RemovalNotification;
 import org.checkerframework.checker.nullness.qual.Nullable;
 import org.joda.time.Instant;
 import org.slf4j.Logger;
@@ -46,48 +55,92 @@ class UnboundedSolaceReader<T> extends UnboundedReader<T> {
   private final UnboundedSolaceSource<T> currentSource;
   private final WatermarkPolicy<T> watermarkPolicy;
   private final SempClient sempClient;
+  private final UUID readerUuid;
+  private final SessionServiceFactory sessionServiceFactory;
   private @Nullable BytesXMLMessage solaceOriginalRecord;
   private @Nullable T solaceMappedRecord;
-  private @Nullable SessionService sessionService;
-  AtomicBoolean active = new AtomicBoolean(true);
 
   /**
-   * Queue to place advanced messages before {@link #getCheckpointMark()} be called non-concurrent
-   * queue, should only be accessed by the reader thread A given {@link UnboundedReader} object will
-   * only be accessed by a single thread at once.
+   * Queue to place advanced messages before {@link #getCheckpointMark()} is called. CAUTION:
+   * Accessed by both reader and checkpointing threads.
    */
-  private final java.util.Queue<BytesXMLMessage> elementsToCheckpoint = new ArrayDeque<>();
+  private final Queue<BytesXMLMessage> safeToAckMessages = new ConcurrentLinkedQueue<>();
+
+  /**
+   * Queue for messages that were ingested in the {@link #advance()} method, but not sent yet to a
+   * {@link SolaceCheckpointMark}.
+   */
+  private final Queue<BytesXMLMessage> receivedMessages = new ArrayDeque<>();
+
+  private static final Cache<UUID, SessionService> sessionServiceCache;
+  private static final ScheduledExecutorService cleanUpThread = Executors.newScheduledThreadPool(1);
+
+  static {
+    Duration cacheExpirationTimeout = Duration.ofMinutes(1);
+    sessionServiceCache =
+        CacheBuilder.newBuilder()
+            .expireAfterAccess(cacheExpirationTimeout)
+            .removalListener(
+                (RemovalNotification<UUID, SessionService> notification) -> {
+                  LOG.info(
+                      "SolaceIO.Read: Closing session for the reader with uuid {} as it has been idle for over {}.",
+                      notification.getKey(),
+                      cacheExpirationTimeout);
+                  SessionService sessionService = notification.getValue();
+                  if (sessionService != null) {
+                    sessionService.close();
+                  }
+                })
+            .build();
+
+    startCleanUpThread();
+  }
+
+  @SuppressWarnings("FutureReturnValueIgnored")
+  private static void startCleanUpThread() {
+    cleanUpThread.scheduleAtFixedRate(sessionServiceCache::cleanUp, 1, 1, TimeUnit.MINUTES);
+  }
 
   public UnboundedSolaceReader(UnboundedSolaceSource<T> currentSource) {
     this.currentSource = currentSource;
     this.watermarkPolicy =
         WatermarkPolicy.create(
             currentSource.getTimestampFn(), currentSource.getWatermarkIdleDurationThreshold());
-    this.sessionService = currentSource.getSessionServiceFactory().create();
+    this.sessionServiceFactory = currentSource.getSessionServiceFactory();
     this.sempClient = currentSource.getSempClientFactory().create();
+    this.readerUuid = UUID.randomUUID();
+  }
+
+  private SessionService getSessionService() {
+    try {
+      return sessionServiceCache.get(
+          readerUuid,
+          () -> {
+            LOG.info("SolaceIO.Read: creating a new session for reader with uuid {}.", readerUuid);
+            SessionService sessionService = sessionServiceFactory.create();
+            sessionService.connect();
+            sessionService.getReceiver().start();
+            return sessionService;
+          });
+    } catch (ExecutionException e) {
+      throw new RuntimeException(e);
+    }
   }
 
   @Override
   public boolean start() {
-    populateSession();
-    checkNotNull(sessionService).getReceiver().start();
+    // Create and initialize SessionService with Receiver
+    getSessionService();
     return advance();
   }
 
-  public void populateSession() {
-    if (sessionService == null) {
-      sessionService = getCurrentSource().getSessionServiceFactory().create();
-    }
-    if (sessionService.isClosed()) {
-      checkNotNull(sessionService).connect();
-    }
-  }
-
   @Override
   public boolean advance() {
+    finalizeReadyMessages();
+
     BytesXMLMessage receivedXmlMessage;
     try {
-      receivedXmlMessage = checkNotNull(sessionService).getReceiver().receive();
+      receivedXmlMessage = getSessionService().getReceiver().receive();
     } catch (IOException e) {
       LOG.warn("SolaceIO.Read: Exception when pulling messages from the broker.", e);
       return false;
@@ -96,23 +149,40 @@ public boolean advance() {
     if (receivedXmlMessage == null) {
       return false;
     }
-    elementsToCheckpoint.add(receivedXmlMessage);
     solaceOriginalRecord = receivedXmlMessage;
     solaceMappedRecord = getCurrentSource().getParseFn().apply(receivedXmlMessage);
-    watermarkPolicy.update(solaceMappedRecord);
+    receivedMessages.add(receivedXmlMessage);
+
     return true;
   }
 
   @Override
   public void close() {
-    active.set(false);
-    checkNotNull(sessionService).close();
+    finalizeReadyMessages();
+    sessionServiceCache.invalidate(readerUuid);
+  }
+
+  public void finalizeReadyMessages() {
+    BytesXMLMessage msg;
+    while ((msg = safeToAckMessages.poll()) != null) {
+      try {
+        msg.ackMessage();
+      } catch (IllegalStateException e) {
+        LOG.error(
+            "SolaceIO.Read: failed to acknowledge the message with applicationMessageId={}, ackMessageId={}. Returning the message to queue to retry.",
+            msg.getApplicationMessageId(),
+            msg.getAckMessageId(),
+            e);
+        safeToAckMessages.add(msg); // In case the error was transient, might succeed later
+        break; // Commit is only best effort
+      }
+    }
   }
 
   @Override
   public Instant getWatermark() {
     // should be only used by a test receiver
-    if (checkNotNull(sessionService).getReceiver().isEOF()) {
+    if (getSessionService().getReceiver().isEOF()) {
       return BoundedWindow.TIMESTAMP_MAX_VALUE;
     }
     return watermarkPolicy.getWatermark();
@@ -120,14 +190,9 @@ public Instant getWatermark() {
 
   @Override
   public UnboundedSource.CheckpointMark getCheckpointMark() {
-    List<BytesXMLMessage> ackQueue = new ArrayList<>();
-    while (!elementsToCheckpoint.isEmpty()) {
-      BytesXMLMessage msg = elementsToCheckpoint.poll();
-      if (msg != null) {
-        ackQueue.add(msg);
-      }
-    }
-    return new SolaceCheckpointMark(active, ackQueue);
+    safeToAckMessages.addAll(receivedMessages);
+    receivedMessages.clear();
+    return new SolaceCheckpointMark(safeToAckMessages);
   }
 
   @Override
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java
index 38b4953a5984..7631d32f63cc 100644
--- a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockEmptySessionService.java
@@ -40,11 +40,6 @@ public void close() {
     throw new UnsupportedOperationException(exceptionMessage);
   }
 
-  @Override
-  public boolean isClosed() {
-    throw new UnsupportedOperationException(exceptionMessage);
-  }
-
   @Override
   public MessageReceiver getReceiver() {
     throw new UnsupportedOperationException(exceptionMessage);
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java
index bd52dee7ea86..6d28bcefc84c 100644
--- a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/MockSessionService.java
@@ -77,11 +77,6 @@ public abstract Builder mockProducerFn(
   @Override
   public void close() {}
 
-  @Override
-  public boolean isClosed() {
-    return false;
-  }
-
   @Override
   public MessageReceiver getReceiver() {
     if (messageReceiver == null) {
@@ -131,11 +126,6 @@ public MockReceiver(
     @Override
     public void start() {}
 
-    @Override
-    public boolean isClosed() {
-      return false;
-    }
-
     @Override
     public BytesXMLMessage receive() throws IOException {
       return getRecordFn.apply(counter.getAndIncrement());
diff --git a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java
index c718c55e1b48..a1f80932eddf 100644
--- a/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java
+++ b/sdks/java/io/solace/src/test/java/org/apache/beam/sdk/io/solace/SolaceIOReadTest.java
@@ -447,25 +447,29 @@ public void testCheckpointMarkAndFinalizeSeparately() throws Exception {
     // start the reader and move to the first record
     assertTrue(reader.start());
 
-    // consume 3 messages (NB: start already consumed the first message)
+    // consume 3 messages (NB: #start() already consumed the first message)
     for (int i = 0; i < 3; i++) {
       assertTrue(String.format("Failed at %d-th message", i), reader.advance());
     }
 
-    // create checkpoint but don't finalize yet
+    // #advance() was called, but the messages were not ready to be acknowledged.
+    assertEquals(0, countAckMessages.get());
+
+    // mark all consumed messages as ready to be acknowledged
     CheckpointMark checkpointMark = reader.getCheckpointMark();
 
-    // consume 2 more messages
-    reader.advance();
+    // consume 1 more message. This will call #ackMsg() on messages that were ready to be acked.
     reader.advance();
+    assertEquals(4, countAckMessages.get());
 
-    // check if messages are still not acknowledged
-    assertEquals(0, countAckMessages.get());
+    // consume 1 more message. No change in the acknowledged messages.
+    reader.advance();
+    assertEquals(4, countAckMessages.get());
 
     // acknowledge from the first checkpoint
     checkpointMark.finalizeCheckpoint();
-
-    // only messages from the first checkpoint are acknowledged
+    // No change in the acknowledged messages, because they were acknowledged in the #advance()
+    // method.
     assertEquals(4, countAckMessages.get());
   }
 

From a27282363aa2b97dda96750f6d1cbf55ebd752ae Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rados=C5=82aw=20Stankiewicz?= <radoslaws@google.com>
Date: Wed, 11 Dec 2024 20:35:42 +0100
Subject: [PATCH 099/135] Update confluent version to fix CVE-2024-26308
 CVE-2024-25710 (#32674)

* bump confluent version

Kafka Schema Registry Client has been reported with following vuln
CVE-2024-26308
CVE-2024-25710 due to vulnerable dependencies.

* try slighly older version due to unmet dependencies to ThrottlingQuotaExceededException

* try slighly older version due to unmet dependencies to ThrottlingQuotaExceededException

* comment on version
---
 sdks/java/io/kafka/build.gradle | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/sdks/java/io/kafka/build.gradle b/sdks/java/io/kafka/build.gradle
index c2f056b0b7cb..04563c478d6d 100644
--- a/sdks/java/io/kafka/build.gradle
+++ b/sdks/java/io/kafka/build.gradle
@@ -31,7 +31,8 @@ enableJavaPerformanceTesting()
 description = "Apache Beam :: SDKs :: Java :: IO :: Kafka"
 ext {
     summary = "Library to read Kafka topics."
-    confluentVersion = "7.6.0"
+    // newer versions e.g. 7.6.* require dropping support for older kafka versions.
+    confluentVersion = "7.5.5"
 }
 
 def kafkaVersions = [

From 3dcd10424f66e20ec746eb9f7ff3122cf716c53c Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Wed, 11 Dec 2024 11:52:45 -0800
Subject: [PATCH 100/135] Update reference.

---
 sdks/python/apache_beam/metrics/cells.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sdks/python/apache_beam/metrics/cells.py b/sdks/python/apache_beam/metrics/cells.py
index e044693a6e9a..8b4b7e1271c2 100644
--- a/sdks/python/apache_beam/metrics/cells.py
+++ b/sdks/python/apache_beam/metrics/cells.py
@@ -318,7 +318,7 @@ def to_runner_api_monitoring_info_impl(self, name, transform_id):
 class BoundedTrieCell(AbstractMetricCell):
   """For internal use only; no backwards-compatibility guarantees.
 
-  Tracks the current value for a StringSet metric.
+  Tracks the current value for a BoundedTrie metric.
 
   Each cell tracks the state of a metric independently per context per bundle.
   Therefore, each metric has a different cell in each bundle, that is later

From bb0c910b195bc44bcef0e268a8b08cc25ab44ef8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 12 Dec 2024 10:27:43 -0500
Subject: [PATCH 101/135] Bump cloud.google.com/go/profiler from 0.4.1 to 0.4.2
 in /sdks (#33351)

Bumps [cloud.google.com/go/profiler](https://github.com/googleapis/google-cloud-go) from 0.4.1 to 0.4.2.
- [Release notes](https://github.com/googleapis/google-cloud-go/releases)
- [Changelog](https://github.com/googleapis/google-cloud-go/blob/main/CHANGES.md)
- [Commits](https://github.com/googleapis/google-cloud-go/compare/ai/v0.4.1...apps/v0.4.2)

---
updated-dependencies:
- dependency-name: cloud.google.com/go/profiler
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 4 ++--
 sdks/go.sum | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index 5406c2b70cbc..30433676f6f4 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -26,7 +26,7 @@ require (
 	cloud.google.com/go/bigquery v1.64.0
 	cloud.google.com/go/bigtable v1.33.0
 	cloud.google.com/go/datastore v1.20.0
-	cloud.google.com/go/profiler v0.4.1
+	cloud.google.com/go/profiler v0.4.2
 	cloud.google.com/go/pubsub v1.45.3
 	cloud.google.com/go/spanner v1.73.0
 	cloud.google.com/go/storage v1.47.0
@@ -159,7 +159,7 @@ require (
 	github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da // indirect
 	github.com/golang/snappy v0.0.4 // indirect
 	github.com/google/flatbuffers v23.5.26+incompatible // indirect
-	github.com/google/pprof v0.0.0-20240528025155-186aa0362fba // indirect
+	github.com/google/pprof v0.0.0-20240727154555-813a5fbdbec8 // indirect
 	github.com/google/renameio/v2 v2.0.0 // indirect
 	github.com/google/s2a-go v0.1.8 // indirect
 	github.com/googleapis/enterprise-certificate-proxy v0.3.4 // indirect
diff --git a/sdks/go.sum b/sdks/go.sum
index bb96c54af087..6394ce515c4d 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -441,8 +441,8 @@ cloud.google.com/go/privatecatalog v0.5.0/go.mod h1:XgosMUvvPyxDjAVNDYxJ7wBW8//h
 cloud.google.com/go/privatecatalog v0.6.0/go.mod h1:i/fbkZR0hLN29eEWiiwue8Pb+GforiEIBnV9yrRUOKI=
 cloud.google.com/go/privatecatalog v0.7.0/go.mod h1:2s5ssIFO69F5csTXcwBP7NPFTZvps26xGzvQ2PQaBYg=
 cloud.google.com/go/privatecatalog v0.8.0/go.mod h1:nQ6pfaegeDAq/Q5lrfCQzQLhubPiZhSaNhIgfJlnIXs=
-cloud.google.com/go/profiler v0.4.1 h1:Q7+lOvikTGMJ/IAWocpYYGit4SIIoILmVZfEEWTORSY=
-cloud.google.com/go/profiler v0.4.1/go.mod h1:LBrtEX6nbvhv1w/e5CPZmX9ajGG9BGLtGbv56Tg4SHs=
+cloud.google.com/go/profiler v0.4.2 h1:KojCmZ+bEPIQrd7bo2UFvZ2xUPLHl55KzHl7iaR4V2I=
+cloud.google.com/go/profiler v0.4.2/go.mod h1:7GcWzs9deJHHdJ5J9V1DzKQ9JoIoTGhezwlLbwkOoCs=
 cloud.google.com/go/pubsub v1.0.1/go.mod h1:R0Gpsv3s54REJCy4fxDixWD93lHJMoZTyQ2kNxGRt3I=
 cloud.google.com/go/pubsub v1.1.0/go.mod h1:EwwdRX2sKPjnvnqCa270oGRyludottCI76h+R3AArQw=
 cloud.google.com/go/pubsub v1.2.0/go.mod h1:jhfEVHT8odbXTkndysNHCcx0awwzvfOlguIAii9o8iA=
@@ -948,8 +948,8 @@ github.com/google/pprof v0.0.0-20210226084205-cbba55b83ad5/go.mod h1:kpwsk12EmLe
 github.com/google/pprof v0.0.0-20210601050228-01bbb1931b22/go.mod h1:kpwsk12EmLew5upagYY7GY0pfYCcupk39gWOCRROcvE=
 github.com/google/pprof v0.0.0-20210609004039-a478d1d731e9/go.mod h1:kpwsk12EmLew5upagYY7GY0pfYCcupk39gWOCRROcvE=
 github.com/google/pprof v0.0.0-20210720184732-4bb14d4b1be1/go.mod h1:kpwsk12EmLew5upagYY7GY0pfYCcupk39gWOCRROcvE=
-github.com/google/pprof v0.0.0-20240528025155-186aa0362fba h1:ql1qNgCyOB7iAEk8JTNM+zJrgIbnyCKX/wdlyPufP5g=
-github.com/google/pprof v0.0.0-20240528025155-186aa0362fba/go.mod h1:K1liHPHnj73Fdn/EKuT8nrFqBihUSKXoLYU0BuatOYo=
+github.com/google/pprof v0.0.0-20240727154555-813a5fbdbec8 h1:FKHo8hFI3A+7w0aUQuYXQ+6EN5stWmeY/AZqtM8xk9k=
+github.com/google/pprof v0.0.0-20240727154555-813a5fbdbec8/go.mod h1:K1liHPHnj73Fdn/EKuT8nrFqBihUSKXoLYU0BuatOYo=
 github.com/google/renameio v0.1.0/go.mod h1:KWCgfxg9yswjAJkECMjeO8J8rahYeXnNhOm40UhjYkI=
 github.com/google/renameio/v2 v2.0.0 h1:UifI23ZTGY8Tt29JbYFiuyIU3eX+RNFtUwefq9qAhxg=
 github.com/google/renameio/v2 v2.0.0/go.mod h1:BtmJXm5YlszgC+TD4HOEEUFgkJP3nLxehU6hfe7jRt4=

From 224900c42a6723ec4d08b1acae6d3e16f41ddb0a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 12 Dec 2024 10:28:14 -0500
Subject: [PATCH 102/135] Bump cloud.google.com/go/storage from 1.47.0 to
 1.48.0 in /sdks (#33327)

Bumps [cloud.google.com/go/storage](https://github.com/googleapis/google-cloud-go) from 1.47.0 to 1.48.0.
- [Release notes](https://github.com/googleapis/google-cloud-go/releases)
- [Changelog](https://github.com/googleapis/google-cloud-go/blob/main/CHANGES.md)
- [Commits](https://github.com/googleapis/google-cloud-go/compare/spanner/v1.47.0...spanner/v1.48.0)

---
updated-dependencies:
- dependency-name: cloud.google.com/go/storage
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 4 ++--
 sdks/go.sum | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index 30433676f6f4..9eda64804cb6 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -29,7 +29,7 @@ require (
 	cloud.google.com/go/profiler v0.4.2
 	cloud.google.com/go/pubsub v1.45.3
 	cloud.google.com/go/spanner v1.73.0
-	cloud.google.com/go/storage v1.47.0
+	cloud.google.com/go/storage v1.48.0
 	github.com/aws/aws-sdk-go-v2 v1.32.6
 	github.com/aws/aws-sdk-go-v2/config v1.28.6
 	github.com/aws/aws-sdk-go-v2/credentials v1.17.47
@@ -60,7 +60,7 @@ require (
 	golang.org/x/text v0.21.0
 	google.golang.org/api v0.210.0
 	google.golang.org/genproto v0.0.0-20241118233622-e639e219e697
-	google.golang.org/grpc v1.67.1
+	google.golang.org/grpc v1.67.2
 	google.golang.org/protobuf v1.35.2
 	gopkg.in/yaml.v2 v2.4.0
 	gopkg.in/yaml.v3 v3.0.1
diff --git a/sdks/go.sum b/sdks/go.sum
index 6394ce515c4d..eae0e0007706 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -561,8 +561,8 @@ cloud.google.com/go/storage v1.23.0/go.mod h1:vOEEDNFnciUMhBeT6hsJIn3ieU5cFRmzeL
 cloud.google.com/go/storage v1.27.0/go.mod h1:x9DOL8TK/ygDUMieqwfhdpQryTeEkhGKMi80i/iqR2s=
 cloud.google.com/go/storage v1.28.1/go.mod h1:Qnisd4CqDdo6BGs2AD5LLnEsmSQ80wQ5ogcBBKhU86Y=
 cloud.google.com/go/storage v1.29.0/go.mod h1:4puEjyTKnku6gfKoTfNOU/W+a9JyuVNxjpS5GBrB8h4=
-cloud.google.com/go/storage v1.47.0 h1:ajqgt30fnOMmLfWfu1PWcb+V9Dxz6n+9WKjdNg5R4HM=
-cloud.google.com/go/storage v1.47.0/go.mod h1:Ks0vP374w0PW6jOUameJbapbQKXqkjGd/OJRp2fb9IQ=
+cloud.google.com/go/storage v1.48.0 h1:FhBDHACbVtdPx7S/AbcKujPWiHvfO6F8OXGgCEbB2+o=
+cloud.google.com/go/storage v1.48.0/go.mod h1:aFoDYNMAjv67lp+xcuZqjUKv/ctmplzQ3wJgodA7b+M=
 cloud.google.com/go/storagetransfer v1.5.0/go.mod h1:dxNzUopWy7RQevYFHewchb29POFv3/AaBgnhqzqiK0w=
 cloud.google.com/go/storagetransfer v1.6.0/go.mod h1:y77xm4CQV/ZhFZH75PLEXY0ROiS7Gh6pSKrM8dJyg6I=
 cloud.google.com/go/storagetransfer v1.7.0/go.mod h1:8Giuj1QNb1kfLAiWM1bN6dHzfdlDAVC9rv9abHot2W4=
@@ -1895,8 +1895,8 @@ google.golang.org/grpc v1.52.3/go.mod h1:pu6fVzoFb+NBYNAvQL08ic+lvB2IojljRYuun5v
 google.golang.org/grpc v1.53.0/go.mod h1:OnIrk0ipVdj4N5d9IUoFUx72/VlD7+jUsHwZgwSMQpw=
 google.golang.org/grpc v1.54.0/go.mod h1:PUSEXI6iWghWaB6lXM4knEgpJNu2qUcKfDtNci3EC2g=
 google.golang.org/grpc v1.56.3/go.mod h1:I9bI3vqKfayGqPUAwGdOSu7kt6oIJLixfffKrpXqQ9s=
-google.golang.org/grpc v1.67.1 h1:zWnc1Vrcno+lHZCOofnIMvycFcc0QRGIzm9dhnDX68E=
-google.golang.org/grpc v1.67.1/go.mod h1:1gLDyUQU7CTLJI90u3nXZ9ekeghjeM7pTDZlqFNg2AA=
+google.golang.org/grpc v1.67.2 h1:Lq11HW1nr5m4OYV+ZVy2BjOK78/zqnTx24vyDBP1JcQ=
+google.golang.org/grpc v1.67.2/go.mod h1:1gLDyUQU7CTLJI90u3nXZ9ekeghjeM7pTDZlqFNg2AA=
 google.golang.org/grpc/cmd/protoc-gen-go-grpc v1.1.0/go.mod h1:6Kw0yEErY5E/yWrBtf03jp27GLLJujG4z/JK95pnjjw=
 google.golang.org/grpc/stats/opentelemetry v0.0.0-20240907200651-3ffb98b2c93a h1:UIpYSuWdWHSzjwcAFRLjKcPXFZVVLXGEM23W+NWqipw=
 google.golang.org/grpc/stats/opentelemetry v0.0.0-20240907200651-3ffb98b2c93a/go.mod h1:9i1T9n4ZinTUZGgzENMi8MDDgbGC5mqTS75JAv6xN3A=

From 272feb8ff69a1d6174d04693347ca9bd2ac1980b Mon Sep 17 00:00:00 2001
From: Shunping Huang <shunping@google.com>
Date: Thu, 12 Dec 2024 10:30:38 -0500
Subject: [PATCH 103/135] Fix custom coder not being used in Reshuffle (global
 window) (#33339)

* Fix typehint in ReshufflePerKey on global window setting.

* Only update the type hint on global window setting. Need more work in non-global windows.

* Apply yapf

* Fix some failed tests.

* Revert change to setup.py
---
 sdks/python/apache_beam/transforms/util.py    | 13 ++++++-
 .../apache_beam/transforms/util_test.py       | 39 +++++++++++++++++++
 2 files changed, 50 insertions(+), 2 deletions(-)

diff --git a/sdks/python/apache_beam/transforms/util.py b/sdks/python/apache_beam/transforms/util.py
index a03652de2496..43d4a6c20e94 100644
--- a/sdks/python/apache_beam/transforms/util.py
+++ b/sdks/python/apache_beam/transforms/util.py
@@ -33,6 +33,7 @@
 from typing import Callable
 from typing import Iterable
 from typing import List
+from typing import Optional
 from typing import Tuple
 from typing import TypeVar
 from typing import Union
@@ -78,6 +79,7 @@
 from apache_beam.utils import windowed_value
 from apache_beam.utils.annotations import deprecated
 from apache_beam.utils.sharded_key import ShardedKey
+from apache_beam.utils.timestamp import Timestamp
 
 if TYPE_CHECKING:
   from apache_beam.runners.pipeline_context import PipelineContext
@@ -953,6 +955,10 @@ def restore_timestamps(element):
             window.GlobalWindows.windowed_value((key, value), timestamp)
             for (value, timestamp) in values
         ]
+
+      ungrouped = pcoll | Map(reify_timestamps).with_input_types(
+          Tuple[K, V]).with_output_types(
+              Tuple[K, Tuple[V, Optional[Timestamp]]])
     else:
 
       # typing: All conditional function variants must have identical signatures
@@ -966,7 +972,9 @@ def restore_timestamps(element):
         key, windowed_values = element
         return [wv.with_value((key, wv.value)) for wv in windowed_values]
 
-    ungrouped = pcoll | Map(reify_timestamps).with_output_types(Any)
+      # TODO(https://github.com/apache/beam/issues/33356): Support reshuffling
+      # unpicklable objects with a non-global window setting.
+      ungrouped = pcoll | Map(reify_timestamps).with_output_types(Any)
 
     # TODO(https://github.com/apache/beam/issues/19785) Using global window as
     # one of the standard window. This is to mitigate the Dataflow Java Runner
@@ -1018,7 +1026,8 @@ def expand(self, pcoll):
         pcoll | 'AddRandomKeys' >>
         Map(lambda t: (random.randrange(0, self.num_buckets), t)
             ).with_input_types(T).with_output_types(Tuple[int, T])
-        | ReshufflePerKey()
+        | ReshufflePerKey().with_input_types(Tuple[int, T]).with_output_types(
+            Tuple[int, T])
         | 'RemoveRandomKeys' >> Map(lambda t: t[1]).with_input_types(
             Tuple[int, T]).with_output_types(T))
 
diff --git a/sdks/python/apache_beam/transforms/util_test.py b/sdks/python/apache_beam/transforms/util_test.py
index d86509c7dde3..7f166f78ef0a 100644
--- a/sdks/python/apache_beam/transforms/util_test.py
+++ b/sdks/python/apache_beam/transforms/util_test.py
@@ -1010,6 +1010,45 @@ def format_with_timestamp(element, timestamp=beam.DoFn.TimestampParam):
           equal_to(expected_data),
           label="formatted_after_reshuffle")
 
+  def test_reshuffle_unpicklable_in_global_window(self):
+    global _Unpicklable
+
+    class _Unpicklable(object):
+      def __init__(self, value):
+        self.value = value
+
+      def __getstate__(self):
+        raise NotImplementedError()
+
+      def __setstate__(self, state):
+        raise NotImplementedError()
+
+    class _UnpicklableCoder(beam.coders.Coder):
+      def encode(self, value):
+        return str(value.value).encode()
+
+      def decode(self, encoded):
+        return _Unpicklable(int(encoded.decode()))
+
+      def to_type_hint(self):
+        return _Unpicklable
+
+      def is_deterministic(self):
+        return True
+
+    beam.coders.registry.register_coder(_Unpicklable, _UnpicklableCoder)
+
+    with TestPipeline() as pipeline:
+      data = [_Unpicklable(i) for i in range(5)]
+      expected_data = [0, 10, 20, 30, 40]
+      result = (
+          pipeline
+          | beam.Create(data)
+          | beam.WindowInto(GlobalWindows())
+          | beam.Reshuffle()
+          | beam.Map(lambda u: u.value * 10))
+      assert_that(result, equal_to(expected_data))
+
 
 class WithKeysTest(unittest.TestCase):
   def setUp(self):

From 7b883373d4a9dc69e10949f0c1b1c7479df62d48 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 12 Dec 2024 09:36:54 -0800
Subject: [PATCH 104/135] Bump golang.org/x/crypto from 0.30.0 to 0.31.0 in
 /sdks (#33366)

Bumps [golang.org/x/crypto](https://github.com/golang/crypto) from 0.30.0 to 0.31.0.
- [Commits](https://github.com/golang/crypto/compare/v0.30.0...v0.31.0)

---
updated-dependencies:
- dependency-name: golang.org/x/crypto
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 2 +-
 sdks/go.sum | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index 9eda64804cb6..cd993672663b 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -190,7 +190,7 @@ require (
 	github.com/youmark/pkcs8 v0.0.0-20240726163527-a2c0da244d78 // indirect
 	github.com/zeebo/xxh3 v1.0.2 // indirect
 	go.opencensus.io v0.24.0 // indirect
-	golang.org/x/crypto v0.30.0 // indirect
+	golang.org/x/crypto v0.31.0 // indirect
 	golang.org/x/mod v0.20.0 // indirect
 	golang.org/x/tools v0.24.0 // indirect
 	golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da // indirect
diff --git a/sdks/go.sum b/sdks/go.sum
index eae0e0007706..a95dcac4913c 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -1266,8 +1266,8 @@ golang.org/x/crypto v0.0.0-20210421170649-83a5a9bb288b/go.mod h1:T9bdIzuCu7OtxOm
 golang.org/x/crypto v0.0.0-20210513164829-c07d793c2f9a/go.mod h1:P+XmwS30IXTQdn5tA2iutPOUgjI07+tq3H3K9MVA1s8=
 golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
 golang.org/x/crypto v0.0.0-20211108221036-ceb1ce70b4fa/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
-golang.org/x/crypto v0.30.0 h1:RwoQn3GkWiMkzlX562cLB7OxWvjH1L8xutO2WoJcRoY=
-golang.org/x/crypto v0.30.0/go.mod h1:kDsLvtWBEx7MV9tJOj9bnXsPbxwJQ6csT/x4KIN4Ssk=
+golang.org/x/crypto v0.31.0 h1:ihbySMvVjLAeSH1IbfcRTkD/iNscyz8rGzjF/E5hV6U=
+golang.org/x/crypto v0.31.0/go.mod h1:kDsLvtWBEx7MV9tJOj9bnXsPbxwJQ6csT/x4KIN4Ssk=
 golang.org/x/exp v0.0.0-20180321215751-8460e604b9de/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
 golang.org/x/exp v0.0.0-20180807140117-3d87b88a115f/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
 golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=

From fd17dcea9cae8a444fcd1fc9708dffdd2e33cda0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 12 Dec 2024 13:01:10 -0500
Subject: [PATCH 105/135] Update numpy requirement from <2.2.0,>=1.14.3 to
 >=1.14.3,<2.3.0 in /sdks/python (#33325)

* Update numpy requirement in /sdks/python

Updates the requirements on [numpy](https://github.com/numpy/numpy) to permit the latest version.
- [Release notes](https://github.com/numpy/numpy/releases)
- [Changelog](https://github.com/numpy/numpy/blob/main/doc/RELEASE_WALKTHROUGH.rst)
- [Commits](https://github.com/numpy/numpy/compare/v1.14.3...v2.2.0)

---
updated-dependencies:
- dependency-name: numpy
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>

* increment in setup.py

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Jack McCluskey <thejackmccluskey@gmail.com>
---
 sdks/python/pyproject.toml | 2 +-
 sdks/python/setup.py       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/sdks/python/pyproject.toml b/sdks/python/pyproject.toml
index 4eb827297019..8000c24f28aa 100644
--- a/sdks/python/pyproject.toml
+++ b/sdks/python/pyproject.toml
@@ -26,7 +26,7 @@ requires = [
     # Avoid https://github.com/pypa/virtualenv/issues/2006
     "distlib==0.3.7",
     # Numpy headers
-    "numpy>=1.14.3,<2.2.0", # Update setup.py as well.
+    "numpy>=1.14.3,<2.3.0", # Update setup.py as well.
     # having cython here will create wheels that are platform dependent.
     "cython>=3.0,<4",
     ## deps for generating external transform wrappers:
diff --git a/sdks/python/setup.py b/sdks/python/setup.py
index 53c7a532e706..da9e0b2e7477 100644
--- a/sdks/python/setup.py
+++ b/sdks/python/setup.py
@@ -361,7 +361,7 @@ def get_portability_package_data():
           'jsonpickle>=3.0.0,<4.0.0',
           # numpy can have breaking changes in minor versions.
           # Use a strict upper bound.
-          'numpy>=1.14.3,<2.2.0',  # Update pyproject.toml as well.
+          'numpy>=1.14.3,<2.3.0',  # Update pyproject.toml as well.
           'objsize>=0.6.1,<0.8.0',
           'packaging>=22.0',
           'pymongo>=3.8.0,<5.0.0',

From 2efd124429b4810dcc1d7f622f48c0fed7fc3c48 Mon Sep 17 00:00:00 2001
From: Yi Hu <yathu@google.com>
Date: Thu, 12 Dec 2024 14:09:40 -0500
Subject: [PATCH 106/135] Switch to use unshaded hive-exec for io expansion
 service (#33349)

* Switch to use unshaded hive-exec for io expansion service

* This enables the shadow jar pick up dependencies of newer versions

* cleanup leftovers
---
 .../IO_Iceberg_Integration_Tests.json         |  2 +-
 ...eam_PostCommit_Python_Xlang_IO_Direct.json |  2 +-
 sdks/java/io/expansion-service/build.gradle   |  2 +-
 sdks/java/io/iceberg/hive/build.gradle        | 33 ++++++++--
 sdks/java/io/iceberg/hive/exec/build.gradle   | 65 -------------------
 settings.gradle.kts                           |  2 -
 6 files changed, 31 insertions(+), 75 deletions(-)
 delete mode 100644 sdks/java/io/iceberg/hive/exec/build.gradle

diff --git a/.github/trigger_files/IO_Iceberg_Integration_Tests.json b/.github/trigger_files/IO_Iceberg_Integration_Tests.json
index 3f63c0c9975f..bbdc3a3910ef 100644
--- a/.github/trigger_files/IO_Iceberg_Integration_Tests.json
+++ b/.github/trigger_files/IO_Iceberg_Integration_Tests.json
@@ -1,4 +1,4 @@
 {
     "comment": "Modify this file in a trivial way to cause this test suite to run",
-    "modification": 2
+    "modification": 3
 }
diff --git a/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json b/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json
index b26833333238..e3d6056a5de9 100644
--- a/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json
+++ b/.github/trigger_files/beam_PostCommit_Python_Xlang_IO_Direct.json
@@ -1,4 +1,4 @@
 {
   "comment": "Modify this file in a trivial way to cause this test suite to run",
-  "modification": 2
+  "modification": 1
 }
diff --git a/sdks/java/io/expansion-service/build.gradle b/sdks/java/io/expansion-service/build.gradle
index 421719b8f986..a27a66b1f3dc 100644
--- a/sdks/java/io/expansion-service/build.gradle
+++ b/sdks/java/io/expansion-service/build.gradle
@@ -60,7 +60,7 @@ dependencies {
   runtimeOnly library.java.bigdataoss_gcs_connector
   // Needed for HiveCatalog
   runtimeOnly ("org.apache.iceberg:iceberg-hive-metastore:1.4.2")
-  runtimeOnly project(path: ":sdks:java:io:iceberg:hive:exec", configuration: "shadow")
+  runtimeOnly project(path: ":sdks:java:io:iceberg:hive")
 
   runtimeOnly library.java.kafka_clients
   runtimeOnly library.java.slf4j_jdk14
diff --git a/sdks/java/io/iceberg/hive/build.gradle b/sdks/java/io/iceberg/hive/build.gradle
index bfa6c75251c4..2d0d2bcc5cde 100644
--- a/sdks/java/io/iceberg/hive/build.gradle
+++ b/sdks/java/io/iceberg/hive/build.gradle
@@ -21,19 +21,39 @@ plugins { id 'org.apache.beam.module' }
 applyJavaNature(
         automaticModuleName: 'org.apache.beam.sdk.io.iceberg.hive',
         exportJavadoc: false,
-        shadowClosure: {},
+        publish: false, // it's an intermediate jar for io-expansion-service
 )
 
 description = "Apache Beam :: SDKs :: Java :: IO :: Iceberg :: Hive"
 ext.summary = "Runtime dependencies needed for Hive catalog integration."
 
 def hive_version = "3.1.3"
+def hbase_version = "2.6.1-hadoop3"
+def hadoop_version = "3.4.1"
 def iceberg_version = "1.4.2"
+def avatica_version = "1.25.0"
 
 dependencies {
     // dependencies needed to run with iceberg's hive catalog
-    runtimeOnly ("org.apache.iceberg:iceberg-hive-metastore:$iceberg_version")
-    runtimeOnly project(path: ":sdks:java:io:iceberg:hive:exec", configuration: "shadow")
+    // these dependencies are going to be included in io-expansion-service
+    implementation ("org.apache.iceberg:iceberg-hive-metastore:$iceberg_version")
+    permitUnusedDeclared ("org.apache.iceberg:iceberg-hive-metastore:$iceberg_version")
+    // analyzeClassesDependencies fails with "Cannot accept visitor on URL", likely the plugin does not recognize "core" classifier
+    // use "core" classifier to depend on un-shaded jar
+    runtimeOnly ("org.apache.hive:hive-exec:$hive_version:core") {
+        // old hadoop-yarn-server-resourcemanager contains critical log4j vulneribility
+        exclude group: "org.apache.hadoop", module: "hadoop-yarn-server-resourcemanager"
+        // old hadoop-yarn-server-resourcemanager contains critical log4j and hadoop vulneribility
+        exclude group: "org.apache.hbase", module: "hbase-client"
+        // old calcite leaks old protobuf-java
+        exclude group: "org.apache.calcite.avatica", module: "avatica"
+    }
+    runtimeOnly ("org.apache.hadoop:hadoop-yarn-server-resourcemanager:$hadoop_version")
+    runtimeOnly ("org.apache.hbase:hbase-client:$hbase_version")
+    runtimeOnly ("org.apache.calcite.avatica:avatica-core:$avatica_version")
+    implementation ("org.apache.hive:hive-metastore:$hive_version")
+    runtimeOnly ("org.apache.iceberg:iceberg-parquet:$iceberg_version")
+    permitUnusedDeclared ("org.apache.hive:hive-metastore:$hive_version")
 
     // ----- below dependencies are for testing and will not appear in the shaded jar -----
     // Beam IcebergIO dependencies
@@ -52,8 +72,6 @@ dependencies {
     testImplementation library.java.junit
 
     // needed to set up test Hive Metastore and run tests
-    testImplementation ("org.apache.iceberg:iceberg-hive-metastore:$iceberg_version")
-    testImplementation project(path: ":sdks:java:io:iceberg:hive:exec", configuration: "shadow")
     testRuntimeOnly ("org.apache.hive.hcatalog:hive-hcatalog-core:$hive_version") {
         exclude group: "org.apache.hive", module: "hive-exec"
         exclude group: "org.apache.parquet", module: "parquet-hadoop-bundle"
@@ -62,6 +80,11 @@ dependencies {
     testImplementation "org.apache.parquet:parquet-column:1.12.0"
 }
 
+configurations.all {
+    // the fatjar "parquet-hadoop-bundle" conflicts with "parquet-hadoop" used by org.apache.iceberg:iceberg-parquet
+    exclude group: "org.apache.parquet", module: "parquet-hadoop-bundle"
+}
+
 task integrationTest(type: Test) {
     group = "Verification"
     def gcpTempLocation = project.findProperty('gcpTempLocation') ?: 'gs://temp-storage-for-end-to-end-tests/iceberg-hive-it'
diff --git a/sdks/java/io/iceberg/hive/exec/build.gradle b/sdks/java/io/iceberg/hive/exec/build.gradle
deleted file mode 100644
index f266ab2ef4db..000000000000
--- a/sdks/java/io/iceberg/hive/exec/build.gradle
+++ /dev/null
@@ -1,65 +0,0 @@
-/*
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements.  See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership.  The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * License); you may not use this file except in compliance
- * with the License.  You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an AS IS BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-plugins {
-    id 'org.apache.beam.module'
-    id 'java'
-    id 'com.github.johnrengelman.shadow'
-}
-
-dependencies {
-    implementation("org.apache.hive:hive-exec:3.1.3")
-    permitUnusedDeclared("org.apache.hive:hive-exec:3.1.3")
-}
-
-configurations {
-    shadow
-}
-
-artifacts {
-    shadow(archives(shadowJar) {
-        builtBy shadowJar
-    })
-}
-
-shadowJar {
-    zip64 true
-
-    def problematicPackages = [
-            'com.google.protobuf',
-            'com.google.common',
-            'shaded.parquet',
-            'org.apache.parquet',
-            'org.joda'
-    ]
-
-    problematicPackages.forEach {
-        relocate it, getJavaRelocatedPath("iceberg.hive.${it}")
-    }
-
-    version "3.1.3"
-    mergeServiceFiles()
-
-    exclude 'LICENSE'
-    exclude(
-            'org/xml/**',
-            'javax/**',
-            'com/sun/**'
-    )
-}
-description = "Apache Beam :: SDKs :: Java :: IO :: Iceberg :: Hive :: Exec"
-ext.summary = "A copy of the hive-exec dependency with some popular libraries relocated."
diff --git a/settings.gradle.kts b/settings.gradle.kts
index d90bb3fb5b82..a8bee45a05ac 100644
--- a/settings.gradle.kts
+++ b/settings.gradle.kts
@@ -357,5 +357,3 @@ include("sdks:java:extensions:combiners")
 findProject(":sdks:java:extensions:combiners")?.name = "combiners"
 include("sdks:java:io:iceberg:hive")
 findProject(":sdks:java:io:iceberg:hive")?.name = "hive"
-include("sdks:java:io:iceberg:hive:exec")
-findProject(":sdks:java:io:iceberg:hive:exec")?.name = "exec"

From e9c0d35ff3390a3ff4cca3562508597dc3a69a65 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 12 Dec 2024 14:21:13 -0500
Subject: [PATCH 107/135] Bump cloud.google.com/go/bigquery from 1.64.0 to
 1.65.0 in /sdks (#33365)

Bumps [cloud.google.com/go/bigquery](https://github.com/googleapis/google-cloud-go) from 1.64.0 to 1.65.0.
- [Release notes](https://github.com/googleapis/google-cloud-go/releases)
- [Changelog](https://github.com/googleapis/google-cloud-go/blob/main/CHANGES.md)
- [Commits](https://github.com/googleapis/google-cloud-go/compare/spanner/v1.64.0...spanner/v1.65.0)

---
updated-dependencies:
- dependency-name: cloud.google.com/go/bigquery
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 2 +-
 sdks/go.sum | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index cd993672663b..e6a182035f5e 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -23,7 +23,7 @@ module github.com/apache/beam/sdks/v2
 go 1.21.0
 
 require (
-	cloud.google.com/go/bigquery v1.64.0
+	cloud.google.com/go/bigquery v1.65.0
 	cloud.google.com/go/bigtable v1.33.0
 	cloud.google.com/go/datastore v1.20.0
 	cloud.google.com/go/profiler v0.4.2
diff --git a/sdks/go.sum b/sdks/go.sum
index a95dcac4913c..34e34ef2f8cd 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -133,8 +133,8 @@ cloud.google.com/go/bigquery v1.47.0/go.mod h1:sA9XOgy0A8vQK9+MWhEQTY6Tix87M/Zur
 cloud.google.com/go/bigquery v1.48.0/go.mod h1:QAwSz+ipNgfL5jxiaK7weyOhzdoAy1zFm0Nf1fysJac=
 cloud.google.com/go/bigquery v1.49.0/go.mod h1:Sv8hMmTFFYBlt/ftw2uN6dFdQPzBlREY9yBh7Oy7/4Q=
 cloud.google.com/go/bigquery v1.50.0/go.mod h1:YrleYEh2pSEbgTBZYMJ5SuSr0ML3ypjRB1zgf7pvQLU=
-cloud.google.com/go/bigquery v1.64.0 h1:vSSZisNyhr2ioJE1OuYBQrnrpB7pIhRQm4jfjc7E/js=
-cloud.google.com/go/bigquery v1.64.0/go.mod h1:gy8Ooz6HF7QmA+TRtX8tZmXBKH5mCFBwUApGAb3zI7Y=
+cloud.google.com/go/bigquery v1.65.0 h1:ZZ1EOJMHTYf6R9lhxIXZJic1qBD4/x9loBIS+82moUs=
+cloud.google.com/go/bigquery v1.65.0/go.mod h1:9WXejQ9s5YkTW4ryDYzKXBooL78u5+akWGXgJqQkY6A=
 cloud.google.com/go/bigtable v1.33.0 h1:2BDaWLRAwXO14DJL/u8crbV2oUbMZkIa2eGq8Yao1bk=
 cloud.google.com/go/bigtable v1.33.0/go.mod h1:HtpnH4g25VT1pejHRtInlFPnN5sjTxbQlsYBjh9t5l0=
 cloud.google.com/go/billing v1.4.0/go.mod h1:g9IdKBEFlItS8bTtlrZdVLWSSdSyFUZKXNS02zKMOZY=

From de5e8ebcee290a00036c868a1f444018bd445506 Mon Sep 17 00:00:00 2001
From: Robert Burke <lostluck@users.noreply.github.com>
Date: Thu, 12 Dec 2024 13:04:26 -0800
Subject: [PATCH 108/135] [#32211] Support OnWindowExpiration in Prism.
 (#33337)

---
 CHANGES.md                                    |   2 +
 runners/prism/java/build.gradle               |  18 +-
 .../prism/internal/engine/elementmanager.go   | 224 +++++++++++++++---
 .../internal/engine/elementmanager_test.go    | 160 +++++++++++++
 .../beam/runners/prism/internal/execute.go    |   4 +
 .../runners/prism/internal/jobservices/job.go |   1 +
 .../prism/internal/jobservices/management.go  |   2 -
 .../beam/runners/prism/internal/preprocess.go |   3 +
 .../pkg/beam/runners/prism/internal/stage.go  |  24 +-
 .../runners/prism/internal/worker/bundle.go   |   4 +-
 10 files changed, 388 insertions(+), 54 deletions(-)

diff --git a/CHANGES.md b/CHANGES.md
index dbadd588ae3f..ea29b6aadc7d 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -69,6 +69,8 @@
 ## New Features / Improvements
 
 * X feature added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
+* Support OnWindowExpiration in Prism ([#32211](https://github.com/apache/beam/issues/32211)).
+  * This enables initial Java GroupIntoBatches support.
 
 ## Breaking Changes
 
diff --git a/runners/prism/java/build.gradle b/runners/prism/java/build.gradle
index 82eb62b9e207..ce71151099bd 100644
--- a/runners/prism/java/build.gradle
+++ b/runners/prism/java/build.gradle
@@ -106,6 +106,12 @@ def sickbayTests = [
     'org.apache.beam.sdk.testing.TestStreamTest.testMultipleStreams',
     'org.apache.beam.sdk.testing.TestStreamTest.testProcessingTimeTrigger',
 
+    // GroupIntoBatchesTest tests that fail:
+    // Teststream has bad KV encodings due to using an outer context.
+    'org.apache.beam.sdk.transforms.GroupIntoBatchesTest.testInStreamingMode',
+    // ShardedKey not yet implemented.
+    'org.apache.beam.sdk.transforms.GroupIntoBatchesTest.testWithShardedKeyInGlobalWindow',
+
     // Coding error somehow: short write: reached end of stream after reading 5 bytes; 98 bytes expected
     'org.apache.beam.sdk.testing.TestStreamTest.testMultiStage',
 
@@ -228,14 +234,16 @@ def createPrismValidatesRunnerTask = { name, environmentType ->
       excludeCategories 'org.apache.beam.sdk.testing.UsesSdkHarnessEnvironment'
 
       // Not yet implemented in Prism
-      // https://github.com/apache/beam/issues/32211
-      excludeCategories 'org.apache.beam.sdk.testing.UsesOnWindowExpiration'
       // https://github.com/apache/beam/issues/32929
       excludeCategories 'org.apache.beam.sdk.testing.UsesOrderedListState'
 
-       // Not supported in Portable Java SDK yet.
-       // https://github.com/apache/beam/issues?q=is%3Aissue+is%3Aopen+MultimapState
-       excludeCategories 'org.apache.beam.sdk.testing.UsesMultimapState'
+      // Not supported in Portable Java SDK yet.
+      // https://github.com/apache/beam/issues?q=is%3Aissue+is%3Aopen+MultimapState
+      excludeCategories 'org.apache.beam.sdk.testing.UsesMultimapState'
+
+      // Processing time with TestStream is unreliable without being able to control
+      // SDK side time portably. Ignore these tests.
+      excludeCategories 'org.apache.beam.sdk.testing.UsesTestStreamWithProcessingTime'
     }
     filter {
       for (String test : sickbayTests) {
diff --git a/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go b/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go
index 1739efdb742a..00e18c669afa 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go
@@ -184,7 +184,8 @@ type Config struct {
 //
 // Watermarks are advanced based on consumed input, except if the stage produces residuals.
 type ElementManager struct {
-	config Config
+	config     Config
+	nextBundID func() string // Generates unique bundleIDs. Set in the Bundles method.
 
 	impulses set[string]            // List of impulse stages.
 	stages   map[string]*stageState // The state for each stage.
@@ -197,6 +198,7 @@ type ElementManager struct {
 	refreshCond       sync.Cond   // refreshCond protects the following fields with it's lock, and unblocks bundle scheduling.
 	inprogressBundles set[string] // Active bundleIDs
 	changedStages     set[string] // Stages that have changed and need their watermark refreshed.
+	injectedBundles   []RunBundle // Represents ready to execute bundles prepared outside of the main loop, such as for onWindowExpiration, or for Triggers.
 
 	livePending     atomic.Int64   // An accessible live pending count. DEBUG USE ONLY
 	pendingElements sync.WaitGroup // pendingElements counts all unprocessed elements in a job. Jobs with no pending elements terminate successfully.
@@ -271,6 +273,16 @@ func (em *ElementManager) StageStateful(ID string) {
 	em.stages[ID].stateful = true
 }
 
+// StageOnWindowExpiration marks the given stage as stateful, which means elements are
+// processed by key.
+func (em *ElementManager) StageOnWindowExpiration(stageID string, timer StaticTimerID) {
+	ss := em.stages[stageID]
+	ss.onWindowExpiration = timer
+	ss.keysToExpireByWindow = map[typex.Window]set[string]{}
+	ss.inProgressExpiredWindows = map[typex.Window]int{}
+	ss.expiryWindowsByBundles = map[string]typex.Window{}
+}
+
 // StageProcessingTimeTimers indicates which timers are processingTime domain timers.
 func (em *ElementManager) StageProcessingTimeTimers(ID string, ptTimers map[string]bool) {
 	em.stages[ID].processingTimeTimersFamilies = ptTimers
@@ -338,6 +350,8 @@ func (rb RunBundle) LogValue() slog.Value {
 // The returned channel is closed when the context is canceled, or there are no pending elements
 // remaining.
 func (em *ElementManager) Bundles(ctx context.Context, upstreamCancelFn context.CancelCauseFunc, nextBundID func() string) <-chan RunBundle {
+	// Make it easier for injected bundles to get unique IDs.
+	em.nextBundID = nextBundID
 	runStageCh := make(chan RunBundle)
 	ctx, cancelFn := context.WithCancelCause(ctx)
 	go func() {
@@ -370,8 +384,9 @@ func (em *ElementManager) Bundles(ctx context.Context, upstreamCancelFn context.
 			changedByProcessingTime := em.processTimeEvents.AdvanceTo(emNow)
 			em.changedStages.merge(changedByProcessingTime)
 
-			// If there are no changed stages or ready processing time events available, we wait until there are.
-			for len(em.changedStages)+len(changedByProcessingTime) == 0 {
+			// If there are no changed stages, ready processing time events,
+			// or injected bundles available, we wait until there are.
+			for len(em.changedStages)+len(changedByProcessingTime)+len(em.injectedBundles) == 0 {
 				// Check to see if we must exit
 				select {
 				case <-ctx.Done():
@@ -386,6 +401,19 @@ func (em *ElementManager) Bundles(ctx context.Context, upstreamCancelFn context.
 				changedByProcessingTime = em.processTimeEvents.AdvanceTo(emNow)
 				em.changedStages.merge(changedByProcessingTime)
 			}
+			// Run any injected bundles first.
+			for len(em.injectedBundles) > 0 {
+				rb := em.injectedBundles[0]
+				em.injectedBundles = em.injectedBundles[1:]
+				em.refreshCond.L.Unlock()
+
+				select {
+				case <-ctx.Done():
+					return
+				case runStageCh <- rb:
+				}
+				em.refreshCond.L.Lock()
+			}
 
 			// We know there is some work we can do that may advance the watermarks,
 			// refresh them, and see which stages have advanced.
@@ -628,6 +656,12 @@ type Block struct {
 	Transform, Family string
 }
 
+// StaticTimerID represents the static user identifiers for a timer,
+// in particular, the ID of the Transform, and the family for the timer.
+type StaticTimerID struct {
+	TransformID, TimerFamily string
+}
+
 // StateForBundle retreives relevant state for the given bundle, WRT the data in the bundle.
 //
 // TODO(lostluck): Consider unifiying with InputForBundle, to reduce lock contention.
@@ -847,6 +881,19 @@ func (em *ElementManager) PersistBundle(rb RunBundle, col2Coders map[string]PCol
 	}
 	delete(stage.inprogressHoldsByBundle, rb.BundleID)
 
+	// Clean up OnWindowExpiration bundle accounting, so window state
+	// may be garbage collected.
+	if stage.expiryWindowsByBundles != nil {
+		win, ok := stage.expiryWindowsByBundles[rb.BundleID]
+		if ok {
+			stage.inProgressExpiredWindows[win] -= 1
+			if stage.inProgressExpiredWindows[win] == 0 {
+				delete(stage.inProgressExpiredWindows, win)
+			}
+			delete(stage.expiryWindowsByBundles, rb.BundleID)
+		}
+	}
+
 	// If there are estimated output watermarks, set the estimated
 	// output watermark for the stage.
 	if len(residuals.MinOutputWatermarks) > 0 {
@@ -1068,6 +1115,12 @@ type stageState struct {
 	strat                        winStrat        // Windowing Strategy for aggregation fireings.
 	processingTimeTimersFamilies map[string]bool // Indicates which timer families use the processing time domain.
 
+	// onWindowExpiration management
+	onWindowExpiration       StaticTimerID                // The static ID of the OnWindowExpiration callback.
+	keysToExpireByWindow     map[typex.Window]set[string] // Tracks all keys ever used with a window, so they may be expired.
+	inProgressExpiredWindows map[typex.Window]int         // Tracks the number of bundles currently expiring these windows, so we don't prematurely garbage collect them.
+	expiryWindowsByBundles   map[string]typex.Window      // Tracks which bundle is handling which window, so the above map can be cleared.
+
 	mu                 sync.Mutex
 	upstreamWatermarks sync.Map   // watermark set from inputPCollection's parent.
 	input              mtime.Time // input watermark for the parallel input.
@@ -1158,6 +1211,14 @@ func (ss *stageState) AddPending(newPending []element) int {
 					timers: map[timerKey]timerTimes{},
 				}
 				ss.pendingByKeys[string(e.keyBytes)] = dnt
+				if ss.keysToExpireByWindow != nil {
+					w, ok := ss.keysToExpireByWindow[e.window]
+					if !ok {
+						w = make(set[string])
+						ss.keysToExpireByWindow[e.window] = w
+					}
+					w.insert(string(e.keyBytes))
+				}
 			}
 			heap.Push(&dnt.elements, e)
 
@@ -1555,48 +1616,143 @@ func (ss *stageState) updateWatermarks(em *ElementManager) set[string] {
 	if minWatermarkHold < newOut {
 		newOut = minWatermarkHold
 	}
-	refreshes := set[string]{}
+	// If the newOut is smaller, then don't change downstream watermarks.
+	if newOut <= ss.output {
+		return nil
+	}
+
 	// If bigger, advance the output watermark
-	if newOut > ss.output {
-		ss.output = newOut
-		for _, outputCol := range ss.outputIDs {
-			consumers := em.consumers[outputCol]
-
-			for _, sID := range consumers {
-				em.stages[sID].updateUpstreamWatermark(outputCol, ss.output)
-				refreshes.insert(sID)
-			}
-			// Inform side input consumers, but don't update the upstream watermark.
-			for _, sID := range em.sideConsumers[outputCol] {
-				refreshes.insert(sID.Global)
-			}
-		}
-		// Garbage collect state, timers and side inputs, for all windows
-		// that are before the new output watermark.
-		// They'll never be read in again.
-		for _, wins := range ss.sideInputs {
-			for win := range wins {
-				// TODO(#https://github.com/apache/beam/issues/31438):
-				// Adjust with AllowedLateness
-				// Clear out anything we've already used.
-				if win.MaxTimestamp() < newOut {
-					delete(wins, win)
+	preventDownstreamUpdate := ss.createOnWindowExpirationBundles(newOut, em)
+
+	// Garbage collect state, timers and side inputs, for all windows
+	// that are before the new output watermark, if they aren't in progress
+	// of being expired.
+	// They'll never be read in again.
+	for _, wins := range ss.sideInputs {
+		for win := range wins {
+			// TODO(#https://github.com/apache/beam/issues/31438):
+			// Adjust with AllowedLateness
+			// Clear out anything we've already used.
+			if win.MaxTimestamp() < newOut {
+				// If the expiry is in progress, skip this window.
+				if ss.inProgressExpiredWindows[win] > 0 {
+					continue
 				}
+				delete(wins, win)
 			}
 		}
-		for _, wins := range ss.state {
-			for win := range wins {
-				// TODO(#https://github.com/apache/beam/issues/31438):
-				// Adjust with AllowedLateness
-				if win.MaxTimestamp() < newOut {
-					delete(wins, win)
+	}
+	for _, wins := range ss.state {
+		for win := range wins {
+			// TODO(#https://github.com/apache/beam/issues/31438):
+			// Adjust with AllowedLateness
+			if win.MaxTimestamp() < newOut {
+				// If the expiry is in progress, skip collecting this window.
+				if ss.inProgressExpiredWindows[win] > 0 {
+					continue
 				}
+				delete(wins, win)
 			}
 		}
 	}
+	// If there are windows to expire, we don't update the output watermark yet.
+	if preventDownstreamUpdate {
+		return nil
+	}
+
+	// Update this stage's output watermark, and then propagate that to downstream stages
+	refreshes := set[string]{}
+	ss.output = newOut
+	for _, outputCol := range ss.outputIDs {
+		consumers := em.consumers[outputCol]
+
+		for _, sID := range consumers {
+			em.stages[sID].updateUpstreamWatermark(outputCol, ss.output)
+			refreshes.insert(sID)
+		}
+		// Inform side input consumers, but don't update the upstream watermark.
+		for _, sID := range em.sideConsumers[outputCol] {
+			refreshes.insert(sID.Global)
+		}
+	}
 	return refreshes
 }
 
+// createOnWindowExpirationBundles injects bundles when windows
+// expire for all keys that were used in that window. Returns true if any
+// bundles are created, which means that the window must not yet be garbage
+// collected.
+//
+// Must be called within the stageState.mu's and the ElementManager.refreshCond
+// critical sections.
+func (ss *stageState) createOnWindowExpirationBundles(newOut mtime.Time, em *ElementManager) bool {
+	var preventDownstreamUpdate bool
+	for win, keys := range ss.keysToExpireByWindow {
+		// Check if the window has expired.
+		// TODO(#https://github.com/apache/beam/issues/31438):
+		// Adjust with AllowedLateness
+		if win.MaxTimestamp() >= newOut {
+			continue
+		}
+		// We can't advance the output watermark if there's garbage to collect.
+		preventDownstreamUpdate = true
+		// Hold off on garbage collecting data for these windows while these
+		// are in progress.
+		ss.inProgressExpiredWindows[win] += 1
+
+		// Produce bundle(s) for these keys and window, and inject them.
+		wm := win.MaxTimestamp()
+		rb := RunBundle{StageID: ss.ID, BundleID: "owe-" + em.nextBundID(), Watermark: wm}
+
+		// Now we need to actually build the bundle.
+		var toProcess []element
+		busyKeys := set[string]{}
+		usedKeys := set[string]{}
+		for k := range keys {
+			if ss.inprogressKeys.present(k) {
+				busyKeys.insert(k)
+				continue
+			}
+			usedKeys.insert(k)
+			toProcess = append(toProcess, element{
+				window:        win,
+				timestamp:     wm,
+				pane:          typex.NoFiringPane(),
+				holdTimestamp: wm,
+				transform:     ss.onWindowExpiration.TransformID,
+				family:        ss.onWindowExpiration.TimerFamily,
+				sequence:      1,
+				keyBytes:      []byte(k),
+				elmBytes:      nil,
+			})
+		}
+		em.addPending(len(toProcess))
+		ss.watermarkHolds.Add(wm, 1)
+		ss.makeInProgressBundle(
+			func() string { return rb.BundleID },
+			toProcess,
+			wm,
+			usedKeys,
+			map[mtime.Time]int{wm: 1},
+		)
+		ss.expiryWindowsByBundles[rb.BundleID] = win
+
+		slog.Debug("OnWindowExpiration-Bundle Created", slog.Any("bundle", rb), slog.Any("usedKeys", usedKeys), slog.Any("window", win), slog.Any("toProcess", toProcess), slog.Any("busyKeys", busyKeys))
+		// We're already in the refreshCond critical section.
+		// Insert that this is in progress here to avoid a race condition.
+		em.inprogressBundles.insert(rb.BundleID)
+		em.injectedBundles = append(em.injectedBundles, rb)
+
+		// Remove the key accounting, or continue tracking which keys still need clearing.
+		if len(busyKeys) == 0 {
+			delete(ss.keysToExpireByWindow, win)
+		} else {
+			ss.keysToExpireByWindow[win] = busyKeys
+		}
+	}
+	return preventDownstreamUpdate
+}
+
 // bundleReady returns the maximum allowed watermark for this stage, and whether
 // it's permitted to execute by side inputs.
 func (ss *stageState) bundleReady(em *ElementManager, emNow mtime.Time) (mtime.Time, bool, bool) {
diff --git a/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager_test.go b/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager_test.go
index d5904b13fb88..0d7da5ea163f 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager_test.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager_test.go
@@ -20,6 +20,7 @@ import (
 	"context"
 	"fmt"
 	"io"
+	"sync/atomic"
 	"testing"
 
 	"github.com/apache/beam/sdks/v2/go/pkg/beam/core/graph/coder"
@@ -524,3 +525,162 @@ func TestElementManager(t *testing.T) {
 		}
 	})
 }
+
+func TestElementManager_OnWindowExpiration(t *testing.T) {
+	t.Run("createOnWindowExpirationBundles", func(t *testing.T) {
+		// Unlike the other tests above, we synthesize the input configuration,
+		em := NewElementManager(Config{})
+		var instID uint64
+		em.nextBundID = func() string {
+			return fmt.Sprintf("inst%03d", atomic.AddUint64(&instID, 1))
+		}
+		em.AddStage("impulse", nil, []string{"input"}, nil)
+		em.AddStage("dofn", []string{"input"}, nil, nil)
+		onWE := StaticTimerID{
+			TransformID: "dofn1",
+			TimerFamily: "onWinExp",
+		}
+		em.StageOnWindowExpiration("dofn", onWE)
+		em.Impulse("impulse")
+
+		stage := em.stages["dofn"]
+		stage.pendingByKeys = map[string]*dataAndTimers{}
+		stage.inprogressKeys = set[string]{}
+
+		validateInProgressExpiredWindows := func(t *testing.T, win typex.Window, want int) {
+			t.Helper()
+			if got := stage.inProgressExpiredWindows[win]; got != want {
+				t.Errorf("stage.inProgressExpiredWindows[%v] = %v, want %v", win, got, want)
+			}
+		}
+		validateSideBundles := func(t *testing.T, keys set[string]) {
+			t.Helper()
+			if len(em.injectedBundles) == 0 {
+				t.Errorf("no injectedBundles exist when checking keys: %v", keys)
+			}
+			// Check that all keys are marked as in progress
+			for k := range keys {
+				if !stage.inprogressKeys.present(k) {
+					t.Errorf("key %q not marked as in progress", k)
+				}
+			}
+
+			bundleID := ""
+		sideBundles:
+			for _, rb := range em.injectedBundles {
+				// find that a side channel bundle exists with these keys.
+				bkeys := stage.inprogressKeysByBundle[rb.BundleID]
+				if len(bkeys) != len(keys) {
+					continue sideBundles
+				}
+				for k := range keys {
+					if !bkeys.present(k) {
+						continue sideBundles
+					}
+				}
+				bundleID = rb.BundleID
+				break
+			}
+			if bundleID == "" {
+				t.Errorf("no bundle found with all the given keys: %v: bundles: %v keysByBundle: %v", keys, em.injectedBundles, stage.inprogressKeysByBundle)
+			}
+		}
+
+		newOut := mtime.EndOfGlobalWindowTime
+		// No windows exist, so no side channel bundles should be set.
+		if got, want := stage.createOnWindowExpirationBundles(newOut, em), false; got != want {
+			t.Errorf("createOnWindowExpirationBundles(%v) = %v, want %v", newOut, got, want)
+		}
+		// Validate that no side channel bundles were created.
+		if got, want := len(stage.inProgressExpiredWindows), 0; got != want {
+			t.Errorf("len(stage.inProgressExpiredWindows) = %v, want %v", got, want)
+		}
+		if got, want := len(em.injectedBundles), 0; got != want {
+			t.Errorf("len(em.injectedBundles) = %v, want %v", got, want)
+		}
+
+		// Configure a few conditions to validate in the call.
+		// Each window is in it's own bundle, all are in the same bundle.
+		// Bundle 1
+		expiredWindow1 := window.IntervalWindow{Start: 0, End: newOut - 1}
+
+		akey := "\u0004key1"
+		keys1 := singleSet(akey)
+		stage.keysToExpireByWindow[expiredWindow1] = keys1
+		// Bundle 2
+		expiredWindow2 := window.IntervalWindow{Start: 1, End: newOut - 1}
+		keys2 := singleSet("\u0004key2")
+		keys2.insert("\u0004key3")
+		keys2.insert("\u0004key4")
+		stage.keysToExpireByWindow[expiredWindow2] = keys2
+
+		// We should never see this key and window combination, as the window is
+		// not yet expired.
+		liveWindow := window.IntervalWindow{Start: 2, End: newOut + 1}
+		stage.keysToExpireByWindow[liveWindow] = singleSet("\u0010keyNotSeen")
+
+		if got, want := stage.createOnWindowExpirationBundles(newOut, em), true; got != want {
+			t.Errorf("createOnWindowExpirationBundles(%v) = %v, want %v", newOut, got, want)
+		}
+
+		// We should only see 2 injectedBundles at this point.
+		if got, want := len(em.injectedBundles), 2; got != want {
+			t.Errorf("len(em.injectedBundles) = %v, want %v", got, want)
+		}
+
+		validateInProgressExpiredWindows(t, expiredWindow1, 1)
+		validateInProgressExpiredWindows(t, expiredWindow2, 1)
+		validateSideBundles(t, keys1)
+		validateSideBundles(t, keys2)
+
+		// Bundle 3
+		expiredWindow3 := window.IntervalWindow{Start: 3, End: newOut - 1}
+		keys3 := singleSet(akey)   // We shouldn't see this key, since it's in progress.
+		keys3.insert("\u0004key5") // We should see this key since it isn't.
+		stage.keysToExpireByWindow[expiredWindow3] = keys3
+
+		if got, want := stage.createOnWindowExpirationBundles(newOut, em), true; got != want {
+			t.Errorf("createOnWindowExpirationBundles(%v) = %v, want %v", newOut, got, want)
+		}
+
+		// We should see 3 injectedBundles at this point.
+		if got, want := len(em.injectedBundles), 3; got != want {
+			t.Errorf("len(em.injectedBundles) = %v, want %v", got, want)
+		}
+
+		validateInProgressExpiredWindows(t, expiredWindow1, 1)
+		validateInProgressExpiredWindows(t, expiredWindow2, 1)
+		validateInProgressExpiredWindows(t, expiredWindow3, 1)
+		validateSideBundles(t, keys1)
+		validateSideBundles(t, keys2)
+		validateSideBundles(t, singleSet("\u0004key5"))
+
+		// remove key1 from "inprogress keys", and the associated bundle.
+		stage.inprogressKeys.remove(akey)
+		delete(stage.inProgressExpiredWindows, expiredWindow1)
+		for bundID, bkeys := range stage.inprogressKeysByBundle {
+			if bkeys.present(akey) {
+				t.Logf("bundID: %v, bkeys: %v, keyByBundle: %v", bundID, bkeys, stage.inprogressKeysByBundle)
+				delete(stage.inprogressKeysByBundle, bundID)
+				win := stage.expiryWindowsByBundles[bundID]
+				delete(stage.expiryWindowsByBundles, bundID)
+				if win != expiredWindow1 {
+					t.Fatalf("Unexpected window: got %v, want %v", win, expiredWindow1)
+				}
+				break
+			}
+		}
+
+		// Now we should get another bundle for expiredWindow3, and have none for expiredWindow1
+		if got, want := stage.createOnWindowExpirationBundles(newOut, em), true; got != want {
+			t.Errorf("createOnWindowExpirationBundles(%v) = %v, want %v", newOut, got, want)
+		}
+
+		validateInProgressExpiredWindows(t, expiredWindow1, 0)
+		validateInProgressExpiredWindows(t, expiredWindow2, 1)
+		validateInProgressExpiredWindows(t, expiredWindow3, 2)
+		validateSideBundles(t, keys1) // Should still have this key present, but with a different bundle.
+		validateSideBundles(t, keys2)
+		validateSideBundles(t, singleSet("\u0004key5")) // still exist..
+	})
+}
diff --git a/sdks/go/pkg/beam/runners/prism/internal/execute.go b/sdks/go/pkg/beam/runners/prism/internal/execute.go
index 614edee47721..fde62f00c7c1 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/execute.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/execute.go
@@ -318,6 +318,10 @@ func executePipeline(ctx context.Context, wks map[string]*worker.W, j *jobservic
 			if stage.stateful {
 				em.StageStateful(stage.ID)
 			}
+			if stage.onWindowExpiration.TimerFamily != "" {
+				slog.Debug("OnWindowExpiration", slog.String("stage", stage.ID), slog.Any("values", stage.onWindowExpiration))
+				em.StageOnWindowExpiration(stage.ID, stage.onWindowExpiration)
+			}
 			if len(stage.processingTimeTimers) > 0 {
 				em.StageProcessingTimeTimers(stage.ID, stage.processingTimeTimers)
 			}
diff --git a/sdks/go/pkg/beam/runners/prism/internal/jobservices/job.go b/sdks/go/pkg/beam/runners/prism/internal/jobservices/job.go
index deef259a99d1..6158cd6d612c 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/jobservices/job.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/jobservices/job.go
@@ -45,6 +45,7 @@ var supportedRequirements = map[string]struct{}{
 	urns.RequirementSplittableDoFn:     {},
 	urns.RequirementStatefulProcessing: {},
 	urns.RequirementBundleFinalization: {},
+	urns.RequirementOnWindowExpiration: {},
 }
 
 // TODO, move back to main package, and key off of executor handlers?
diff --git a/sdks/go/pkg/beam/runners/prism/internal/jobservices/management.go b/sdks/go/pkg/beam/runners/prism/internal/jobservices/management.go
index a2840760bf7a..894a6e1427a2 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/jobservices/management.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/jobservices/management.go
@@ -182,8 +182,6 @@ func (s *Server) Prepare(ctx context.Context, req *jobpb.PrepareJobRequest) (_ *
 				check("TimerFamilySpecs.TimeDomain.Urn", spec.GetTimeDomain(), pipepb.TimeDomain_EVENT_TIME, pipepb.TimeDomain_PROCESSING_TIME)
 			}
 
-			check("OnWindowExpirationTimerFamily", pardo.GetOnWindowExpirationTimerFamilySpec(), "") // Unsupported for now.
-
 			// Check for a stateful SDF and direct user to https://github.com/apache/beam/issues/32139
 			if pardo.GetRestrictionCoderId() != "" && isStateful {
 				check("Splittable+Stateful DoFn", "See https://github.com/apache/beam/issues/32139 for information.", "")
diff --git a/sdks/go/pkg/beam/runners/prism/internal/preprocess.go b/sdks/go/pkg/beam/runners/prism/internal/preprocess.go
index dceaa9ab8fcb..0d3ec7c365c1 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/preprocess.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/preprocess.go
@@ -449,6 +449,9 @@ func finalizeStage(stg *stage, comps *pipepb.Components, pipelineFacts *fusionFa
 				if len(pardo.GetTimerFamilySpecs())+len(pardo.GetStateSpecs())+len(pardo.GetOnWindowExpirationTimerFamilySpec()) > 0 {
 					stg.stateful = true
 				}
+				if pardo.GetOnWindowExpirationTimerFamilySpec() != "" {
+					stg.onWindowExpiration = engine.StaticTimerID{TransformID: link.Transform, TimerFamily: pardo.GetOnWindowExpirationTimerFamilySpec()}
+				}
 				sis = pardo.GetSideInputs()
 			}
 			if _, ok := sis[link.Local]; ok {
diff --git a/sdks/go/pkg/beam/runners/prism/internal/stage.go b/sdks/go/pkg/beam/runners/prism/internal/stage.go
index 9f00c22789b6..9dd6cbdafec8 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/stage.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/stage.go
@@ -57,18 +57,20 @@ type link struct {
 // account, but all serialization boundaries remain since the pcollections
 // would continue to get serialized.
 type stage struct {
-	ID           string
-	transforms   []string
-	primaryInput string          // PCollection used as the parallel input.
-	outputs      []link          // PCollections that must escape this stage.
-	sideInputs   []engine.LinkID // Non-parallel input PCollections and their consumers
-	internalCols []string        // PCollections that escape. Used for precise coder sending.
-	envID        string
-	finalize     bool
-	stateful     bool
+	ID                 string
+	transforms         []string
+	primaryInput       string          // PCollection used as the parallel input.
+	outputs            []link          // PCollections that must escape this stage.
+	sideInputs         []engine.LinkID // Non-parallel input PCollections and their consumers
+	internalCols       []string        // PCollections that escape. Used for precise coder sending.
+	envID              string
+	finalize           bool
+	stateful           bool
+	onWindowExpiration engine.StaticTimerID
+
 	// hasTimers indicates the transform+timerfamily pairs that need to be waited on for
 	// the stage to be considered complete.
-	hasTimers            []struct{ Transform, TimerFamily string }
+	hasTimers            []engine.StaticTimerID
 	processingTimeTimers map[string]bool
 
 	exe              transformExecuter
@@ -452,7 +454,7 @@ func buildDescriptor(stg *stage, comps *pipepb.Components, wk *worker.W, em *eng
 			}
 		}
 		for timerID, v := range pardo.GetTimerFamilySpecs() {
-			stg.hasTimers = append(stg.hasTimers, struct{ Transform, TimerFamily string }{Transform: tid, TimerFamily: timerID})
+			stg.hasTimers = append(stg.hasTimers, engine.StaticTimerID{TransformID: tid, TimerFamily: timerID})
 			if v.TimeDomain == pipepb.TimeDomain_PROCESSING_TIME {
 				if stg.processingTimeTimers == nil {
 					stg.processingTimeTimers = map[string]bool{}
diff --git a/sdks/go/pkg/beam/runners/prism/internal/worker/bundle.go b/sdks/go/pkg/beam/runners/prism/internal/worker/bundle.go
index 83ad1bda9841..14cd84aef821 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/worker/bundle.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/worker/bundle.go
@@ -42,7 +42,7 @@ type B struct {
 	InputTransformID       string
 	Input                  []*engine.Block // Data and Timers for this bundle.
 	EstimatedInputElements int
-	HasTimers              []struct{ Transform, TimerFamily string } // Timer streams to terminate.
+	HasTimers              []engine.StaticTimerID // Timer streams to terminate.
 
 	// IterableSideInputData is a map from transformID + inputID, to window, to data.
 	IterableSideInputData map[SideInputKey]map[typex.Window][][]byte
@@ -190,7 +190,7 @@ func (b *B) ProcessOn(ctx context.Context, wk *W) <-chan struct{} {
 	for _, tid := range b.HasTimers {
 		timers = append(timers, &fnpb.Elements_Timers{
 			InstructionId: b.InstID,
-			TransformId:   tid.Transform,
+			TransformId:   tid.TransformID,
 			TimerFamilyId: tid.TimerFamily,
 			IsLast:        true,
 		})

From 02f9cb94fcd31527933164ecc3709c5d9f04cae3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 12 Dec 2024 22:16:26 -0800
Subject: [PATCH 109/135] Bump google.golang.org/api from 0.210.0 to 0.211.0 in
 /sdks (#33374)

Bumps [google.golang.org/api](https://github.com/googleapis/google-api-go-client) from 0.210.0 to 0.211.0.
- [Release notes](https://github.com/googleapis/google-api-go-client/releases)
- [Changelog](https://github.com/googleapis/google-api-go-client/blob/main/CHANGES.md)
- [Commits](https://github.com/googleapis/google-api-go-client/compare/v0.210.0...v0.211.0)

---
updated-dependencies:
- dependency-name: google.golang.org/api
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod |  8 ++++----
 sdks/go.sum | 16 ++++++++--------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index e6a182035f5e..79b32b051df3 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -58,7 +58,7 @@ require (
 	golang.org/x/sync v0.10.0
 	golang.org/x/sys v0.28.0
 	golang.org/x/text v0.21.0
-	google.golang.org/api v0.210.0
+	google.golang.org/api v0.211.0
 	google.golang.org/genproto v0.0.0-20241118233622-e639e219e697
 	google.golang.org/grpc v1.67.2
 	google.golang.org/protobuf v1.35.2
@@ -75,7 +75,7 @@ require (
 
 require (
 	cel.dev/expr v0.16.1 // indirect
-	cloud.google.com/go/auth v0.11.0 // indirect
+	cloud.google.com/go/auth v0.12.1 // indirect
 	cloud.google.com/go/auth/oauth2adapt v0.2.6 // indirect
 	cloud.google.com/go/monitoring v1.21.2 // indirect
 	dario.cat/mergo v1.0.0 // indirect
@@ -194,6 +194,6 @@ require (
 	golang.org/x/mod v0.20.0 // indirect
 	golang.org/x/tools v0.24.0 // indirect
 	golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da // indirect
-	google.golang.org/genproto/googleapis/api v0.0.0-20241113202542-65e8d215514f // indirect
-	google.golang.org/genproto/googleapis/rpc v0.0.0-20241118233622-e639e219e697 // indirect
+	google.golang.org/genproto/googleapis/api v0.0.0-20241118233622-e639e219e697 // indirect
+	google.golang.org/genproto/googleapis/rpc v0.0.0-20241206012308-a4fef0638583 // indirect
 )
diff --git a/sdks/go.sum b/sdks/go.sum
index 34e34ef2f8cd..0e7792f499f4 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -101,8 +101,8 @@ cloud.google.com/go/assuredworkloads v1.7.0/go.mod h1:z/736/oNmtGAyU47reJgGN+KVo
 cloud.google.com/go/assuredworkloads v1.8.0/go.mod h1:AsX2cqyNCOvEQC8RMPnoc0yEarXQk6WEKkxYfL6kGIo=
 cloud.google.com/go/assuredworkloads v1.9.0/go.mod h1:kFuI1P78bplYtT77Tb1hi0FMxM0vVpRC7VVoJC3ZoT0=
 cloud.google.com/go/assuredworkloads v1.10.0/go.mod h1:kwdUQuXcedVdsIaKgKTp9t0UJkE5+PAVNhdQm4ZVq2E=
-cloud.google.com/go/auth v0.11.0 h1:Ic5SZz2lsvbYcWT5dfjNWgw6tTlGi2Wc8hyQSC9BstA=
-cloud.google.com/go/auth v0.11.0/go.mod h1:xxA5AqpDrvS+Gkmo9RqrGGRh6WSNKKOXhY3zNOr38tI=
+cloud.google.com/go/auth v0.12.1 h1:n2Bj25BUMM0nvE9D2XLTiImanwZhO3DkfWSYS/SAJP4=
+cloud.google.com/go/auth v0.12.1/go.mod h1:BFMu+TNpF3DmvfBO9ClqTR/SiqVIm7LukKF9mbendF4=
 cloud.google.com/go/auth/oauth2adapt v0.2.6 h1:V6a6XDu2lTwPZWOawrAa9HUK+DB2zfJyTuciBG5hFkU=
 cloud.google.com/go/auth/oauth2adapt v0.2.6/go.mod h1:AlmsELtlEBnaNTL7jCj8VQFLy6mbZv0s4Q7NGBeQ5E8=
 cloud.google.com/go/automl v1.5.0/go.mod h1:34EjfoFGMZ5sgJ9EoLsRtdPSNZLcfflJR39VbVNS2M0=
@@ -1707,8 +1707,8 @@ google.golang.org/api v0.108.0/go.mod h1:2Ts0XTHNVWxypznxWOYUeI4g3WdP9Pk2Qk58+a/
 google.golang.org/api v0.110.0/go.mod h1:7FC4Vvx1Mooxh8C5HWjzZHcavuS2f6pmJpZx60ca7iI=
 google.golang.org/api v0.111.0/go.mod h1:qtFHvU9mhgTJegR31csQ+rwxyUTHOKFqCKWp1J0fdw0=
 google.golang.org/api v0.114.0/go.mod h1:ifYI2ZsFK6/uGddGfAD5BMxlnkBqCmqHSDUVi45N5Yg=
-google.golang.org/api v0.210.0 h1:HMNffZ57OoZCRYSbdWVRoqOa8V8NIHLL0CzdBPLztWk=
-google.golang.org/api v0.210.0/go.mod h1:B9XDZGnx2NtyjzVkOVTGrFSAVZgPcbedzKg/gTLwqBs=
+google.golang.org/api v0.211.0 h1:IUpLjq09jxBSV1lACO33CGY3jsRcbctfGzhj+ZSE/Bg=
+google.golang.org/api v0.211.0/go.mod h1:XOloB4MXFH4UTlQSGuNUxw0UT74qdENK8d6JNsXKLi0=
 google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM=
 google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4=
 google.golang.org/appengine v1.5.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4=
@@ -1850,10 +1850,10 @@ google.golang.org/genproto v0.0.0-20230331144136-dcfb400f0633/go.mod h1:UUQDJDOl
 google.golang.org/genproto v0.0.0-20230410155749-daa745c078e1/go.mod h1:nKE/iIaLqn2bQwXBg8f1g2Ylh6r5MN5CmZvuzZCgsCU=
 google.golang.org/genproto v0.0.0-20241118233622-e639e219e697 h1:ToEetK57OidYuqD4Q5w+vfEnPvPpuTwedCNVohYJfNk=
 google.golang.org/genproto v0.0.0-20241118233622-e639e219e697/go.mod h1:JJrvXBWRZaFMxBufik1a4RpFw4HhgVtBBWQeQgUj2cc=
-google.golang.org/genproto/googleapis/api v0.0.0-20241113202542-65e8d215514f h1:M65LEviCfuZTfrfzwwEoxVtgvfkFkBUbFnRbxCXuXhU=
-google.golang.org/genproto/googleapis/api v0.0.0-20241113202542-65e8d215514f/go.mod h1:Yo94eF2nj7igQt+TiJ49KxjIH8ndLYPZMIRSiRcEbg0=
-google.golang.org/genproto/googleapis/rpc v0.0.0-20241118233622-e639e219e697 h1:LWZqQOEjDyONlF1H6afSWpAL/znlREo2tHfLoe+8LMA=
-google.golang.org/genproto/googleapis/rpc v0.0.0-20241118233622-e639e219e697/go.mod h1:5uTbfoYQed2U9p3KIj2/Zzm02PYhndfdmML0qC3q3FU=
+google.golang.org/genproto/googleapis/api v0.0.0-20241118233622-e639e219e697 h1:pgr/4QbFyktUv9CtQ/Fq4gzEE6/Xs7iCXbktaGzLHbQ=
+google.golang.org/genproto/googleapis/api v0.0.0-20241118233622-e639e219e697/go.mod h1:+D9ySVjN8nY8YCVjc5O7PZDIdZporIDY3KaGfJunh88=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20241206012308-a4fef0638583 h1:IfdSdTcLFy4lqUQrQJLkLt1PB+AsqVz6lwkWPzWEz10=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20241206012308-a4fef0638583/go.mod h1:5uTbfoYQed2U9p3KIj2/Zzm02PYhndfdmML0qC3q3FU=
 google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c=
 google.golang.org/grpc v1.20.1/go.mod h1:10oTOabMzJvdu6/UiuZezV6QK5dSlG84ov/aaiqXj38=
 google.golang.org/grpc v1.21.1/go.mod h1:oYelfM1adQP15Ek0mdvEgi9Df8B9CZIaU1084ijfRaM=

From 994d2f0cad0a4e7d2511c518af6d4f5a9696cd21 Mon Sep 17 00:00:00 2001
From: "Doroszlai, Attila" <6454655+adoroszlai@users.noreply.github.com>
Date: Fri, 13 Dec 2024 15:13:51 +0100
Subject: [PATCH 110/135] Fix Apache snapshot repo usage (#33370)

* limit Apache snapshot repo content type

* move up Confluent repo
---
 .../apache/beam/gradle/Repositories.groovy    | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/buildSrc/src/main/groovy/org/apache/beam/gradle/Repositories.groovy b/buildSrc/src/main/groovy/org/apache/beam/gradle/Repositories.groovy
index 52cbbd15c35b..58ec64a0add3 100644
--- a/buildSrc/src/main/groovy/org/apache/beam/gradle/Repositories.groovy
+++ b/buildSrc/src/main/groovy/org/apache/beam/gradle/Repositories.groovy
@@ -39,20 +39,25 @@ class Repositories {
       mavenCentral()
       mavenLocal()
 
+      // For Confluent Kafka dependencies
+      maven {
+        url "https://packages.confluent.io/maven/"
+        content { includeGroup "io.confluent" }
+      }
+
       // Release staging repository
       maven { url "https://oss.sonatype.org/content/repositories/staging/" }
 
       // Apache nightly snapshots
-      maven { url "https://repository.apache.org/snapshots" }
+      maven {
+        url "https://repository.apache.org/snapshots"
+        mavenContent {
+          snapshotsOnly()
+        }
+      }
 
       // Apache release snapshots
       maven { url "https://repository.apache.org/content/repositories/releases" }
-
-      // For Confluent Kafka dependencies
-      maven {
-        url "https://packages.confluent.io/maven/"
-        content { includeGroup "io.confluent" }
-      }
     }
 
     // Apply a plugin which provides the 'updateOfflineRepository' task that creates an offline

From a6061feb05363a6175e28f80f684b6d306a42150 Mon Sep 17 00:00:00 2001
From: twosom <72733442+twosom@users.noreply.github.com>
Date: Sat, 14 Dec 2024 00:44:48 +0900
Subject: [PATCH 111/135] Batch optimized SparkRunner groupByKey (#33322)

* feat : optimized SparkRunner batch groupByKey

* update CHANGES.md

* touch trigger files

* remove unused test
---
 .../beam_PostCommit_Java_PVR_Spark_Batch.json |  2 +-
 ...PostCommit_Java_ValidatesRunner_Spark.json |  3 +-
 ...mit_Java_ValidatesRunner_Spark_Java11.json |  3 +-
 CHANGES.md                                    |  1 +
 .../translation/GroupCombineFunctions.java    | 46 ++++++---
 .../GroupNonMergingWindowsFunctions.java      | 98 ++++++++++++++-----
 .../GroupNonMergingWindowsFunctionsTest.java  | 57 -----------
 7 files changed, 116 insertions(+), 94 deletions(-)

diff --git a/.github/trigger_files/beam_PostCommit_Java_PVR_Spark_Batch.json b/.github/trigger_files/beam_PostCommit_Java_PVR_Spark_Batch.json
index f1ba03a243ee..455144f02a35 100644
--- a/.github/trigger_files/beam_PostCommit_Java_PVR_Spark_Batch.json
+++ b/.github/trigger_files/beam_PostCommit_Java_PVR_Spark_Batch.json
@@ -1,4 +1,4 @@
 {
   "comment": "Modify this file in a trivial way to cause this test suite to run",
-  "modification": 5
+  "modification": 6
 }
diff --git a/.github/trigger_files/beam_PostCommit_Java_ValidatesRunner_Spark.json b/.github/trigger_files/beam_PostCommit_Java_ValidatesRunner_Spark.json
index 9b023f630c36..03d86a8d023e 100644
--- a/.github/trigger_files/beam_PostCommit_Java_ValidatesRunner_Spark.json
+++ b/.github/trigger_files/beam_PostCommit_Java_ValidatesRunner_Spark.json
@@ -2,5 +2,6 @@
   "comment": "Modify this file in a trivial way to cause this test suite to run",
   "https://github.com/apache/beam/pull/31156": "noting that PR #31156 should run this test",
   "https://github.com/apache/beam/pull/31798": "noting that PR #31798 should run this test",
-  "https://github.com/apache/beam/pull/32546": "noting that PR #32546 should run this test"
+  "https://github.com/apache/beam/pull/32546": "noting that PR #32546 should run this test",
+  "https://github.com/apache/beam/pull/33322": "noting that PR #33322 should run this test"
 }
diff --git a/.github/trigger_files/beam_PostCommit_Java_ValidatesRunner_Spark_Java11.json b/.github/trigger_files/beam_PostCommit_Java_ValidatesRunner_Spark_Java11.json
index 9b023f630c36..03d86a8d023e 100644
--- a/.github/trigger_files/beam_PostCommit_Java_ValidatesRunner_Spark_Java11.json
+++ b/.github/trigger_files/beam_PostCommit_Java_ValidatesRunner_Spark_Java11.json
@@ -2,5 +2,6 @@
   "comment": "Modify this file in a trivial way to cause this test suite to run",
   "https://github.com/apache/beam/pull/31156": "noting that PR #31156 should run this test",
   "https://github.com/apache/beam/pull/31798": "noting that PR #31798 should run this test",
-  "https://github.com/apache/beam/pull/32546": "noting that PR #32546 should run this test"
+  "https://github.com/apache/beam/pull/32546": "noting that PR #32546 should run this test",
+  "https://github.com/apache/beam/pull/33322": "noting that PR #33322 should run this test"
 }
diff --git a/CHANGES.md b/CHANGES.md
index ea29b6aadc7d..5bbb10f76efb 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -68,6 +68,7 @@
 
 ## New Features / Improvements
 
+* Improved batch performance of SparkRunner's GroupByKey ([#20943](https://github.com/apache/beam/pull/20943)).
 * X feature added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
 * Support OnWindowExpiration in Prism ([#32211](https://github.com/apache/beam/issues/32211)).
   * This enables initial Java GroupIntoBatches support.
diff --git a/runners/spark/src/main/java/org/apache/beam/runners/spark/translation/GroupCombineFunctions.java b/runners/spark/src/main/java/org/apache/beam/runners/spark/translation/GroupCombineFunctions.java
index 62c5e2579427..1d8901ed5ffc 100644
--- a/runners/spark/src/main/java/org/apache/beam/runners/spark/translation/GroupCombineFunctions.java
+++ b/runners/spark/src/main/java/org/apache/beam/runners/spark/translation/GroupCombineFunctions.java
@@ -17,6 +17,9 @@
  */
 package org.apache.beam.runners.spark.translation;
 
+import java.util.Iterator;
+import java.util.List;
+import java.util.stream.Collectors;
 import org.apache.beam.runners.spark.coders.CoderHelpers;
 import org.apache.beam.runners.spark.util.ByteArray;
 import org.apache.beam.sdk.coders.Coder;
@@ -27,6 +30,7 @@
 import org.apache.beam.sdk.values.KV;
 import org.apache.beam.sdk.values.WindowingStrategy;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.Iterables;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.Iterators;
 import org.apache.spark.Partitioner;
 import org.apache.spark.api.java.JavaPairRDD;
 import org.apache.spark.api.java.JavaRDD;
@@ -49,18 +53,36 @@ public static <K, V> JavaRDD<KV<K, Iterable<WindowedValue<V>>>> groupByKeyOnly(
       @Nullable Partitioner partitioner) {
     // we use coders to convert objects in the PCollection to byte arrays, so they
     // can be transferred over the network for the shuffle.
-    JavaPairRDD<ByteArray, byte[]> pairRDD =
-        rdd.map(new ReifyTimestampsAndWindowsFunction<>())
-            .mapToPair(TranslationUtils.toPairFunction())
-            .mapToPair(CoderHelpers.toByteFunction(keyCoder, wvCoder));
-
-    // If no partitioner is passed, the default group by key operation is called
-    JavaPairRDD<ByteArray, Iterable<byte[]>> groupedRDD =
-        (partitioner != null) ? pairRDD.groupByKey(partitioner) : pairRDD.groupByKey();
-
-    return groupedRDD
-        .mapToPair(CoderHelpers.fromByteFunctionIterable(keyCoder, wvCoder))
-        .map(new TranslationUtils.FromPairFunction<>());
+    final JavaPairRDD<ByteArray, byte[]> pairRDD =
+        rdd.mapPartitionsToPair(
+            (Iterator<WindowedValue<KV<K, V>>> iter) ->
+                Iterators.transform(
+                    iter,
+                    (WindowedValue<KV<K, V>> wv) -> {
+                      final K key = wv.getValue().getKey();
+                      final WindowedValue<V> windowedValue = wv.withValue(wv.getValue().getValue());
+                      final ByteArray keyBytes =
+                          new ByteArray(CoderHelpers.toByteArray(key, keyCoder));
+                      final byte[] windowedValueBytes =
+                          CoderHelpers.toByteArray(windowedValue, wvCoder);
+                      return Tuple2.apply(keyBytes, windowedValueBytes);
+                    }));
+
+    final JavaPairRDD<ByteArray, List<byte[]>> combined =
+        GroupNonMergingWindowsFunctions.combineByKey(pairRDD, partitioner).cache();
+
+    return combined.mapPartitions(
+        (Iterator<Tuple2<ByteArray, List<byte[]>>> iter) ->
+            Iterators.transform(
+                iter,
+                (Tuple2<ByteArray, List<byte[]>> tuple) -> {
+                  final K key = CoderHelpers.fromByteArray(tuple._1().getValue(), keyCoder);
+                  final List<WindowedValue<V>> windowedValues =
+                      tuple._2().stream()
+                          .map(bytes -> CoderHelpers.fromByteArray(bytes, wvCoder))
+                          .collect(Collectors.toList());
+                  return KV.of(key, windowedValues);
+                }));
   }
 
   /**
diff --git a/runners/spark/src/main/java/org/apache/beam/runners/spark/translation/GroupNonMergingWindowsFunctions.java b/runners/spark/src/main/java/org/apache/beam/runners/spark/translation/GroupNonMergingWindowsFunctions.java
index 2461d5cc8d66..14630fbb0a1f 100644
--- a/runners/spark/src/main/java/org/apache/beam/runners/spark/translation/GroupNonMergingWindowsFunctions.java
+++ b/runners/spark/src/main/java/org/apache/beam/runners/spark/translation/GroupNonMergingWindowsFunctions.java
@@ -17,7 +17,9 @@
  */
 package org.apache.beam.runners.spark.translation;
 
+import java.util.ArrayList;
 import java.util.Iterator;
+import java.util.List;
 import java.util.Objects;
 import org.apache.beam.runners.spark.coders.CoderHelpers;
 import org.apache.beam.runners.spark.util.ByteArray;
@@ -41,6 +43,9 @@
 import org.apache.spark.Partitioner;
 import org.apache.spark.api.java.JavaPairRDD;
 import org.apache.spark.api.java.JavaRDD;
+import org.apache.spark.api.java.function.Function;
+import org.apache.spark.api.java.function.Function2;
+import org.checkerframework.checker.nullness.qual.Nullable;
 import org.joda.time.Instant;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -259,9 +264,12 @@ private WindowedValue<KV<K, V>> decodeItem(Tuple2<ByteArray, byte[]> item) {
   }
 
   /**
-   * Group all values with a given key for that composite key with Spark's groupByKey, dropping the
-   * Window (which must be GlobalWindow) and returning the grouped result in the appropriate global
-   * window.
+   * Groups values with a given key using Spark's combineByKey operation in the Global Window
+   * context. The window information (which must be GlobalWindow) is dropped during processing, and
+   * the grouped results are returned in the appropriate global window with the maximum timestamp.
+   *
+   * <p>This implementation uses {@link JavaPairRDD#combineByKey} for better performance compared to
+   * {@link JavaPairRDD#groupByKey}, as it allows for local aggregation before shuffle operations.
    */
   static <K, V, W extends BoundedWindow>
       JavaRDD<WindowedValue<KV<K, Iterable<V>>>> groupByKeyInGlobalWindow(
@@ -269,24 +277,70 @@ JavaRDD<WindowedValue<KV<K, Iterable<V>>>> groupByKeyInGlobalWindow(
           Coder<K> keyCoder,
           Coder<V> valueCoder,
           Partitioner partitioner) {
-    JavaPairRDD<ByteArray, byte[]> rawKeyValues =
-        rdd.mapToPair(
-            wv ->
-                new Tuple2<>(
-                    new ByteArray(CoderHelpers.toByteArray(wv.getValue().getKey(), keyCoder)),
-                    CoderHelpers.toByteArray(wv.getValue().getValue(), valueCoder)));
-
-    JavaPairRDD<ByteArray, Iterable<byte[]>> grouped =
-        (partitioner == null) ? rawKeyValues.groupByKey() : rawKeyValues.groupByKey(partitioner);
-    return grouped.map(
-        kvs ->
-            WindowedValue.timestampedValueInGlobalWindow(
-                KV.of(
-                    CoderHelpers.fromByteArray(kvs._1.getValue(), keyCoder),
-                    Iterables.transform(
-                        kvs._2,
-                        encodedValue -> CoderHelpers.fromByteArray(encodedValue, valueCoder))),
-                GlobalWindow.INSTANCE.maxTimestamp(),
-                PaneInfo.ON_TIME_AND_ONLY_FIRING));
+    final JavaPairRDD<ByteArray, byte[]> rawKeyValues =
+        rdd.mapPartitionsToPair(
+            (Iterator<WindowedValue<KV<K, V>>> iter) ->
+                Iterators.transform(
+                    iter,
+                    (WindowedValue<KV<K, V>> wv) -> {
+                      final ByteArray keyBytes =
+                          new ByteArray(CoderHelpers.toByteArray(wv.getValue().getKey(), keyCoder));
+                      final byte[] valueBytes =
+                          CoderHelpers.toByteArray(wv.getValue().getValue(), valueCoder);
+                      return Tuple2.apply(keyBytes, valueBytes);
+                    }));
+
+    JavaPairRDD<ByteArray, List<byte[]>> combined = combineByKey(rawKeyValues, partitioner).cache();
+
+    return combined.mapPartitions(
+        (Iterator<Tuple2<ByteArray, List<byte[]>>> iter) ->
+            Iterators.transform(
+                iter,
+                kvs ->
+                    WindowedValue.timestampedValueInGlobalWindow(
+                        KV.of(
+                            CoderHelpers.fromByteArray(kvs._1.getValue(), keyCoder),
+                            Iterables.transform(
+                                kvs._2(),
+                                encodedValue ->
+                                    CoderHelpers.fromByteArray(encodedValue, valueCoder))),
+                        GlobalWindow.INSTANCE.maxTimestamp(),
+                        PaneInfo.ON_TIME_AND_ONLY_FIRING)));
+  }
+
+  /**
+   * Combines values by key using Spark's {@link JavaPairRDD#combineByKey} operation.
+   *
+   * @param rawKeyValues Input RDD of key-value pairs
+   * @param partitioner Optional custom partitioner for data distribution
+   * @return RDD with values combined into Lists per key
+   */
+  static JavaPairRDD<ByteArray, List<byte[]>> combineByKey(
+      JavaPairRDD<ByteArray, byte[]> rawKeyValues, @Nullable Partitioner partitioner) {
+
+    final Function<byte[], List<byte[]>> createCombiner =
+        value -> {
+          List<byte[]> list = new ArrayList<>();
+          list.add(value);
+          return list;
+        };
+
+    final Function2<List<byte[]>, byte[], List<byte[]>> mergeValues =
+        (list, value) -> {
+          list.add(value);
+          return list;
+        };
+
+    final Function2<List<byte[]>, List<byte[]>, List<byte[]>> mergeCombiners =
+        (list1, list2) -> {
+          list1.addAll(list2);
+          return list1;
+        };
+
+    if (partitioner == null) {
+      return rawKeyValues.combineByKey(createCombiner, mergeValues, mergeCombiners);
+    }
+
+    return rawKeyValues.combineByKey(createCombiner, mergeValues, mergeCombiners, partitioner);
   }
 }
diff --git a/runners/spark/src/test/java/org/apache/beam/runners/spark/translation/GroupNonMergingWindowsFunctionsTest.java b/runners/spark/src/test/java/org/apache/beam/runners/spark/translation/GroupNonMergingWindowsFunctionsTest.java
index ed7bc078564e..fd299924af91 100644
--- a/runners/spark/src/test/java/org/apache/beam/runners/spark/translation/GroupNonMergingWindowsFunctionsTest.java
+++ b/runners/spark/src/test/java/org/apache/beam/runners/spark/translation/GroupNonMergingWindowsFunctionsTest.java
@@ -18,12 +18,6 @@
 package org.apache.beam.runners.spark.translation;
 
 import static org.junit.Assert.assertEquals;
-import static org.mockito.Mockito.any;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.never;
-import static org.mockito.Mockito.times;
-import static org.mockito.Mockito.verify;
-import static org.mockito.Mockito.when;
 
 import java.util.Arrays;
 import java.util.Iterator;
@@ -45,9 +39,6 @@
 import org.apache.beam.sdk.values.KV;
 import org.apache.beam.sdk.values.WindowingStrategy;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.primitives.Bytes;
-import org.apache.spark.Partitioner;
-import org.apache.spark.api.java.JavaPairRDD;
-import org.apache.spark.api.java.JavaRDD;
 import org.joda.time.Duration;
 import org.joda.time.Instant;
 import org.junit.Assert;
@@ -121,54 +112,6 @@ public void testGbkIteratorValuesCannotBeReiterated() throws Coder.NonDeterminis
     }
   }
 
-  @Test
-  @SuppressWarnings({"rawtypes", "unchecked"})
-  public void testGroupByKeyInGlobalWindowWithPartitioner() {
-    // mocking
-    Partitioner mockPartitioner = mock(Partitioner.class);
-    JavaRDD mockRdd = mock(JavaRDD.class);
-    Coder mockKeyCoder = mock(Coder.class);
-    Coder mockValueCoder = mock(Coder.class);
-    JavaPairRDD mockRawKeyValues = mock(JavaPairRDD.class);
-    JavaPairRDD mockGrouped = mock(JavaPairRDD.class);
-
-    when(mockRdd.mapToPair(any())).thenReturn(mockRawKeyValues);
-    when(mockRawKeyValues.groupByKey(any(Partitioner.class)))
-        .thenAnswer(
-            invocation -> {
-              Partitioner partitioner = invocation.getArgument(0);
-              assertEquals(partitioner, mockPartitioner);
-              return mockGrouped;
-            });
-    when(mockGrouped.map(any())).thenReturn(mock(JavaRDD.class));
-
-    GroupNonMergingWindowsFunctions.groupByKeyInGlobalWindow(
-        mockRdd, mockKeyCoder, mockValueCoder, mockPartitioner);
-
-    verify(mockRawKeyValues, never()).groupByKey();
-    verify(mockRawKeyValues, times(1)).groupByKey(any(Partitioner.class));
-  }
-
-  @Test
-  @SuppressWarnings({"rawtypes", "unchecked"})
-  public void testGroupByKeyInGlobalWindowWithoutPartitioner() {
-    // mocking
-    JavaRDD mockRdd = mock(JavaRDD.class);
-    Coder mockKeyCoder = mock(Coder.class);
-    Coder mockValueCoder = mock(Coder.class);
-    JavaPairRDD mockRawKeyValues = mock(JavaPairRDD.class);
-    JavaPairRDD mockGrouped = mock(JavaPairRDD.class);
-
-    when(mockRdd.mapToPair(any())).thenReturn(mockRawKeyValues);
-    when(mockRawKeyValues.groupByKey()).thenReturn(mockGrouped);
-
-    GroupNonMergingWindowsFunctions.groupByKeyInGlobalWindow(
-        mockRdd, mockKeyCoder, mockValueCoder, null);
-
-    verify(mockRawKeyValues, times(1)).groupByKey();
-    verify(mockRawKeyValues, never()).groupByKey(any(Partitioner.class));
-  }
-
   private GroupByKeyIterator<String, Integer, GlobalWindow> createGbkIterator()
       throws Coder.NonDeterministicException {
     return createGbkIterator(

From 011ec94b9e36bb013f165f9dc4799474aeaa5ac2 Mon Sep 17 00:00:00 2001
From: Robert Burke <lostluck@users.noreply.github.com>
Date: Fri, 13 Dec 2024 08:46:43 -0800
Subject: [PATCH 112/135] remove flaky tests that terminate before read.
 (#33371)

Co-authored-by: lostluck <13907733+lostluck@users.noreply.github.com>
---
 .../beam/core/runtime/harness/datamgr_test.go | 28 -------------------
 1 file changed, 28 deletions(-)

diff --git a/sdks/go/pkg/beam/core/runtime/harness/datamgr_test.go b/sdks/go/pkg/beam/core/runtime/harness/datamgr_test.go
index 92c4d0a8f8cd..9f6f8a986a3f 100644
--- a/sdks/go/pkg/beam/core/runtime/harness/datamgr_test.go
+++ b/sdks/go/pkg/beam/core/runtime/harness/datamgr_test.go
@@ -261,22 +261,6 @@ func TestElementChan(t *testing.T) {
 				return elms
 			},
 			wantSum: 6, wantCount: 3,
-		}, {
-			name: "FillBufferThenAbortThenRead",
-			sequenceFn: func(ctx context.Context, t *testing.T, client *fakeChanClient, c *DataChannel) <-chan exec.Elements {
-				for i := 0; i < bufElements+2; i++ {
-					client.Send(&fnpb.Elements{Data: []*fnpb.Elements_Data{dataElm(1, false)}})
-				}
-				elms := openChan(ctx, t, c, timerID)
-				c.removeInstruction(instID)
-
-				// These will be ignored
-				client.Send(&fnpb.Elements{Data: []*fnpb.Elements_Data{dataElm(1, false)}})
-				client.Send(&fnpb.Elements{Data: []*fnpb.Elements_Data{dataElm(2, false)}})
-				client.Send(&fnpb.Elements{Data: []*fnpb.Elements_Data{dataElm(3, true)}})
-				return elms
-			},
-			wantSum: bufElements, wantCount: bufElements,
 		}, {
 			name: "DataThenReaderThenLast",
 			sequenceFn: func(ctx context.Context, t *testing.T, client *fakeChanClient, c *DataChannel) <-chan exec.Elements {
@@ -389,18 +373,6 @@ func TestElementChan(t *testing.T) {
 				return elms
 			},
 			wantSum: 0, wantCount: 0,
-		}, {
-			name: "SomeTimersAndADataThenReaderThenCleanup",
-			sequenceFn: func(ctx context.Context, t *testing.T, client *fakeChanClient, c *DataChannel) <-chan exec.Elements {
-				client.Send(&fnpb.Elements{
-					Timers: []*fnpb.Elements_Timers{timerElm(1, false), timerElm(2, true)},
-					Data:   []*fnpb.Elements_Data{dataElm(3, true)},
-				})
-				elms := openChan(ctx, t, c, timerID)
-				c.removeInstruction(instID)
-				return elms
-			},
-			wantSum: 6, wantCount: 3,
 		},
 	}
 	for _, test := range tests {

From f92dde16fa66fe104cd6057612bfadb4732c186b Mon Sep 17 00:00:00 2001
From: Damon <damondouglas@users.noreply.github.com>
Date: Fri, 13 Dec 2024 10:41:07 -0800
Subject: [PATCH 113/135] Clean up Java Tests GitHub workflow (#33354)

* Remove use of static credentials

* Stage for adding back dataflow

* Remove unnecessary dataflow test
---
 .github/workflows/java_tests.yml | 72 +-------------------------------
 1 file changed, 2 insertions(+), 70 deletions(-)

diff --git a/.github/workflows/java_tests.yml b/.github/workflows/java_tests.yml
index 1d6441b24681..bdc78b88cb97 100644
--- a/.github/workflows/java_tests.yml
+++ b/.github/workflows/java_tests.yml
@@ -20,11 +20,7 @@
 name: Java Tests
 on:
   workflow_dispatch:
-    inputs:
-      runDataflow:
-        description: 'Type "true" if you want to run Dataflow tests (GCP variables must be configured, check CI.md)'
-        default: 'false'
-        required: false
+  
   schedule:
     - cron: '10 2 * * *'
   push:
@@ -33,8 +29,7 @@ on:
   pull_request:
     branches: ['master', 'release-*']
     tags: ['v*']
-    paths: ['sdks/java/**', 'model/**', 'runners/**', 'examples/java/**',
-            'examples/kotlin/**', 'release/**', 'buildSrc/**']
+    paths: ['sdks/java/**', 'model/**', 'runners/**', 'examples/java/**', 'examples/kotlin/**', 'release/**', 'buildSrc/**']
 # This allows a subsequently queued workflow run to interrupt previous runs
 concurrency:
   group: '${{ github.workflow }} @ ${{ github.event.issue.number || github.event.pull_request.head.label || github.sha || github.head_ref || github.ref }}-${{ github.event.schedule || github.event.comment.id || github.event.sender.login}}'
@@ -44,26 +39,6 @@ env:
   GRADLE_ENTERPRISE_CACHE_USERNAME: ${{ secrets.GE_CACHE_USERNAME }}
   GRADLE_ENTERPRISE_CACHE_PASSWORD: ${{ secrets.GE_CACHE_PASSWORD }}
 jobs:
-  check_gcp_variables:
-    timeout-minutes: 5
-    name: "Check GCP variables set"
-    runs-on: [self-hosted, ubuntu-20.04, main]
-    outputs:
-      gcp-variables-set: ${{ steps.check_gcp_variables.outputs.gcp-variables-set }}
-    steps:
-      - name: Check out code
-        uses: actions/checkout@v4
-      - name: "Check are GCP variables set"
-        run: "./scripts/ci/ci_check_are_gcp_variables_set.sh"
-        id: check_gcp_variables
-        env:
-          GCP_PROJECT_ID: ${{ secrets.GCP_PROJECT_ID }}
-          GCP_SA_EMAIL: ${{ secrets.GCP_SA_EMAIL }}
-          GCP_SA_KEY: ${{ secrets.GCP_SA_KEY }}
-          GCP_TESTING_BUCKET: ${{ secrets.GCP_TESTING_BUCKET }}
-          GCP_REGION: "not-needed-here"
-          GCP_PYTHON_WHEELS_BUCKET: "not-needed-here"
-
   java_unit_tests:
     name: 'Java Unit Tests'
     runs-on: ${{ matrix.os }}
@@ -152,46 +127,3 @@ jobs:
         with:
           name: java_wordcount_direct_runner-${{matrix.os}}
           path: examples/java/build/reports/tests/integrationTest
-
-  java_wordcount_dataflow:
-    name: 'Java Wordcount Dataflow'
-    needs:
-      - check_gcp_variables
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [[self-hosted, ubuntu-20.04, main], windows-latest]
-    # TODO(https://github.com/apache/beam/issues/31848) run on Dataflow after fixes credential on macOS/win GHA runner
-    if: |
-      needs.check_gcp_variables.outputs.gcp-variables-set == 'true' &&
-        (github.event_name == 'workflow_dispatch' && github.event.inputs.runDataflow == 'true')
-    steps:
-      - name: Check out code
-        uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-          submodules: recursive
-      - name: Setup environment
-        uses: ./.github/actions/setup-environment-action
-        with:
-          java-version: 11
-          go-version: default
-      - name: Authenticate on GCP
-        uses: google-github-actions/auth@v1
-        with:
-          credentials_json: ${{ secrets.GCP_SA_KEY }}
-          project_id: ${{ secrets.GCP_PROJECT_ID }}
-      - name: Run WordCount
-        uses: ./.github/actions/gradle-command-self-hosted-action
-        with:
-          gradle-command: integrationTest
-          arguments: -p examples/ --tests org.apache.beam.examples.WordCountIT
-            -DintegrationTestPipelineOptions=[\"--runner=DataflowRunner\",\"--project=${{ secrets.GCP_PROJECT_ID }}\",\"--tempRoot=gs://${{ secrets.GCP_TESTING_BUCKET }}/tmp/\"]
-            -DintegrationTestRunner=dataflow
-      - name: Upload test logs
-        uses: actions/upload-artifact@v4
-        if: always()
-        with:
-          name: java_wordcount_dataflow-${{matrix.os}}
-          path: examples/java/build/reports/tests/integrationTest
\ No newline at end of file

From 88398f33ce663748d87a7df61fe5d948e6e1b4f9 Mon Sep 17 00:00:00 2001
From: Jeffrey Kinard <jeff@thekinards.com>
Date: Fri, 13 Dec 2024 14:41:02 -0500
Subject: [PATCH 114/135] fix BoundedTrieData get_result return type hint

Signed-off-by: Jeffrey Kinard <jeff@thekinards.com>
---
 sdks/python/apache_beam/metrics/cells.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sdks/python/apache_beam/metrics/cells.py b/sdks/python/apache_beam/metrics/cells.py
index 9a62cae14691..b765c830f69c 100644
--- a/sdks/python/apache_beam/metrics/cells.py
+++ b/sdks/python/apache_beam/metrics/cells.py
@@ -826,7 +826,7 @@ def __repr__(self) -> str:
   def get_cumulative(self) -> "BoundedTrieData":
     return copy.deepcopy(self)
 
-  def get_result(self) -> set[tuple]:
+  def get_result(self) -> Set[tuple]:
     if self._root is None:
       if self._singleton is None:
         return set()

From 9d1eea496a49c391d55cb9855282e4949da7f437 Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Wed, 27 Nov 2024 10:00:57 -0800
Subject: [PATCH 115/135] End to end BoundedTrie metrics through worker and
 runner APIs.

---
 sdks/python/apache_beam/metrics/cells.py      | 29 +++++++++++++++++--
 sdks/python/apache_beam/metrics/execution.py  | 17 ++++++++++-
 sdks/python/apache_beam/metrics/metric.py     | 24 +++++++++++++++
 sdks/python/apache_beam/metrics/metricbase.py |  9 ++++++
 .../apache_beam/metrics/monitoring_infos.py   | 18 +++++++++++-
 .../runners/direct/direct_metrics.py          | 16 +++++++++-
 .../runners/direct/direct_runner_test.py      | 10 +++++++
 .../portability/fn_api_runner/fn_runner.py    | 13 +++++++--
 .../fn_api_runner/fn_runner_test.py           |  8 +++++
 .../runners/portability/portable_metrics.py   |  5 +++-
 .../runners/portability/portable_runner.py    |  5 ++--
 11 files changed, 142 insertions(+), 12 deletions(-)

diff --git a/sdks/python/apache_beam/metrics/cells.py b/sdks/python/apache_beam/metrics/cells.py
index 9a62cae14691..a6549272a67e 100644
--- a/sdks/python/apache_beam/metrics/cells.py
+++ b/sdks/python/apache_beam/metrics/cells.py
@@ -691,12 +691,18 @@ def from_proto(proto: metrics_pb2.BoundedTrieNode) -> '_BoundedTrieNode':
           for name,
           child in proto.children.items()
       }
-      node._size = min(1, sum(child._size for child in node._children.values()))
+      node._size = max(1, sum(child._size for child in node._children.values()))
     return node
 
   def size(self):
     return self._size
 
+  def contains(self, segments):
+    if self._truncated or not segments:
+      return True
+    head, *tail = segments
+    return head in self._children and self._children[head].contains(tail)
+
   def add(self, segments) -> int:
     if self._truncated or not segments:
       return 0
@@ -784,15 +790,31 @@ class BoundedTrieData(object):
   _DEFAULT_BOUND = 100
 
   def __init__(self, *, root=None, singleton=None, bound=_DEFAULT_BOUND):
-    assert singleton is None or root is None
     self._singleton = singleton
     self._root = root
     self._bound = bound
+    assert singleton is None or root is None
+
+  def size(self):
+    if self._singleton is not None:
+      return 1
+    elif self._root is not None:
+      return self._root.size()
+    else:
+      return 0
+
+  def contains(self, value):
+    if self._singleton is not None:
+      return tuple(value) == self._singleton
+    elif self._root is not None:
+      return self._root.contains(value)
+    else:
+      return False
 
   def to_proto(self) -> metrics_pb2.BoundedTrie:
     return metrics_pb2.BoundedTrie(
         bound=self._bound,
-        singleton=self._singlton if self._singleton else None,
+        singleton=self._singleton if self._singleton else None,
         root=self._root.to_proto() if self._root else None)
 
   @staticmethod
@@ -844,6 +866,7 @@ def add(self, segments):
     else:
       if self._root is None:
         self._root = self.as_trie()
+        self._singleton = None
       self._root.add(segments)
       if self._root._size > self._bound:
         self._root.trim()
diff --git a/sdks/python/apache_beam/metrics/execution.py b/sdks/python/apache_beam/metrics/execution.py
index fa70d3a4d9c0..c28c8340a505 100644
--- a/sdks/python/apache_beam/metrics/execution.py
+++ b/sdks/python/apache_beam/metrics/execution.py
@@ -43,6 +43,7 @@
 from typing import cast
 
 from apache_beam.metrics import monitoring_infos
+from apache_beam.metrics.cells import BoundedTrieCell
 from apache_beam.metrics.cells import CounterCell
 from apache_beam.metrics.cells import DistributionCell
 from apache_beam.metrics.cells import GaugeCell
@@ -52,6 +53,7 @@
 from apache_beam.runners.worker.statesampler import get_current_tracker
 
 if TYPE_CHECKING:
+  from apache_beam.metrics.cells import BoundedTrieData
   from apache_beam.metrics.cells import GaugeData
   from apache_beam.metrics.cells import DistributionData
   from apache_beam.metrics.cells import MetricCell
@@ -265,6 +267,9 @@ def get_string_set(self, metric_name):
         StringSetCell,
         self.get_metric_cell(_TypedMetricName(StringSetCell, metric_name)))
 
+  def get_bounded_trie(self, metric_name):
+    return self.get_metric_cell(_TypedMetricName(BoundedTrieCell, metric_name))
+
   def get_metric_cell(self, typed_metric_name):
     # type: (_TypedMetricName) -> MetricCell
     cell = self.metrics.get(typed_metric_name, None)
@@ -304,7 +309,14 @@ def get_cumulative(self):
         v in self.metrics.items() if k.cell_type == StringSetCell
     }
 
-    return MetricUpdates(counters, distributions, gauges, string_sets)
+    bounded_tries = {
+        MetricKey(self.step_name, k.metric_name): v.get_cumulative()
+        for k,
+        v in self.metrics.items() if k.cell_type == BoundedTrieCell
+    }
+
+    return MetricUpdates(
+        counters, distributions, gauges, string_sets, bounded_tries)
 
   def to_runner_api(self):
     return [
@@ -358,6 +370,7 @@ def __init__(
       distributions=None,  # type: Optional[Dict[MetricKey, DistributionData]]
       gauges=None,  # type: Optional[Dict[MetricKey, GaugeData]]
       string_sets=None,  # type: Optional[Dict[MetricKey, StringSetData]]
+      bounded_tries=None,  # type: Optional[Dict[MetricKey, BoundedTrieData]]
   ):
     # type: (...) -> None
 
@@ -368,8 +381,10 @@ def __init__(
       distributions: Dictionary of MetricKey:MetricUpdate objects.
       gauges: Dictionary of MetricKey:MetricUpdate objects.
       string_sets: Dictionary of MetricKey:MetricUpdate objects.
+      bounded_tries: Dictionary of MetricKey:MetricUpdate objects.
     """
     self.counters = counters or {}
     self.distributions = distributions or {}
     self.gauges = gauges or {}
     self.string_sets = string_sets or {}
+    self.bounded_tries = bounded_tries or {}
diff --git a/sdks/python/apache_beam/metrics/metric.py b/sdks/python/apache_beam/metrics/metric.py
index 3e665dd805ea..33af25e20ca4 100644
--- a/sdks/python/apache_beam/metrics/metric.py
+++ b/sdks/python/apache_beam/metrics/metric.py
@@ -42,6 +42,7 @@
 from apache_beam.metrics import cells
 from apache_beam.metrics.execution import MetricResult
 from apache_beam.metrics.execution import MetricUpdater
+from apache_beam.metrics.metricbase import BoundedTrie
 from apache_beam.metrics.metricbase import Counter
 from apache_beam.metrics.metricbase import Distribution
 from apache_beam.metrics.metricbase import Gauge
@@ -135,6 +136,22 @@ def string_set(
     namespace = Metrics.get_namespace(namespace)
     return Metrics.DelegatingStringSet(MetricName(namespace, name))
 
+  @staticmethod
+  def bounded_trie(
+      namespace: Union[Type, str],
+      name: str) -> 'Metrics.DelegatingBoundedTrie':
+    """Obtains or creates a Bounded Trie metric.
+
+    Args:
+      namespace: A class or string that gives the namespace to a metric
+      name: A string that gives a unique name to a metric
+
+    Returns:
+      A BoundedTrie object.
+    """
+    namespace = Metrics.get_namespace(namespace)
+    return Metrics.DelegatingBoundedTrie(MetricName(namespace, name))
+
   class DelegatingCounter(Counter):
     """Metrics Counter that Delegates functionality to MetricsEnvironment."""
     def __init__(
@@ -164,12 +181,19 @@ def __init__(self, metric_name: MetricName) -> None:
       super().__init__(metric_name)
       self.add = MetricUpdater(cells.StringSetCell, metric_name)  # type: ignore[method-assign]
 
+  class DelegatingBoundedTrie(BoundedTrie):
+    """Metrics StringSet that Delegates functionality to MetricsEnvironment."""
+    def __init__(self, metric_name: MetricName) -> None:
+      super().__init__(metric_name)
+      self.add = MetricUpdater(cells.BoundedTrieCell, metric_name)  # type: ignore[method-assign]
+
 
 class MetricResults(object):
   COUNTERS = "counters"
   DISTRIBUTIONS = "distributions"
   GAUGES = "gauges"
   STRINGSETS = "string_sets"
+  BOUNDED_TRIES = "bounded_tries"
 
   @staticmethod
   def _matches_name(filter: 'MetricsFilter', metric_key: 'MetricKey') -> bool:
diff --git a/sdks/python/apache_beam/metrics/metricbase.py b/sdks/python/apache_beam/metrics/metricbase.py
index 7819dbb093a5..9b35bb24f895 100644
--- a/sdks/python/apache_beam/metrics/metricbase.py
+++ b/sdks/python/apache_beam/metrics/metricbase.py
@@ -43,6 +43,7 @@
     'Distribution',
     'Gauge',
     'StringSet',
+    'BoundedTrie',
     'Histogram',
     'MetricName'
 ]
@@ -152,6 +153,14 @@ def add(self, value):
     raise NotImplementedError
 
 
+class BoundedTrie(Metric):
+  """BoundedTrie Metric interface.
+
+  Reports set of unique string values during pipeline execution.."""
+  def add(self, value):
+    raise NotImplementedError
+
+
 class Histogram(Metric):
   """Histogram Metric interface.
 
diff --git a/sdks/python/apache_beam/metrics/monitoring_infos.py b/sdks/python/apache_beam/metrics/monitoring_infos.py
index 397fcc578d53..e343793b3ad4 100644
--- a/sdks/python/apache_beam/metrics/monitoring_infos.py
+++ b/sdks/python/apache_beam/metrics/monitoring_infos.py
@@ -27,6 +27,7 @@
 
 from apache_beam.coders import coder_impl
 from apache_beam.coders import coders
+from apache_beam.metrics.cells import BoundedTrieData
 from apache_beam.metrics.cells import DistributionData
 from apache_beam.metrics.cells import DistributionResult
 from apache_beam.metrics.cells import GaugeData
@@ -168,6 +169,14 @@ def extract_string_set_value(monitoring_info_proto):
   return set(coder.decode(monitoring_info_proto.payload))
 
 
+def extract_bounded_trie_value(monitoring_info_proto):
+  if not is_bounded_trie(monitoring_info_proto):
+    raise ValueError('Unsupported type %s' % monitoring_info_proto.type)
+
+  return BoundedTrieData.from_proto(
+      metrics_pb2.BoundedTrie.FromString(monitoring_info_proto.payload))
+
+
 def create_labels(ptransform=None, namespace=None, name=None, pcollection=None):
   """Create the label dictionary based on the provided values.
 
@@ -382,6 +391,11 @@ def is_string_set(monitoring_info_proto):
   return monitoring_info_proto.type in STRING_SET_TYPES
 
 
+def is_bounded_trie(monitoring_info_proto):
+  """Returns true if the monitoring info is a StringSet metric."""
+  return monitoring_info_proto.type in BOUNDED_TRIE_TYPES
+
+
 def is_user_monitoring_info(monitoring_info_proto):
   """Returns true if the monitoring info is a user metric."""
   return monitoring_info_proto.urn in USER_METRIC_URNS
@@ -389,7 +403,7 @@ def is_user_monitoring_info(monitoring_info_proto):
 
 def extract_metric_result_map_value(
     monitoring_info_proto
-) -> Union[None, int, DistributionResult, GaugeResult, set]:
+) -> Union[None, int, DistributionResult, GaugeResult, set, BoundedTrieData]:
   """Returns the relevant GaugeResult, DistributionResult or int value for
   counter metric, set for StringSet metric.
 
@@ -407,6 +421,8 @@ def extract_metric_result_map_value(
     return GaugeResult(GaugeData(value, timestamp))
   if is_string_set(monitoring_info_proto):
     return extract_string_set_value(monitoring_info_proto)
+  if is_bounded_trie(monitoring_info_proto):
+    return extract_bounded_trie_value(monitoring_info_proto)
   return None
 
 
diff --git a/sdks/python/apache_beam/runners/direct/direct_metrics.py b/sdks/python/apache_beam/runners/direct/direct_metrics.py
index d20849d769af..5beb19d4610a 100644
--- a/sdks/python/apache_beam/runners/direct/direct_metrics.py
+++ b/sdks/python/apache_beam/runners/direct/direct_metrics.py
@@ -27,6 +27,7 @@
 from typing import Any
 from typing import SupportsInt
 
+from apache_beam.metrics.cells import BoundedTrieData
 from apache_beam.metrics.cells import DistributionData
 from apache_beam.metrics.cells import GaugeData
 from apache_beam.metrics.cells import StringSetData
@@ -102,6 +103,8 @@ def __init__(self):
         lambda: DirectMetric(GenericAggregator(GaugeData)))
     self._string_sets = defaultdict(
         lambda: DirectMetric(GenericAggregator(StringSetData)))
+    self._bounded_tries = defaultdict(
+        lambda: DirectMetric(GenericAggregator(BoundedTrieData)))
 
   def _apply_operation(self, bundle, updates, op):
     for k, v in updates.counters.items():
@@ -116,6 +119,9 @@ def _apply_operation(self, bundle, updates, op):
     for k, v in updates.string_sets.items():
       op(self._string_sets[k], bundle, v)
 
+    for k, v in updates.bounded_tries.items():
+      op(self._bounded_tries[k], bundle, v)
+
   def commit_logical(self, bundle, updates):
     op = lambda obj, bundle, update: obj.commit_logical(bundle, update)
     self._apply_operation(bundle, updates, op)
@@ -157,12 +163,20 @@ def query(self, filter=None):
             v.extract_latest_attempted()) for k,
         v in self._string_sets.items() if self.matches(filter, k)
     ]
+    bounded_tries = [
+        MetricResult(
+            MetricKey(k.step, k.metric),
+            v.extract_committed(),
+            v.extract_latest_attempted()) for k,
+        v in self._bounded_tries.items() if self.matches(filter, k)
+    ]
 
     return {
         self.COUNTERS: counters,
         self.DISTRIBUTIONS: distributions,
         self.GAUGES: gauges,
-        self.STRINGSETS: string_sets
+        self.STRINGSETS: string_sets,
+        self.BOUNDED_TRIES: bounded_tries,
     }
 
 
diff --git a/sdks/python/apache_beam/runners/direct/direct_runner_test.py b/sdks/python/apache_beam/runners/direct/direct_runner_test.py
index d8f1ea097b88..1af5f1bc7bea 100644
--- a/sdks/python/apache_beam/runners/direct/direct_runner_test.py
+++ b/sdks/python/apache_beam/runners/direct/direct_runner_test.py
@@ -78,6 +78,8 @@ def process(self, element):
         distro.update(element)
         str_set = Metrics.string_set(self.__class__, 'element_str_set')
         str_set.add(str(element % 4))
+        Metrics.bounded_trie(self.__class__, 'element_bounded_trie').add(
+            ("a", "b", str(element % 4)))
         return [element]
 
     p = Pipeline(DirectRunner())
@@ -124,6 +126,14 @@ def process(self, element):
     hc.assert_that(len(str_set_result.committed), hc.equal_to(4))
     hc.assert_that(len(str_set_result.attempted), hc.equal_to(4))
 
+    bounded_trie_results = metrics['bounded_tries'][0]
+    hc.assert_that(
+        bounded_trie_results.key,
+        hc.equal_to(
+            MetricKey('Do', MetricName(namespace, 'element_bounded_trie'))))
+    hc.assert_that(bounded_trie_results.committed.size(), hc.equal_to(4))
+    hc.assert_that(bounded_trie_results.attempted.size(), hc.equal_to(4))
+
   def test_create_runner(self):
     self.assertTrue(isinstance(create_runner('DirectRunner'), DirectRunner))
     self.assertTrue(
diff --git a/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner.py b/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner.py
index 1ed21942d28f..95bcb7567918 100644
--- a/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner.py
+++ b/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner.py
@@ -1536,16 +1536,18 @@ def __init__(self, step_monitoring_infos, user_metrics_only=True):
     self._distributions = {}
     self._gauges = {}
     self._string_sets = {}
+    self._bounded_tries = {}
     self._user_metrics_only = user_metrics_only
     self._monitoring_infos = step_monitoring_infos
 
     for smi in step_monitoring_infos.values():
-      counters, distributions, gauges, string_sets = \
-          portable_metrics.from_monitoring_infos(smi, user_metrics_only)
+      counters, distributions, gauges, string_sets, bounded_tries = (
+          portable_metrics.from_monitoring_infos(smi, user_metrics_only))
       self._counters.update(counters)
       self._distributions.update(distributions)
       self._gauges.update(gauges)
       self._string_sets.update(string_sets)
+      self._bounded_tries.update(bounded_tries)
 
   def query(self, filter=None):
     counters = [
@@ -1564,12 +1566,17 @@ def query(self, filter=None):
         MetricResult(k, v, v) for k,
         v in self._string_sets.items() if self.matches(filter, k)
     ]
+    bounded_tries = [
+        MetricResult(k, v, v) for k,
+        v in self._bounded_tries.items() if self.matches(filter, k)
+    ]
 
     return {
         self.COUNTERS: counters,
         self.DISTRIBUTIONS: distributions,
         self.GAUGES: gauges,
-        self.STRINGSETS: string_sets
+        self.STRINGSETS: string_sets,
+        self.BOUNDED_TRIES: bounded_tries,
     }
 
   def monitoring_infos(self) -> List[metrics_pb2.MonitoringInfo]:
diff --git a/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py b/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
index 1309e7c74abc..217092fbf806 100644
--- a/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
+++ b/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
@@ -1216,6 +1216,7 @@ def test_metrics(self, check_gauge=True):
     distribution = beam.metrics.Metrics.distribution('ns', 'distribution')
     gauge = beam.metrics.Metrics.gauge('ns', 'gauge')
     string_set = beam.metrics.Metrics.string_set('ns', 'string_set')
+    bounded_trie = beam.metrics.Metrics.bounded_trie('ns', 'bounded_trie')
 
     elements = ['a', 'zzz']
     pcoll = p | beam.Create(elements)
@@ -1225,6 +1226,7 @@ def test_metrics(self, check_gauge=True):
     pcoll | 'dist' >> beam.FlatMap(lambda x: distribution.update(len(x)))
     pcoll | 'gauge' >> beam.FlatMap(lambda x: gauge.set(3))
     pcoll | 'string_set' >> beam.FlatMap(lambda x: string_set.add(x))
+    pcoll | 'bounded_trie' >> beam.FlatMap(lambda x: bounded_trie.add(tuple(x)))
 
     res = p.run()
     res.wait_until_finish()
@@ -1248,6 +1250,12 @@ def test_metrics(self, check_gauge=True):
                                   .with_name('string_set'))['string_sets']
     self.assertEqual(str_set.committed, set(elements))
 
+    bounded_trie, = res.metrics().query(beam.metrics.MetricsFilter()
+                                  .with_name('bounded_trie'))['bounded_tries']
+    self.assertEqual(bounded_trie.committed.size(), 2)
+    for element in elements:
+      self.assertTrue(bounded_trie.committed.contains(tuple(element)), element)
+
   def test_callbacks_with_exception(self):
     elements_list = ['1', '2']
 
diff --git a/sdks/python/apache_beam/runners/portability/portable_metrics.py b/sdks/python/apache_beam/runners/portability/portable_metrics.py
index 5bc3e0539181..e92d33910415 100644
--- a/sdks/python/apache_beam/runners/portability/portable_metrics.py
+++ b/sdks/python/apache_beam/runners/portability/portable_metrics.py
@@ -42,6 +42,7 @@ def from_monitoring_infos(monitoring_info_list, user_metrics_only=False):
   distributions = {}
   gauges = {}
   string_sets = {}
+  bounded_tries = {}
 
   for mi in monitoring_info_list:
     if (user_metrics_only and not monitoring_infos.is_user_monitoring_info(mi)):
@@ -62,8 +63,10 @@ def from_monitoring_infos(monitoring_info_list, user_metrics_only=False):
       gauges[key] = metric_result
     elif monitoring_infos.is_string_set(mi):
       string_sets[key] = metric_result
+    elif monitoring_infos.is_bounded_trie(mi):
+      bounded_tries[key] = metric_result
 
-  return counters, distributions, gauges, string_sets
+  return counters, distributions, gauges, string_sets, bounded_tries
 
 
 def _create_metric_key(monitoring_info):
diff --git a/sdks/python/apache_beam/runners/portability/portable_runner.py b/sdks/python/apache_beam/runners/portability/portable_runner.py
index ba48bbec6d3a..fe9dcfa62b29 100644
--- a/sdks/python/apache_beam/runners/portability/portable_runner.py
+++ b/sdks/python/apache_beam/runners/portability/portable_runner.py
@@ -437,7 +437,7 @@ def _combine(committed, attempted, filter):
     ]
 
   def query(self, filter=None):
-    counters, distributions, gauges, stringsets = [
+    counters, distributions, gauges, stringsets, bounded_tries = [
         self._combine(x, y, filter)
         for x, y in zip(self.committed, self.attempted)
     ]
@@ -446,7 +446,8 @@ def query(self, filter=None):
         self.COUNTERS: counters,
         self.DISTRIBUTIONS: distributions,
         self.GAUGES: gauges,
-        self.STRINGSETS: stringsets
+        self.STRINGSETS: stringsets,
+        self.BOUNDED_TRIES: bounded_tries,
     }
 
 

From 0768e108649b64408c7bd2d41eee8c61d43b35fb Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Fri, 13 Dec 2024 16:21:03 -0800
Subject: [PATCH 116/135] Add missing pxd definition.

This is needed to override _update_locked.
---
 sdks/python/apache_beam/metrics/cells.pxd | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/sdks/python/apache_beam/metrics/cells.pxd b/sdks/python/apache_beam/metrics/cells.pxd
index 7590bd8b5966..ebadeec97984 100644
--- a/sdks/python/apache_beam/metrics/cells.pxd
+++ b/sdks/python/apache_beam/metrics/cells.pxd
@@ -55,6 +55,10 @@ cdef class StringSetCell(AbstractMetricCell):
   pass
 
 
+cdef class BoundedTrieCell(AbstractMetricCell):
+  pass
+
+
 cdef class DistributionData(object):
   cdef readonly libc.stdint.int64_t sum
   cdef readonly libc.stdint.int64_t count

From 2aab9cd9d1bcbcce49113423adbd526bf2392ab4 Mon Sep 17 00:00:00 2001
From: Shunping Huang <shunping@google.com>
Date: Fri, 13 Dec 2024 20:31:09 -0500
Subject: [PATCH 117/135] Fix custom coders not being used in Reshuffle (non
 global window) (#33363)

* Fix typehint in ReshufflePerKey on global window setting.

* Only update the type hint on global window setting. Need more work in non-global windows.

* Apply yapf

* Fix some failed tests.

* Revert change to setup.py

* Fix custom coders not being used in reshuffle in non-global windows

* Revert changes in setup.py. Reformat.

* Make WindowedValue a generic class. Support its conversion to the correct type constraint in Beam.

* Cython does not support Python generic class. Add a subclass as a workroundand keep it un-cythonized.

* Add comments

* Fix type error.

* Remove the base class of WindowedValue in TypedWindowedValue.

* Move TypedWindowedValue out from windowed_value.py

* Revise the comments

* Fix the module location when matching.

* Fix test failure where __name__ of a type alias not found in python 3.9

* Add a note about the window coder.

---------

Co-authored-by: Robert Bradshaw <robertwb@gmail.com>
---
 sdks/python/apache_beam/coders/coders.py      |  8 +++
 sdks/python/apache_beam/coders/typecoders.py  |  2 +
 sdks/python/apache_beam/transforms/util.py    |  6 +--
 .../apache_beam/transforms/util_test.py       | 51 ++++++++++++-------
 .../typehints/native_type_compatibility.py    | 26 ++++++++++
 .../python/apache_beam/typehints/typehints.py |  9 ++++
 6 files changed, 81 insertions(+), 21 deletions(-)

diff --git a/sdks/python/apache_beam/coders/coders.py b/sdks/python/apache_beam/coders/coders.py
index a0c55da81800..724f268a8312 100644
--- a/sdks/python/apache_beam/coders/coders.py
+++ b/sdks/python/apache_beam/coders/coders.py
@@ -1402,6 +1402,14 @@ def __hash__(self):
     return hash(
         (self.wrapped_value_coder, self.timestamp_coder, self.window_coder))
 
+  @classmethod
+  def from_type_hint(cls, typehint, registry):
+    # type: (Any, CoderRegistry) -> WindowedValueCoder
+    # Ideally this'd take two parameters so that one could hint at
+    # the window type as well instead of falling back to the
+    # pickle coders.
+    return cls(registry.get_coder(typehint.inner_type))
+
 
 Coder.register_structured_urn(
     common_urns.coders.WINDOWED_VALUE.urn, WindowedValueCoder)
diff --git a/sdks/python/apache_beam/coders/typecoders.py b/sdks/python/apache_beam/coders/typecoders.py
index 1667cb7a916a..892f508d0136 100644
--- a/sdks/python/apache_beam/coders/typecoders.py
+++ b/sdks/python/apache_beam/coders/typecoders.py
@@ -94,6 +94,8 @@ def register_standard_coders(self, fallback_coder):
     self._register_coder_internal(str, coders.StrUtf8Coder)
     self._register_coder_internal(typehints.TupleConstraint, coders.TupleCoder)
     self._register_coder_internal(typehints.DictConstraint, coders.MapCoder)
+    self._register_coder_internal(
+        typehints.WindowedTypeConstraint, coders.WindowedValueCoder)
     # Default fallback coders applied in that order until the first matching
     # coder found.
     default_fallback_coders = [
diff --git a/sdks/python/apache_beam/transforms/util.py b/sdks/python/apache_beam/transforms/util.py
index 43d4a6c20e94..c9fd2c76b0db 100644
--- a/sdks/python/apache_beam/transforms/util.py
+++ b/sdks/python/apache_beam/transforms/util.py
@@ -74,6 +74,7 @@
 from apache_beam.transforms.window import TimestampedValue
 from apache_beam.typehints import trivial_inference
 from apache_beam.typehints.decorators import get_signature
+from apache_beam.typehints.native_type_compatibility import TypedWindowedValue
 from apache_beam.typehints.sharded_key_type import ShardedKeyType
 from apache_beam.utils import shared
 from apache_beam.utils import windowed_value
@@ -972,9 +973,8 @@ def restore_timestamps(element):
         key, windowed_values = element
         return [wv.with_value((key, wv.value)) for wv in windowed_values]
 
-      # TODO(https://github.com/apache/beam/issues/33356): Support reshuffling
-      # unpicklable objects with a non-global window setting.
-      ungrouped = pcoll | Map(reify_timestamps).with_output_types(Any)
+      ungrouped = pcoll | Map(reify_timestamps).with_input_types(
+          Tuple[K, V]).with_output_types(Tuple[K, TypedWindowedValue[V]])
 
     # TODO(https://github.com/apache/beam/issues/19785) Using global window as
     # one of the standard window. This is to mitigate the Dataflow Java Runner
diff --git a/sdks/python/apache_beam/transforms/util_test.py b/sdks/python/apache_beam/transforms/util_test.py
index 7f166f78ef0a..db73310dfe25 100644
--- a/sdks/python/apache_beam/transforms/util_test.py
+++ b/sdks/python/apache_beam/transforms/util_test.py
@@ -1010,32 +1010,33 @@ def format_with_timestamp(element, timestamp=beam.DoFn.TimestampParam):
           equal_to(expected_data),
           label="formatted_after_reshuffle")
 
-  def test_reshuffle_unpicklable_in_global_window(self):
-    global _Unpicklable
+  global _Unpicklable
+  global _UnpicklableCoder
 
-    class _Unpicklable(object):
-      def __init__(self, value):
-        self.value = value
+  class _Unpicklable(object):
+    def __init__(self, value):
+      self.value = value
 
-      def __getstate__(self):
-        raise NotImplementedError()
+    def __getstate__(self):
+      raise NotImplementedError()
 
-      def __setstate__(self, state):
-        raise NotImplementedError()
+    def __setstate__(self, state):
+      raise NotImplementedError()
 
-    class _UnpicklableCoder(beam.coders.Coder):
-      def encode(self, value):
-        return str(value.value).encode()
+  class _UnpicklableCoder(beam.coders.Coder):
+    def encode(self, value):
+      return str(value.value).encode()
 
-      def decode(self, encoded):
-        return _Unpicklable(int(encoded.decode()))
+    def decode(self, encoded):
+      return _Unpicklable(int(encoded.decode()))
 
-      def to_type_hint(self):
-        return _Unpicklable
+    def to_type_hint(self):
+      return _Unpicklable
 
-      def is_deterministic(self):
-        return True
+    def is_deterministic(self):
+      return True
 
+  def test_reshuffle_unpicklable_in_global_window(self):
     beam.coders.registry.register_coder(_Unpicklable, _UnpicklableCoder)
 
     with TestPipeline() as pipeline:
@@ -1049,6 +1050,20 @@ def is_deterministic(self):
           | beam.Map(lambda u: u.value * 10))
       assert_that(result, equal_to(expected_data))
 
+  def test_reshuffle_unpicklable_in_non_global_window(self):
+    beam.coders.registry.register_coder(_Unpicklable, _UnpicklableCoder)
+
+    with TestPipeline() as pipeline:
+      data = [_Unpicklable(i) for i in range(5)]
+      expected_data = [0, 0, 0, 10, 10, 10, 20, 20, 20, 30, 30, 30, 40, 40, 40]
+      result = (
+          pipeline
+          | beam.Create(data)
+          | beam.WindowInto(window.SlidingWindows(size=3, period=1))
+          | beam.Reshuffle()
+          | beam.Map(lambda u: u.value * 10))
+      assert_that(result, equal_to(expected_data))
+
 
 class WithKeysTest(unittest.TestCase):
   def setUp(self):
diff --git a/sdks/python/apache_beam/typehints/native_type_compatibility.py b/sdks/python/apache_beam/typehints/native_type_compatibility.py
index 6f704b37a969..381d4f7aae2b 100644
--- a/sdks/python/apache_beam/typehints/native_type_compatibility.py
+++ b/sdks/python/apache_beam/typehints/native_type_compatibility.py
@@ -24,9 +24,13 @@
 import sys
 import types
 import typing
+from typing import Generic
+from typing import TypeVar
 
 from apache_beam.typehints import typehints
 
+T = TypeVar('T')
+
 _LOGGER = logging.getLogger(__name__)
 
 # Describes an entry in the type map in convert_to_beam_type.
@@ -216,6 +220,18 @@ def convert_collections_to_typing(typ):
   return typ
 
 
+# During type inference of WindowedValue, we need to pass in the inner value
+# type. This cannot be achieved immediately with WindowedValue class because it
+# is not parameterized. Changing it to a generic class (e.g. WindowedValue[T])
+# could work in theory. However, the class is cythonized and it seems that
+# cython does not handle generic classes well.
+# The workaround here is to create a separate class solely for the type
+# inference purpose. This class should never be used for creating instances.
+class TypedWindowedValue(Generic[T]):
+  def __init__(self, *args, **kwargs):
+    raise NotImplementedError("This class is solely for type inference")
+
+
 def convert_to_beam_type(typ):
   """Convert a given typing type to a Beam type.
 
@@ -267,6 +283,12 @@ def convert_to_beam_type(typ):
     # TODO(https://github.com/apache/beam/issues/20076): Currently unhandled.
     _LOGGER.info('Converting NewType type hint to Any: "%s"', typ)
     return typehints.Any
+  elif typ_module == 'apache_beam.typehints.native_type_compatibility' and \
+      getattr(typ, "__name__", typ.__origin__.__name__) == 'TypedWindowedValue':
+    # Need to pass through WindowedValue class so that it can be converted
+    # to the correct type constraint in Beam
+    # This is needed to fix https://github.com/apache/beam/issues/33356
+    pass
   elif (typ_module != 'typing') and (typ_module != 'collections.abc'):
     # Only translate types from the typing and collections.abc modules.
     return typ
@@ -324,6 +346,10 @@ def convert_to_beam_type(typ):
           match=_match_is_exactly_collection,
           arity=1,
           beam_type=typehints.Collection),
+      _TypeMapEntry(
+          match=_match_issubclass(TypedWindowedValue),
+          arity=1,
+          beam_type=typehints.WindowedValue),
   ]
 
   # Find the first matching entry.
diff --git a/sdks/python/apache_beam/typehints/typehints.py b/sdks/python/apache_beam/typehints/typehints.py
index 0e18e887c2a0..a65a0f753826 100644
--- a/sdks/python/apache_beam/typehints/typehints.py
+++ b/sdks/python/apache_beam/typehints/typehints.py
@@ -1213,6 +1213,15 @@ def type_check(self, instance):
               repr(self.inner_type),
               instance.value.__class__.__name__))
 
+  def bind_type_variables(self, bindings):
+    bound_inner_type = bind_type_variables(self.inner_type, bindings)
+    if bound_inner_type == self.inner_type:
+      return self
+    return WindowedValue[bound_inner_type]
+
+  def __repr__(self):
+    return 'WindowedValue[%s]' % repr(self.inner_type)
+
 
 class GeneratorHint(IteratorHint):
   """A Generator type hint.

From 5918e6d7993be5378af91c5d865f84fee9c7afef Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Fri, 13 Dec 2024 22:49:34 -0800
Subject: [PATCH 118/135] Skip unsupported runners.

---
 .../runners/portability/flink_runner_test.py        |  2 +-
 .../portability/fn_api_runner/fn_runner_test.py     | 13 +++++++------
 .../runners/portability/prism_runner_test.py        |  3 +++
 3 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/sdks/python/apache_beam/runners/portability/flink_runner_test.py b/sdks/python/apache_beam/runners/portability/flink_runner_test.py
index 4dc2446fdd9d..30f1a4c06025 100644
--- a/sdks/python/apache_beam/runners/portability/flink_runner_test.py
+++ b/sdks/python/apache_beam/runners/portability/flink_runner_test.py
@@ -303,7 +303,7 @@ def test_flattened_side_input(self):
     super().test_flattened_side_input(with_transcoding=False)
 
   def test_metrics(self):
-    super().test_metrics(check_gauge=False)
+    super().test_metrics(check_gauge=False, check_bounded_trie=False)
 
   def test_sdf_with_watermark_tracking(self):
     raise unittest.SkipTest("BEAM-2939")
diff --git a/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py b/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
index 217092fbf806..65d598171c08 100644
--- a/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
+++ b/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
@@ -1209,7 +1209,7 @@ def expand(self, pcolls):
       pcoll_b = p | 'b' >> beam.Create(['b'])
       assert_that((pcoll_a, pcoll_b) | First(), equal_to(['a']))
 
-  def test_metrics(self, check_gauge=True):
+  def test_metrics(self, check_gauge=True, check_bounded_trie=False):
     p = self.create_pipeline()
 
     counter = beam.metrics.Metrics.counter('ns', 'counter')
@@ -1250,11 +1250,12 @@ def test_metrics(self, check_gauge=True):
                                   .with_name('string_set'))['string_sets']
     self.assertEqual(str_set.committed, set(elements))
 
-    bounded_trie, = res.metrics().query(beam.metrics.MetricsFilter()
-                                  .with_name('bounded_trie'))['bounded_tries']
-    self.assertEqual(bounded_trie.committed.size(), 2)
-    for element in elements:
-      self.assertTrue(bounded_trie.committed.contains(tuple(element)), element)
+    if check_bounded_trie:
+      bounded_trie, = res.metrics().query(beam.metrics.MetricsFilter()
+                                    .with_name('bounded_trie'))['bounded_tries']
+      self.assertEqual(bounded_trie.committed.size(), 2)
+      for element in elements:
+        self.assertTrue(bounded_trie.committed.contains(tuple(element)), element)
 
   def test_callbacks_with_exception(self):
     elements_list = ['1', '2']
diff --git a/sdks/python/apache_beam/runners/portability/prism_runner_test.py b/sdks/python/apache_beam/runners/portability/prism_runner_test.py
index bc72d551f966..337ac9919487 100644
--- a/sdks/python/apache_beam/runners/portability/prism_runner_test.py
+++ b/sdks/python/apache_beam/runners/portability/prism_runner_test.py
@@ -231,6 +231,9 @@ def test_pack_combiners(self):
         "Requires Prism to support coder:" +
         " 'beam:coder:tuple:v1'. https://github.com/apache/beam/issues/32636")
 
+  def test_metrics(self):
+    super().test_metrics(check_bounded_trie=False)
+
 
 # Inherits all other tests.
 

From f77efba731d748cf9958d461c9b5b9d40fc196bb Mon Sep 17 00:00:00 2001
From: Reeba Qureshi <64488642+reeba212@users.noreply.github.com>
Date: Mon, 16 Dec 2024 20:10:34 +0530
Subject: [PATCH 119/135] [yaml] Add use cases for Enrichment transform in YAML
 (#32289)

* Create use case for enriching spanner data with bigquery

End to end use case that demonstrates how spanner IO and enrichment transform coupled with other YAML transforms can be used in the real world

* Create example for bigtable enrichment

* Add project_id parameter to BigQueryWrapper

* minor changes

* remove project id being passed into bigquery wrapper

* add license

* add expected blocks

* Update examples_test.py

* Update examples_test.py

* fix formatting

* fix examples_test

Signed-off-by: Jeffrey Kinard <jeff@thekinards.com>

* Apply suggestions from code review

Co-authored-by: Jeff Kinard <jeff@thekinards.com>

* Update bigquery_tools.py

* Update bigquery_tools.py

---------

Signed-off-by: Jeffrey Kinard <jeff@thekinards.com>
Co-authored-by: Jeffrey Kinard <jeff@thekinards.com>
---
 .../yaml/examples/testing/examples_test.py    | 168 +++++++++++++++++-
 .../transforms/ml/bigtable_enrichment.yaml    |  55 ++++++
 .../ml/enrich_spanner_with_bigquery.yaml      | 102 +++++++++++
 3 files changed, 318 insertions(+), 7 deletions(-)
 create mode 100644 sdks/python/apache_beam/yaml/examples/transforms/ml/bigtable_enrichment.yaml
 create mode 100644 sdks/python/apache_beam/yaml/examples/transforms/ml/enrich_spanner_with_bigquery.yaml

diff --git a/sdks/python/apache_beam/yaml/examples/testing/examples_test.py b/sdks/python/apache_beam/yaml/examples/testing/examples_test.py
index 3b497ed1efab..109e98410852 100644
--- a/sdks/python/apache_beam/yaml/examples/testing/examples_test.py
+++ b/sdks/python/apache_beam/yaml/examples/testing/examples_test.py
@@ -21,9 +21,11 @@
 import os
 import random
 import unittest
+from typing import Any
 from typing import Callable
 from typing import Dict
 from typing import List
+from typing import Optional
 from typing import Union
 from unittest import mock
 
@@ -34,11 +36,63 @@
 from apache_beam.examples.snippets.util import assert_matches_stdout
 from apache_beam.options.pipeline_options import PipelineOptions
 from apache_beam.testing.test_pipeline import TestPipeline
+from apache_beam.yaml import yaml_provider
 from apache_beam.yaml import yaml_transform
 from apache_beam.yaml.readme_test import TestEnvironment
 from apache_beam.yaml.readme_test import replace_recursive
 
 
+# Used to simulate Enrichment transform during tests
+# The GitHub action that invokes these tests does not
+# have gcp dependencies installed which is a prerequisite
+# to apache_beam.transforms.enrichment.Enrichment as a top-level
+# import.
+@beam.ptransform.ptransform_fn
+def test_enrichment(
+    pcoll,
+    enrichment_handler: str,
+    handler_config: Dict[str, Any],
+    timeout: Optional[float] = 30):
+  if enrichment_handler == 'BigTable':
+    row_key = handler_config['row_key']
+    bt_data = INPUT_TABLES[(
+        'BigTable', handler_config['instance_id'], handler_config['table_id'])]
+    products = {str(data[row_key]): data for data in bt_data}
+
+    def _fn(row):
+      left = row._asdict()
+      right = products[str(left[row_key])]
+      left['product'] = left.get('product', None) or right
+      return beam.Row(**left)
+  elif enrichment_handler == 'BigQuery':
+    row_key = handler_config['fields']
+    dataset, table = handler_config['table_name'].split('.')[-2:]
+    bq_data = INPUT_TABLES[('BigQuery', str(dataset), str(table))]
+    bq_data = {
+        tuple(str(data[key]) for key in row_key): data
+        for data in bq_data
+    }
+
+    def _fn(row):
+      left = row._asdict()
+      right = bq_data[tuple(str(left[k]) for k in row_key)]
+      row = {
+          key: left.get(key, None) or right[key]
+          for key in {*left.keys(), *right.keys()}
+      }
+      return beam.Row(**row)
+
+  else:
+    raise ValueError(f'{enrichment_handler} is not a valid enrichment_handler.')
+
+  return pcoll | beam.Map(_fn)
+
+
+TEST_PROVIDERS = {
+    'TestEnrichment': test_enrichment,
+}
+
+
 def check_output(expected: List[str]):
   def _check_inner(actual: List[PCollection[str]]):
     formatted_actual = actual | beam.Flatten() | beam.Map(
@@ -59,7 +113,31 @@ def products_csv():
   ])
 
 
-def spanner_data():
+def spanner_orders_data():
+  return [{
+      'order_id': 1,
+      'customer_id': 1001,
+      'product_id': 2001,
+      'order_date': '24-03-24',
+      'order_amount': 150,
+  },
+          {
+              'order_id': 2,
+              'customer_id': 1002,
+              'product_id': 2002,
+              'order_date': '19-04-24',
+              'order_amount': 90,
+          },
+          {
+              'order_id': 3,
+              'customer_id': 1003,
+              'product_id': 2003,
+              'order_date': '7-05-24',
+              'order_amount': 110,
+          }]
+
+
+def spanner_shipments_data():
   return [{
       'shipment_id': 'S1',
       'customer_id': 'C1',
@@ -110,6 +188,44 @@ def spanner_data():
           }]
 
 
+def bigtable_data():
+  return [{
+      'product_id': '1', 'product_name': 'pixel 5', 'product_stock': '2'
+  }, {
+      'product_id': '2', 'product_name': 'pixel 6', 'product_stock': '4'
+  }, {
+      'product_id': '3', 'product_name': 'pixel 7', 'product_stock': '20'
+  }, {
+      'product_id': '4', 'product_name': 'pixel 8', 'product_stock': '10'
+  }, {
+      'product_id': '5', 'product_name': 'pixel 11', 'product_stock': '3'
+  }, {
+      'product_id': '6', 'product_name': 'pixel 12', 'product_stock': '7'
+  }, {
+      'product_id': '7', 'product_name': 'pixel 13', 'product_stock': '8'
+  }, {
+      'product_id': '8', 'product_name': 'pixel 14', 'product_stock': '3'
+  }]
+
+
+def bigquery_data():
+  return [{
+      'customer_id': 1001,
+      'customer_name': 'Alice',
+      'customer_email': 'alice@gmail.com'
+  },
+          {
+              'customer_id': 1002,
+              'customer_name': 'Bob',
+              'customer_email': 'bob@gmail.com'
+          },
+          {
+              'customer_id': 1003,
+              'customer_name': 'Claire',
+              'customer_email': 'claire@gmail.com'
+          }]
+
+
 def create_test_method(
     pipeline_spec_file: str,
     custom_preprocessors: List[Callable[..., Union[Dict, List]]]):
@@ -135,7 +251,11 @@ def test_yaml_example(self):
           pickle_library='cloudpickle',
           **yaml_transform.SafeLineLoader.strip_metadata(pipeline_spec.get(
               'options', {})))) as p:
-        actual = [yaml_transform.expand_pipeline(p, pipeline_spec)]
+        actual = [
+            yaml_transform.expand_pipeline(
+                p,
+                pipeline_spec, [yaml_provider.InlineProvider(TEST_PROVIDERS)])
+        ]
         if not actual[0]:
           actual = list(p.transforms_stack[0].parts[-1].outputs.values())
           for transform in p.transforms_stack[0].parts[:-1]:
@@ -213,7 +333,8 @@ def _wordcount_test_preprocessor(
     'test_simple_filter_yaml',
     'test_simple_filter_and_combine_yaml',
     'test_spanner_read_yaml',
-    'test_spanner_write_yaml'
+    'test_spanner_write_yaml',
+    'test_enrich_spanner_with_bigquery_yaml'
 ])
 def _io_write_test_preprocessor(
     test_spec: dict, expected: List[str], env: TestEnvironment):
@@ -249,7 +370,8 @@ def _file_io_read_test_preprocessor(
   return test_spec
 
 
-@YamlExamplesTestSuite.register_test_preprocessor(['test_spanner_read_yaml'])
+@YamlExamplesTestSuite.register_test_preprocessor(
+    ['test_spanner_read_yaml', 'test_enrich_spanner_with_bigquery_yaml'])
 def _spanner_io_read_test_preprocessor(
     test_spec: dict, expected: List[str], env: TestEnvironment):
 
@@ -265,14 +387,42 @@ def _spanner_io_read_test_preprocessor(
             k: v
             for k, v in config.items() if k.startswith('__')
         }
-        transform['config']['elements'] = INPUT_TABLES[(
-            str(instance), str(database), str(table))]
+        elements = INPUT_TABLES[(str(instance), str(database), str(table))]
+        if config.get('query', None):
+          config['query'].replace('select ',
+                                  'SELECT ').replace(' from ', ' FROM ')
+          columns = set(
+              ''.join(config['query'].split('SELECT ')[1:]).split(
+                  ' FROM', maxsplit=1)[0].split(', '))
+          if columns != {'*'}:
+            elements = [{
+                column: element[column]
+                for column in element if column in columns
+            } for element in elements]
+        transform['config']['elements'] = elements
+
+  return test_spec
+
+
+@YamlExamplesTestSuite.register_test_preprocessor(
+    ['test_bigtable_enrichment_yaml', 'test_enrich_spanner_with_bigquery_yaml'])
+def _enrichment_test_preprocessor(
+    test_spec: dict, expected: List[str], env: TestEnvironment):
+  if pipeline := test_spec.get('pipeline', None):
+    for transform in pipeline.get('transforms', []):
+      if transform.get('type', '').startswith('Enrichment'):
+        transform['type'] = 'TestEnrichment'
 
   return test_spec
 
 
 INPUT_FILES = {'products.csv': products_csv()}
-INPUT_TABLES = {('shipment-test', 'shipment', 'shipments'): spanner_data()}
+INPUT_TABLES = {
+    ('shipment-test', 'shipment', 'shipments'): spanner_shipments_data(),
+    ('orders-test', 'order-database', 'orders'): spanner_orders_data(),
+    ('BigTable', 'beam-test', 'bigtable-enrichment-test'): bigtable_data(),
+    ('BigQuery', 'ALL_TEST', 'customers'): bigquery_data()
+}
 
 YAML_DOCS_DIR = os.path.join(os.path.dirname(__file__))
 ExamplesTest = YamlExamplesTestSuite(
@@ -290,6 +440,10 @@ def _spanner_io_read_test_preprocessor(
     'IOExamplesTest', os.path.join(YAML_DOCS_DIR,
                                    '../transforms/io/*.yaml')).run()
 
+MLTest = YamlExamplesTestSuite(
+    'MLExamplesTest', os.path.join(YAML_DOCS_DIR,
+                                   '../transforms/ml/*.yaml')).run()
+
 if __name__ == '__main__':
   logging.getLogger().setLevel(logging.INFO)
   unittest.main()
diff --git a/sdks/python/apache_beam/yaml/examples/transforms/ml/bigtable_enrichment.yaml b/sdks/python/apache_beam/yaml/examples/transforms/ml/bigtable_enrichment.yaml
new file mode 100644
index 000000000000..788b69de7857
--- /dev/null
+++ b/sdks/python/apache_beam/yaml/examples/transforms/ml/bigtable_enrichment.yaml
@@ -0,0 +1,55 @@
+# coding=utf-8
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+pipeline:
+  type: chain
+  transforms:
+
+  # Step 1: Creating a collection of elements that needs
+  # to be enriched. Here we are simulating sales data
+    - type: Create
+      config:
+        elements:
+        - sale_id: 1
+          customer_id: 1
+          product_id: 1
+          quantity: 1
+
+  # Step 2: Enriching the data with Bigtable
+  # This specific bigtable stores product data in the below format
+  # product:product_id, product:product_name, product:product_stock
+    - type: Enrichment
+      config:
+        enrichment_handler: 'BigTable'
+        handler_config:
+          project_id: 'apache-beam-testing'
+          instance_id: 'beam-test'
+          table_id: 'bigtable-enrichment-test'
+          row_key: 'product_id'
+        timeout: 30
+
+  # Step 3: Logging for testing
+  # This is a simple way to view the enriched data
+  # We can also store it somewhere like a json file
+    - type: LogForTesting
+
+options:
+  yaml_experimental_features: Enrichment
+  
+# Expected:
+#  Row(sale_id=1, customer_id=1, product_id=1, quantity=1, product={'product_id': '1', 'product_name': 'pixel 5', 'product_stock': '2'})
\ No newline at end of file
diff --git a/sdks/python/apache_beam/yaml/examples/transforms/ml/enrich_spanner_with_bigquery.yaml b/sdks/python/apache_beam/yaml/examples/transforms/ml/enrich_spanner_with_bigquery.yaml
new file mode 100644
index 000000000000..e63b3105cc0c
--- /dev/null
+++ b/sdks/python/apache_beam/yaml/examples/transforms/ml/enrich_spanner_with_bigquery.yaml
@@ -0,0 +1,102 @@
+# coding=utf-8
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+pipeline:
+  transforms:
+    # Step 1: Read orders details from Spanner
+    - type: ReadFromSpanner
+      name: ReadOrders
+      config:
+        project_id: 'apache-beam-testing'
+        instance_id: 'orders-test'
+        database_id: 'order-database'
+        query: 'SELECT customer_id, product_id, order_date, order_amount FROM orders'
+
+    # Step 2: Enrich order details with customers details from BigQuery
+    - type: Enrichment
+      name: Enriched
+      input: ReadOrders
+      config:
+        enrichment_handler: 'BigQuery'
+        handler_config:
+          project: "apache-beam-testing"
+          table_name: "apache-beam-testing.ALL_TEST.customers"
+          row_restriction_template: "customer_id = 1001 or customer_id = 1003"
+          fields: ["customer_id"]
+
+    # Step 3: Map enriched values to Beam schema
+    # TODO: This should be removed when schema'd enrichment is available
+    - type: MapToFields
+      name: MapEnrichedValues
+      input: Enriched
+      config:
+        language: python
+        fields:
+          customer_id:
+            callable: 'lambda x: x.customer_id'
+            output_type: integer
+          customer_name:
+            callable: 'lambda x: x.customer_name'
+            output_type: string
+          customer_email:
+            callable: 'lambda x: x.customer_email'
+            output_type: string 
+          product_id:
+            callable: 'lambda x: x.product_id'
+            output_type: integer
+          order_date:
+            callable: 'lambda x: x.order_date'
+            output_type: string
+          order_amount:
+            callable: 'lambda x: x.order_amount'
+            output_type: integer
+
+    # Step 4: Filter orders with amount greater than 110
+    - type: Filter
+      name: FilterHighValueOrders
+      input: MapEnrichedValues
+      config:
+        keep: "order_amount > 110"
+        language: "python"
+
+
+    # Step 6: Write processed order to another spanner table
+    #   Note: Make sure to replace $VARS with your values.
+    - type: WriteToSpanner
+      name: WriteProcessedOrders
+      input: FilterHighValueOrders
+      config:
+        project_id: '$PROJECT'
+        instance_id: '$INSTANCE'
+        database_id: '$DATABASE'
+        table_id: '$TABLE'
+        error_handling:
+          output: my_error_output
+
+    # Step 7: Handle write errors by writing to JSON
+    - type: WriteToJson
+      name: WriteErrorsToJson
+      input: WriteProcessedOrders.my_error_output
+      config:
+        path: 'errors.json'
+
+options:
+  yaml_experimental_features: Enrichment
+
+# Expected:
+#  Row(customer_id=1001, customer_name='Alice', customer_email='alice@gmail.com', product_id=2001, order_date='24-03-24', order_amount=150)

From 0eb82b70acc8124d3edae761f7b85143b069c406 Mon Sep 17 00:00:00 2001
From: Kenneth Knowles <klk@google.com>
Date: Mon, 16 Dec 2024 10:05:08 -0500
Subject: [PATCH 120/135] Fix duplicate yml entry causing test result dashboard
 sync to fail

---
 .github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink.yml
index 1442f5ffafc0..f79ca8747828 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink.yml
@@ -93,4 +93,3 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
-          large_files: true

From 74b723db434f10d2fbbe53e68e9f9bdb707da936 Mon Sep 17 00:00:00 2001
From: Kenneth Knowles <klk@google.com>
Date: Mon, 16 Dec 2024 10:34:00 -0500
Subject: [PATCH 121/135] Fix yaml error in Flink Java8 ValidatesRunner

---
 .../beam_PostCommit_Java_ValidatesRunner_Flink_Java8.yml         | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink_Java8.yml b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink_Java8.yml
index 0f12ce6f90ef..c51c39987236 100644
--- a/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink_Java8.yml
+++ b/.github/workflows/beam_PostCommit_Java_ValidatesRunner_Flink_Java8.yml
@@ -110,4 +110,3 @@ jobs:
           commit: '${{ env.prsha || env.GITHUB_SHA }}'
           comment_mode: ${{ github.event_name == 'issue_comment'  && 'always' || 'off' }}
           files: '**/build/test-results/**/*.xml'
-          large_files: true

From 0f4c64768f80661ed1dfbdcd38e762c1fa52d2fe Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@google.com>
Date: Mon, 16 Dec 2024 09:59:49 -0800
Subject: [PATCH 122/135] yapf

---
 .../runners/portability/fn_api_runner/fn_runner_test.py        | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py b/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
index 65d598171c08..3f036ab27f6e 100644
--- a/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
+++ b/sdks/python/apache_beam/runners/portability/fn_api_runner/fn_runner_test.py
@@ -1255,7 +1255,8 @@ def test_metrics(self, check_gauge=True, check_bounded_trie=False):
                                     .with_name('bounded_trie'))['bounded_tries']
       self.assertEqual(bounded_trie.committed.size(), 2)
       for element in elements:
-        self.assertTrue(bounded_trie.committed.contains(tuple(element)), element)
+        self.assertTrue(
+            bounded_trie.committed.contains(tuple(element)), element)
 
   def test_callbacks_with_exception(self):
     elements_list = ['1', '2']

From 4bac374df961f54ee7c7be2a8811714fb71a4a72 Mon Sep 17 00:00:00 2001
From: ldetmer <1771267+ldetmer@users.noreply.github.com>
Date: Mon, 16 Dec 2024 21:45:22 +0000
Subject: [PATCH 123/135] chore: upgrade google_cloud_bigdataoss_version to
 2.2.26 in order to be protobuf 3 and 4 compatible (#33395)

---
 .../main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy b/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
index a59c1d7630b0..ef934efa94be 100644
--- a/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
+++ b/buildSrc/src/main/groovy/org/apache/beam/gradle/BeamModulePlugin.groovy
@@ -606,7 +606,7 @@ class BeamModulePlugin implements Plugin<Project> {
     def gax_version = "2.55.0"
     def google_ads_version = "33.0.0"
     def google_clients_version = "2.0.0"
-    def google_cloud_bigdataoss_version = "2.2.16"
+    def google_cloud_bigdataoss_version = "2.2.26"
     // [bomupgrader] determined by: com.google.cloud:google-cloud-spanner, consistent with: google_cloud_platform_libraries_bom
     def google_cloud_spanner_version = "6.79.0"
     def google_code_gson_version = "2.10.1"

From 3dc2b2edc095cc23a6a773e4064da5c2a97c96f7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 Dec 2024 23:22:01 -0800
Subject: [PATCH 124/135] Bump google.golang.org/protobuf from 1.35.2 to 1.36.0
 in /sdks (#33397)

Bumps google.golang.org/protobuf from 1.35.2 to 1.36.0.

---
updated-dependencies:
- dependency-name: google.golang.org/protobuf
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod | 2 +-
 sdks/go.sum | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index 79b32b051df3..d0f607bd2abf 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -61,7 +61,7 @@ require (
 	google.golang.org/api v0.211.0
 	google.golang.org/genproto v0.0.0-20241118233622-e639e219e697
 	google.golang.org/grpc v1.67.2
-	google.golang.org/protobuf v1.35.2
+	google.golang.org/protobuf v1.36.0
 	gopkg.in/yaml.v2 v2.4.0
 	gopkg.in/yaml.v3 v3.0.1
 )
diff --git a/sdks/go.sum b/sdks/go.sum
index 0e7792f499f4..d4679497e21a 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -1917,8 +1917,8 @@ google.golang.org/protobuf v1.28.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqw
 google.golang.org/protobuf v1.28.1/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
 google.golang.org/protobuf v1.29.1/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
 google.golang.org/protobuf v1.30.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
-google.golang.org/protobuf v1.35.2 h1:8Ar7bF+apOIoThw1EdZl0p1oWvMqTHmpA2fRTyZO8io=
-google.golang.org/protobuf v1.35.2/go.mod h1:9fA7Ob0pmnwhb644+1+CVWFRbNajQ6iRojtC/QF5bRE=
+google.golang.org/protobuf v1.36.0 h1:mjIs9gYtt56AzC4ZaffQuh88TZurBGhIJMBZGSxNerQ=
+google.golang.org/protobuf v1.36.0/go.mod h1:9fA7Ob0pmnwhb644+1+CVWFRbNajQ6iRojtC/QF5bRE=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=

From c5a5be5e14edb87ba055b576ada3ff260b47bcf0 Mon Sep 17 00:00:00 2001
From: claudevdm <33973061+claudevdm@users.noreply.github.com>
Date: Tue, 17 Dec 2024 10:24:55 -0500
Subject: [PATCH 125/135] Rag chunking embedding (#33364)

* Add core RAG types.

* Add chunking base.

* Add LangChain TextSplitter chunking.

* Add generic type support for embeddings.

* Add base rag EmbeddingTypeAdapter.

* Create HuggingfaceTextEmbeddings.

* Linter fixes.

* Docstring fixes.

* Typehint fixes.

* Docstring fix.

* Add EmbeddingManager to args and more test coverage.
---
 sdks/python/apache_beam/ml/rag/__init__.py    |  25 ++
 .../apache_beam/ml/rag/chunking/__init__.py   |  21 ++
 .../apache_beam/ml/rag/chunking/base.py       |  92 ++++++++
 .../apache_beam/ml/rag/chunking/base_test.py  | 139 +++++++++++
 .../apache_beam/ml/rag/chunking/langchain.py  | 120 ++++++++++
 .../ml/rag/chunking/langchain_test.py         | 217 ++++++++++++++++++
 .../apache_beam/ml/rag/embeddings/__init__.py |  20 ++
 .../apache_beam/ml/rag/embeddings/base.py     |  55 +++++
 .../ml/rag/embeddings/base_test.py            |  93 ++++++++
 .../ml/rag/embeddings/huggingface.py          |  74 ++++++
 .../ml/rag/embeddings/huggingface_test.py     | 108 +++++++++
 sdks/python/apache_beam/ml/rag/types.py       |  73 ++++++
 sdks/python/apache_beam/ml/transforms/base.py | 181 +++++++++------
 .../apache_beam/ml/transforms/base_test.py    | 103 ++++++---
 .../ml/transforms/embeddings/huggingface.py   |   4 +-
 15 files changed, 1225 insertions(+), 100 deletions(-)
 create mode 100644 sdks/python/apache_beam/ml/rag/__init__.py
 create mode 100644 sdks/python/apache_beam/ml/rag/chunking/__init__.py
 create mode 100644 sdks/python/apache_beam/ml/rag/chunking/base.py
 create mode 100644 sdks/python/apache_beam/ml/rag/chunking/base_test.py
 create mode 100644 sdks/python/apache_beam/ml/rag/chunking/langchain.py
 create mode 100644 sdks/python/apache_beam/ml/rag/chunking/langchain_test.py
 create mode 100644 sdks/python/apache_beam/ml/rag/embeddings/__init__.py
 create mode 100644 sdks/python/apache_beam/ml/rag/embeddings/base.py
 create mode 100644 sdks/python/apache_beam/ml/rag/embeddings/base_test.py
 create mode 100644 sdks/python/apache_beam/ml/rag/embeddings/huggingface.py
 create mode 100644 sdks/python/apache_beam/ml/rag/embeddings/huggingface_test.py
 create mode 100644 sdks/python/apache_beam/ml/rag/types.py

diff --git a/sdks/python/apache_beam/ml/rag/__init__.py b/sdks/python/apache_beam/ml/rag/__init__.py
new file mode 100644
index 000000000000..554beb9d7aba
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/__init__.py
@@ -0,0 +1,25 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+"""Apache Beam RAG (Retrieval Augmented Generation) components.
+This package provides components for building RAG pipelines in Apache Beam,
+including:
+- Chunking
+- Embedding generation
+- Vector storage
+- Vector search enrichment
+"""
diff --git a/sdks/python/apache_beam/ml/rag/chunking/__init__.py b/sdks/python/apache_beam/ml/rag/chunking/__init__.py
new file mode 100644
index 000000000000..34a6a966b19e
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/chunking/__init__.py
@@ -0,0 +1,21 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+"""Chunking components for RAG pipelines.
+This module provides components for splitting text into chunks for RAG
+pipelines.
+"""
diff --git a/sdks/python/apache_beam/ml/rag/chunking/base.py b/sdks/python/apache_beam/ml/rag/chunking/base.py
new file mode 100644
index 000000000000..626a6ea8abbe
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/chunking/base.py
@@ -0,0 +1,92 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+import abc
+import functools
+from collections.abc import Callable
+from typing import Any
+from typing import Dict
+from typing import Optional
+
+import apache_beam as beam
+from apache_beam.ml.rag.types import Chunk
+from apache_beam.ml.transforms.base import MLTransformProvider
+
+ChunkIdFn = Callable[[Chunk], str]
+
+
+def _assign_chunk_id(chunk_id_fn: ChunkIdFn, chunk: Chunk):
+  chunk.id = chunk_id_fn(chunk)
+  return chunk
+
+
+class ChunkingTransformProvider(MLTransformProvider):
+  def __init__(self, chunk_id_fn: Optional[ChunkIdFn] = None):
+    """Base class for chunking transforms in RAG pipelines.
+
+    ChunkingTransformProvider defines the interface for splitting documents
+    into chunks for embedding and retrieval. Implementations should define how
+    to split content while preserving metadata and managing chunk IDs.
+
+    The transform flow:
+    - Takes input documents with content and metadata
+    - Splits content into chunks using implementation-specific logic
+    - Preserves document metadata in resulting chunks
+    - Optionally assigns unique IDs to chunks (configurable via chunk_id_fn
+
+    Example usage:
+      >>> class MyChunker(ChunkingTransformProvider):
+      ...     def get_splitter_transform(self):
+      ...         return beam.ParDo(MySplitterDoFn())
+      ... 
+      >>> chunker = MyChunker(chunk_id_fn=my_id_function)
+      >>> 
+      >>> with beam.Pipeline() as p:
+      ...     chunks = (
+      ...         p 
+      ...         | beam.Create([{'text': 'document...', 'source': 'doc.txt'}])
+      ...         | MLTransform(...).with_transform(chunker))
+
+    Args:
+      chunk_id_fn: Optional function to generate chunk IDs. If not provided,
+        random UUIDs will be used. Function should take a Chunk and return str.
+    """
+    self.assign_chunk_id_fn = functools.partial(
+        _assign_chunk_id, chunk_id_fn) if chunk_id_fn is not None else None
+
+  @abc.abstractmethod
+  def get_splitter_transform(
+      self
+  ) -> beam.PTransform[beam.PCollection[Dict[str, Any]],
+                       beam.PCollection[Chunk]]:
+    """Creates transforms that emits splits for given content."""
+    raise NotImplementedError(
+        "Subclasses must implement get_splitter_transform")
+
+  def get_ptransform_for_processing(
+      self, **kwargs
+  ) -> beam.PTransform[beam.PCollection[Dict[str, Any]],
+                       beam.PCollection[Chunk]]:
+    """Creates transform for processing documents into chunks."""
+    ptransform = (
+        "Split document" >>
+        self.get_splitter_transform().with_output_types(Chunk))
+    if self.assign_chunk_id_fn:
+      ptransform = (
+          ptransform | "Assign chunk id" >> beam.Map(
+              self.assign_chunk_id_fn).with_output_types(Chunk))
+    return ptransform
diff --git a/sdks/python/apache_beam/ml/rag/chunking/base_test.py b/sdks/python/apache_beam/ml/rag/chunking/base_test.py
new file mode 100644
index 000000000000..54e25591c348
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/chunking/base_test.py
@@ -0,0 +1,139 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Tests for apache_beam.ml.rag.chunking.base."""
+
+import unittest
+from typing import Any
+from typing import Dict
+from typing import Optional
+
+import pytest
+
+import apache_beam as beam
+from apache_beam.ml.rag.chunking.base import ChunkIdFn
+from apache_beam.ml.rag.chunking.base import ChunkingTransformProvider
+from apache_beam.ml.rag.types import Chunk
+from apache_beam.ml.rag.types import Content
+from apache_beam.testing.test_pipeline import TestPipeline
+from apache_beam.testing.util import assert_that
+from apache_beam.testing.util import equal_to
+
+
+class WordSplitter(beam.DoFn):
+  def process(self, element):
+    words = element['text'].split()
+    for i, word in enumerate(words):
+      yield Chunk(
+          content=Content(text=word),
+          index=i,
+          metadata={'source': element['source']})
+
+
+class InvalidChunkingProvider(ChunkingTransformProvider):
+  def __init__(self, chunk_id_fn: Optional[ChunkIdFn] = None):
+    super().__init__(chunk_id_fn=chunk_id_fn)
+
+
+class MockChunkingProvider(ChunkingTransformProvider):
+  def __init__(self, chunk_id_fn: Optional[ChunkIdFn] = None):
+    super().__init__(chunk_id_fn=chunk_id_fn)
+
+  def get_splitter_transform(
+      self
+  ) -> beam.PTransform[beam.PCollection[Dict[str, Any]],
+                       beam.PCollection[Chunk]]:
+    return beam.ParDo(WordSplitter())
+
+
+def chunk_equals(expected, actual):
+  """Custom equality function for Chunk objects."""
+  if not isinstance(expected, Chunk) or not isinstance(actual, Chunk):
+    return False
+  # Don't compare IDs since they're randomly generated
+  return (
+      expected.index == actual.index and expected.content == actual.content and
+      expected.metadata == actual.metadata)
+
+
+def id_equals(expected, actual):
+  """Custom equality function for Chunk object id's."""
+  if not isinstance(expected, Chunk) or not isinstance(actual, Chunk):
+    return False
+  return (expected.id == actual.id)
+
+
+@pytest.mark.uses_transformers
+class ChunkingTransformProviderTest(unittest.TestCase):
+  def setUp(self):
+    self.test_doc = {'text': 'hello world test', 'source': 'test.txt'}
+
+  def test_doesnt_override_get_text_splitter_transform(self):
+    provider = InvalidChunkingProvider()
+    with self.assertRaises(NotImplementedError):
+      provider.get_splitter_transform()
+
+  def test_chunking_transform(self):
+    """Test the complete chunking transform."""
+    provider = MockChunkingProvider()
+
+    with TestPipeline() as p:
+      chunks = (
+          p
+          | beam.Create([self.test_doc])
+          | provider.get_ptransform_for_processing())
+
+      expected = [
+          Chunk(
+              content=Content(text="hello"),
+              index=0,
+              metadata={'source': 'test.txt'}),
+          Chunk(
+              content=Content(text="world"),
+              index=1,
+              metadata={'source': 'test.txt'}),
+          Chunk(
+              content=Content(text="test"),
+              index=2,
+              metadata={'source': 'test.txt'})
+      ]
+
+      assert_that(chunks, equal_to(expected, equals_fn=chunk_equals))
+
+  def test_custom_chunk_id_fn(self):
+    """Test the a custom chink id function."""
+    def source_index_id_fn(chunk: Chunk):
+      return f"{chunk.metadata['source']}_{chunk.index}"
+
+    provider = MockChunkingProvider(chunk_id_fn=source_index_id_fn)
+
+    with TestPipeline() as p:
+      chunks = (
+          p
+          | beam.Create([self.test_doc])
+          | provider.get_ptransform_for_processing())
+
+      expected = [
+          Chunk(content=Content(text="hello"), id="test.txt_0"),
+          Chunk(content=Content(text="world"), id="test.txt_1"),
+          Chunk(content=Content(text="test"), id="test.txt_2")
+      ]
+
+      assert_that(chunks, equal_to(expected, equals_fn=id_equals))
+
+
+if __name__ == '__main__':
+  unittest.main()
diff --git a/sdks/python/apache_beam/ml/rag/chunking/langchain.py b/sdks/python/apache_beam/ml/rag/chunking/langchain.py
new file mode 100644
index 000000000000..9e3b6b0c8ef9
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/chunking/langchain.py
@@ -0,0 +1,120 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+from typing import Any
+from typing import Dict
+from typing import List
+from typing import Optional
+
+import apache_beam as beam
+from apache_beam.ml.rag.chunking.base import ChunkIdFn
+from apache_beam.ml.rag.chunking.base import ChunkingTransformProvider
+from apache_beam.ml.rag.types import Chunk
+from apache_beam.ml.rag.types import Content
+
+try:
+  from langchain.text_splitter import TextSplitter
+except ImportError:
+  TextSplitter = None
+
+
+class LangChainChunker(ChunkingTransformProvider):
+  def __init__(
+      self,
+      text_splitter: TextSplitter,
+      document_field: str,
+      metadata_fields: List[str],
+      chunk_id_fn: Optional[ChunkIdFn] = None):
+    """A ChunkingTransformProvider that uses LangChain text splitters.
+  
+    This provider integrates LangChain's text splitting capabilities into
+    Beam's MLTransform framework. It supports various text splitting strategies
+    through LangChain's TextSplitter interface, including recursive character
+    splitting and other methods. 
+
+    The provider:
+    - Takes documents with text content and metadata
+    - Splits text using configured LangChain splitter
+    - Preserves document metadata in resulting chunks
+    - Assigns unique IDs to chunks (configurable via chunk_id_fn)
+
+    Example usage:
+      ```python
+      from langchain.text_splitter import RecursiveCharacterTextSplitter
+      
+      splitter = RecursiveCharacterTextSplitter(
+          chunk_size=100,
+          chunk_overlap=20
+      )
+      
+      chunker = LangChainChunker(text_splitter=splitter)
+      
+      with beam.Pipeline() as p:
+        chunks = (
+            p 
+            | beam.Create([{'text': 'long document...', 'source': 'doc.txt'}])
+            | MLTransform(...).with_transform(chunker))
+      ```
+
+    Args:
+      text_splitter: A LangChain TextSplitter instance that defines how
+        documents are split into chunks.
+      metadata_fields: List of field names to copy from input documents to
+        chunk metadata. These fields will be preserved in each chunk created
+        from the document.
+      chunk_id_fn: Optional function that take a Chunk and return str to
+        generate chunk IDs. If not provided, random UUIDs will be used.
+    """
+    if not TextSplitter:
+      raise ImportError(
+          "langchain is required to use LangChainChunker"
+          "Please install it with using `pip install langchain`.")
+    if not isinstance(text_splitter, TextSplitter):
+      raise TypeError("text_splitter must be a LangChain TextSplitter")
+    if not document_field:
+      raise ValueError("document_field cannot be empty")
+    super().__init__(chunk_id_fn)
+    self.text_splitter = text_splitter
+    self.document_field = document_field
+    self.metadata_fields = metadata_fields
+
+  def get_splitter_transform(
+      self
+  ) -> beam.PTransform[beam.PCollection[Dict[str, Any]],
+                       beam.PCollection[Chunk]]:
+    return "Langchain text split" >> beam.ParDo(
+        _LangChainTextSplitter(
+            text_splitter=self.text_splitter,
+            document_field=self.document_field,
+            metadata_fields=self.metadata_fields))
+
+
+class _LangChainTextSplitter(beam.DoFn):
+  def __init__(
+      self,
+      text_splitter: TextSplitter,
+      document_field: str,
+      metadata_fields: List[str]):
+    self.text_splitter = text_splitter
+    self.document_field = document_field
+    self.metadata_fields = metadata_fields
+
+  def process(self, element):
+    text_chunks = self.text_splitter.split_text(element[self.document_field])
+    metadata = {field: element[field] for field in self.metadata_fields}
+    for i, text_chunk in enumerate(text_chunks):
+      yield Chunk(content=Content(text=text_chunk), index=i, metadata=metadata)
diff --git a/sdks/python/apache_beam/ml/rag/chunking/langchain_test.py b/sdks/python/apache_beam/ml/rag/chunking/langchain_test.py
new file mode 100644
index 000000000000..83a4fc1a778f
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/chunking/langchain_test.py
@@ -0,0 +1,217 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Tests for apache_beam.ml.rag.chunking.langchain."""
+
+import unittest
+
+import apache_beam as beam
+from apache_beam.ml.rag.types import Chunk
+from apache_beam.testing.test_pipeline import TestPipeline
+from apache_beam.testing.util import assert_that
+from apache_beam.testing.util import equal_to
+
+try:
+  from apache_beam.ml.rag.chunking.langchain import LangChainChunker
+
+  from langchain.text_splitter import (
+      CharacterTextSplitter, RecursiveCharacterTextSplitter)
+  LANGCHAIN_AVAILABLE = True
+except ImportError:
+  LANGCHAIN_AVAILABLE = False
+
+# Import optional dependencies
+try:
+  from transformers import AutoTokenizer
+  TRANSFORMERS_AVAILABLE = True
+except ImportError:
+  TRANSFORMERS_AVAILABLE = False
+
+
+def chunk_equals(expected, actual):
+  """Custom equality function for Chunk objects."""
+  if not isinstance(expected, Chunk) or not isinstance(actual, Chunk):
+    return False
+  return (
+      expected.content == actual.content and expected.index == actual.index and
+      expected.metadata == actual.metadata)
+
+
+@unittest.skipIf(not LANGCHAIN_AVAILABLE, 'langchain is not installed.')
+class LangChainChunkingTest(unittest.TestCase):
+  def setUp(self):
+    self.simple_text = {
+        'content': 'This is a simple test document. It has multiple sentences. '
+        'We will use it to test basic splitting.',
+        'source': 'simple.txt',
+        'language': 'en'
+    }
+
+    self.complex_text = {
+        'content': (
+            'The patient arrived at 2 p.m. yesterday. '
+            'Initial assessment was completed. '
+            'Lab results showed normal ranges. '
+            'Follow-up scheduled for next week.'),
+        'source': 'medical.txt',
+        'language': 'en'
+    }
+
+  def test_no_metadata_fields(self):
+    """Test chunking with no metadata fields specified."""
+    splitter = CharacterTextSplitter(chunk_size=100, chunk_overlap=20)
+    provider = LangChainChunker(
+        document_field='content', metadata_fields=[], text_splitter=splitter)
+
+    with TestPipeline() as p:
+      chunks = (
+          p
+          | beam.Create([self.simple_text])
+          | provider.get_ptransform_for_processing())
+      chunks_count = chunks | beam.combiners.Count.Globally()
+
+      assert_that(chunks_count, lambda x: x[0] > 0, 'Has chunks')
+
+      assert_that(chunks, lambda x: all(c.metadata == {} for c in x))
+
+  def test_multiple_metadata_fields(self):
+    """Test chunking with multiple metadata fields."""
+    splitter = CharacterTextSplitter(chunk_size=100, chunk_overlap=20)
+    provider = LangChainChunker(
+        document_field='content',
+        metadata_fields=['source', 'language'],
+        text_splitter=splitter)
+
+    with TestPipeline() as p:
+      chunks = (
+          p
+          | beam.Create([self.simple_text])
+          | provider.get_ptransform_for_processing())
+      chunks_count = chunks | beam.combiners.Count.Globally()
+
+      assert_that(chunks_count, lambda x: x[0] > 0, 'Has chunks')
+      assert_that(
+          chunks,
+          lambda x: all(
+              c.metadata == {
+                  'source': 'simple.txt', 'language': 'en'
+              } for c in x))
+
+  def test_recursive_splitter_no_overlap(self):
+    """Test RecursiveCharacterTextSplitter with no overlap."""
+    splitter = RecursiveCharacterTextSplitter(
+        chunk_size=30, chunk_overlap=0, separators=[". "])
+    provider = LangChainChunker(
+        document_field='content',
+        metadata_fields=['source'],
+        text_splitter=splitter)
+
+    with TestPipeline() as p:
+      chunks = (
+          p
+          | beam.Create([self.simple_text])
+          | provider.get_ptransform_for_processing())
+      chunks_count = chunks | beam.combiners.Count.Globally()
+
+      assert_that(chunks_count, lambda x: x[0] > 0, 'Has chunks')
+      assert_that(chunks, lambda x: all(len(c.content.text) <= 30 for c in x))
+
+  @unittest.skipIf(not TRANSFORMERS_AVAILABLE, "transformers not available")
+  def test_huggingface_tokenizer_splitter(self):
+    """Test text splitter created from HuggingFace tokenizer."""
+    tokenizer = AutoTokenizer.from_pretrained("bert-base-uncased")
+    splitter = RecursiveCharacterTextSplitter.from_huggingface_tokenizer(
+        tokenizer,
+        chunk_size=10,  # tokens
+        chunk_overlap=2  # tokens
+    )
+
+    provider = LangChainChunker(
+        document_field='content',
+        metadata_fields=['source'],
+        text_splitter=splitter)
+
+    with TestPipeline() as p:
+      chunks = (
+          p
+          | beam.Create([self.simple_text])
+          | provider.get_ptransform_for_processing())
+
+      def check_token_lengths(chunks):
+        for chunk in chunks:
+          # Verify each chunk's token length is within limits
+          num_tokens = len(tokenizer.encode(chunk.content.text))
+          if not num_tokens <= 10:
+            raise AssertionError(
+                f"Chunk has {num_tokens} tokens, expected <= 10")
+        return True
+
+      chunks_count = chunks | beam.combiners.Count.Globally()
+
+      assert_that(chunks_count, lambda x: x[0] > 0, 'Has chunks')
+      assert_that(chunks, check_token_lengths)
+
+  def test_invalid_document_field(self):
+    """Test that using an invalid document field raises KeyError."""
+    splitter = CharacterTextSplitter(chunk_size=100, chunk_overlap=20)
+    provider = LangChainChunker(
+        document_field='nonexistent',
+        metadata_fields={},
+        text_splitter=splitter)
+
+    with self.assertRaises(KeyError):
+      with TestPipeline() as p:
+        _ = (
+            p
+            | beam.Create([self.simple_text])
+            | provider.get_ptransform_for_processing())
+
+  def test_empty_document_field(self):
+    """Test that using an invalid document field raises KeyError."""
+    splitter = CharacterTextSplitter(chunk_size=100, chunk_overlap=20)
+
+    with self.assertRaises(ValueError):
+      _ = LangChainChunker(
+          document_field='', metadata_fields={}, text_splitter=splitter)
+
+  def test_invalid_text_splitter(self):
+    """Test that using an invalid document field raises KeyError."""
+
+    with self.assertRaises(TypeError):
+      _ = LangChainChunker(
+          document_field='nonexistent', text_splitter="Not a text splitter!")
+
+  def test_empty_text(self):
+    """Test that empty text produces no chunks."""
+    empty_doc = {'content': '', 'source': 'empty.txt'}
+
+    splitter = CharacterTextSplitter(chunk_size=100, chunk_overlap=20)
+    provider = LangChainChunker(
+        document_field='content',
+        metadata_fields=['source'],
+        text_splitter=splitter)
+
+    with TestPipeline() as p:
+      chunks = (
+          p
+          | beam.Create([empty_doc])
+          | provider.get_ptransform_for_processing())
+
+      assert_that(chunks, equal_to([]))
+
+
+if __name__ == '__main__':
+  unittest.main()
diff --git a/sdks/python/apache_beam/ml/rag/embeddings/__init__.py b/sdks/python/apache_beam/ml/rag/embeddings/__init__.py
new file mode 100644
index 000000000000..d2cdb63c0bde
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/embeddings/__init__.py
@@ -0,0 +1,20 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+"""Embedding components for RAG pipelines.
+This module provides components for generating embeddings in RAG pipelines.
+"""
diff --git a/sdks/python/apache_beam/ml/rag/embeddings/base.py b/sdks/python/apache_beam/ml/rag/embeddings/base.py
new file mode 100644
index 000000000000..25dc3ee47e80
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/embeddings/base.py
@@ -0,0 +1,55 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections.abc import Sequence
+from typing import List
+
+from apache_beam.ml.rag.types import Chunk
+from apache_beam.ml.rag.types import Embedding
+from apache_beam.ml.transforms.base import EmbeddingTypeAdapter
+
+
+def create_rag_adapter() -> EmbeddingTypeAdapter[Chunk, Chunk]:
+  """Creates adapter for converting between Chunk and Embedding types.
+    
+    The adapter:
+    - Extracts text from Chunk.content.text for embedding
+    - Creates Embedding objects from model output
+    - Sets Embedding in Chunk.embedding
+    
+    Returns:
+        EmbeddingTypeAdapter configured for RAG pipeline types
+    """
+  return EmbeddingTypeAdapter(
+      input_fn=_extract_chunk_text, output_fn=_add_embedding_fn)
+
+
+def _extract_chunk_text(chunks: Sequence[Chunk]) -> List[str]:
+  """Extract text from chunks for embedding."""
+  chunk_texts = []
+  for chunk in chunks:
+    if not chunk.content.text:
+      raise ValueError("Expected chunk text content.")
+    chunk_texts.append(chunk.content.text)
+  return chunk_texts
+
+
+def _add_embedding_fn(
+    chunks: Sequence[Chunk], embeddings: Sequence[List[float]]) -> List[Chunk]:
+  """Create Embeddings from chunks and embedding vectors."""
+  for chunk, embedding in zip(chunks, embeddings):
+    chunk.embedding = Embedding(dense_embedding=embedding)
+  return list(chunks)
diff --git a/sdks/python/apache_beam/ml/rag/embeddings/base_test.py b/sdks/python/apache_beam/ml/rag/embeddings/base_test.py
new file mode 100644
index 000000000000..3a27ae8e7ebb
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/embeddings/base_test.py
@@ -0,0 +1,93 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+from apache_beam.ml.rag.embeddings.base import create_rag_adapter
+from apache_beam.ml.rag.types import Chunk
+from apache_beam.ml.rag.types import Content
+from apache_beam.ml.rag.types import Embedding
+
+
+class RAGBaseEmbeddingsTest(unittest.TestCase):
+  def setUp(self):
+    self.test_chunks = [
+        Chunk(
+            content=Content(text="This is a test sentence."),
+            id="1",
+            metadata={
+                "source": "test.txt", "language": "en"
+            }),
+        Chunk(
+            content=Content(text="Another example."),
+            id="2",
+            metadata={
+                "source": "test2.txt", "language": "en"
+            })
+    ]
+
+  def test_adapter_input_conversion(self):
+    """Test the RAG type adapter converts correctly."""
+    adapter = create_rag_adapter()
+
+    # Test input conversion
+    texts = adapter.input_fn(self.test_chunks)
+    self.assertEqual(texts, ["This is a test sentence.", "Another example."])
+
+  def test_adapter_input_conversion_missing_text_content(self):
+    """Test the RAG type adapter converts correctly."""
+    adapter = create_rag_adapter()
+
+    # Test input conversion
+    with self.assertRaisesRegex(ValueError, "Expected chunk text content"):
+      adapter.input_fn([
+          Chunk(
+              content=Content(),
+              id="1",
+              metadata={
+                  "source": "test.txt", "language": "en"
+              })
+      ])
+
+  def test_adapter_output_conversion(self):
+    """Test the RAG type adapter converts correctly."""
+    # Test output conversion
+    mock_embeddings = [[0.1, 0.2, 0.3], [0.4, 0.5, 0.6]]
+    # Expected outputs
+    expected = [
+        Chunk(
+            id="1",
+            embedding=Embedding(dense_embedding=[0.1, 0.2, 0.3]),
+            metadata={
+                'source': 'test.txt', 'language': 'en'
+            },
+            content=Content(text='This is a test sentence.')),
+        Chunk(
+            id="2",
+            embedding=Embedding(dense_embedding=[0.4, 0.5, 0.6]),
+            metadata={
+                'source': 'test2.txt', 'language': 'en'
+            },
+            content=Content(text='Another example.')),
+    ]
+    adapter = create_rag_adapter()
+
+    embeddings = adapter.output_fn(self.test_chunks, mock_embeddings)
+    self.assertListEqual(embeddings, expected)
+
+
+if __name__ == '__main__':
+  unittest.main()
diff --git a/sdks/python/apache_beam/ml/rag/embeddings/huggingface.py b/sdks/python/apache_beam/ml/rag/embeddings/huggingface.py
new file mode 100644
index 000000000000..4cb0aecd6e82
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/embeddings/huggingface.py
@@ -0,0 +1,74 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""RAG-specific embedding implementations using HuggingFace models."""
+
+from typing import Optional
+
+import apache_beam as beam
+from apache_beam.ml.inference.base import RunInference
+from apache_beam.ml.rag.embeddings.base import create_rag_adapter
+from apache_beam.ml.rag.types import Chunk
+from apache_beam.ml.transforms.base import EmbeddingsManager
+from apache_beam.ml.transforms.base import _TextEmbeddingHandler
+from apache_beam.ml.transforms.embeddings.huggingface import _SentenceTransformerModelHandler
+
+try:
+  from sentence_transformers import SentenceTransformer
+except ImportError:
+  SentenceTransformer = None
+
+
+class HuggingfaceTextEmbeddings(EmbeddingsManager):
+  def __init__(
+      self, model_name: str, *, max_seq_length: Optional[int] = None, **kwargs):
+    """Utilizes huggingface SentenceTransformer embeddings for RAG pipeline.
+
+        Args:
+            model_name: Name of the sentence-transformers model to use
+            max_seq_length: Maximum sequence length for the model
+            **kwargs: Additional arguments passed to 
+            :class:`~apache_beam.ml.transforms.base.EmbeddingsManager`
+            constructor including ModelHandler arguments
+        """
+    if not SentenceTransformer:
+      raise ImportError(
+          "sentence-transformers is required to use "
+          "HuggingfaceTextEmbeddings."
+          "Please install it with using `pip install sentence-transformers`.")
+    super().__init__(type_adapter=create_rag_adapter(), **kwargs)
+    self.model_name = model_name
+    self.max_seq_length = max_seq_length
+    self.model_class = SentenceTransformer
+
+  def get_model_handler(self):
+    """Returns model handler configured with RAG adapter."""
+    return _SentenceTransformerModelHandler(
+        model_class=self.model_class,
+        max_seq_length=self.max_seq_length,
+        model_name=self.model_name,
+        load_model_args=self.load_model_args,
+        min_batch_size=self.min_batch_size,
+        max_batch_size=self.max_batch_size,
+        large_model=self.large_model)
+
+  def get_ptransform_for_processing(
+      self, **kwargs
+  ) -> beam.PTransform[beam.PCollection[Chunk], beam.PCollection[Chunk]]:
+    """Returns PTransform that uses the RAG adapter."""
+    return RunInference(
+        model_handler=_TextEmbeddingHandler(self),
+        inference_args=self.inference_args).with_output_types(Chunk)
diff --git a/sdks/python/apache_beam/ml/rag/embeddings/huggingface_test.py b/sdks/python/apache_beam/ml/rag/embeddings/huggingface_test.py
new file mode 100644
index 000000000000..aa63d13025a1
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/embeddings/huggingface_test.py
@@ -0,0 +1,108 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Tests for apache_beam.ml.rag.embeddings.huggingface."""
+
+import tempfile
+import unittest
+
+import pytest
+
+import apache_beam as beam
+from apache_beam.ml.rag.embeddings.huggingface import HuggingfaceTextEmbeddings
+from apache_beam.ml.rag.types import Chunk
+from apache_beam.ml.rag.types import Content
+from apache_beam.ml.rag.types import Embedding
+from apache_beam.ml.transforms.base import MLTransform
+from apache_beam.testing.test_pipeline import TestPipeline
+from apache_beam.testing.util import assert_that
+from apache_beam.testing.util import equal_to
+
+# pylint: disable=unused-import
+try:
+  from sentence_transformers import SentenceTransformer
+  SENTENCE_TRANSFORMERS_AVAILABLE = True
+except ImportError:
+  SENTENCE_TRANSFORMERS_AVAILABLE = False
+
+
+def chunk_approximately_equals(expected, actual):
+  """Compare embeddings allowing for numerical differences."""
+  if not isinstance(expected, Chunk) or not isinstance(actual, Chunk):
+    return False
+
+  return (
+      expected.id == actual.id and expected.metadata == actual.metadata and
+      expected.content == actual.content and
+      len(expected.embedding.dense_embedding) == len(
+          actual.embedding.dense_embedding) and
+      all(isinstance(x, float) for x in actual.embedding.dense_embedding))
+
+
+@pytest.mark.uses_transformers
+@unittest.skipIf(
+    not SENTENCE_TRANSFORMERS_AVAILABLE, "sentence-transformers not available")
+class HuggingfaceTextEmbeddingsTest(unittest.TestCase):
+  def setUp(self):
+    self.artifact_location = tempfile.mkdtemp(prefix='sentence_transformers_')
+    self.test_chunks = [
+        Chunk(
+            content=Content(text="This is a test sentence."),
+            id="1",
+            metadata={
+                "source": "test.txt", "language": "en"
+            }),
+        Chunk(
+            content=Content(text="Another example."),
+            id="2",
+            metadata={
+                "source": "test.txt", "language": "en"
+            })
+    ]
+
+  def test_embedding_pipeline(self):
+    expected = [
+        Chunk(
+            id="1",
+            embedding=Embedding(dense_embedding=[0.0] * 384),
+            metadata={
+                "source": "test.txt", "language": "en"
+            },
+            content=Content(text="This is a test sentence.")),
+        Chunk(
+            id="2",
+            embedding=Embedding(dense_embedding=[0.0] * 384),
+            metadata={
+                "source": "test.txt", "language": "en"
+            },
+            content=Content(text="Another example."))
+    ]
+    embedder = HuggingfaceTextEmbeddings(
+        model_name="sentence-transformers/all-MiniLM-L6-v2")
+
+    with TestPipeline() as p:
+      embeddings = (
+          p
+          | beam.Create(self.test_chunks)
+          | MLTransform(write_artifact_location=self.artifact_location).
+          with_transform(embedder))
+
+      assert_that(
+          embeddings, equal_to(expected, equals_fn=chunk_approximately_equals))
+
+
+if __name__ == '__main__':
+  unittest.main()
diff --git a/sdks/python/apache_beam/ml/rag/types.py b/sdks/python/apache_beam/ml/rag/types.py
new file mode 100644
index 000000000000..79429899e4c1
--- /dev/null
+++ b/sdks/python/apache_beam/ml/rag/types.py
@@ -0,0 +1,73 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+"""Core types for RAG pipelines.
+This module contains the core dataclasses used throughout the RAG pipeline
+implementation, including Chunk and Embedding types that define the data
+contracts between different stages of the pipeline.
+"""
+
+import uuid
+from dataclasses import dataclass
+from dataclasses import field
+from typing import Any
+from typing import Dict
+from typing import List
+from typing import Optional
+from typing import Tuple
+
+
+@dataclass
+class Content:
+  """Container for embeddable content. Add new types as when as necessary.
+
+    Args:
+        text: Text content to be embedded
+    """
+  text: Optional[str] = None
+
+
+@dataclass
+class Embedding:
+  """Represents vector embeddings.
+    
+    Args:
+        dense_embedding: Dense vector representation
+        sparse_embedding: Optional sparse vector representation for hybrid
+          search
+    """
+  dense_embedding: Optional[List[float]] = None
+  # For hybrid search
+  sparse_embedding: Optional[Tuple[List[int], List[float]]] = None
+
+
+@dataclass
+class Chunk:
+  """Represents a chunk of embeddable content with metadata.
+    
+    Args:
+        content: The actual content of the chunk
+        id: Unique identifier for the chunk
+        index: Index of this chunk within the original document
+        metadata: Additional metadata about the chunk (e.g., document source)
+        embedding: Vector embeddings of the content 
+    """
+  content: Content
+  id: str = field(default_factory=lambda: str(uuid.uuid4()))
+  index: int = 0
+  metadata: Dict[str, Any] = field(default_factory=dict)
+  embedding: Optional[Embedding] = None
diff --git a/sdks/python/apache_beam/ml/transforms/base.py b/sdks/python/apache_beam/ml/transforms/base.py
index a963f602a06d..57a5efd3ff0e 100644
--- a/sdks/python/apache_beam/ml/transforms/base.py
+++ b/sdks/python/apache_beam/ml/transforms/base.py
@@ -15,18 +15,24 @@
 # limitations under the License.
 
 import abc
-import collections
+import functools
 import logging
 import os
 import tempfile
 import uuid
+from collections.abc import Callable
 from collections.abc import Mapping
 from collections.abc import Sequence
+from dataclasses import dataclass
 from typing import Any
+from typing import Dict
 from typing import Generic
+from typing import Iterable
+from typing import List
 from typing import Optional
 from typing import TypeVar
 from typing import Union
+from typing import cast
 
 import jsonpickle
 import numpy as np
@@ -62,36 +68,31 @@
 # Output of the apply() method of BaseOperation.
 OperationOutputT = TypeVar('OperationOutputT')
 
+# Input to the EmbeddingTypeAdapter input_fn
+EmbeddingTypeAdapterInputT = TypeVar(
+    'EmbeddingTypeAdapterInputT')  # e.g., Chunk
+# Output of the EmbeddingTypeAdapter output_fn
+EmbeddingTypeAdapterOutputT = TypeVar(
+    'EmbeddingTypeAdapterOutputT')  # e.g., Embedding
 
-def _convert_list_of_dicts_to_dict_of_lists(
-    list_of_dicts: Sequence[dict[str, Any]]) -> dict[str, list[Any]]:
-  keys_to_element_list = collections.defaultdict(list)
-  input_keys = list_of_dicts[0].keys()
-  for d in list_of_dicts:
-    if set(d.keys()) != set(input_keys):
-      extra_keys = set(d.keys()) - set(input_keys) if len(
-          d.keys()) > len(input_keys) else set(input_keys) - set(d.keys())
-      raise RuntimeError(
-          f'All the dicts in the input data should have the same keys. '
-          f'Got: {extra_keys} instead.')
-    for key, value in d.items():
-      keys_to_element_list[key].append(value)
-  return keys_to_element_list
-
-
-def _convert_dict_of_lists_to_lists_of_dict(
-    dict_of_lists: dict[str, list[Any]]) -> list[dict[str, Any]]:
-  batch_length = len(next(iter(dict_of_lists.values())))
-  result: list[dict[str, Any]] = [{} for _ in range(batch_length)]
-  # all the values in the dict_of_lists should have same length
-  for key, values in dict_of_lists.items():
-    assert len(values) == batch_length, (
-        "This function expects all the values "
-        "in the dict_of_lists to have same length."
-        )
-    for i in range(len(values)):
-      result[i][key] = values[i]
-  return result
+
+@dataclass
+class EmbeddingTypeAdapter(Generic[EmbeddingTypeAdapterInputT,
+                                   EmbeddingTypeAdapterOutputT]):
+  """Adapts input types to text for embedding and converts output embeddings.
+
+    Args:
+        input_fn: Function to extract text for embedding from input type
+        output_fn: Function to create output type from input and embeddings
+    """
+  input_fn: Callable[[Sequence[EmbeddingTypeAdapterInputT]], List[str]]
+  output_fn: Callable[[Sequence[EmbeddingTypeAdapterInputT], Sequence[Any]],
+                      List[EmbeddingTypeAdapterOutputT]]
+
+  def __reduce__(self):
+    """Custom serialization that preserves type information during
+    jsonpickle."""
+    return (self.__class__, (self.input_fn, self.output_fn))
 
 
 def _map_errors_to_beam_row(element, cls_name=None):
@@ -182,13 +183,74 @@ def append_transform(self, transform: BaseOperation):
     """
 
 
+def _dict_input_fn(columns: Sequence[str],
+                   batch: Sequence[Dict[str, Any]]) -> List[str]:
+  """Extract text from specified columns in batch."""
+  if not batch or not isinstance(batch[0], dict):
+    raise TypeError(
+        'Expected data to be dicts, got '
+        f'{type(batch[0])} instead.')
+
+  result = []
+  expected_keys = set(batch[0].keys())
+  expected_columns = set(columns)
+  # Process one batch item at a time
+  for item in batch:
+    item_keys = item.keys()
+    if set(item_keys) != expected_keys:
+      extra_keys = item_keys - expected_keys
+      missing_keys = expected_keys - item_keys
+      raise RuntimeError(
+          f'All dicts in batch must have the same keys. '
+          f'extra keys: {extra_keys}, '
+          f'missing keys: {missing_keys}')
+    missing_columns = expected_columns - item_keys
+    if (missing_columns):
+      raise RuntimeError(
+          f'Data does not contain the following columns '
+          f': {missing_columns}.')
+
+    # Get all columns for this item
+    for col in columns:
+      result.append(item[col])
+  return result
+
+
+def _dict_output_fn(
+    columns: Sequence[str],
+    batch: Sequence[Dict[str, Any]],
+    embeddings: Sequence[Any]) -> List[Dict[str, Any]]:
+  """Map embeddings back to columns in batch."""
+  result = []
+  for batch_idx, item in enumerate(batch):
+    for col_idx, col in enumerate(columns):
+      embedding_idx = batch_idx * len(columns) + col_idx
+      item[col] = embeddings[embedding_idx]
+    result.append(item)
+  return result
+
+
+def _create_dict_adapter(
+    columns: List[str]) -> EmbeddingTypeAdapter[Dict[str, Any], Dict[str, Any]]:
+  """Create adapter for dict-based processing."""
+  return EmbeddingTypeAdapter[Dict[str, Any], Dict[str, Any]](
+      input_fn=cast(
+          Callable[[Sequence[Dict[str, Any]]], List[str]],
+          functools.partial(_dict_input_fn, columns)),
+      output_fn=cast(
+          Callable[[Sequence[Dict[str, Any]], Sequence[Any]],
+                   List[Dict[str, Any]]],
+          functools.partial(_dict_output_fn, columns)))
+
+
 # TODO:https://github.com/apache/beam/issues/29356
 #  Add support for inference_fn
 class EmbeddingsManager(MLTransformProvider):
   def __init__(
       self,
-      columns: list[str],
       *,
+      columns: Optional[list[str]] = None,
+      type_adapter: Optional[EmbeddingTypeAdapter] = None,
       # common args for all ModelHandlers.
       load_model_args: Optional[dict[str, Any]] = None,
       min_batch_size: Optional[int] = None,
@@ -200,6 +262,12 @@ def __init__(
     self.max_batch_size = max_batch_size
     self.large_model = large_model
     self.columns = columns
+    if columns is not None:
+      self.type_adapter = _create_dict_adapter(columns)
+    elif type_adapter is not None:
+      self.type_adapter = type_adapter
+    else:
+      raise ValueError("Either columns or type_adapter must be specified")
     self.inference_args = kwargs.pop('inference_args', {})
 
     if kwargs:
@@ -616,38 +684,6 @@ def load_model(self):
   def _validate_column_data(self, batch):
     pass
 
-  def _validate_batch(self, batch: Sequence[dict[str, Any]]):
-    if not batch or not isinstance(batch[0], dict):
-      raise TypeError(
-          'Expected data to be dicts, got '
-          f'{type(batch[0])} instead.')
-
-  def _process_batch(
-      self,
-      dict_batch: dict[str, list[Any]],
-      model: ModelT,
-      inference_args: Optional[dict[str, Any]]) -> dict[str, list[Any]]:
-    result: dict[str, list[Any]] = collections.defaultdict(list)
-    input_keys = dict_batch.keys()
-    missing_columns_in_data = set(self.columns) - set(input_keys)
-    if missing_columns_in_data:
-      raise RuntimeError(
-          f'Data does not contain the following columns '
-          f': {missing_columns_in_data}.')
-    for key, batch in dict_batch.items():
-      if key in self.columns:
-        self._validate_column_data(batch)
-        prediction = self._underlying.run_inference(
-            batch, model, inference_args)
-        if isinstance(prediction, np.ndarray):
-          prediction = prediction.tolist()
-          result[key] = prediction  # type: ignore[assignment]
-        else:
-          result[key] = prediction  # type: ignore[assignment]
-      else:
-        result[key] = batch
-    return result
-
   def run_inference(
       self,
       batch: Sequence[dict[str, list[str]]],
@@ -659,12 +695,19 @@ def run_inference(
     a list of dicts. Each dict should have the same keys, and the shape
     should be of the same size for a single key across the batch.
     """
-    self._validate_batch(batch)
-    dict_batch = _convert_list_of_dicts_to_dict_of_lists(list_of_dicts=batch)
-    transformed_batch = self._process_batch(dict_batch, model, inference_args)
-    return _convert_dict_of_lists_to_lists_of_dict(
-        dict_of_lists=transformed_batch,
-    )
+    embedding_input = self.embedding_config.type_adapter.input_fn(batch)
+    self._validate_column_data(batch=embedding_input)
+    prediction = self._underlying.run_inference(
+        embedding_input, model, inference_args)
+    # Convert prediction to Sequence[Any]
+    if isinstance(prediction, np.ndarray):
+      prediction_seq = prediction.tolist()
+    elif isinstance(prediction, Iterable) and not isinstance(prediction,
+                                                             (str, bytes)):
+      prediction_seq = list(prediction)
+    else:
+      prediction_seq = [prediction]
+    return self.embedding_config.type_adapter.output_fn(batch, prediction_seq)
 
   def get_metrics_namespace(self) -> str:
     return (
diff --git a/sdks/python/apache_beam/ml/transforms/base_test.py b/sdks/python/apache_beam/ml/transforms/base_test.py
index 3db5a63b9542..1ef01acca18a 100644
--- a/sdks/python/apache_beam/ml/transforms/base_test.py
+++ b/sdks/python/apache_beam/ml/transforms/base_test.py
@@ -78,6 +78,10 @@ def setUp(self) -> None:
   def tearDown(self):
     shutil.rmtree(self.artifact_location)
 
+  def test_ml_transform_no_read_or_write_artifact_lcoation(self):
+    with self.assertRaises(ValueError):
+      _ = base.MLTransform(transforms=[])
+
   @unittest.skipIf(tft is None, 'tft module is not installed.')
   def test_ml_transform_appends_transforms_to_process_handler_correctly(self):
     fake_fn_1 = _FakeOperation(name='fake_fn_1', columns=['x'])
@@ -354,6 +358,21 @@ def __repr__(self):
     return 'FakeEmbeddingsManager'
 
 
+class InvalidEmbeddingsManager(base.EmbeddingsManager):
+  def __init__(self, **kwargs):
+    super().__init__(**kwargs)
+
+  def get_model_handler(self) -> ModelHandler:
+    InvalidEmbeddingsManager.__repr__ = lambda x: 'InvalidEmbeddingsManager'  # type: ignore[method-assign]
+    return FakeModelHandler()
+
+  def get_ptransform_for_processing(self, **kwargs) -> beam.PTransform:
+    return (RunInference(model_handler=base._TextEmbeddingHandler(self)))
+
+  def __repr__(self):
+    return 'InvalidEmbeddingsManager'
+
+
 class TextEmbeddingHandlerTest(unittest.TestCase):
   def setUp(self) -> None:
     self.embedding_conig = FakeEmbeddingsManager(columns=['x'])
@@ -362,6 +381,10 @@ def setUp(self) -> None:
   def tearDown(self) -> None:
     shutil.rmtree(self.artifact_location)
 
+  def test_no_columns_or_type_adapter(self):
+    with self.assertRaises(ValueError):
+      _ = InvalidEmbeddingsManager()
+
   def test_handler_with_incompatible_datatype(self):
     text_handler = base._TextEmbeddingHandler(
         embeddings_manager=self.embedding_conig)
@@ -430,9 +453,9 @@ def test_handler_on_multiple_columns(self):
             'x': "Apache Beam", 'y': "Hello world", 'z': 'unchanged'
         },
     ]
-    self.embedding_conig.columns = ['x', 'y']
+    embedding_config = FakeEmbeddingsManager(columns=['x', 'y'])
     expected_data = [{
-        key: (value[::-1] if key in self.embedding_conig.columns else value)
+        key: (value[::-1] if key in embedding_config.columns else value)
         for key,
         value in d.items()
     } for d in data]
@@ -440,9 +463,8 @@ def test_handler_on_multiple_columns(self):
       result = (
           p
           | beam.Create(data)
-          | base.MLTransform(
-              write_artifact_location=self.artifact_location).with_transform(
-                  self.embedding_conig))
+          | base.MLTransform(write_artifact_location=self.artifact_location).
+          with_transform(embedding_config))
       assert_that(
           result,
           equal_to(expected_data),
@@ -457,16 +479,15 @@ def test_handler_on_columns_not_exist_in_input_data(self):
             'x': "Apache Beam", 'y': "Hello world"
         },
     ]
-    self.embedding_conig.columns = ['x', 'y', 'a']
+    embedding_config = FakeEmbeddingsManager(columns=['x', 'y', 'a'])
 
     with self.assertRaises(RuntimeError):
       with beam.Pipeline() as p:
         _ = (
             p
             | beam.Create(data)
-            | base.MLTransform(
-                write_artifact_location=self.artifact_location).with_transform(
-                    self.embedding_conig))
+            | base.MLTransform(write_artifact_location=self.artifact_location).
+            with_transform(embedding_config))
 
   def test_handler_with_list_data(self):
     data = [{
@@ -550,7 +571,7 @@ def tearDown(self) -> None:
     shutil.rmtree(self.artifact_location)
 
   @unittest.skipIf(PIL is None, 'PIL module is not installed.')
-  def test_handler_with_incompatible_datatype(self):
+  def test_handler_with_non_dict_datatype(self):
     image_handler = base._ImageEmbeddingHandler(
         embeddings_manager=self.embedding_config)
     data = [
@@ -561,6 +582,24 @@ def test_handler_with_incompatible_datatype(self):
     with self.assertRaises(TypeError):
       image_handler.run_inference(data, None, None)
 
+  @unittest.skipIf(PIL is None, 'PIL module is not installed.')
+  def test_handler_with_non_image_datatype(self):
+    image_handler = base._ImageEmbeddingHandler(
+        embeddings_manager=self.embedding_config)
+    data = [
+        {
+            'x': 'hi there'
+        },
+        {
+            'x': 'not an image'
+        },
+        {
+            'x': 'image_path.jpg'
+        },
+    ]
+    with self.assertRaises(TypeError):
+      image_handler.run_inference(data, None, None)
+
   @unittest.skipIf(PIL is None, 'PIL module is not installed.')
   def test_handler_with_dict_inputs(self):
     img_one = PIL.Image.new(mode='RGB', size=(1, 1))
@@ -588,31 +627,37 @@ def test_handler_with_dict_inputs(self):
 
 
 class TestUtilFunctions(unittest.TestCase):
-  def test_list_of_dicts_to_dict_of_lists_normal(self):
+  def test_dict_input_fn_normal(self):
+    input_list = [{'a': 1, 'b': 2}, {'a': 3, 'b': 4}]
+    columns = ['a', 'b']
+
+    expected_output = [1, 2, 3, 4]
+    self.assertEqual(base._dict_input_fn(columns, input_list), expected_output)
+
+  def test_dict_output_fn_normal(self):
     input_list = [{'a': 1, 'b': 2}, {'a': 3, 'b': 4}]
-    expected_output = {'a': [1, 3], 'b': [2, 4]}
+    columns = ['a', 'b']
+    embeddings = [1.1, 2.2, 3.3, 4.4]
+
+    expected_output = [{'a': 1.1, 'b': 2.2}, {'a': 3.3, 'b': 4.4}]
     self.assertEqual(
-        base._convert_list_of_dicts_to_dict_of_lists(input_list),
-        expected_output)
+        base._dict_output_fn(columns, input_list, embeddings), expected_output)
 
-  def test_list_of_dicts_to_dict_of_lists_on_list_inputs(self):
+  def test_dict_input_fn_on_list_inputs(self):
     input_list = [{'a': [1, 2, 10], 'b': 3}, {'a': [1], 'b': 5}]
-    expected_output = {'a': [[1, 2, 10], [1]], 'b': [3, 5]}
-    self.assertEqual(
-        base._convert_list_of_dicts_to_dict_of_lists(input_list),
-        expected_output)
+    columns = ['a', 'b']
 
-  def test_dict_of_lists_to_lists_of_dict_normal(self):
-    input_dict = {'a': [1, 3], 'b': [2, 4]}
-    expected_output = [{'a': 1, 'b': 2}, {'a': 3, 'b': 4}]
-    self.assertEqual(
-        base._convert_dict_of_lists_to_lists_of_dict(input_dict),
-        expected_output)
+    expected_output = [[1, 2, 10], 3, [1], 5]
+    self.assertEqual(base._dict_input_fn(columns, input_list), expected_output)
 
-  def test_dict_of_lists_to_lists_of_dict_unequal_length(self):
-    input_dict = {'a': [1, 3], 'b': [2]}
-    with self.assertRaises(AssertionError):
-      base._convert_dict_of_lists_to_lists_of_dict(input_dict)
+  def test_dict_output_fn_on_list_inputs(self):
+    input_list = [{'a': [1, 2, 10], 'b': 3}, {'a': [1], 'b': 5}]
+    columns = ['a', 'b']
+    embeddings = [1.1, 2.2, 3.3, 4.4]
+
+    expected_output = [{'a': 1.1, 'b': 2.2}, {'a': 3.3, 'b': 4.4}]
+    self.assertEqual(
+        base._dict_output_fn(columns, input_list, embeddings), expected_output)
 
 
 class TestJsonPickleTransformAttributeManager(unittest.TestCase):
diff --git a/sdks/python/apache_beam/ml/transforms/embeddings/huggingface.py b/sdks/python/apache_beam/ml/transforms/embeddings/huggingface.py
index 2162ed050c42..e492cb164222 100644
--- a/sdks/python/apache_beam/ml/transforms/embeddings/huggingface.py
+++ b/sdks/python/apache_beam/ml/transforms/embeddings/huggingface.py
@@ -133,7 +133,7 @@ def __init__(
       max_batch_size: The maximum batch size to be used for inference.
       large_model: Whether to share the model across processes.
     """
-    super().__init__(columns, **kwargs)
+    super().__init__(columns=columns, **kwargs)
     self.model_name = model_name
     self.max_seq_length = max_seq_length
     self.image_model = image_model
@@ -219,7 +219,7 @@ def __init__(
       api_url: Optional[str] = None,
       **kwargs,
       ):
-    super().__init__(columns, **kwargs)
+    super().__init__(columns=columns, **kwargs)
     self._authorization_token = {"Authorization": f"Bearer {hf_token}"}
     self._model_name = model_name
     self.hf_token = hf_token

From d34409e27c42d1ac16d4f2912e436195147f17bb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 17 Dec 2024 10:37:50 -0500
Subject: [PATCH 126/135] Bump google.golang.org/api from 0.211.0 to 0.212.0 in
 /sdks (#33398)

Bumps [google.golang.org/api](https://github.com/googleapis/google-api-go-client) from 0.211.0 to 0.212.0.
- [Release notes](https://github.com/googleapis/google-api-go-client/releases)
- [Changelog](https://github.com/googleapis/google-api-go-client/blob/main/CHANGES.md)
- [Commits](https://github.com/googleapis/google-api-go-client/compare/v0.211.0...v0.212.0)

---
updated-dependencies:
- dependency-name: google.golang.org/api
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 sdks/go.mod |  6 +++---
 sdks/go.sum | 12 ++++++------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/sdks/go.mod b/sdks/go.mod
index d0f607bd2abf..ffe9d942f799 100644
--- a/sdks/go.mod
+++ b/sdks/go.mod
@@ -58,7 +58,7 @@ require (
 	golang.org/x/sync v0.10.0
 	golang.org/x/sys v0.28.0
 	golang.org/x/text v0.21.0
-	google.golang.org/api v0.211.0
+	google.golang.org/api v0.212.0
 	google.golang.org/genproto v0.0.0-20241118233622-e639e219e697
 	google.golang.org/grpc v1.67.2
 	google.golang.org/protobuf v1.36.0
@@ -75,7 +75,7 @@ require (
 
 require (
 	cel.dev/expr v0.16.1 // indirect
-	cloud.google.com/go/auth v0.12.1 // indirect
+	cloud.google.com/go/auth v0.13.0 // indirect
 	cloud.google.com/go/auth/oauth2adapt v0.2.6 // indirect
 	cloud.google.com/go/monitoring v1.21.2 // indirect
 	dario.cat/mergo v1.0.0 // indirect
@@ -123,7 +123,7 @@ require (
 
 require (
 	cloud.google.com/go v0.116.0 // indirect
-	cloud.google.com/go/compute/metadata v0.5.2 // indirect
+	cloud.google.com/go/compute/metadata v0.6.0 // indirect
 	cloud.google.com/go/iam v1.2.2 // indirect
 	cloud.google.com/go/longrunning v0.6.2 // indirect
 	github.com/Azure/go-ansiterm v0.0.0-20210617225240-d185dfc1b5a1 // indirect
diff --git a/sdks/go.sum b/sdks/go.sum
index d4679497e21a..a32b86613ba7 100644
--- a/sdks/go.sum
+++ b/sdks/go.sum
@@ -101,8 +101,8 @@ cloud.google.com/go/assuredworkloads v1.7.0/go.mod h1:z/736/oNmtGAyU47reJgGN+KVo
 cloud.google.com/go/assuredworkloads v1.8.0/go.mod h1:AsX2cqyNCOvEQC8RMPnoc0yEarXQk6WEKkxYfL6kGIo=
 cloud.google.com/go/assuredworkloads v1.9.0/go.mod h1:kFuI1P78bplYtT77Tb1hi0FMxM0vVpRC7VVoJC3ZoT0=
 cloud.google.com/go/assuredworkloads v1.10.0/go.mod h1:kwdUQuXcedVdsIaKgKTp9t0UJkE5+PAVNhdQm4ZVq2E=
-cloud.google.com/go/auth v0.12.1 h1:n2Bj25BUMM0nvE9D2XLTiImanwZhO3DkfWSYS/SAJP4=
-cloud.google.com/go/auth v0.12.1/go.mod h1:BFMu+TNpF3DmvfBO9ClqTR/SiqVIm7LukKF9mbendF4=
+cloud.google.com/go/auth v0.13.0 h1:8Fu8TZy167JkW8Tj3q7dIkr2v4cndv41ouecJx0PAHs=
+cloud.google.com/go/auth v0.13.0/go.mod h1:COOjD9gwfKNKz+IIduatIhYJQIc0mG3H102r/EMxX6Q=
 cloud.google.com/go/auth/oauth2adapt v0.2.6 h1:V6a6XDu2lTwPZWOawrAa9HUK+DB2zfJyTuciBG5hFkU=
 cloud.google.com/go/auth/oauth2adapt v0.2.6/go.mod h1:AlmsELtlEBnaNTL7jCj8VQFLy6mbZv0s4Q7NGBeQ5E8=
 cloud.google.com/go/automl v1.5.0/go.mod h1:34EjfoFGMZ5sgJ9EoLsRtdPSNZLcfflJR39VbVNS2M0=
@@ -188,8 +188,8 @@ cloud.google.com/go/compute/metadata v0.1.0/go.mod h1:Z1VN+bulIf6bt4P/C37K4DyZYZ
 cloud.google.com/go/compute/metadata v0.2.0/go.mod h1:zFmK7XCadkQkj6TtorcaGlCW1hT1fIilQDwofLpJ20k=
 cloud.google.com/go/compute/metadata v0.2.1/go.mod h1:jgHgmJd2RKBGzXqF5LR2EZMGxBkeanZ9wwa75XHJgOM=
 cloud.google.com/go/compute/metadata v0.2.3/go.mod h1:VAV5nSsACxMJvgaAuX6Pk2AawlZn8kiOGuCv6gTkwuA=
-cloud.google.com/go/compute/metadata v0.5.2 h1:UxK4uu/Tn+I3p2dYWTfiX4wva7aYlKixAHn3fyqngqo=
-cloud.google.com/go/compute/metadata v0.5.2/go.mod h1:C66sj2AluDcIqakBq/M8lw8/ybHgOZqin2obFxa/E5k=
+cloud.google.com/go/compute/metadata v0.6.0 h1:A6hENjEsCDtC1k8byVsgwvVcioamEHvZ4j01OwKxG9I=
+cloud.google.com/go/compute/metadata v0.6.0/go.mod h1:FjyFAW1MW0C203CEOMDTu3Dk1FlqW3Rga40jzHL4hfg=
 cloud.google.com/go/contactcenterinsights v1.3.0/go.mod h1:Eu2oemoePuEFc/xKFPjbTuPSj0fYJcPls9TFlPNnHHY=
 cloud.google.com/go/contactcenterinsights v1.4.0/go.mod h1:L2YzkGbPsv+vMQMCADxJoT9YiTTnSEd6fEvCeHTYVck=
 cloud.google.com/go/contactcenterinsights v1.6.0/go.mod h1:IIDlT6CLcDoyv79kDv8iWxMSTZhLxSCofVV5W6YFM/w=
@@ -1707,8 +1707,8 @@ google.golang.org/api v0.108.0/go.mod h1:2Ts0XTHNVWxypznxWOYUeI4g3WdP9Pk2Qk58+a/
 google.golang.org/api v0.110.0/go.mod h1:7FC4Vvx1Mooxh8C5HWjzZHcavuS2f6pmJpZx60ca7iI=
 google.golang.org/api v0.111.0/go.mod h1:qtFHvU9mhgTJegR31csQ+rwxyUTHOKFqCKWp1J0fdw0=
 google.golang.org/api v0.114.0/go.mod h1:ifYI2ZsFK6/uGddGfAD5BMxlnkBqCmqHSDUVi45N5Yg=
-google.golang.org/api v0.211.0 h1:IUpLjq09jxBSV1lACO33CGY3jsRcbctfGzhj+ZSE/Bg=
-google.golang.org/api v0.211.0/go.mod h1:XOloB4MXFH4UTlQSGuNUxw0UT74qdENK8d6JNsXKLi0=
+google.golang.org/api v0.212.0 h1:BcRj3MJfHF3FYD29rk7u9kuu1SyfGqfHcA0hSwKqkHg=
+google.golang.org/api v0.212.0/go.mod h1:gICpLlpp12/E8mycRMzgy3SQ9cFh2XnVJ6vJi/kQbvI=
 google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM=
 google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4=
 google.golang.org/appengine v1.5.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4=

From f7a7bddb3bad80275e59591d8444e68b61ece760 Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Tue, 17 Dec 2024 08:43:35 -0800
Subject: [PATCH 127/135] Faster default coder for unknown windows. (#33382)

This will get used in a windowed reshuffle, among other places.
---
 sdks/python/apache_beam/coders/coder_impl.pxd | 12 ++++++
 sdks/python/apache_beam/coders/coder_impl.py  | 31 +++++++++++++++
 sdks/python/apache_beam/coders/coders.py      | 38 ++++++++++++++++++-
 .../apache_beam/coders/coders_test_common.py  |  8 ++++
 4 files changed, 88 insertions(+), 1 deletion(-)

diff --git a/sdks/python/apache_beam/coders/coder_impl.pxd b/sdks/python/apache_beam/coders/coder_impl.pxd
index 52889fa2fd92..8a28499555c1 100644
--- a/sdks/python/apache_beam/coders/coder_impl.pxd
+++ b/sdks/python/apache_beam/coders/coder_impl.pxd
@@ -219,6 +219,18 @@ cdef libc.stdint.int64_t MIN_TIMESTAMP_micros
 cdef libc.stdint.int64_t MAX_TIMESTAMP_micros
 
 
+cdef class _OrderedUnionCoderImpl(StreamCoderImpl):
+  cdef tuple _types
+  cdef tuple _coder_impls
+  cdef CoderImpl _fallback_coder_impl
+
+  @cython.locals(ix=int, c=CoderImpl)
+  cpdef encode_to_stream(self, value, OutputStream stream, bint nested)
+
+  @cython.locals(ix=int, c=CoderImpl)
+  cpdef decode_from_stream(self, InputStream stream, bint nested)
+
+
 cdef class WindowedValueCoderImpl(StreamCoderImpl):
   """A coder for windowed values."""
   cdef CoderImpl _value_coder
diff --git a/sdks/python/apache_beam/coders/coder_impl.py b/sdks/python/apache_beam/coders/coder_impl.py
index 5262e6adf8a6..5dff35052901 100644
--- a/sdks/python/apache_beam/coders/coder_impl.py
+++ b/sdks/python/apache_beam/coders/coder_impl.py
@@ -1421,6 +1421,37 @@ def estimate_size(self, value, nested=False):
     return size
 
 
+class _OrderedUnionCoderImpl(StreamCoderImpl):
+  def __init__(self, coder_impl_types, fallback_coder_impl):
+    assert len(coder_impl_types) < 128
+    self._types, self._coder_impls = zip(*coder_impl_types)
+    self._fallback_coder_impl = fallback_coder_impl
+
+  def encode_to_stream(self, value, out, nested):
+    value_t = type(value)
+    for (ix, t) in enumerate(self._types):
+      if value_t is t:
+        out.write_byte(ix)
+        c = self._coder_impls[ix]  # for typing
+        c.encode_to_stream(value, out, nested)
+        break
+    else:
+      if self._fallback_coder_impl is None:
+        raise ValueError("No fallback.")
+      out.write_byte(0xFF)
+      self._fallback_coder_impl.encode_to_stream(value, out, nested)
+
+  def decode_from_stream(self, in_stream, nested):
+    ix = in_stream.read_byte()
+    if ix == 0xFF:
+      if self._fallback_coder_impl is None:
+        raise ValueError("No fallback.")
+      return self._fallback_coder_impl.decode_from_stream(in_stream, nested)
+    else:
+      c = self._coder_impls[ix]  # for typing
+      return c.decode_from_stream(in_stream, nested)
+
+
 class WindowedValueCoderImpl(StreamCoderImpl):
   """For internal use only; no backwards-compatibility guarantees.
 
diff --git a/sdks/python/apache_beam/coders/coders.py b/sdks/python/apache_beam/coders/coders.py
index 724f268a8312..e52c6048a15c 100644
--- a/sdks/python/apache_beam/coders/coders.py
+++ b/sdks/python/apache_beam/coders/coders.py
@@ -1350,12 +1350,48 @@ def __hash__(self):
     common_urns.coders.INTERVAL_WINDOW.urn, IntervalWindowCoder)
 
 
+class _OrderedUnionCoder(FastCoder):
+  def __init__(
+      self, *coder_types: Tuple[type, Coder], fallback_coder: Optional[Coder]):
+    self._coder_types = coder_types
+    self._fallback_coder = fallback_coder
+
+  def _create_impl(self):
+    return coder_impl._OrderedUnionCoderImpl(
+        [(t, c.get_impl()) for t, c in self._coder_types],
+        fallback_coder_impl=self._fallback_coder.get_impl()
+        if self._fallback_coder else None)
+
+  def is_deterministic(self) -> bool:
+    return (
+        all(c.is_deterministic for _, c in self._coder_types) and (
+            self._fallback_coder is None or
+            self._fallback_coder.is_deterministic()))
+
+  def to_type_hint(self):
+    return Any
+
+  def __eq__(self, other):
+    return (
+        type(self) == type(other) and
+        self._coder_types == other._coder_types and
+        self._fallback_coder == other._fallback_coder)
+
+  def __hash__(self):
+    return hash((type(self), tuple(self._coder_types), self._fallback_coder))
+
+
 class WindowedValueCoder(FastCoder):
   """Coder for windowed values."""
   def __init__(self, wrapped_value_coder, window_coder=None):
     # type: (Coder, Optional[Coder]) -> None
     if not window_coder:
-      window_coder = PickleCoder()
+      # Avoid circular imports.
+      from apache_beam.transforms import window
+      window_coder = _OrderedUnionCoder(
+          (window.GlobalWindow, GlobalWindowCoder()),
+          (window.IntervalWindow, IntervalWindowCoder()),
+          fallback_coder=PickleCoder())
     self.wrapped_value_coder = wrapped_value_coder
     self.timestamp_coder = TimestampCoder()
     self.window_coder = window_coder
diff --git a/sdks/python/apache_beam/coders/coders_test_common.py b/sdks/python/apache_beam/coders/coders_test_common.py
index 4bd9698dd57b..f3381cdb1d69 100644
--- a/sdks/python/apache_beam/coders/coders_test_common.py
+++ b/sdks/python/apache_beam/coders/coders_test_common.py
@@ -769,6 +769,14 @@ def test_decimal_coder(self):
           test_encodings[idx],
           base64.b64encode(test_coder.encode(value)).decode().rstrip("="))
 
+  def test_OrderedUnionCoder(self):
+    test_coder = coders._OrderedUnionCoder((str, coders.StrUtf8Coder()),
+                                           (int, coders.VarIntCoder()),
+                                           fallback_coder=coders.FloatCoder())
+    self.check_coder(test_coder, 's')
+    self.check_coder(test_coder, 123)
+    self.check_coder(test_coder, 1.5)
+
 
 if __name__ == '__main__':
   logging.getLogger().setLevel(logging.INFO)

From e50a136219e3b5f45467d173ff29e4a22ec499de Mon Sep 17 00:00:00 2001
From: Ahmed Abualsaud <65791736+ahmedabu98@users.noreply.github.com>
Date: Tue, 17 Dec 2024 13:10:01 -0500
Subject: [PATCH 128/135] Support creating BigLake managed tables (#33125)

* create managed biglake tables

* add to translation

* add to changes.md

* adjust changes description
---
 CHANGES.md                                    |  1 +
 .../beam/sdk/io/gcp/bigquery/BigQueryIO.java  | 50 +++++++++++-
 .../gcp/bigquery/BigQueryIOTranslation.java   |  8 ++
 .../io/gcp/bigquery/CreateTableHelpers.java   | 32 +++++++-
 .../sdk/io/gcp/bigquery/CreateTables.java     |  3 +-
 .../sdk/io/gcp/bigquery/StorageApiLoads.java  | 13 ++-
 .../StorageApiWriteRecordsInconsistent.java   |  9 ++-
 .../StorageApiWriteUnshardedRecords.java      | 16 +++-
 .../StorageApiWritesShardedRecords.java       |  8 +-
 .../bigquery/BigQueryIOTranslationTest.java   |  1 +
 .../io/gcp/bigquery/BigQueryIOWriteTest.java  | 34 ++++++++
 .../StorageApiSinkCreateIfNeededIT.java       | 80 ++++++++++++++++---
 12 files changed, 226 insertions(+), 29 deletions(-)

diff --git a/CHANGES.md b/CHANGES.md
index 0cfac6c73c1e..7a8ed493c216 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -66,6 +66,7 @@
 * gcs-connector config options can be set via GcsOptions (Java) ([#32769](https://github.com/apache/beam/pull/32769)).
 * Support for X source added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
 * Upgraded the default version of Hadoop dependencies to 3.4.1. Hadoop 2.10.2 is still supported (Java) ([#33011](https://github.com/apache/beam/issues/33011)).
+* [BigQueryIO] Create managed BigLake tables dynamically ([#33125](https://github.com/apache/beam/pull/33125))
 
 ## New Features / Improvements
 
diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java
index 9a7f3a05556c..30626da31c7c 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java
@@ -54,6 +54,7 @@
 import java.io.IOException;
 import java.io.Serializable;
 import java.lang.reflect.InvocationTargetException;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
 import java.util.Map;
@@ -629,6 +630,9 @@ public class BigQueryIO {
   private static final SerializableFunction<TableSchema, org.apache.avro.Schema>
       DEFAULT_AVRO_SCHEMA_FACTORY = BigQueryAvroUtils::toGenericAvroSchema;
 
+  static final String CONNECTION_ID = "connectionId";
+  static final String STORAGE_URI = "storageUri";
+
   /**
    * @deprecated Use {@link #read(SerializableFunction)} or {@link #readTableRows} instead. {@link
    *     #readTableRows()} does exactly the same as {@link #read}, however {@link
@@ -2372,6 +2376,8 @@ public enum Method {
     /** Table description. Default is empty. */
     abstract @Nullable String getTableDescription();
 
+    abstract @Nullable Map<String, String> getBigLakeConfiguration();
+
     /** An option to indicate if table validation is desired. Default is true. */
     abstract boolean getValidate();
 
@@ -2484,6 +2490,8 @@ abstract Builder<T> setAvroSchemaFactory(
 
       abstract Builder<T> setTableDescription(String tableDescription);
 
+      abstract Builder<T> setBigLakeConfiguration(Map<String, String> bigLakeConfiguration);
+
       abstract Builder<T> setValidate(boolean validate);
 
       abstract Builder<T> setBigQueryServices(BigQueryServices bigQueryServices);
@@ -2909,6 +2917,30 @@ public Write<T> withTableDescription(String tableDescription) {
       return toBuilder().setTableDescription(tableDescription).build();
     }
 
+    /**
+     * Specifies a configuration to create BigLake tables. The following options are available:
+     *
+     * <ul>
+     *   <li>connectionId (REQUIRED): the name of your cloud resource connection.
+     *   <li>storageUri (REQUIRED): the path to your GCS folder where data will be written to. This
+     *       sink will create sub-folders for each project, dataset, and table destination. Example:
+     *       if you specify a storageUri of {@code "gs://foo/bar"} and writing to table {@code
+     *       "my_project.my_dataset.my_table"}, your data will be written under {@code
+     *       "gs://foo/bar/my_project/my_dataset/my_table/"}
+     *   <li>fileFormat (OPTIONAL): defaults to {@code "parquet"}
+     *   <li>tableFormat (OPTIONAL): defaults to {@code "iceberg"}
+     * </ul>
+     *
+     * <p><b>NOTE:</b> This is only supported with the Storage Write API methods.
+     *
+     * @see <a href="https://cloud.google.com/bigquery/docs/iceberg-tables#api">BigQuery Tables for
+     *     Apache Iceberg documentation</a>
+     */
+    public Write<T> withBigLakeConfiguration(Map<String, String> bigLakeConfiguration) {
+      checkArgument(bigLakeConfiguration != null, "bigLakeConfiguration can not be null");
+      return toBuilder().setBigLakeConfiguration(bigLakeConfiguration).build();
+    }
+
     /**
      * Specifies a policy for handling failed inserts.
      *
@@ -3454,8 +3486,21 @@ && getStorageApiTriggeringFrequency(bqOptions) != null) {
         checkArgument(
             !getAutoSchemaUpdate(),
             "withAutoSchemaUpdate only supported when using STORAGE_WRITE_API or STORAGE_API_AT_LEAST_ONCE.");
-      } else if (getWriteDisposition() == WriteDisposition.WRITE_TRUNCATE) {
-        LOG.error("The Storage API sink does not support the WRITE_TRUNCATE write disposition.");
+        checkArgument(
+            getBigLakeConfiguration() == null,
+            "bigLakeConfiguration is only supported when using STORAGE_WRITE_API or STORAGE_API_AT_LEAST_ONCE.");
+      } else {
+        if (getWriteDisposition() == WriteDisposition.WRITE_TRUNCATE) {
+          LOG.error("The Storage API sink does not support the WRITE_TRUNCATE write disposition.");
+        }
+        if (getBigLakeConfiguration() != null) {
+          checkArgument(
+              Arrays.stream(new String[] {CONNECTION_ID, STORAGE_URI})
+                  .allMatch(getBigLakeConfiguration()::containsKey),
+              String.format(
+                  "bigLakeConfiguration must contain keys '%s' and '%s'",
+                  CONNECTION_ID, STORAGE_URI));
+        }
       }
       if (getRowMutationInformationFn() != null) {
         checkArgument(
@@ -3905,6 +3950,7 @@ private <DestinationT> WriteResult continueExpandTyped(
                 getPropagateSuccessfulStorageApiWritesPredicate(),
                 getRowMutationInformationFn() != null,
                 getDefaultMissingValueInterpretation(),
+                getBigLakeConfiguration(),
                 getBadRecordRouter(),
                 getBadRecordErrorHandler());
         return input.apply("StorageApiLoads", storageApiLoads);
diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOTranslation.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOTranslation.java
index 561f5ccfc457..1da47156dda7 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOTranslation.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOTranslation.java
@@ -393,6 +393,7 @@ static class BigQueryIOWriteTranslator implements TransformPayloadTranslator<Wri
             .addNullableByteArrayField("write_disposition")
             .addNullableArrayField("schema_update_options", FieldType.BYTES)
             .addNullableStringField("table_description")
+            .addNullableMapField("biglake_configuration", FieldType.STRING, FieldType.STRING)
             .addNullableBooleanField("validate")
             .addNullableByteArrayField("bigquery_services")
             .addNullableInt32Field("max_files_per_bundle")
@@ -510,6 +511,9 @@ public Row toConfigRow(Write<?> transform) {
       if (transform.getTableDescription() != null) {
         fieldValues.put("table_description", transform.getTableDescription());
       }
+      if (transform.getBigLakeConfiguration() != null) {
+        fieldValues.put("biglake_configuration", transform.getBigLakeConfiguration());
+      }
       fieldValues.put("validate", transform.getValidate());
       if (transform.getBigQueryServices() != null) {
         fieldValues.put("bigquery_services", toByteArray(transform.getBigQueryServices()));
@@ -719,6 +723,10 @@ public Write<?> fromConfigRow(Row configRow, PipelineOptions options) {
         if (tableDescription != null) {
           builder = builder.setTableDescription(tableDescription);
         }
+        Map<String, String> biglakeConfiguration = configRow.getMap("biglake_configuration");
+        if (biglakeConfiguration != null) {
+          builder = builder.setBigLakeConfiguration(biglakeConfiguration);
+        }
         Boolean validate = configRow.getBoolean("validate");
         if (validate != null) {
           builder = builder.setValidate(validate);
diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/CreateTableHelpers.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/CreateTableHelpers.java
index 7a94657107ec..7c428917503f 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/CreateTableHelpers.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/CreateTableHelpers.java
@@ -17,11 +17,14 @@
  */
 package org.apache.beam.sdk.io.gcp.bigquery;
 
+import static org.apache.beam.sdk.io.gcp.bigquery.BigQueryIO.CONNECTION_ID;
+import static org.apache.beam.sdk.io.gcp.bigquery.BigQueryIO.STORAGE_URI;
 import static org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.base.Preconditions.checkArgument;
 
 import com.google.api.client.util.BackOff;
 import com.google.api.client.util.BackOffUtils;
 import com.google.api.gax.rpc.ApiException;
+import com.google.api.services.bigquery.model.BigLakeConfiguration;
 import com.google.api.services.bigquery.model.Clustering;
 import com.google.api.services.bigquery.model.EncryptionConfiguration;
 import com.google.api.services.bigquery.model.Table;
@@ -31,6 +34,7 @@
 import com.google.api.services.bigquery.model.TimePartitioning;
 import io.grpc.StatusRuntimeException;
 import java.util.Collections;
+import java.util.Map;
 import java.util.Set;
 import java.util.concurrent.Callable;
 import java.util.concurrent.ConcurrentHashMap;
@@ -41,6 +45,7 @@
 import org.apache.beam.sdk.util.FluentBackoff;
 import org.apache.beam.sdk.util.Preconditions;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.annotations.VisibleForTesting;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.base.MoreObjects;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.base.Strings;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.base.Supplier;
 import org.checkerframework.checker.nullness.qual.Nullable;
@@ -91,7 +96,8 @@ static TableDestination possiblyCreateTable(
       CreateDisposition createDisposition,
       @Nullable Coder<?> tableDestinationCoder,
       @Nullable String kmsKey,
-      BigQueryServices bqServices) {
+      BigQueryServices bqServices,
+      @Nullable Map<String, String> bigLakeConfiguration) {
     checkArgument(
         tableDestination.getTableSpec() != null,
         "DynamicDestinations.getTable() must return a TableDestination "
@@ -132,7 +138,8 @@ static TableDestination possiblyCreateTable(
               createDisposition,
               tableSpec,
               kmsKey,
-              bqServices);
+              bqServices,
+              bigLakeConfiguration);
         }
       }
     }
@@ -147,7 +154,8 @@ private static void tryCreateTable(
       CreateDisposition createDisposition,
       String tableSpec,
       @Nullable String kmsKey,
-      BigQueryServices bqServices) {
+      BigQueryServices bqServices,
+      @Nullable Map<String, String> bigLakeConfiguration) {
     TableReference tableReference = tableDestination.getTableReference().clone();
     tableReference.setTableId(BigQueryHelpers.stripPartitionDecorator(tableReference.getTableId()));
     try (DatasetService datasetService = bqServices.getDatasetService(options)) {
@@ -189,6 +197,24 @@ private static void tryCreateTable(
         if (kmsKey != null) {
           table.setEncryptionConfiguration(new EncryptionConfiguration().setKmsKeyName(kmsKey));
         }
+        if (bigLakeConfiguration != null) {
+          TableReference ref = table.getTableReference();
+          table.setBiglakeConfiguration(
+              new BigLakeConfiguration()
+                  .setTableFormat(
+                      MoreObjects.firstNonNull(bigLakeConfiguration.get("tableFormat"), "iceberg"))
+                  .setFileFormat(
+                      MoreObjects.firstNonNull(bigLakeConfiguration.get("fileFormat"), "parquet"))
+                  .setConnectionId(
+                      Preconditions.checkArgumentNotNull(bigLakeConfiguration.get(CONNECTION_ID)))
+                  .setStorageUri(
+                      String.format(
+                          "%s/%s/%s/%s",
+                          Preconditions.checkArgumentNotNull(bigLakeConfiguration.get(STORAGE_URI)),
+                          ref.getProjectId(),
+                          ref.getDatasetId(),
+                          ref.getTableId())));
+        }
         datasetService.createTable(table);
       }
     } catch (Exception e) {
diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/CreateTables.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/CreateTables.java
index 1bbd4e756084..7008c049a4a5 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/CreateTables.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/CreateTables.java
@@ -132,7 +132,8 @@ public void processElement(ProcessContext context) {
                     createDisposition,
                     dynamicDestinations.getDestinationCoder(),
                     kmsKey,
-                    bqServices);
+                    bqServices,
+                    null);
               });
 
       context.output(KV.of(tableDestination, context.element().getValue()));
diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiLoads.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiLoads.java
index 4ca9d5035c81..0bc60e98b253 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiLoads.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiLoads.java
@@ -23,6 +23,7 @@
 import com.google.cloud.bigquery.storage.v1.AppendRowsRequest;
 import java.io.IOException;
 import java.nio.ByteBuffer;
+import java.util.Map;
 import java.util.concurrent.ThreadLocalRandom;
 import java.util.function.Predicate;
 import javax.annotation.Nullable;
@@ -76,6 +77,7 @@ public class StorageApiLoads<DestinationT, ElementT>
   private final boolean usesCdc;
 
   private final AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation;
+  private final Map<String, String> bigLakeConfiguration;
 
   private final BadRecordRouter badRecordRouter;
 
@@ -98,6 +100,7 @@ public StorageApiLoads(
       Predicate<String> propagateSuccessfulStorageApiWritesPredicate,
       boolean usesCdc,
       AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation,
+      Map<String, String> bigLakeConfiguration,
       BadRecordRouter badRecordRouter,
       ErrorHandler<BadRecord, ?> badRecordErrorHandler) {
     this.destinationCoder = destinationCoder;
@@ -118,6 +121,7 @@ public StorageApiLoads(
     this.successfulRowsPredicate = propagateSuccessfulStorageApiWritesPredicate;
     this.usesCdc = usesCdc;
     this.defaultMissingValueInterpretation = defaultMissingValueInterpretation;
+    this.bigLakeConfiguration = bigLakeConfiguration;
     this.badRecordRouter = badRecordRouter;
     this.badRecordErrorHandler = badRecordErrorHandler;
   }
@@ -186,7 +190,8 @@ public WriteResult expandInconsistent(
                     createDisposition,
                     kmsKey,
                     usesCdc,
-                    defaultMissingValueInterpretation));
+                    defaultMissingValueInterpretation,
+                    bigLakeConfiguration));
 
     PCollection<BigQueryStorageApiInsertError> insertErrors =
         PCollectionList.of(convertMessagesResult.get(failedRowsTag))
@@ -279,7 +284,8 @@ public WriteResult expandTriggered(
                 successfulRowsPredicate,
                 autoUpdateSchema,
                 ignoreUnknownValues,
-                defaultMissingValueInterpretation));
+                defaultMissingValueInterpretation,
+                bigLakeConfiguration));
 
     PCollection<BigQueryStorageApiInsertError> insertErrors =
         PCollectionList.of(convertMessagesResult.get(failedRowsTag))
@@ -372,7 +378,8 @@ public WriteResult expandUntriggered(
                     createDisposition,
                     kmsKey,
                     usesCdc,
-                    defaultMissingValueInterpretation));
+                    defaultMissingValueInterpretation,
+                    bigLakeConfiguration));
 
     PCollection<BigQueryStorageApiInsertError> insertErrors =
         PCollectionList.of(convertMessagesResult.get(failedRowsTag))
diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWriteRecordsInconsistent.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWriteRecordsInconsistent.java
index 0860b4eda8a2..58bbed8ba5a9 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWriteRecordsInconsistent.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWriteRecordsInconsistent.java
@@ -19,6 +19,7 @@
 
 import com.google.api.services.bigquery.model.TableRow;
 import com.google.cloud.bigquery.storage.v1.AppendRowsRequest;
+import java.util.Map;
 import java.util.function.Predicate;
 import javax.annotation.Nullable;
 import org.apache.beam.sdk.coders.Coder;
@@ -55,6 +56,7 @@ public class StorageApiWriteRecordsInconsistent<DestinationT, ElementT>
   private final @Nullable String kmsKey;
   private final boolean usesCdc;
   private final AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation;
+  private final @Nullable Map<String, String> bigLakeConfiguration;
 
   public StorageApiWriteRecordsInconsistent(
       StorageApiDynamicDestinations<ElementT, DestinationT> dynamicDestinations,
@@ -69,7 +71,8 @@ public StorageApiWriteRecordsInconsistent(
       BigQueryIO.Write.CreateDisposition createDisposition,
       @Nullable String kmsKey,
       boolean usesCdc,
-      AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation) {
+      AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation,
+      @Nullable Map<String, String> bigLakeConfiguration) {
     this.dynamicDestinations = dynamicDestinations;
     this.bqServices = bqServices;
     this.failedRowsTag = failedRowsTag;
@@ -83,6 +86,7 @@ public StorageApiWriteRecordsInconsistent(
     this.kmsKey = kmsKey;
     this.usesCdc = usesCdc;
     this.defaultMissingValueInterpretation = defaultMissingValueInterpretation;
+    this.bigLakeConfiguration = bigLakeConfiguration;
   }
 
   @Override
@@ -116,7 +120,8 @@ public PCollectionTuple expand(PCollection<KV<DestinationT, StorageApiWritePaylo
                         kmsKey,
                         usesCdc,
                         defaultMissingValueInterpretation,
-                        bigQueryOptions.getStorageWriteApiMaxRetries()))
+                        bigQueryOptions.getStorageWriteApiMaxRetries(),
+                        bigLakeConfiguration))
                 .withOutputTags(finalizeTag, tupleTagList)
                 .withSideInputs(dynamicDestinations.getSideInputs()));
     result.get(failedRowsTag).setCoder(failedRowsCoder);
diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWriteUnshardedRecords.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWriteUnshardedRecords.java
index c4ba8a8600d9..30a9ecd274dc 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWriteUnshardedRecords.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWriteUnshardedRecords.java
@@ -120,6 +120,7 @@ public class StorageApiWriteUnshardedRecords<DestinationT, ElementT>
   private final @Nullable String kmsKey;
   private final boolean usesCdc;
   private final AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation;
+  private final @Nullable Map<String, String> bigLakeConfiguration;
 
   /**
    * The Guava cache object is thread-safe. However our protocol requires that client pin the
@@ -179,7 +180,8 @@ public StorageApiWriteUnshardedRecords(
       BigQueryIO.Write.CreateDisposition createDisposition,
       @Nullable String kmsKey,
       boolean usesCdc,
-      AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation) {
+      AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation,
+      @Nullable Map<String, String> bigLakeConfiguration) {
     this.dynamicDestinations = dynamicDestinations;
     this.bqServices = bqServices;
     this.failedRowsTag = failedRowsTag;
@@ -193,6 +195,7 @@ public StorageApiWriteUnshardedRecords(
     this.kmsKey = kmsKey;
     this.usesCdc = usesCdc;
     this.defaultMissingValueInterpretation = defaultMissingValueInterpretation;
+    this.bigLakeConfiguration = bigLakeConfiguration;
   }
 
   @Override
@@ -228,7 +231,8 @@ public PCollectionTuple expand(PCollection<KV<DestinationT, StorageApiWritePaylo
                         kmsKey,
                         usesCdc,
                         defaultMissingValueInterpretation,
-                        options.getStorageWriteApiMaxRetries()))
+                        options.getStorageWriteApiMaxRetries(),
+                        bigLakeConfiguration))
                 .withOutputTags(finalizeTag, tupleTagList)
                 .withSideInputs(dynamicDestinations.getSideInputs()));
 
@@ -954,6 +958,7 @@ void postFlush() {
     private final BigQueryServices bqServices;
     private final boolean useDefaultStream;
     private int streamAppendClientCount;
+    private final @Nullable Map<String, String> bigLakeConfiguration;
 
     WriteRecordsDoFn(
         String operationName,
@@ -973,7 +978,8 @@ void postFlush() {
         @Nullable String kmsKey,
         boolean usesCdc,
         AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation,
-        int maxRetries) {
+        int maxRetries,
+        @Nullable Map<String, String> bigLakeConfiguration) {
       this.messageConverters = new TwoLevelMessageConverterCache<>(operationName);
       this.dynamicDestinations = dynamicDestinations;
       this.bqServices = bqServices;
@@ -992,6 +998,7 @@ void postFlush() {
       this.usesCdc = usesCdc;
       this.defaultMissingValueInterpretation = defaultMissingValueInterpretation;
       this.maxRetries = maxRetries;
+      this.bigLakeConfiguration = bigLakeConfiguration;
     }
 
     boolean shouldFlush() {
@@ -1098,7 +1105,8 @@ DestinationState createDestinationState(
                 createDisposition,
                 destinationCoder,
                 kmsKey,
-                bqServices);
+                bqServices,
+                bigLakeConfiguration);
             return true;
           };
 
diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWritesShardedRecords.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWritesShardedRecords.java
index e2674fe34f2e..738a52b69cb7 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWritesShardedRecords.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiWritesShardedRecords.java
@@ -131,6 +131,7 @@ public class StorageApiWritesShardedRecords<DestinationT extends @NonNull Object
   private final boolean autoUpdateSchema;
   private final boolean ignoreUnknownValues;
   private final AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation;
+  private final @Nullable Map<String, String> bigLakeConfiguration;
 
   private final Duration streamIdleTime = DEFAULT_STREAM_IDLE_TIME;
   private final TupleTag<BigQueryStorageApiInsertError> failedRowsTag;
@@ -232,7 +233,8 @@ public StorageApiWritesShardedRecords(
       Predicate<String> successfulRowsPredicate,
       boolean autoUpdateSchema,
       boolean ignoreUnknownValues,
-      AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation) {
+      AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation,
+      @Nullable Map<String, String> bigLakeConfiguration) {
     this.dynamicDestinations = dynamicDestinations;
     this.createDisposition = createDisposition;
     this.kmsKey = kmsKey;
@@ -246,6 +248,7 @@ public StorageApiWritesShardedRecords(
     this.autoUpdateSchema = autoUpdateSchema;
     this.ignoreUnknownValues = ignoreUnknownValues;
     this.defaultMissingValueInterpretation = defaultMissingValueInterpretation;
+    this.bigLakeConfiguration = bigLakeConfiguration;
   }
 
   @Override
@@ -499,7 +502,8 @@ public void process(
                 createDisposition,
                 destinationCoder,
                 kmsKey,
-                bqServices);
+                bqServices,
+                bigLakeConfiguration);
             return true;
           };
 
diff --git a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOTranslationTest.java b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOTranslationTest.java
index e15258e6ab40..5b7b5d473190 100644
--- a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOTranslationTest.java
+++ b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOTranslationTest.java
@@ -96,6 +96,7 @@ public class BigQueryIOTranslationTest {
     WRITE_TRANSFORM_SCHEMA_MAPPING.put("getWriteDisposition", "write_disposition");
     WRITE_TRANSFORM_SCHEMA_MAPPING.put("getSchemaUpdateOptions", "schema_update_options");
     WRITE_TRANSFORM_SCHEMA_MAPPING.put("getTableDescription", "table_description");
+    WRITE_TRANSFORM_SCHEMA_MAPPING.put("getBigLakeConfiguration", "biglake_configuration");
     WRITE_TRANSFORM_SCHEMA_MAPPING.put("getValidate", "validate");
     WRITE_TRANSFORM_SCHEMA_MAPPING.put("getBigQueryServices", "bigquery_services");
     WRITE_TRANSFORM_SCHEMA_MAPPING.put("getMaxFilesPerBundle", "max_files_per_bundle");
diff --git a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOWriteTest.java b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOWriteTest.java
index d96e22f84907..69994c019509 100644
--- a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOWriteTest.java
+++ b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIOWriteTest.java
@@ -2257,6 +2257,40 @@ public void testUpdateTableSchemaNoUnknownValues() throws Exception {
     p.run();
   }
 
+  @Test
+  public void testBigLakeConfigurationFailsForNonStorageApiWrites() {
+    assumeTrue(!useStorageApi);
+    thrown.expect(IllegalArgumentException.class);
+    thrown.expectMessage(
+        "bigLakeConfiguration is only supported when using STORAGE_WRITE_API or STORAGE_API_AT_LEAST_ONCE");
+
+    p.apply(Create.empty(TableRowJsonCoder.of()))
+        .apply(
+            BigQueryIO.writeTableRows()
+                .to("project-id:dataset-id.table")
+                .withBigLakeConfiguration(
+                    ImmutableMap.of(
+                        "connectionId", "some-connection",
+                        "storageUri", "gs://bucket"))
+                .withTestServices(fakeBqServices));
+    p.run();
+  }
+
+  @Test
+  public void testBigLakeConfigurationFailsForMissingProperties() {
+    assumeTrue(useStorageApi);
+    thrown.expect(IllegalArgumentException.class);
+    thrown.expectMessage("bigLakeConfiguration must contain keys 'connectionId' and 'storageUri'");
+
+    p.apply(Create.empty(TableRowJsonCoder.of()))
+        .apply(
+            BigQueryIO.writeTableRows()
+                .to("project-id:dataset-id.table")
+                .withBigLakeConfiguration(ImmutableMap.of("connectionId", "some-connection"))
+                .withTestServices(fakeBqServices));
+    p.run();
+  }
+
   @SuppressWarnings({"unused"})
   static class UpdateTableSchemaDoFn extends DoFn<KV<String, TableRow>, TableRow> {
     @TimerId("updateTimer")
diff --git a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiSinkCreateIfNeededIT.java b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiSinkCreateIfNeededIT.java
index 18c832f0c54b..858921e19ced 100644
--- a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiSinkCreateIfNeededIT.java
+++ b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/StorageApiSinkCreateIfNeededIT.java
@@ -17,23 +17,32 @@
  */
 package org.apache.beam.sdk.io.gcp.bigquery;
 
+import static org.apache.beam.sdk.io.gcp.bigquery.BigQueryIO.CONNECTION_ID;
+import static org.apache.beam.sdk.io.gcp.bigquery.BigQueryIO.STORAGE_URI;
 import static org.hamcrest.MatcherAssert.assertThat;
+import static org.junit.Assert.assertEquals;
 
 import com.google.api.services.bigquery.model.TableFieldSchema;
 import com.google.api.services.bigquery.model.TableRow;
 import com.google.api.services.bigquery.model.TableSchema;
+import com.google.api.services.storage.model.Objects;
 import java.io.IOException;
 import java.util.List;
+import java.util.Map;
 import java.util.stream.Collectors;
 import java.util.stream.LongStream;
 import org.apache.beam.sdk.Pipeline;
 import org.apache.beam.sdk.extensions.gcp.options.GcpOptions;
+import org.apache.beam.sdk.extensions.gcp.options.GcsOptions;
+import org.apache.beam.sdk.extensions.gcp.util.GcsUtil;
 import org.apache.beam.sdk.io.gcp.testing.BigqueryClient;
 import org.apache.beam.sdk.testing.TestPipeline;
 import org.apache.beam.sdk.transforms.Create;
 import org.apache.beam.sdk.values.PCollection;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableList;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableMap;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.Iterables;
+import org.checkerframework.checker.nullness.qual.Nullable;
 import org.hamcrest.Matchers;
 import org.joda.time.Duration;
 import org.junit.AfterClass;
@@ -57,11 +66,16 @@ public static Iterable<Object[]> data() {
 
   private static final Logger LOG = LoggerFactory.getLogger(StorageApiSinkCreateIfNeededIT.class);
 
-  private static final BigqueryClient BQ_CLIENT = new BigqueryClient("StorageApiSinkFailedRowsIT");
+  private static final BigqueryClient BQ_CLIENT =
+      new BigqueryClient("StorageApiSinkCreateIfNeededIT");
   private static final String PROJECT =
       TestPipeline.testingPipelineOptions().as(GcpOptions.class).getProject();
   private static final String BIG_QUERY_DATASET_ID =
-      "storage_api_sink_failed_rows" + System.nanoTime();
+      "storage_api_sink_create_tables_" + System.nanoTime();
+  private static final String TEST_CONNECTION_ID =
+      "projects/apache-beam-testing/locations/us/connections/apache-beam-testing-storageapi-biglake-nodelete";
+  private static final String TEST_STORAGE_URI =
+      "gs://apache-beam-testing-bq-biglake/" + StorageApiSinkCreateIfNeededIT.class.getSimpleName();
   private static final List<TableFieldSchema> FIELDS =
       ImmutableList.<TableFieldSchema>builder()
           .add(new TableFieldSchema().setType("STRING").setName("str"))
@@ -96,19 +110,55 @@ public void testCreateManyTables() throws IOException, InterruptedException {
 
     String table = "table" + System.nanoTime();
     String tableSpecBase = PROJECT + "." + BIG_QUERY_DATASET_ID + "." + table;
-    runPipeline(getMethod(), tableSpecBase, inputs);
-    assertTablesCreated(tableSpecBase, 100);
+    runPipeline(getMethod(), tableSpecBase, inputs, null);
+    assertTablesCreated(tableSpecBase, 100, true);
   }
 
-  private void assertTablesCreated(String tableSpecPrefix, int expectedRows)
+  @Test
+  public void testCreateBigLakeTables() throws IOException, InterruptedException {
+    int numTables = 5;
+    List<TableRow> inputs =
+        LongStream.range(0, numTables)
+            .mapToObj(l -> new TableRow().set("str", "foo").set("tablenum", l))
+            .collect(Collectors.toList());
+
+    String table = "iceberg_table_" + System.nanoTime() + "_";
+    String tableSpecBase = PROJECT + "." + BIG_QUERY_DATASET_ID + "." + table;
+    Map<String, String> bigLakeConfiguration =
+        ImmutableMap.of(
+            CONNECTION_ID, TEST_CONNECTION_ID,
+            STORAGE_URI, TEST_STORAGE_URI);
+    runPipeline(getMethod(), tableSpecBase, inputs, bigLakeConfiguration);
+    assertTablesCreated(tableSpecBase, numTables, false);
+    assertIcebergTablesCreated(table, numTables);
+  }
+
+  private void assertIcebergTablesCreated(String tablePrefix, int expectedRows)
       throws IOException, InterruptedException {
+    GcsUtil gcsUtil = TestPipeline.testingPipelineOptions().as(GcsOptions.class).getGcsUtil();
+
+    Objects objects =
+        gcsUtil.listObjects(
+            "apache-beam-testing-bq-biglake",
+            String.format(
+                "%s/%s/%s/%s",
+                getClass().getSimpleName(), PROJECT, BIG_QUERY_DATASET_ID, tablePrefix),
+            null);
+
+    assertEquals(expectedRows, objects.getItems().size());
+  }
+
+  private void assertTablesCreated(String tableSpecPrefix, int expectedRows, boolean useWildCard)
+      throws IOException, InterruptedException {
+    String query = String.format("SELECT COUNT(*) FROM `%s`", tableSpecPrefix + "*");
+    if (!useWildCard) {
+      query = String.format("SELECT (SELECT COUNT(*) FROM `%s`)", tableSpecPrefix + 0);
+      for (int i = 1; i < expectedRows; i++) {
+        query += String.format(" + (SELECT COUNT(*) FROM `%s`)", tableSpecPrefix + i);
+      }
+    }
     TableRow queryResponse =
-        Iterables.getOnlyElement(
-            BQ_CLIENT.queryUnflattened(
-                String.format("SELECT COUNT(*) FROM `%s`", tableSpecPrefix + "*"),
-                PROJECT,
-                true,
-                true));
+        Iterables.getOnlyElement(BQ_CLIENT.queryUnflattened(query, PROJECT, true, true));
     int numRowsWritten = Integer.parseInt((String) queryResponse.get("f0_"));
     if (useAtLeastOnce) {
       assertThat(numRowsWritten, Matchers.greaterThanOrEqualTo(expectedRows));
@@ -118,7 +168,10 @@ private void assertTablesCreated(String tableSpecPrefix, int expectedRows)
   }
 
   private static void runPipeline(
-      BigQueryIO.Write.Method method, String tableSpecBase, Iterable<TableRow> tableRows) {
+      BigQueryIO.Write.Method method,
+      String tableSpecBase,
+      Iterable<TableRow> tableRows,
+      @Nullable Map<String, String> bigLakeConfiguration) {
     Pipeline p = Pipeline.create();
 
     BigQueryIO.Write<TableRow> write =
@@ -131,6 +184,9 @@ private static void runPipeline(
       write = write.withNumStorageWriteApiStreams(1);
       write = write.withTriggeringFrequency(Duration.standardSeconds(1));
     }
+    if (bigLakeConfiguration != null) {
+      write = write.withBigLakeConfiguration(bigLakeConfiguration);
+    }
     PCollection<TableRow> input = p.apply("Create test cases", Create.of(tableRows));
     input = input.setIsBoundedInternal(PCollection.IsBounded.UNBOUNDED);
     input.apply("Write using Storage Write API", write);

From c83444dbb9454320c9dc46a1c8a9eb0cbca1b0ee Mon Sep 17 00:00:00 2001
From: Robert Bradshaw <robertwb@gmail.com>
Date: Tue, 17 Dec 2024 10:44:23 -0800
Subject: [PATCH 129/135] Docstring fix.

---
 sdks/python/apache_beam/metrics/monitoring_infos.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sdks/python/apache_beam/metrics/monitoring_infos.py b/sdks/python/apache_beam/metrics/monitoring_infos.py
index e343793b3ad4..cb4e60e218f6 100644
--- a/sdks/python/apache_beam/metrics/monitoring_infos.py
+++ b/sdks/python/apache_beam/metrics/monitoring_infos.py
@@ -392,7 +392,7 @@ def is_string_set(monitoring_info_proto):
 
 
 def is_bounded_trie(monitoring_info_proto):
-  """Returns true if the monitoring info is a StringSet metric."""
+  """Returns true if the monitoring info is a BoundedTrie metric."""
   return monitoring_info_proto.type in BOUNDED_TRIE_TYPES
 
 

From 8e1e12453baa8ffa564922496994446c9e41003c Mon Sep 17 00:00:00 2001
From: Robert Burke <lostluck@users.noreply.github.com>
Date: Tue, 17 Dec 2024 10:45:33 -0800
Subject: [PATCH 130/135] [#32929] Add OrderedListState support to Prism.
 (#33350)

---
 CHANGES.md                                    |   1 +
 runners/prism/java/build.gradle               |   4 -
 .../runners/prism/internal/engine/data.go     |  97 ++++++++
 .../prism/internal/engine/data_test.go        | 222 ++++++++++++++++++
 .../prism/internal/engine/elementmanager.go   |  11 +-
 .../beam/runners/prism/internal/execute.go    |   2 +-
 .../prism/internal/jobservices/management.go  |   3 +-
 .../pkg/beam/runners/prism/internal/stage.go  |  37 +++
 .../beam/runners/prism/internal/urns/urns.go  |   5 +-
 .../runners/prism/internal/worker/worker.go   |  14 ++
 10 files changed, 385 insertions(+), 11 deletions(-)
 create mode 100644 sdks/go/pkg/beam/runners/prism/internal/engine/data_test.go

diff --git a/CHANGES.md b/CHANGES.md
index 7a8ed493c216..deaa8bfcd471 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -74,6 +74,7 @@
 * X feature added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
 * Support OnWindowExpiration in Prism ([#32211](https://github.com/apache/beam/issues/32211)).
   * This enables initial Java GroupIntoBatches support.
+* Support OrderedListState in Prism ([#32929](https://github.com/apache/beam/issues/32929)).
 
 ## Breaking Changes
 
diff --git a/runners/prism/java/build.gradle b/runners/prism/java/build.gradle
index ce71151099bd..cd2e90fde67c 100644
--- a/runners/prism/java/build.gradle
+++ b/runners/prism/java/build.gradle
@@ -233,10 +233,6 @@ def createPrismValidatesRunnerTask = { name, environmentType ->
       excludeCategories 'org.apache.beam.sdk.testing.UsesExternalService'
       excludeCategories 'org.apache.beam.sdk.testing.UsesSdkHarnessEnvironment'
 
-      // Not yet implemented in Prism
-      // https://github.com/apache/beam/issues/32929
-      excludeCategories 'org.apache.beam.sdk.testing.UsesOrderedListState'
-
       // Not supported in Portable Java SDK yet.
       // https://github.com/apache/beam/issues?q=is%3Aissue+is%3Aopen+MultimapState
       excludeCategories 'org.apache.beam.sdk.testing.UsesMultimapState'
diff --git a/sdks/go/pkg/beam/runners/prism/internal/engine/data.go b/sdks/go/pkg/beam/runners/prism/internal/engine/data.go
index 7b8689f95112..380b6e2f31d1 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/engine/data.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/engine/data.go
@@ -17,13 +17,17 @@ package engine
 
 import (
 	"bytes"
+	"cmp"
 	"fmt"
 	"log/slog"
+	"slices"
+	"sort"
 
 	"github.com/apache/beam/sdks/v2/go/pkg/beam/core/graph/coder"
 	"github.com/apache/beam/sdks/v2/go/pkg/beam/core/graph/window"
 	"github.com/apache/beam/sdks/v2/go/pkg/beam/core/runtime/exec"
 	"github.com/apache/beam/sdks/v2/go/pkg/beam/core/typex"
+	"google.golang.org/protobuf/encoding/protowire"
 )
 
 // StateData is a "union" between Bag state and MultiMap state to increase common code.
@@ -42,6 +46,10 @@ type TimerKey struct {
 type TentativeData struct {
 	Raw map[string][][]byte
 
+	// stateTypeLen is a map from LinkID to valueLen function for parsing data.
+	// Only used by OrderedListState, since Prism must manipulate these datavalues,
+	// which isn't expected, or a requirement of other state values.
+	stateTypeLen map[LinkID]func([]byte) int
 	// state is a map from transformID + UserStateID, to window, to userKey, to datavalues.
 	state map[LinkID]map[typex.Window]map[string]StateData
 	// timers is a map from the Timer transform+family to the encoded timer.
@@ -220,3 +228,92 @@ func (d *TentativeData) ClearMultimapKeysState(stateID LinkID, wKey, uKey []byte
 	kmap[string(uKey)] = StateData{}
 	slog.Debug("State() MultimapKeys.Clear", slog.Any("StateID", stateID), slog.Any("UserKey", uKey), slog.Any("WindowKey", wKey))
 }
+
+// AppendOrderedListState appends the incoming timestamped data to the existing tentative data bundle.
+// Assumes the data is TimestampedValue encoded, which has a BigEndian int64 suffixed to the data.
+// This means we may always use the last 8 bytes to determine the value sorting.
+//
+// The stateID has the Transform and Local fields populated, for the Transform and UserStateID respectively.
+func (d *TentativeData) AppendOrderedListState(stateID LinkID, wKey, uKey []byte, data []byte) {
+	kmap := d.appendState(stateID, wKey)
+	typeLen := d.stateTypeLen[stateID]
+	var datums [][]byte
+
+	// We need to parse out all values individually for later sorting.
+	//
+	// OrderedListState is encoded as KVs with varint encoded millis followed by the value.
+	// This is not the standard TimestampValueCoder encoding, which
+	// uses a big-endian long as a suffix to the value. This is important since
+	// values may be concatenated, and we'll need to split them out out.
+	//
+	// The TentativeData.stateTypeLen is populated with a function to extract
+	// the length of a the next value, so we can skip through elements individually.
+	for i := 0; i < len(data); {
+		// Get the length of the VarInt for the timestamp.
+		_, tn := protowire.ConsumeVarint(data[i:])
+
+		// Get the length of the encoded value.
+		vn := typeLen(data[i+tn:])
+		prev := i
+		i += tn + vn
+		datums = append(datums, data[prev:i])
+	}
+
+	s := StateData{Bag: append(kmap[string(uKey)].Bag, datums...)}
+	sort.SliceStable(s.Bag, func(i, j int) bool {
+		vi := s.Bag[i]
+		vj := s.Bag[j]
+		return compareTimestampSuffixes(vi, vj)
+	})
+	kmap[string(uKey)] = s
+	slog.Debug("State() OrderedList.Append", slog.Any("StateID", stateID), slog.Any("UserKey", uKey), slog.Any("Window", wKey), slog.Any("NewData", s))
+}
+
+func compareTimestampSuffixes(vi, vj []byte) bool {
+	ims, _ := protowire.ConsumeVarint(vi)
+	jms, _ := protowire.ConsumeVarint(vj)
+	return (int64(ims)) < (int64(jms))
+}
+
+// GetOrderedListState available state from the tentative bundle data.
+// The stateID has the Transform and Local fields populated, for the Transform and UserStateID respectively.
+func (d *TentativeData) GetOrderedListState(stateID LinkID, wKey, uKey []byte, start, end int64) [][]byte {
+	winMap := d.state[stateID]
+	w := d.toWindow(wKey)
+	data := winMap[w][string(uKey)]
+
+	lo, hi := findRange(data.Bag, start, end)
+	slog.Debug("State() OrderedList.Get", slog.Any("StateID", stateID), slog.Any("UserKey", uKey), slog.Any("Window", wKey), slog.Group("range", slog.Int64("start", start), slog.Int64("end", end)), slog.Group("outrange", slog.Int("lo", lo), slog.Int("hi", hi)), slog.Any("Data", data.Bag[lo:hi]))
+	return data.Bag[lo:hi]
+}
+
+func cmpSuffix(vs [][]byte, target int64) func(i int) int {
+	return func(i int) int {
+		v := vs[i]
+		ims, _ := protowire.ConsumeVarint(v)
+		tvsbi := cmp.Compare(target, int64(ims))
+		slog.Debug("cmpSuffix", "target", target, "bi", ims, "tvsbi", tvsbi)
+		return tvsbi
+	}
+}
+
+func findRange(bag [][]byte, start, end int64) (int, int) {
+	lo, _ := sort.Find(len(bag), cmpSuffix(bag, start))
+	hi, _ := sort.Find(len(bag), cmpSuffix(bag, end))
+	return lo, hi
+}
+
+func (d *TentativeData) ClearOrderedListState(stateID LinkID, wKey, uKey []byte, start, end int64) {
+	winMap := d.state[stateID]
+	w := d.toWindow(wKey)
+	kMap := winMap[w]
+	data := kMap[string(uKey)]
+
+	lo, hi := findRange(data.Bag, start, end)
+	slog.Debug("State() OrderedList.Clear", slog.Any("StateID", stateID), slog.Any("UserKey", uKey), slog.Any("Window", wKey), slog.Group("range", slog.Int64("start", start), slog.Int64("end", end)), "lo", lo, "hi", hi, slog.Any("PreClearData", data.Bag))
+
+	cleared := slices.Delete(data.Bag, lo, hi)
+	// Zero the current entry to clear.
+	// Delete makes it difficult to delete the persisted stage state for the key.
+	kMap[string(uKey)] = StateData{Bag: cleared}
+}
diff --git a/sdks/go/pkg/beam/runners/prism/internal/engine/data_test.go b/sdks/go/pkg/beam/runners/prism/internal/engine/data_test.go
new file mode 100644
index 000000000000..1d0497104182
--- /dev/null
+++ b/sdks/go/pkg/beam/runners/prism/internal/engine/data_test.go
@@ -0,0 +1,222 @@
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements.  See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License.  You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package engine
+
+import (
+	"bytes"
+	"encoding/binary"
+	"math"
+	"testing"
+
+	"github.com/google/go-cmp/cmp"
+	"google.golang.org/protobuf/encoding/protowire"
+)
+
+func TestCompareTimestampSuffixes(t *testing.T) {
+	t.Run("simple", func(t *testing.T) {
+		loI := int64(math.MinInt64)
+		hiI := int64(math.MaxInt64)
+
+		loB := binary.BigEndian.AppendUint64(nil, uint64(loI))
+		hiB := binary.BigEndian.AppendUint64(nil, uint64(hiI))
+
+		if compareTimestampSuffixes(loB, hiB) != (loI < hiI) {
+			t.Errorf("lo vs Hi%v < %v: bytes %v vs %v, %v %v", loI, hiI, loB, hiB, loI < hiI, compareTimestampSuffixes(loB, hiB))
+		}
+	})
+}
+
+func TestOrderedListState(t *testing.T) {
+	time1 := protowire.AppendVarint(nil, 11)
+	time2 := protowire.AppendVarint(nil, 22)
+	time3 := protowire.AppendVarint(nil, 33)
+	time4 := protowire.AppendVarint(nil, 44)
+	time5 := protowire.AppendVarint(nil, 55)
+
+	wKey := []byte{} // global window.
+	uKey := []byte("\u0007userkey")
+	linkID := LinkID{
+		Transform: "dofn",
+		Local:     "localStateName",
+	}
+	cc := func(a []byte, b ...byte) []byte {
+		return bytes.Join([][]byte{a, b}, []byte{})
+	}
+
+	t.Run("bool", func(t *testing.T) {
+		d := TentativeData{
+			stateTypeLen: map[LinkID]func([]byte) int{
+				linkID: func(_ []byte) int {
+					return 1
+				},
+			},
+		}
+
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time3, 1))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time2, 0))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time5, 1))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time1, 1))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time4, 0))
+
+		got := d.GetOrderedListState(linkID, wKey, uKey, 0, 60)
+		want := [][]byte{
+			cc(time1, 1),
+			cc(time2, 0),
+			cc(time3, 1),
+			cc(time4, 0),
+			cc(time5, 1),
+		}
+		if d := cmp.Diff(want, got); d != "" {
+			t.Errorf("OrderedList booleans \n%v", d)
+		}
+
+		d.ClearOrderedListState(linkID, wKey, uKey, 12, 54)
+		got = d.GetOrderedListState(linkID, wKey, uKey, 0, 60)
+		want = [][]byte{
+			cc(time1, 1),
+			cc(time5, 1),
+		}
+		if d := cmp.Diff(want, got); d != "" {
+			t.Errorf("OrderedList booleans, after clear\n%v", d)
+		}
+	})
+	t.Run("float64", func(t *testing.T) {
+		d := TentativeData{
+			stateTypeLen: map[LinkID]func([]byte) int{
+				linkID: func(_ []byte) int {
+					return 8
+				},
+			},
+		}
+
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time5, 0, 0, 0, 0, 0, 0, 0, 1))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time1, 0, 0, 0, 0, 0, 0, 1, 0))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time3, 0, 0, 0, 0, 0, 1, 0, 0))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time2, 0, 0, 0, 0, 1, 0, 0, 0))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time4, 0, 0, 0, 1, 0, 0, 0, 0))
+
+		got := d.GetOrderedListState(linkID, wKey, uKey, 0, 60)
+		want := [][]byte{
+			cc(time1, 0, 0, 0, 0, 0, 0, 1, 0),
+			cc(time2, 0, 0, 0, 0, 1, 0, 0, 0),
+			cc(time3, 0, 0, 0, 0, 0, 1, 0, 0),
+			cc(time4, 0, 0, 0, 1, 0, 0, 0, 0),
+			cc(time5, 0, 0, 0, 0, 0, 0, 0, 1),
+		}
+		if d := cmp.Diff(want, got); d != "" {
+			t.Errorf("OrderedList float64s \n%v", d)
+		}
+
+		d.ClearOrderedListState(linkID, wKey, uKey, 11, 12)
+		d.ClearOrderedListState(linkID, wKey, uKey, 33, 34)
+		d.ClearOrderedListState(linkID, wKey, uKey, 55, 56)
+
+		got = d.GetOrderedListState(linkID, wKey, uKey, 0, 60)
+		want = [][]byte{
+			cc(time2, 0, 0, 0, 0, 1, 0, 0, 0),
+			cc(time4, 0, 0, 0, 1, 0, 0, 0, 0),
+		}
+		if d := cmp.Diff(want, got); d != "" {
+			t.Errorf("OrderedList float64s, after clear \n%v", d)
+		}
+	})
+
+	t.Run("varint", func(t *testing.T) {
+		d := TentativeData{
+			stateTypeLen: map[LinkID]func([]byte) int{
+				linkID: func(b []byte) int {
+					_, n := protowire.ConsumeVarint(b)
+					return int(n)
+				},
+			},
+		}
+
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time2, protowire.AppendVarint(nil, 56)...))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time4, protowire.AppendVarint(nil, 20067)...))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time3, protowire.AppendVarint(nil, 7777777)...))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time1, protowire.AppendVarint(nil, 424242)...))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time5, protowire.AppendVarint(nil, 0)...))
+
+		got := d.GetOrderedListState(linkID, wKey, uKey, 0, 60)
+		want := [][]byte{
+			cc(time1, protowire.AppendVarint(nil, 424242)...),
+			cc(time2, protowire.AppendVarint(nil, 56)...),
+			cc(time3, protowire.AppendVarint(nil, 7777777)...),
+			cc(time4, protowire.AppendVarint(nil, 20067)...),
+			cc(time5, protowire.AppendVarint(nil, 0)...),
+		}
+		if d := cmp.Diff(want, got); d != "" {
+			t.Errorf("OrderedList int32 \n%v", d)
+		}
+	})
+	t.Run("lp", func(t *testing.T) {
+		d := TentativeData{
+			stateTypeLen: map[LinkID]func([]byte) int{
+				linkID: func(b []byte) int {
+					l, n := protowire.ConsumeVarint(b)
+					return int(l) + n
+				},
+			},
+		}
+
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time1, []byte("\u0003one")...))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time2, []byte("\u0003two")...))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time3, []byte("\u0005three")...))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time4, []byte("\u0004four")...))
+		d.AppendOrderedListState(linkID, wKey, uKey, cc(time5, []byte("\u0019FourHundredAndEleventyTwo")...))
+
+		got := d.GetOrderedListState(linkID, wKey, uKey, 0, 60)
+		want := [][]byte{
+			cc(time1, []byte("\u0003one")...),
+			cc(time2, []byte("\u0003two")...),
+			cc(time3, []byte("\u0005three")...),
+			cc(time4, []byte("\u0004four")...),
+			cc(time5, []byte("\u0019FourHundredAndEleventyTwo")...),
+		}
+		if d := cmp.Diff(want, got); d != "" {
+			t.Errorf("OrderedList int32 \n%v", d)
+		}
+	})
+	t.Run("lp_onecall", func(t *testing.T) {
+		d := TentativeData{
+			stateTypeLen: map[LinkID]func([]byte) int{
+				linkID: func(b []byte) int {
+					l, n := protowire.ConsumeVarint(b)
+					return int(l) + n
+				},
+			},
+		}
+		d.AppendOrderedListState(linkID, wKey, uKey, bytes.Join([][]byte{
+			time5, []byte("\u0019FourHundredAndEleventyTwo"),
+			time3, []byte("\u0005three"),
+			time2, []byte("\u0003two"),
+			time1, []byte("\u0003one"),
+			time4, []byte("\u0004four"),
+		}, nil))
+
+		got := d.GetOrderedListState(linkID, wKey, uKey, 0, 60)
+		want := [][]byte{
+			cc(time1, []byte("\u0003one")...),
+			cc(time2, []byte("\u0003two")...),
+			cc(time3, []byte("\u0005three")...),
+			cc(time4, []byte("\u0004four")...),
+			cc(time5, []byte("\u0019FourHundredAndEleventyTwo")...),
+		}
+		if d := cmp.Diff(want, got); d != "" {
+			t.Errorf("OrderedList int32 \n%v", d)
+		}
+	})
+}
diff --git a/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go b/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go
index 00e18c669afa..7180bb456f1a 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/engine/elementmanager.go
@@ -269,8 +269,10 @@ func (em *ElementManager) StageAggregates(ID string) {
 
 // StageStateful marks the given stage as stateful, which means elements are
 // processed by key.
-func (em *ElementManager) StageStateful(ID string) {
-	em.stages[ID].stateful = true
+func (em *ElementManager) StageStateful(ID string, stateTypeLen map[LinkID]func([]byte) int) {
+	ss := em.stages[ID]
+	ss.stateful = true
+	ss.stateTypeLen = stateTypeLen
 }
 
 // StageOnWindowExpiration marks the given stage as stateful, which means elements are
@@ -669,7 +671,9 @@ func (em *ElementManager) StateForBundle(rb RunBundle) TentativeData {
 	ss := em.stages[rb.StageID]
 	ss.mu.Lock()
 	defer ss.mu.Unlock()
-	var ret TentativeData
+	ret := TentativeData{
+		stateTypeLen: ss.stateTypeLen,
+	}
 	keys := ss.inprogressKeysByBundle[rb.BundleID]
 	// TODO(lostluck): Also track windows per bundle, to reduce copying.
 	if len(ss.state) > 0 {
@@ -1136,6 +1140,7 @@ type stageState struct {
 	inprogressKeys         set[string]                                      // all keys that are assigned to bundles.
 	inprogressKeysByBundle map[string]set[string]                           // bundle to key assignments.
 	state                  map[LinkID]map[typex.Window]map[string]StateData // state data for this stage, from {tid, stateID} -> window -> userKey
+	stateTypeLen           map[LinkID]func([]byte) int                      // map from state to a function that will produce the total length of a single value in bytes.
 
 	// Accounting for handling watermark holds for timers.
 	// We track the count of timers with the same hold, and clear it from
diff --git a/sdks/go/pkg/beam/runners/prism/internal/execute.go b/sdks/go/pkg/beam/runners/prism/internal/execute.go
index fde62f00c7c1..8b56c30eb61b 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/execute.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/execute.go
@@ -316,7 +316,7 @@ func executePipeline(ctx context.Context, wks map[string]*worker.W, j *jobservic
 			sort.Strings(outputs)
 			em.AddStage(stage.ID, []string{stage.primaryInput}, outputs, stage.sideInputs)
 			if stage.stateful {
-				em.StageStateful(stage.ID)
+				em.StageStateful(stage.ID, stage.stateTypeLen)
 			}
 			if stage.onWindowExpiration.TimerFamily != "" {
 				slog.Debug("OnWindowExpiration", slog.String("stage", stage.ID), slog.Any("values", stage.onWindowExpiration))
diff --git a/sdks/go/pkg/beam/runners/prism/internal/jobservices/management.go b/sdks/go/pkg/beam/runners/prism/internal/jobservices/management.go
index 894a6e1427a2..af559a92ab46 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/jobservices/management.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/jobservices/management.go
@@ -174,7 +174,8 @@ func (s *Server) Prepare(ctx context.Context, req *jobpb.PrepareJobRequest) (_ *
 			// Validate all the state features
 			for _, spec := range pardo.GetStateSpecs() {
 				isStateful = true
-				check("StateSpec.Protocol.Urn", spec.GetProtocol().GetUrn(), urns.UserStateBag, urns.UserStateMultiMap)
+				check("StateSpec.Protocol.Urn", spec.GetProtocol().GetUrn(),
+					urns.UserStateBag, urns.UserStateMultiMap, urns.UserStateOrderedList)
 			}
 			// Validate all the timer features
 			for _, spec := range pardo.GetTimerFamilySpecs() {
diff --git a/sdks/go/pkg/beam/runners/prism/internal/stage.go b/sdks/go/pkg/beam/runners/prism/internal/stage.go
index 9dd6cbdafec8..e1e942a06f0c 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/stage.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/stage.go
@@ -35,6 +35,7 @@ import (
 	"github.com/apache/beam/sdks/v2/go/pkg/beam/runners/prism/internal/worker"
 	"golang.org/x/exp/maps"
 	"google.golang.org/protobuf/encoding/prototext"
+	"google.golang.org/protobuf/encoding/protowire"
 	"google.golang.org/protobuf/proto"
 )
 
@@ -73,6 +74,10 @@ type stage struct {
 	hasTimers            []engine.StaticTimerID
 	processingTimeTimers map[string]bool
 
+	// stateTypeLen maps state values to encoded lengths for the type.
+	// Only used for OrderedListState which must manipulate individual state datavalues.
+	stateTypeLen map[engine.LinkID]func([]byte) int
+
 	exe              transformExecuter
 	inputTransformID string
 	inputInfo        engine.PColInfo
@@ -438,6 +443,38 @@ func buildDescriptor(stg *stage, comps *pipepb.Components, wk *worker.W, em *eng
 				rewriteCoder(&s.SetSpec.ElementCoderId)
 			case *pipepb.StateSpec_OrderedListSpec:
 				rewriteCoder(&s.OrderedListSpec.ElementCoderId)
+				// Add the length determination helper for OrderedList state values.
+				if stg.stateTypeLen == nil {
+					stg.stateTypeLen = map[engine.LinkID]func([]byte) int{}
+				}
+				linkID := engine.LinkID{
+					Transform: tid,
+					Local:     stateID,
+				}
+				var fn func([]byte) int
+				switch v := coders[s.OrderedListSpec.GetElementCoderId()]; v.GetSpec().GetUrn() {
+				case urns.CoderBool:
+					fn = func(_ []byte) int {
+						return 1
+					}
+				case urns.CoderDouble:
+					fn = func(_ []byte) int {
+						return 8
+					}
+				case urns.CoderVarInt:
+					fn = func(b []byte) int {
+						_, n := protowire.ConsumeVarint(b)
+						return int(n)
+					}
+				case urns.CoderLengthPrefix, urns.CoderBytes, urns.CoderStringUTF8:
+					fn = func(b []byte) int {
+						l, n := protowire.ConsumeVarint(b)
+						return int(l) + n
+					}
+				default:
+					rewriteErr = fmt.Errorf("unknown coder used for ordered list state after re-write id: %v coder: %v, for state %v for transform %v in stage %v", s.OrderedListSpec.GetElementCoderId(), v, stateID, tid, stg.ID)
+				}
+				stg.stateTypeLen[linkID] = fn
 			case *pipepb.StateSpec_CombiningSpec:
 				rewriteCoder(&s.CombiningSpec.AccumulatorCoderId)
 			case *pipepb.StateSpec_MapSpec:
diff --git a/sdks/go/pkg/beam/runners/prism/internal/urns/urns.go b/sdks/go/pkg/beam/runners/prism/internal/urns/urns.go
index 5312fd799c89..12e62ef84a81 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/urns/urns.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/urns/urns.go
@@ -95,8 +95,9 @@ var (
 	SideInputMultiMap = siUrn(pipepb.StandardSideInputTypes_MULTIMAP)
 
 	// UserState kinds
-	UserStateBag      = usUrn(pipepb.StandardUserStateTypes_BAG)
-	UserStateMultiMap = usUrn(pipepb.StandardUserStateTypes_MULTIMAP)
+	UserStateBag         = usUrn(pipepb.StandardUserStateTypes_BAG)
+	UserStateMultiMap    = usUrn(pipepb.StandardUserStateTypes_MULTIMAP)
+	UserStateOrderedList = usUrn(pipepb.StandardUserStateTypes_ORDERED_LIST)
 
 	// WindowsFns
 	WindowFnGlobal  = quickUrn(pipepb.GlobalWindowsPayload_PROPERTIES)
diff --git a/sdks/go/pkg/beam/runners/prism/internal/worker/worker.go b/sdks/go/pkg/beam/runners/prism/internal/worker/worker.go
index c2c988aa097f..9d9058975b26 100644
--- a/sdks/go/pkg/beam/runners/prism/internal/worker/worker.go
+++ b/sdks/go/pkg/beam/runners/prism/internal/worker/worker.go
@@ -554,6 +554,11 @@ func (wk *W) State(state fnpb.BeamFnState_StateServer) error {
 				case *fnpb.StateKey_MultimapKeysUserState_:
 					mmkey := key.GetMultimapKeysUserState()
 					data = b.OutputData.GetMultimapKeysState(engine.LinkID{Transform: mmkey.GetTransformId(), Local: mmkey.GetUserStateId()}, mmkey.GetWindow(), mmkey.GetKey())
+				case *fnpb.StateKey_OrderedListUserState_:
+					olkey := key.GetOrderedListUserState()
+					data = b.OutputData.GetOrderedListState(
+						engine.LinkID{Transform: olkey.GetTransformId(), Local: olkey.GetUserStateId()},
+						olkey.GetWindow(), olkey.GetKey(), olkey.GetRange().GetStart(), olkey.GetRange().GetEnd())
 				default:
 					panic(fmt.Sprintf("unsupported StateKey Get type: %T: %v", key.GetType(), prototext.Format(key)))
 				}
@@ -578,6 +583,11 @@ func (wk *W) State(state fnpb.BeamFnState_StateServer) error {
 				case *fnpb.StateKey_MultimapUserState_:
 					mmkey := key.GetMultimapUserState()
 					b.OutputData.AppendMultimapState(engine.LinkID{Transform: mmkey.GetTransformId(), Local: mmkey.GetUserStateId()}, mmkey.GetWindow(), mmkey.GetKey(), mmkey.GetMapKey(), req.GetAppend().GetData())
+				case *fnpb.StateKey_OrderedListUserState_:
+					olkey := key.GetOrderedListUserState()
+					b.OutputData.AppendOrderedListState(
+						engine.LinkID{Transform: olkey.GetTransformId(), Local: olkey.GetUserStateId()},
+						olkey.GetWindow(), olkey.GetKey(), req.GetAppend().GetData())
 				default:
 					panic(fmt.Sprintf("unsupported StateKey Append type: %T: %v", key.GetType(), prototext.Format(key)))
 				}
@@ -601,6 +611,10 @@ func (wk *W) State(state fnpb.BeamFnState_StateServer) error {
 				case *fnpb.StateKey_MultimapKeysUserState_:
 					mmkey := key.GetMultimapUserState()
 					b.OutputData.ClearMultimapKeysState(engine.LinkID{Transform: mmkey.GetTransformId(), Local: mmkey.GetUserStateId()}, mmkey.GetWindow(), mmkey.GetKey())
+				case *fnpb.StateKey_OrderedListUserState_:
+					olkey := key.GetOrderedListUserState()
+					b.OutputData.ClearOrderedListState(engine.LinkID{Transform: olkey.GetTransformId(), Local: olkey.GetUserStateId()},
+						olkey.GetWindow(), olkey.GetKey(), olkey.GetRange().GetStart(), olkey.GetRange().GetEnd())
 				default:
 					panic(fmt.Sprintf("unsupported StateKey Clear type: %T: %v", key.GetType(), prototext.Format(key)))
 				}

From 0e375012dbe954e6892a53a2623125e5b74daecb Mon Sep 17 00:00:00 2001
From: Jack McCluskey <34928439+jrmccluskey@users.noreply.github.com>
Date: Tue, 17 Dec 2024 14:44:13 -0500
Subject: [PATCH 131/135] Add TF MNIST classification cost benchmark (#33391)

* Add TF MNIST classification cost benchmark

* linting

* Generalize to single workflow file for cost benchmarks

* fix incorrect UTC time in comment

* move wordcount to same workflow

* update workflow job name
---
 ...> beam_Python_CostBenchmarks_Dataflow.yml} | 28 +++++++++----
 .../python_tf_mnist_classification.txt        | 29 +++++++++++++
 ...low_mnist_classification_cost_benchmark.py | 41 +++++++++++++++++++
 3 files changed, 91 insertions(+), 7 deletions(-)
 rename .github/workflows/{beam_Wordcount_Python_Cost_Benchmark_Dataflow.yml => beam_Python_CostBenchmarks_Dataflow.yml} (69%)
 create mode 100644 .github/workflows/cost-benchmarks-pipeline-options/python_tf_mnist_classification.txt
 create mode 100644 sdks/python/apache_beam/testing/benchmarks/inference/tensorflow_mnist_classification_cost_benchmark.py

diff --git a/.github/workflows/beam_Wordcount_Python_Cost_Benchmark_Dataflow.yml b/.github/workflows/beam_Python_CostBenchmarks_Dataflow.yml
similarity index 69%
rename from .github/workflows/beam_Wordcount_Python_Cost_Benchmark_Dataflow.yml
rename to .github/workflows/beam_Python_CostBenchmarks_Dataflow.yml
index 51d1005affbc..18fe37e142ac 100644
--- a/.github/workflows/beam_Wordcount_Python_Cost_Benchmark_Dataflow.yml
+++ b/.github/workflows/beam_Python_CostBenchmarks_Dataflow.yml
@@ -13,9 +13,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-name: Wordcount Python Cost Benchmarks Dataflow
+name: Python Cost Benchmarks Dataflow
 
 on:
+  schedule:
+    - cron: '30 18 * * 6' # Run at 6:30 pm UTC on Saturdays
   workflow_dispatch:
 
 #Setting explicit permissions for the action to avoid the default permissions which are `write-all` in case of pull_request_target event
@@ -47,16 +49,17 @@ env:
   INFLUXDB_USER_PASSWORD: ${{ secrets.INFLUXDB_USER_PASSWORD }}
 
 jobs:
-  beam_Inference_Python_Benchmarks_Dataflow:
+  beam_Python_Cost_Benchmarks_Dataflow:
     if: |
-      github.event_name == 'workflow_dispatch'
+      github.event_name == 'workflow_dispatch' ||
+      (github.event_name == 'schedule' && github.repository == 'apache/beam')
     runs-on: [self-hosted, ubuntu-20.04, main]
     timeout-minutes: 900
     name: ${{ matrix.job_name }} (${{ matrix.job_phrase }})
     strategy:
       matrix:
-        job_name: ["beam_Wordcount_Python_Cost_Benchmarks_Dataflow"]
-        job_phrase: ["Run Wordcount Cost Benchmark"]
+        job_name: ["beam_Python_CostBenchmark_Dataflow"]
+        job_phrase: ["Run Python Dataflow Cost Benchmarks"]
     steps:
       - uses: actions/checkout@v4
       - name: Setup repository
@@ -76,10 +79,11 @@ jobs:
           test-language: python
           argument-file-paths: |
             ${{ github.workspace }}/.github/workflows/cost-benchmarks-pipeline-options/python_wordcount.txt
+            ${{ github.workspace }}/.github/workflows/cost-benchmarks-pipeline-options/python_tf_mnist_classification.txt
       # The env variables are created and populated in the test-arguments-action as "<github.job>_test_arguments_<argument_file_paths_index>"
       - name: get current time
         run: echo "NOW_UTC=$(date '+%m%d%H%M%S' --utc)" >> $GITHUB_ENV
-      - name: run wordcount on Dataflow Python
+      - name: Run wordcount on Dataflow
         uses: ./.github/actions/gradle-command-self-hosted-action
         timeout-minutes: 30
         with:
@@ -88,4 +92,14 @@ jobs:
             -PloadTest.mainClass=apache_beam.testing.benchmarks.wordcount.wordcount \
             -Prunner=DataflowRunner \
             -PpythonVersion=3.10 \
-            '-PloadTest.args=${{ env.beam_Inference_Python_Benchmarks_Dataflow_test_arguments_1 }} --job_name=benchmark-tests-wordcount-python-${{env.NOW_UTC}} --output=gs://temp-storage-for-end-to-end-tests/wordcount/result_wordcount-${{env.NOW_UTC}}.txt' \
\ No newline at end of file
+            '-PloadTest.args=${{ env.beam_Inference_Python_Benchmarks_Dataflow_test_arguments_1 }} --job_name=benchmark-tests-wordcount-python-${{env.NOW_UTC}} --output_file=gs://temp-storage-for-end-to-end-tests/wordcount/result_wordcount-${{env.NOW_UTC}}.txt' \
+      - name: Run Tensorflow MNIST Image Classification on Dataflow
+        uses: ./.github/actions/gradle-command-self-hosted-action
+        timeout-minutes: 30
+        with:
+          gradle-command: :sdks:python:apache_beam:testing:load_tests:run
+          arguments: |
+            -PloadTest.mainClass=apache_beam.testing.benchmarks.inference.tensorflow_mnist_classification_cost_benchmark \
+            -Prunner=DataflowRunner \
+            -PpythonVersion=3.10 \
+            '-PloadTest.args=${{ env.beam_Inference_Python_Benchmarks_Dataflow_test_arguments_2 }} --job_name=benchmark-tests-tf-mnist-classification-python-${{env.NOW_UTC}} --input_file=gs://apache-beam-ml/testing/inputs/it_mnist_data.csv --output_file=gs://temp-storage-for-end-to-end-tests/wordcount/result_tf_mnist-${{env.NOW_UTC}}.txt --model=gs://apache-beam-ml/models/tensorflow/mnist/' \
\ No newline at end of file
diff --git a/.github/workflows/cost-benchmarks-pipeline-options/python_tf_mnist_classification.txt b/.github/workflows/cost-benchmarks-pipeline-options/python_tf_mnist_classification.txt
new file mode 100644
index 000000000000..01f4460b8c7e
--- /dev/null
+++ b/.github/workflows/cost-benchmarks-pipeline-options/python_tf_mnist_classification.txt
@@ -0,0 +1,29 @@
+#  Licensed to the Apache Software Foundation (ASF) under one
+#  or more contributor license agreements.  See the NOTICE file
+#  distributed with this work for additional information
+#  regarding copyright ownership.  The ASF licenses this file
+#  to you under the Apache License, Version 2.0 (the
+#  "License"); you may not use this file except in compliance
+#  with the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+--region=us-central1
+--machine_type=n1-standard-2
+--num_workers=1
+--disk_size_gb=50
+--autoscaling_algorithm=NONE
+--input_options={}
+--staging_location=gs://temp-storage-for-perf-tests/loadtests
+--temp_location=gs://temp-storage-for-perf-tests/loadtests
+--requirements_file=apache_beam/ml/inference/tensorflow_tests_requirements.txt
+--publish_to_big_query=true
+--metrics_dataset=beam_run_inference
+--metrics_table=tf_mnist_classification
+--runner=DataflowRunner
\ No newline at end of file
diff --git a/sdks/python/apache_beam/testing/benchmarks/inference/tensorflow_mnist_classification_cost_benchmark.py b/sdks/python/apache_beam/testing/benchmarks/inference/tensorflow_mnist_classification_cost_benchmark.py
new file mode 100644
index 000000000000..f7e12dcead03
--- /dev/null
+++ b/sdks/python/apache_beam/testing/benchmarks/inference/tensorflow_mnist_classification_cost_benchmark.py
@@ -0,0 +1,41 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# pytype: skip-file
+
+import logging
+
+from apache_beam.examples.inference import tensorflow_mnist_classification
+from apache_beam.testing.load_tests.dataflow_cost_benchmark import DataflowCostBenchmark
+
+
+class TensorflowMNISTClassificationCostBenchmark(DataflowCostBenchmark):
+  def __init__(self):
+    super().__init__()
+
+  def test(self):
+    extra_opts = {}
+    extra_opts['input'] = self.pipeline.get_option('input_file')
+    extra_opts['output'] = self.pipeline.get_option('output_file')
+    extra_opts['model_path'] = self.pipeline.get_option('model')
+    tensorflow_mnist_classification.run(
+        self.pipeline.get_full_options_as_args(**extra_opts),
+        save_main_session=False)
+
+
+if __name__ == '__main__':
+  logging.basicConfig(level=logging.INFO)
+  TensorflowMNISTClassificationCostBenchmark().run()

From e27ecedfda5ad83a07935d26a95849e86896885e Mon Sep 17 00:00:00 2001
From: Nick Anikin <52892974+an2x@users.noreply.github.com>
Date: Tue, 17 Dec 2024 15:56:51 -0500
Subject: [PATCH 132/135] Do no throw exceptions if commitSync fails in
 KafkaUnboundedReader. (#33402)

Committing consumer offsets to Kafka is not critical for KafkaIO because it relies on the offsets stored in KafkaCheckpointMark, but throwing an exception makes Dataflow retry the same work item unnecessarily.
---
 .../sdk/io/kafka/KafkaUnboundedReader.java    | 21 ++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/sdks/java/io/kafka/src/main/java/org/apache/beam/sdk/io/kafka/KafkaUnboundedReader.java b/sdks/java/io/kafka/src/main/java/org/apache/beam/sdk/io/kafka/KafkaUnboundedReader.java
index 069607955c6d..ab9e26b3b740 100644
--- a/sdks/java/io/kafka/src/main/java/org/apache/beam/sdk/io/kafka/KafkaUnboundedReader.java
+++ b/sdks/java/io/kafka/src/main/java/org/apache/beam/sdk/io/kafka/KafkaUnboundedReader.java
@@ -606,13 +606,20 @@ private void commitCheckpointMark() {
       LOG.debug("{}: Committing finalized checkpoint {}", this, checkpointMark);
       Consumer<byte[], byte[]> consumer = Preconditions.checkStateNotNull(this.consumer);
 
-      consumer.commitSync(
-          checkpointMark.getPartitions().stream()
-              .filter(p -> p.getNextOffset() != UNINITIALIZED_OFFSET)
-              .collect(
-                  Collectors.toMap(
-                      p -> new TopicPartition(p.getTopic(), p.getPartition()),
-                      p -> new OffsetAndMetadata(p.getNextOffset()))));
+      try {
+        consumer.commitSync(
+            checkpointMark.getPartitions().stream()
+                .filter(p -> p.getNextOffset() != UNINITIALIZED_OFFSET)
+                .collect(
+                    Collectors.toMap(
+                        p -> new TopicPartition(p.getTopic(), p.getPartition()),
+                        p -> new OffsetAndMetadata(p.getNextOffset()))));
+      } catch (Exception e) {
+        // Log but ignore the exception. Committing consumer offsets to Kafka is not critical for
+        // KafkaIO because it relies on the offsets stored in KafkaCheckpointMark.
+        LOG.warn(
+            String.format("%s: Could not commit finalized checkpoint %s", this, checkpointMark), e);
+      }
     }
   }
 

From 470d7d6194749ab0de9fdc39d3e45ed5a9d76aff Mon Sep 17 00:00:00 2001
From: Shunping Huang <shunping@google.com>
Date: Tue, 17 Dec 2024 16:27:28 -0500
Subject: [PATCH 133/135] Add missing to_type_hint to WindowedValueCoder
 (#33403)

* Add missing to_type_hint to WindowedValueCoder

* Add type ignore to make mypy happy.
---
 sdks/python/apache_beam/coders/coders.py      | 3 +++
 sdks/python/apache_beam/coders/coders_test.py | 6 ++++++
 2 files changed, 9 insertions(+)

diff --git a/sdks/python/apache_beam/coders/coders.py b/sdks/python/apache_beam/coders/coders.py
index e52c6048a15c..22d041f34f8b 100644
--- a/sdks/python/apache_beam/coders/coders.py
+++ b/sdks/python/apache_beam/coders/coders.py
@@ -1446,6 +1446,9 @@ def from_type_hint(cls, typehint, registry):
     # pickle coders.
     return cls(registry.get_coder(typehint.inner_type))
 
+  def to_type_hint(self):
+    return typehints.WindowedValue[self.wrapped_value_coder.to_type_hint()]
+
 
 Coder.register_structured_urn(
     common_urns.coders.WINDOWED_VALUE.urn, WindowedValueCoder)
diff --git a/sdks/python/apache_beam/coders/coders_test.py b/sdks/python/apache_beam/coders/coders_test.py
index dc9780e36be3..bddd2cb57e06 100644
--- a/sdks/python/apache_beam/coders/coders_test.py
+++ b/sdks/python/apache_beam/coders/coders_test.py
@@ -258,6 +258,12 @@ def test_numpy_int(self):
         _ = indata | "CombinePerKey" >> beam.CombinePerKey(sum)
 
 
+class WindowedValueCoderTest(unittest.TestCase):
+  def test_to_type_hint(self):
+    coder = coders.WindowedValueCoder(coders.VarIntCoder())
+    self.assertEqual(coder.to_type_hint(), typehints.WindowedValue[int])  # type: ignore[misc]
+
+
 if __name__ == '__main__':
   logging.getLogger().setLevel(logging.INFO)
   unittest.main()

From a9f50fae94b49a4e83acb131c04a34731a4a6604 Mon Sep 17 00:00:00 2001
From: Ahmed Abualsaud <65791736+ahmedabu98@users.noreply.github.com>
Date: Tue, 17 Dec 2024 16:30:21 -0500
Subject: [PATCH 134/135] Python ExternalTransformProvider improvements
 (#33359)

---
 .../python/apache_beam/transforms/external.py | 14 ++--
 .../transforms/external_transform_provider.py | 65 +++++++++++++------
 2 files changed, 51 insertions(+), 28 deletions(-)

diff --git a/sdks/python/apache_beam/transforms/external.py b/sdks/python/apache_beam/transforms/external.py
index e44f7482dc61..fb37a8fd974d 100644
--- a/sdks/python/apache_beam/transforms/external.py
+++ b/sdks/python/apache_beam/transforms/external.py
@@ -962,14 +962,14 @@ def __init__(
       self, path_to_jar, extra_args=None, classpath=None, append_args=None):
     if extra_args and append_args:
       raise ValueError('Only one of extra_args or append_args may be provided')
-    self._path_to_jar = path_to_jar
+    self.path_to_jar = path_to_jar
     self._extra_args = extra_args
     self._classpath = classpath or []
     self._service_count = 0
     self._append_args = append_args or []
 
   def is_existing_service(self):
-    return subprocess_server.is_service_endpoint(self._path_to_jar)
+    return subprocess_server.is_service_endpoint(self.path_to_jar)
 
   @staticmethod
   def _expand_jars(jar):
@@ -997,7 +997,7 @@ def _expand_jars(jar):
   def _default_args(self):
     """Default arguments to be used by `JavaJarExpansionService`."""
 
-    to_stage = ','.join([self._path_to_jar] + sum((
+    to_stage = ','.join([self.path_to_jar] + sum((
         JavaJarExpansionService._expand_jars(jar)
         for jar in self._classpath or []), []))
     args = ['{{PORT}}', f'--filesToStage={to_stage}']
@@ -1009,8 +1009,8 @@ def _default_args(self):
 
   def __enter__(self):
     if self._service_count == 0:
-      self._path_to_jar = subprocess_server.JavaJarServer.local_jar(
-          self._path_to_jar)
+      self.path_to_jar = subprocess_server.JavaJarServer.local_jar(
+          self.path_to_jar)
       if self._extra_args is None:
         self._extra_args = self._default_args() + self._append_args
       # Consider memoizing these servers (with some timeout).
@@ -1018,7 +1018,7 @@ def __enter__(self):
           'Starting a JAR-based expansion service from JAR %s ' + (
               'and with classpath: %s' %
               self._classpath if self._classpath else ''),
-          self._path_to_jar)
+          self.path_to_jar)
       classpath_urls = [
           subprocess_server.JavaJarServer.local_jar(path)
           for jar in self._classpath
@@ -1026,7 +1026,7 @@ def __enter__(self):
       ]
       self._service_provider = subprocess_server.JavaJarServer(
           ExpansionAndArtifactRetrievalStub,
-          self._path_to_jar,
+          self.path_to_jar,
           self._extra_args,
           classpath=classpath_urls)
       self._service = self._service_provider.__enter__()
diff --git a/sdks/python/apache_beam/transforms/external_transform_provider.py b/sdks/python/apache_beam/transforms/external_transform_provider.py
index 117c7f7c9b93..b22cd4b24cb6 100644
--- a/sdks/python/apache_beam/transforms/external_transform_provider.py
+++ b/sdks/python/apache_beam/transforms/external_transform_provider.py
@@ -26,6 +26,7 @@
 
 from apache_beam.transforms import PTransform
 from apache_beam.transforms.external import BeamJarExpansionService
+from apache_beam.transforms.external import JavaJarExpansionService
 from apache_beam.transforms.external import SchemaAwareExternalTransform
 from apache_beam.transforms.external import SchemaTransformsConfig
 from apache_beam.typehints.schemas import named_tuple_to_schema
@@ -133,37 +134,57 @@ class ExternalTransformProvider:
   (see the `urn_pattern` parameter).
 
   These classes are generated when :class:`ExternalTransformProvider` is
-  initialized. We need to give it one or more expansion service addresses that
-  are already up and running:
-  >>> provider = ExternalTransformProvider(["localhost:12345",
-  ...                                             "localhost:12121"])
-  We can also give it the gradle target of a standard Beam expansion service:
-  >>> provider = ExternalTransform(BeamJarExpansionService(
-  ...     "sdks:java:io:google-cloud-platform:expansion-service:shadowJar"))
-  Let's take a look at the output of :func:`get_available()` to know the
-  available transforms in the expansion service(s) we provided:
+  initialized. You can give it an expansion service address that is already
+  up and running:
+
+  >>> provider = ExternalTransformProvider("localhost:12345")
+
+  Or you can give it the path to an expansion service Jar file:
+
+  >>> provider = ExternalTransformProvider(JavaJarExpansionService(
+          "path/to/expansion-service.jar"))
+
+  Or you can give it the gradle target of a standard Beam expansion service:
+
+  >>> provider = ExternalTransformProvider(BeamJarExpansionService(
+          "sdks:java:io:google-cloud-platform:expansion-service:shadowJar"))
+
+  Note that you can provide a list of these services:
+
+  >>> provider = ExternalTransformProvider([
+          "localhost:12345",
+          JavaJarExpansionService("path/to/expansion-service.jar"),
+          BeamJarExpansionService(
+            "sdks:java:io:google-cloud-platform:expansion-service:shadowJar")])
+
+  The output of :func:`get_available()` provides a list of available transforms
+  in the provided expansion service(s):
+
   >>> provider.get_available()
   [('JdbcWrite', 'beam:schematransform:org.apache.beam:jdbc_write:v1'),
   ('BigtableRead', 'beam:schematransform:org.apache.beam:bigtable_read:v1'),
   ...]
 
-  Then retrieve a transform by :func:`get()`, :func:`get_urn()`, or by directly
-  accessing it as an attribute of :class:`ExternalTransformProvider`.
-  All of the following commands do the same thing:
+  You can retrieve a transform with :func:`get()`, :func:`get_urn()`, or by
+  directly accessing it as an attribute. The following lines all do the same
+  thing:
+
   >>> provider.get('BigqueryStorageRead')
   >>> provider.get_urn(
-  ...       'beam:schematransform:org.apache.beam:bigquery_storage_read:v1')
+            'beam:schematransform:org.apache.beam:bigquery_storage_read:v1')
   >>> provider.BigqueryStorageRead
 
-  You can inspect the transform's documentation to know more about it. This
-  returns some documentation only IF the underlying SchemaTransform
-  implementation provides any.
+  You can inspect the transform's documentation for more details. The following
+  returns the documentation provided by the underlying SchemaTransform. If no
+  such documentation is provided, this will be empty.
+
   >>> import inspect
   >>> inspect.getdoc(provider.BigqueryStorageRead)
 
   Similarly, you can inspect the transform's signature to know more about its
   parameters, including their names, types, and any documentation that the
   underlying SchemaTransform may provide:
+
   >>> inspect.signature(provider.BigqueryStorageRead)
   (query: 'typing.Union[str, NoneType]: The SQL query to be executed to...',
   row_restriction: 'typing.Union[str, NoneType]: Read only rows that match...',
@@ -178,8 +199,6 @@ class ExternalTransformProvider:
                 query=query,
                 row_restriction=restriction)
         | 'Some processing' >> beam.Map(...))
-
-  Experimental; no backwards compatibility guarantees.
   """
   def __init__(self, expansion_services, urn_pattern=STANDARD_URN_PATTERN):
     f"""Initialize an ExternalTransformProvider
@@ -188,6 +207,7 @@ def __init__(self, expansion_services, urn_pattern=STANDARD_URN_PATTERN):
       A list of expansion services to discover transforms from.
       Supported forms:
       * a string representing the expansion service address
+      * a :attr:`JavaJarExpansionService` pointing to the path of a Java Jar
       * a :attr:`BeamJarExpansionService` pointing to a gradle target
     :param urn_pattern:
       The regular expression used to match valid transforms. In addition to
@@ -213,11 +233,14 @@ def _create_wrappers(self):
       target = service
       if isinstance(service, BeamJarExpansionService):
         target = service.gradle_target
+      if isinstance(service, JavaJarExpansionService):
+        target = service.path_to_jar
       try:
         schematransform_configs = SchemaAwareExternalTransform.discover(service)
       except Exception as e:
         logging.exception(
-            "Encountered an error while discovering expansion service %s:\n%s",
+            "Encountered an error while discovering "
+            "expansion service at '%s':\n%s",
             target,
             e)
         continue
@@ -249,7 +272,7 @@ def _create_wrappers(self):
 
       if skipped_urns:
         logging.info(
-            "Skipped URN(s) in %s that don't follow the pattern \"%s\": %s",
+            "Skipped URN(s) in '%s' that don't follow the pattern \"%s\": %s",
             target,
             self._urn_pattern,
             skipped_urns)
@@ -262,7 +285,7 @@ def get_available(self) -> List[Tuple[str, str]]:
     return list(self._name_to_urn.items())
 
   def get_all(self) -> Dict[str, ExternalTransform]:
-    """Get all ExternalTransform"""
+    """Get all ExternalTransforms"""
     return self._transforms
 
   def get(self, name) -> ExternalTransform:

From 286e29cb7a57c7a716de080167bfaf729251fd45 Mon Sep 17 00:00:00 2001
From: Ahmed Abualsaud <65791736+ahmedabu98@users.noreply.github.com>
Date: Tue, 17 Dec 2024 16:33:50 -0500
Subject: [PATCH 135/135] [Managed Iceberg] Support partitioning time types
 (year, month, day, hour) (#32939)

---
 .../IO_Iceberg_Integration_Tests.json         |   2 +-
 CHANGES.md                                    |   1 +
 .../sdk/io/iceberg/RecordWriterManager.java   |  79 +++++-
 .../sdk/io/iceberg/SerializableDataFile.java  |   5 +-
 .../beam/sdk/io/iceberg/IcebergIOIT.java      |   2 +-
 ...ebergWriteSchemaTransformProviderTest.java |  98 ++++++++
 .../io/iceberg/RecordWriterManagerTest.java   | 224 +++++++++++++++++-
 7 files changed, 402 insertions(+), 9 deletions(-)

diff --git a/.github/trigger_files/IO_Iceberg_Integration_Tests.json b/.github/trigger_files/IO_Iceberg_Integration_Tests.json
index bbdc3a3910ef..2160d3c68005 100644
--- a/.github/trigger_files/IO_Iceberg_Integration_Tests.json
+++ b/.github/trigger_files/IO_Iceberg_Integration_Tests.json
@@ -1,4 +1,4 @@
 {
     "comment": "Modify this file in a trivial way to cause this test suite to run",
-    "modification": 3
+    "modification": 5
 }
diff --git a/CHANGES.md b/CHANGES.md
index deaa8bfcd471..7707e252961b 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -65,6 +65,7 @@
 
 * gcs-connector config options can be set via GcsOptions (Java) ([#32769](https://github.com/apache/beam/pull/32769)).
 * Support for X source added (Java/Python) ([#X](https://github.com/apache/beam/issues/X)).
+* [Managed Iceberg] Support partitioning by time (year, month, day, hour) for types `date`, `time`, `timestamp`, and `timestamp(tz)` ([#32939](https://github.com/apache/beam/pull/32939))
 * Upgraded the default version of Hadoop dependencies to 3.4.1. Hadoop 2.10.2 is still supported (Java) ([#33011](https://github.com/apache/beam/issues/33011)).
 * [BigQueryIO] Create managed BigLake tables dynamically ([#33125](https://github.com/apache/beam/pull/33125))
 
diff --git a/sdks/java/io/iceberg/src/main/java/org/apache/beam/sdk/io/iceberg/RecordWriterManager.java b/sdks/java/io/iceberg/src/main/java/org/apache/beam/sdk/io/iceberg/RecordWriterManager.java
index 255fce9ece4e..4c21a0175ab0 100644
--- a/sdks/java/io/iceberg/src/main/java/org/apache/beam/sdk/io/iceberg/RecordWriterManager.java
+++ b/sdks/java/io/iceberg/src/main/java/org/apache/beam/sdk/io/iceberg/RecordWriterManager.java
@@ -21,6 +21,11 @@
 import static org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.base.Preconditions.checkState;
 
 import java.io.IOException;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.time.ZoneOffset;
+import java.time.format.DateTimeFormatter;
+import java.time.temporal.ChronoUnit;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
@@ -31,6 +36,7 @@
 import org.apache.beam.sdk.util.WindowedValue;
 import org.apache.beam.sdk.values.Row;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.annotations.VisibleForTesting;
+import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.base.Splitter;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.Cache;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.CacheBuilder;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.cache.RemovalNotification;
@@ -38,14 +44,20 @@
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.Maps;
 import org.apache.iceberg.DataFile;
 import org.apache.iceberg.ManifestFile;
+import org.apache.iceberg.PartitionField;
 import org.apache.iceberg.PartitionKey;
 import org.apache.iceberg.PartitionSpec;
 import org.apache.iceberg.Table;
 import org.apache.iceberg.catalog.Catalog;
 import org.apache.iceberg.catalog.TableIdentifier;
+import org.apache.iceberg.data.GenericRecord;
 import org.apache.iceberg.data.Record;
 import org.apache.iceberg.exceptions.AlreadyExistsException;
 import org.apache.iceberg.exceptions.NoSuchTableException;
+import org.apache.iceberg.expressions.Literal;
+import org.apache.iceberg.transforms.Transform;
+import org.apache.iceberg.transforms.Transforms;
+import org.apache.iceberg.types.Types;
 import org.checkerframework.checker.nullness.qual.Nullable;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -90,6 +102,7 @@ class DestinationState {
     final Cache<PartitionKey, RecordWriter> writers;
     private final List<SerializableDataFile> dataFiles = Lists.newArrayList();
     @VisibleForTesting final Map<PartitionKey, Integer> writerCounts = Maps.newHashMap();
+    private final Map<String, PartitionField> partitionFieldMap = Maps.newHashMap();
     private final List<Exception> exceptions = Lists.newArrayList();
 
     DestinationState(IcebergDestination icebergDestination, Table table) {
@@ -98,6 +111,9 @@ class DestinationState {
       this.spec = table.spec();
       this.partitionKey = new PartitionKey(spec, schema);
       this.table = table;
+      for (PartitionField partitionField : spec.fields()) {
+        partitionFieldMap.put(partitionField.name(), partitionField);
+      }
 
       // build a cache of RecordWriters.
       // writers will expire after 1 min of idle time.
@@ -123,7 +139,9 @@ class DestinationState {
                       throw rethrow;
                     }
                     openWriters--;
-                    dataFiles.add(SerializableDataFile.from(recordWriter.getDataFile(), pk));
+                    String partitionPath = getPartitionDataPath(pk.toPath(), partitionFieldMap);
+                    dataFiles.add(
+                        SerializableDataFile.from(recordWriter.getDataFile(), partitionPath));
                   })
               .build();
     }
@@ -136,7 +154,7 @@ class DestinationState {
      * can't create a new writer, the {@link Record} is rejected and {@code false} is returned.
      */
     boolean write(Record record) {
-      partitionKey.partition(record);
+      partitionKey.partition(getPartitionableRecord(record));
 
       if (!writers.asMap().containsKey(partitionKey) && openWriters >= maxNumWriters) {
         return false;
@@ -185,8 +203,65 @@ private RecordWriter createWriter(PartitionKey partitionKey) {
             e);
       }
     }
+
+    /**
+     * Resolves an input {@link Record}'s partition values and returns another {@link Record} that
+     * can be applied to the destination's {@link PartitionSpec}.
+     */
+    private Record getPartitionableRecord(Record record) {
+      if (spec.isUnpartitioned()) {
+        return record;
+      }
+      Record output = GenericRecord.create(schema);
+      for (PartitionField partitionField : spec.fields()) {
+        Transform<?, ?> transform = partitionField.transform();
+        Types.NestedField field = schema.findField(partitionField.sourceId());
+        String name = field.name();
+        Object value = record.getField(name);
+        @Nullable Literal<Object> literal = Literal.of(value.toString()).to(field.type());
+        if (literal == null || transform.isVoid() || transform.isIdentity()) {
+          output.setField(name, value);
+        } else {
+          output.setField(name, literal.value());
+        }
+      }
+      return output;
+    }
   }
 
+  /**
+   * Returns an equivalent partition path that is made up of partition data. Needed to reconstruct a
+   * {@link DataFile}.
+   */
+  @VisibleForTesting
+  static String getPartitionDataPath(
+      String partitionPath, Map<String, PartitionField> partitionFieldMap) {
+    if (partitionPath.isEmpty() || partitionFieldMap.isEmpty()) {
+      return partitionPath;
+    }
+    List<String> resolved = new ArrayList<>();
+    for (String partition : Splitter.on('/').splitToList(partitionPath)) {
+      List<String> nameAndValue = Splitter.on('=').splitToList(partition);
+      String name = nameAndValue.get(0);
+      String value = nameAndValue.get(1);
+      String transformName =
+          Preconditions.checkArgumentNotNull(partitionFieldMap.get(name)).transform().toString();
+      if (Transforms.month().toString().equals(transformName)) {
+        int month = YearMonth.parse(value).getMonthValue();
+        value = String.valueOf(month);
+      } else if (Transforms.hour().toString().equals(transformName)) {
+        long hour = ChronoUnit.HOURS.between(EPOCH, LocalDateTime.parse(value, HOUR_FORMATTER));
+        value = String.valueOf(hour);
+      }
+      resolved.add(name + "=" + value);
+    }
+    return String.join("/", resolved);
+  }
+
+  private static final DateTimeFormatter HOUR_FORMATTER =
+      DateTimeFormatter.ofPattern("yyyy-MM-dd-HH");
+  private static final LocalDateTime EPOCH = LocalDateTime.ofEpochSecond(0, 0, ZoneOffset.UTC);
+
   private final Catalog catalog;
   private final String filePrefix;
   private final long maxFileSize;
diff --git a/sdks/java/io/iceberg/src/main/java/org/apache/beam/sdk/io/iceberg/SerializableDataFile.java b/sdks/java/io/iceberg/src/main/java/org/apache/beam/sdk/io/iceberg/SerializableDataFile.java
index 59b456162008..eef2b154d243 100644
--- a/sdks/java/io/iceberg/src/main/java/org/apache/beam/sdk/io/iceberg/SerializableDataFile.java
+++ b/sdks/java/io/iceberg/src/main/java/org/apache/beam/sdk/io/iceberg/SerializableDataFile.java
@@ -116,13 +116,14 @@ abstract static class Builder {
    * Create a {@link SerializableDataFile} from a {@link DataFile} and its associated {@link
    * PartitionKey}.
    */
-  static SerializableDataFile from(DataFile f, PartitionKey key) {
+  static SerializableDataFile from(DataFile f, String partitionPath) {
+
     return SerializableDataFile.builder()
         .setPath(f.path().toString())
         .setFileFormat(f.format().toString())
         .setRecordCount(f.recordCount())
         .setFileSizeInBytes(f.fileSizeInBytes())
-        .setPartitionPath(key.toPath())
+        .setPartitionPath(partitionPath)
         .setPartitionSpecId(f.specId())
         .setKeyMetadata(f.keyMetadata())
         .setSplitOffsets(f.splitOffsets())
diff --git a/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergIOIT.java b/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergIOIT.java
index c79b0a550051..a060bc16d6c7 100644
--- a/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergIOIT.java
+++ b/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergIOIT.java
@@ -354,7 +354,7 @@ public void testWritePartitionedData() {
     PartitionSpec partitionSpec =
         PartitionSpec.builderFor(ICEBERG_SCHEMA)
             .identity("bool")
-            .identity("modulo_5")
+            .hour("datetime")
             .truncate("str", "value_x".length())
             .build();
     Table table =
diff --git a/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergWriteSchemaTransformProviderTest.java b/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergWriteSchemaTransformProviderTest.java
index 47dc9aa425dd..9834547c4741 100644
--- a/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergWriteSchemaTransformProviderTest.java
+++ b/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/IcebergWriteSchemaTransformProviderTest.java
@@ -23,14 +23,19 @@
 import static org.hamcrest.MatcherAssert.assertThat;
 import static org.junit.Assert.assertEquals;
 
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.UUID;
+import org.apache.beam.sdk.Pipeline;
 import org.apache.beam.sdk.managed.Managed;
 import org.apache.beam.sdk.schemas.Schema;
+import org.apache.beam.sdk.schemas.logicaltypes.SqlTypes;
 import org.apache.beam.sdk.testing.PAssert;
 import org.apache.beam.sdk.testing.TestPipeline;
 import org.apache.beam.sdk.testing.TestStream;
@@ -49,12 +54,16 @@
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableList;
 import org.apache.beam.vendor.guava.v32_1_2_jre.com.google.common.collect.ImmutableMap;
 import org.apache.iceberg.CatalogUtil;
+import org.apache.iceberg.PartitionSpec;
 import org.apache.iceberg.Table;
 import org.apache.iceberg.catalog.TableIdentifier;
 import org.apache.iceberg.data.IcebergGenerics;
 import org.apache.iceberg.data.Record;
+import org.apache.iceberg.util.DateTimeUtil;
 import org.checkerframework.checker.nullness.qual.Nullable;
 import org.hamcrest.Matchers;
+import org.joda.time.DateTime;
+import org.joda.time.DateTimeZone;
 import org.joda.time.Duration;
 import org.joda.time.Instant;
 import org.junit.ClassRule;
@@ -360,4 +369,93 @@ public Void apply(Iterable<Row> input) {
       return null;
     }
   }
+
+  @Test
+  public void testWritePartitionedData() {
+    Schema schema =
+        Schema.builder()
+            .addStringField("str")
+            .addInt32Field("int")
+            .addLogicalTypeField("y_date", SqlTypes.DATE)
+            .addLogicalTypeField("y_datetime", SqlTypes.DATETIME)
+            .addDateTimeField("y_datetime_tz")
+            .addLogicalTypeField("m_date", SqlTypes.DATE)
+            .addLogicalTypeField("m_datetime", SqlTypes.DATETIME)
+            .addDateTimeField("m_datetime_tz")
+            .addLogicalTypeField("d_date", SqlTypes.DATE)
+            .addLogicalTypeField("d_datetime", SqlTypes.DATETIME)
+            .addDateTimeField("d_datetime_tz")
+            .addLogicalTypeField("h_datetime", SqlTypes.DATETIME)
+            .addDateTimeField("h_datetime_tz")
+            .build();
+    org.apache.iceberg.Schema icebergSchema = IcebergUtils.beamSchemaToIcebergSchema(schema);
+    PartitionSpec spec =
+        PartitionSpec.builderFor(icebergSchema)
+            .identity("str")
+            .bucket("int", 5)
+            .year("y_date")
+            .year("y_datetime")
+            .year("y_datetime_tz")
+            .month("m_date")
+            .month("m_datetime")
+            .month("m_datetime_tz")
+            .day("d_date")
+            .day("d_datetime")
+            .day("d_datetime_tz")
+            .hour("h_datetime")
+            .hour("h_datetime_tz")
+            .build();
+    String identifier = "default.table_" + Long.toString(UUID.randomUUID().hashCode(), 16);
+
+    warehouse.createTable(TableIdentifier.parse(identifier), icebergSchema, spec);
+    Map<String, Object> config =
+        ImmutableMap.of(
+            "table",
+            identifier,
+            "catalog_properties",
+            ImmutableMap.of("type", "hadoop", "warehouse", warehouse.location));
+
+    List<Row> rows = new ArrayList<>();
+    for (int i = 0; i < 30; i++) {
+      long millis = i * 100_00_000_000L;
+      LocalDate localDate = DateTimeUtil.dateFromDays(i * 100);
+      LocalDateTime localDateTime = DateTimeUtil.timestampFromMicros(millis * 1000);
+      DateTime dateTime = new DateTime(millis).withZone(DateTimeZone.forOffsetHoursMinutes(3, 25));
+      Row row =
+          Row.withSchema(schema)
+              .addValues(
+                  "str_" + i,
+                  i,
+                  localDate,
+                  localDateTime,
+                  dateTime,
+                  localDate,
+                  localDateTime,
+                  dateTime,
+                  localDate,
+                  localDateTime,
+                  dateTime,
+                  localDateTime,
+                  dateTime)
+              .build();
+      rows.add(row);
+    }
+
+    PCollection<Row> result =
+        testPipeline
+            .apply("Records To Add", Create.of(rows))
+            .setRowSchema(schema)
+            .apply(Managed.write(Managed.ICEBERG).withConfig(config))
+            .get(SNAPSHOTS_TAG);
+
+    PAssert.that(result)
+        .satisfies(new VerifyOutputs(Collections.singletonList(identifier), "append"));
+    testPipeline.run().waitUntilFinish();
+
+    Pipeline p = Pipeline.create(TestPipeline.testingPipelineOptions());
+    PCollection<Row> readRows =
+        p.apply(Managed.read(Managed.ICEBERG).withConfig(config)).getSinglePCollection();
+    PAssert.that(readRows).containsInAnyOrder(rows);
+    p.run();
+  }
 }
diff --git a/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/RecordWriterManagerTest.java b/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/RecordWriterManagerTest.java
index 2bce390e0992..5168f71fef99 100644
--- a/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/RecordWriterManagerTest.java
+++ b/sdks/java/io/iceberg/src/test/java/org/apache/beam/sdk/io/iceberg/RecordWriterManagerTest.java
@@ -27,9 +27,14 @@
 import static org.junit.Assert.assertTrue;
 
 import java.io.IOException;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import org.apache.beam.sdk.schemas.Schema;
+import org.apache.beam.sdk.schemas.logicaltypes.SqlTypes;
 import org.apache.beam.sdk.transforms.windowing.GlobalWindow;
 import org.apache.beam.sdk.transforms.windowing.PaneInfo;
 import org.apache.beam.sdk.util.WindowedValue;
@@ -39,6 +44,7 @@
 import org.apache.hadoop.conf.Configuration;
 import org.apache.iceberg.DataFile;
 import org.apache.iceberg.FileFormat;
+import org.apache.iceberg.PartitionField;
 import org.apache.iceberg.PartitionKey;
 import org.apache.iceberg.PartitionSpec;
 import org.apache.iceberg.Table;
@@ -46,6 +52,8 @@
 import org.apache.iceberg.catalog.TableIdentifier;
 import org.apache.iceberg.hadoop.HadoopCatalog;
 import org.checkerframework.checker.nullness.qual.Nullable;
+import org.joda.time.DateTime;
+import org.joda.time.DateTimeZone;
 import org.junit.Before;
 import org.junit.ClassRule;
 import org.junit.Rule;
@@ -85,9 +93,14 @@ public void setUp() {
 
   private WindowedValue<IcebergDestination> getWindowedDestination(
       String tableName, @Nullable PartitionSpec partitionSpec) {
+    return getWindowedDestination(tableName, ICEBERG_SCHEMA, partitionSpec);
+  }
+
+  private WindowedValue<IcebergDestination> getWindowedDestination(
+      String tableName, org.apache.iceberg.Schema schema, @Nullable PartitionSpec partitionSpec) {
     TableIdentifier tableIdentifier = TableIdentifier.of("default", tableName);
 
-    warehouse.createTable(tableIdentifier, ICEBERG_SCHEMA, partitionSpec);
+    warehouse.createTable(tableIdentifier, schema, partitionSpec);
 
     IcebergDestination icebergDestination =
         IcebergDestination.builder()
@@ -314,8 +327,15 @@ public void testSerializableDataFileRoundTripEquality() throws IOException {
     DataFile datafile = writer.getDataFile();
     assertEquals(2L, datafile.recordCount());
 
+    Map<String, PartitionField> partitionFieldMap = new HashMap<>();
+    for (PartitionField partitionField : PARTITION_SPEC.fields()) {
+      partitionFieldMap.put(partitionField.name(), partitionField);
+    }
+
+    String partitionPath =
+        RecordWriterManager.getPartitionDataPath(partitionKey.toPath(), partitionFieldMap);
     DataFile roundTripDataFile =
-        SerializableDataFile.from(datafile, partitionKey)
+        SerializableDataFile.from(datafile, partitionPath)
             .createDataFile(ImmutableMap.of(PARTITION_SPEC.specId(), PARTITION_SPEC));
 
     checkDataFileEquality(datafile, roundTripDataFile);
@@ -347,8 +367,14 @@ public void testRecreateSerializableDataAfterUpdatingPartitionSpec() throws IOEx
     writer.close();
 
     // fetch data file and its serializable version
+    Map<String, PartitionField> partitionFieldMap = new HashMap<>();
+    for (PartitionField partitionField : PARTITION_SPEC.fields()) {
+      partitionFieldMap.put(partitionField.name(), partitionField);
+    }
+    String partitionPath =
+        RecordWriterManager.getPartitionDataPath(partitionKey.toPath(), partitionFieldMap);
     DataFile datafile = writer.getDataFile();
-    SerializableDataFile serializableDataFile = SerializableDataFile.from(datafile, partitionKey);
+    SerializableDataFile serializableDataFile = SerializableDataFile.from(datafile, partitionPath);
 
     assertEquals(2L, datafile.recordCount());
     assertEquals(serializableDataFile.getPartitionSpecId(), datafile.specId());
@@ -415,6 +441,198 @@ public void testWriterKeepsUpWithUpdatingPartitionSpec() throws IOException {
     }
   }
 
+  @Test
+  public void testIdentityPartitioning() throws IOException {
+    Schema primitiveTypeSchema =
+        Schema.builder()
+            .addBooleanField("bool")
+            .addInt32Field("int")
+            .addInt64Field("long")
+            .addFloatField("float")
+            .addDoubleField("double")
+            .addStringField("str")
+            .build();
+
+    Row row =
+        Row.withSchema(primitiveTypeSchema).addValues(true, 1, 1L, 1.23f, 4.56, "str").build();
+    org.apache.iceberg.Schema icebergSchema =
+        IcebergUtils.beamSchemaToIcebergSchema(primitiveTypeSchema);
+    PartitionSpec spec =
+        PartitionSpec.builderFor(icebergSchema)
+            .identity("bool")
+            .identity("int")
+            .identity("long")
+            .identity("float")
+            .identity("double")
+            .identity("str")
+            .build();
+    WindowedValue<IcebergDestination> dest =
+        getWindowedDestination("identity_partitioning", icebergSchema, spec);
+
+    RecordWriterManager writer =
+        new RecordWriterManager(catalog, "test_prefix", Long.MAX_VALUE, Integer.MAX_VALUE);
+    writer.write(dest, row);
+    writer.close();
+    List<SerializableDataFile> files = writer.getSerializableDataFiles().get(dest);
+    assertEquals(1, files.size());
+    SerializableDataFile dataFile = files.get(0);
+    assertEquals(1, dataFile.getRecordCount());
+    // build this string: bool=true/int=1/long=1/float=1.0/double=1.0/str=str
+    List<String> expectedPartitions = new ArrayList<>();
+    for (Schema.Field field : primitiveTypeSchema.getFields()) {
+      Object val = row.getValue(field.getName());
+      expectedPartitions.add(field.getName() + "=" + val);
+    }
+    String expectedPartitionPath = String.join("/", expectedPartitions);
+    assertEquals(expectedPartitionPath, dataFile.getPartitionPath());
+    assertThat(dataFile.getPath(), containsString(expectedPartitionPath));
+  }
+
+  @Test
+  public void testBucketPartitioning() throws IOException {
+    Schema bucketSchema =
+        Schema.builder()
+            .addInt32Field("int")
+            .addInt64Field("long")
+            .addStringField("str")
+            .addLogicalTypeField("date", SqlTypes.DATE)
+            .addLogicalTypeField("time", SqlTypes.TIME)
+            .addLogicalTypeField("datetime", SqlTypes.DATETIME)
+            .addDateTimeField("datetime_tz")
+            .build();
+
+    String timestamp = "2024-10-08T13:18:20.053";
+    LocalDateTime localDateTime = LocalDateTime.parse(timestamp);
+
+    Row row =
+        Row.withSchema(bucketSchema)
+            .addValues(
+                1,
+                1L,
+                "str",
+                localDateTime.toLocalDate(),
+                localDateTime.toLocalTime(),
+                localDateTime,
+                DateTime.parse(timestamp))
+            .build();
+    org.apache.iceberg.Schema icebergSchema = IcebergUtils.beamSchemaToIcebergSchema(bucketSchema);
+    PartitionSpec spec =
+        PartitionSpec.builderFor(icebergSchema)
+            .bucket("int", 2)
+            .bucket("long", 2)
+            .bucket("str", 2)
+            .bucket("date", 2)
+            .bucket("time", 2)
+            .bucket("datetime", 2)
+            .bucket("datetime_tz", 2)
+            .build();
+    WindowedValue<IcebergDestination> dest =
+        getWindowedDestination("bucket_partitioning", icebergSchema, spec);
+
+    RecordWriterManager writer =
+        new RecordWriterManager(catalog, "test_prefix", Long.MAX_VALUE, Integer.MAX_VALUE);
+    writer.write(dest, row);
+    writer.close();
+    List<SerializableDataFile> files = writer.getSerializableDataFiles().get(dest);
+    assertEquals(1, files.size());
+    SerializableDataFile dataFile = files.get(0);
+    assertEquals(1, dataFile.getRecordCount());
+    for (Schema.Field field : bucketSchema.getFields()) {
+      String expectedPartition = field.getName() + "_bucket";
+      assertThat(dataFile.getPartitionPath(), containsString(expectedPartition));
+      assertThat(dataFile.getPath(), containsString(expectedPartition));
+    }
+  }
+
+  @Test
+  public void testTimePartitioning() throws IOException {
+    Schema timePartitioningSchema =
+        Schema.builder()
+            .addLogicalTypeField("y_date", SqlTypes.DATE)
+            .addLogicalTypeField("y_datetime", SqlTypes.DATETIME)
+            .addDateTimeField("y_datetime_tz")
+            .addLogicalTypeField("m_date", SqlTypes.DATE)
+            .addLogicalTypeField("m_datetime", SqlTypes.DATETIME)
+            .addDateTimeField("m_datetime_tz")
+            .addLogicalTypeField("d_date", SqlTypes.DATE)
+            .addLogicalTypeField("d_datetime", SqlTypes.DATETIME)
+            .addDateTimeField("d_datetime_tz")
+            .addLogicalTypeField("h_datetime", SqlTypes.DATETIME)
+            .addDateTimeField("h_datetime_tz")
+            .build();
+    org.apache.iceberg.Schema icebergSchema =
+        IcebergUtils.beamSchemaToIcebergSchema(timePartitioningSchema);
+    PartitionSpec spec =
+        PartitionSpec.builderFor(icebergSchema)
+            .year("y_date")
+            .year("y_datetime")
+            .year("y_datetime_tz")
+            .month("m_date")
+            .month("m_datetime")
+            .month("m_datetime_tz")
+            .day("d_date")
+            .day("d_datetime")
+            .day("d_datetime_tz")
+            .hour("h_datetime")
+            .hour("h_datetime_tz")
+            .build();
+
+    WindowedValue<IcebergDestination> dest =
+        getWindowedDestination("time_partitioning", icebergSchema, spec);
+
+    String timestamp = "2024-10-08T13:18:20.053";
+    LocalDateTime localDateTime = LocalDateTime.parse(timestamp);
+    LocalDate localDate = localDateTime.toLocalDate();
+    String timestamptz = "2024-10-08T13:18:20.053+03:27";
+    DateTime dateTime = DateTime.parse(timestamptz);
+
+    Row row =
+        Row.withSchema(timePartitioningSchema)
+            .addValues(localDate, localDateTime, dateTime) // year
+            .addValues(localDate, localDateTime, dateTime) // month
+            .addValues(localDate, localDateTime, dateTime) // day
+            .addValues(localDateTime, dateTime) // hour
+            .build();
+
+    // write some rows
+    RecordWriterManager writer =
+        new RecordWriterManager(catalog, "test_prefix", Long.MAX_VALUE, Integer.MAX_VALUE);
+    writer.write(dest, row);
+    writer.close();
+    List<SerializableDataFile> files = writer.getSerializableDataFiles().get(dest);
+    assertEquals(1, files.size());
+    SerializableDataFile serializableDataFile = files.get(0);
+    assertEquals(1, serializableDataFile.getRecordCount());
+
+    int year = localDateTime.getYear();
+    int month = localDateTime.getMonthValue();
+    int day = localDateTime.getDayOfMonth();
+    int hour = localDateTime.getHour();
+    List<String> expectedPartitions = new ArrayList<>();
+    for (Schema.Field field : timePartitioningSchema.getFields()) {
+      String name = field.getName();
+      String expected = "";
+      if (name.startsWith("y_")) {
+        expected = String.format("%s_year=%s", name, year);
+      } else if (name.startsWith("m_")) {
+        expected = String.format("%s_month=%s-%02d", name, year, month);
+      } else if (name.startsWith("d_")) {
+        expected = String.format("%s_day=%s-%02d-%02d", name, year, month, day);
+      } else if (name.startsWith("h_")) {
+        if (name.contains("tz")) {
+          hour = dateTime.withZone(DateTimeZone.UTC).getHourOfDay();
+        }
+        expected = String.format("%s_hour=%s-%02d-%02d-%02d", name, year, month, day, hour);
+      }
+      expectedPartitions.add(expected);
+    }
+    String expectedPartition = String.join("/", expectedPartitions);
+    DataFile dataFile =
+        serializableDataFile.createDataFile(
+            catalog.loadTable(dest.getValue().getTableIdentifier()).specs());
+    assertThat(dataFile.path().toString(), containsString(expectedPartition));
+  }
+
   @Rule public ExpectedException thrown = ExpectedException.none();
 
   @Test