AWS emr documentation change
Summary
Updated documentation links and phrasing consistency (e.g., replaced 'see' with 'refer to' in multiple sections). Minor grammar fixes (e.g., removed redundant 'the' in Kafka connectivity section). No changes to technical requirements or security configurations.
Security assessment
The changes are purely editorial (link phrasing, grammar) and do not modify security requirements. References to VPC access, IAM permissions, and Kafka IAM authentication remain unchanged in substance. No evidence of new security guidance or vulnerability fixes.
Diff
diff --git a/emr/latest/EMR-Serverless-UserGuide/jobs-spark-streaming-connectors.md b/emr/latest/EMR-Serverless-UserGuide/jobs-spark-streaming-connectors.md index d2a74baa8..cc12206d0 100644 --- a//emr/latest/EMR-Serverless-UserGuide/jobs-spark-streaming-connectors.md +++ b//emr/latest/EMR-Serverless-UserGuide/jobs-spark-streaming-connectors.md @@ -13 +13 @@ The following are the supported streaming connectors: -The [Amazon Kinesis Data Streams connector](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-spark-structured-streaming-kinesis.html) for Apache Spark enables building streaming applications and pipelines that consume data from and write data to Amazon Kinesis Data Streams. The connector supports enhanced fan-out consumption with a dedicated read throughput rate of up to 2MB/second per shard. By default, Amazon EMR Serverless 7.1.0 and higher includes the connector, so you don't need to build or download any additional packages. For more information about the connector, see the [ spark-sql-kinesis-connector page on GitHub](https://github.com/awslabs/spark-sql-kinesis-connector/). +The [Amazon Kinesis Data Streams connector](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-spark-structured-streaming-kinesis.html) for Apache Spark enables building streaming applications and pipelines that consume data from and write data to Amazon Kinesis Data Streams. The connector supports enhanced fan-out consumption with a dedicated read throughput rate of up to 2MB/second per shard. By default, Amazon EMR Serverless 7.1.0 and higher includes the connector, so you don't need to build or download any additional packages. For more information about the connector, refer to the [ spark-sql-kinesis-connector page on GitHub](https://github.com/awslabs/spark-sql-kinesis-connector/). @@ -35 +35 @@ The following is an example of how to start a job run with the Kinesis Data Stre -To connect to Kinesis Data Streams, you must configure the EMR Serverless application with VPC access and use a VPC endpoint to allow private access. or use a NAT Gateway to get public access. For more information, see [Configuring VPC access](https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/vpc-access.html). You must also make sure that your job runtime role has the necessary read and write permissions to access the required data streams. To learn more about how to configure a job runtime role, see [Job runtime roles for Amazon EMR Serverless](https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/security-iam-runtime-role.html). For a full list of all of the required permissions, see the [spark-sql-kinesis-connector page on GitHub](https://github.com/awslabs/spark-sql-kinesis-connector/?tab=readme-ov-file#how-to-use-it). +To connect to Kinesis Data Streams, configure the EMR Serverless application with VPC access and use a VPC endpoint to allow private access. or use a NAT Gateway to get public access. For more information, refer to [Configuring VPC access](https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/vpc-access.html). You must also make sure that your job runtime role has the necessary read and write permissions to access the required data streams. To learn more about how to configure a job runtime role, refer to [Job runtime roles for Amazon EMR Serverless](https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/security-iam-runtime-role.html). For a full list of all of the required permissions, refer to the [spark-sql-kinesis-connector page on GitHub](https://github.com/awslabs/spark-sql-kinesis-connector/?tab=readme-ov-file#how-to-use-it). @@ -39 +39 @@ To connect to Kinesis Data Streams, you must configure the EMR Serverless applic -The Apache Kafka connector for Spark structured streaming is an open-source connector from the Spark community and is available in a Maven repository. This connector facilitates Spark structured streaming applications to read data from and write data to self-managed Apache Kafka and Amazon Managed Streaming for Apache Kafka. For more information about the connector, see the [Structured Streaming + Kafka Integration Guide](https://spark.apache.org/docs/latest/structured-streaming-kafka-integration.html) in the Apache Spark documentation. +The Apache Kafka connector for Spark structured streaming is an open-source connector from the Spark community and is available in a Maven repository. This connector facilitates Spark structured streaming applications to read data from and write data to self-managed Apache Kafka and Amazon Managed Streaming for Apache Kafka. For more information about the connector, refer to the [Structured Streaming + Kafka Integration Guide](https://spark.apache.org/docs/latest/structured-streaming-kafka-integration.html) in the Apache Spark documentation. @@ -61 +61 @@ The following example demonstrates how to include the Kafka connector in your jo -The Apache Kafka connector version depends on your EMR Serverless release version and corresponding Spark version. To find the correct Kafka version, see the see the [Structured Streaming + Kafka Integration Guide](https://spark.apache.org/docs/latest/structured-streaming-kafka-integration.html). +The Apache Kafka connector version depends on your EMR Serverless release version and corresponding Spark version. To find the correct Kafka version, see the refer to the [Structured Streaming + Kafka Integration Guide](https://spark.apache.org/docs/latest/structured-streaming-kafka-integration.html). @@ -63 +63 @@ The Apache Kafka connector version depends on your EMR Serverless release versio -To use Amazon Managed Streaming for Apache Kafka with IAM authentication, you must include another dependency to enable the Kafka connector to connect to Amazon MSK with IAM. For more information, see the [aws-msk-iam-auth repository on GitHub](https://github.com/aws/aws-msk-iam-auth). You must also make sure that the job runtime role has the necessary IAM permissions. The following example demonstrates how to use the connector with IAM authentication. +To use Amazon Managed Streaming for Apache Kafka with IAM authentication, include another dependency to enable the Kafka connector to connect to Amazon MSK with IAM. For more information, refer to the [aws-msk-iam-auth repository on GitHub](https://github.com/aws/aws-msk-iam-auth). You must also make sure that the job runtime role has the necessary IAM permissions. The following example demonstrates how to use the connector with IAM authentication. @@ -83 +83 @@ To use Amazon Managed Streaming for Apache Kafka with IAM authentication, you mu -To use the Kafka connector and the IAM authentication library from Amazon MSK you must configure the EMR Serverless application with VPC access. Your subnets must have Internet access and use a NAT Gateway to access the the Maven dependencies. For more information, see [Configuring VPC access](https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/vpc-access.html). The subnets must have network connectivity to access the Kafka cluster. This is true regardless of whether your Kafka cluster is self-managed or if you use Amazon Managed Streaming for Apache Kafka. +To use the Kafka connector and the IAM authentication library from Amazon MSK configure the EMR Serverless application with VPC access. Your subnets must have Internet access and use a NAT Gateway to access the the Maven dependencies. For more information, refer to [Configuring VPC access](https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/vpc-access.html). The subnets must have network connectivity to access the Kafka cluster. This is true regardless of whether your Kafka cluster is self-managed or if you use Amazon Managed Streaming for Apache Kafka.