org.apache.beam.sdk.io.aws.sns

Class SnsIO.Write

java.lang.Object

org.apache.beam.sdk.transforms.PTransform<org.apache.beam.sdk.values.PCollection<com.amazonaws.services.sns.model.PublishRequest>,org.apache.beam.sdk.values.PCollectionTuple>

org.apache.beam.sdk.io.aws.sns.SnsIO.Write

All Implemented Interfaces:

java.io.Serializable, org.apache.beam.sdk.transforms.display.HasDisplayData

Enclosing class:

SnsIO

public abstract static class SnsIO.Write
extends org.apache.beam.sdk.transforms.PTransform<org.apache.beam.sdk.values.PCollection<com.amazonaws.services.sns.model.PublishRequest>,org.apache.beam.sdk.values.PCollectionTuple>

Implementation of SnsIO.write().

See Also:

Serialized Form

Field Summary

Fields inherited from class org.apache.beam.sdk.transforms.PTransform

name

Constructor Summary

Constructors

Constructor and Description
Write()

Method Summary

Modifier and Type	Method and Description
org.apache.beam.sdk.values.PCollectionTuple	expand(org.apache.beam.sdk.values.PCollection<com.amazonaws.services.sns.model.PublishRequest> input)
SnsIO.Write	withAWSClientsProvider(AwsClientsProvider awsClientsProvider) Allows to specify custom AwsClientsProvider.
SnsIO.Write	withAWSClientsProvider(java.lang.String awsAccessKey, java.lang.String awsSecretKey, com.amazonaws.regions.Regions region) Specify credential details and region to be used to write to SNS.
SnsIO.Write	withAWSClientsProvider(java.lang.String awsAccessKey, java.lang.String awsSecretKey, com.amazonaws.regions.Regions region, java.lang.String serviceEndpoint) Specify credential details and region to be used to write to SNS.
SnsIO.Write	withCoder(org.apache.beam.sdk.coders.Coder<com.amazonaws.services.sns.model.PublishResult> coder) Encode the PublishResult with the given coder.
SnsIO.Write	withFullPublishResult() Encode the full PublishResult object, including sdkResponseMetadata and sdkHttpMetadata with the HTTP response headers.
SnsIO.Write	withFullPublishResultWithoutHeaders() Encode the full PublishResult object, including sdkResponseMetadata and sdkHttpMetadata but excluding the HTTP response headers.
SnsIO.Write	withResultOutputTag(org.apache.beam.sdk.values.TupleTag<com.amazonaws.services.sns.model.PublishResult> results) Tuple tag to store results.
SnsIO.Write	withRetryConfiguration(SnsIO.RetryConfiguration retryConfiguration) Provides configuration to retry a failed request to publish a message to SNS.
SnsIO.Write	withTopicName(java.lang.String topicName) Specify the SNS topic which will be used for writing, this name is mandatory.

Methods inherited from class org.apache.beam.sdk.transforms.PTransform

compose, compose, getAdditionalInputs, getDefaultOutputCoder, getDefaultOutputCoder, getDefaultOutputCoder, getKindString, getName, populateDisplayData, toString, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Write

public Write()

Method Detail

withTopicName

public SnsIO.Write withTopicName(java.lang.String topicName)

Specify the SNS topic which will be used for writing, this name is mandatory.

Parameters:

topicName - topicName

withAWSClientsProvider

public SnsIO.Write withAWSClientsProvider(AwsClientsProvider awsClientsProvider)

Allows to specify custom AwsClientsProvider. AwsClientsProvider creates new AmazonSNS which is later used for writing to a SNS topic.

withAWSClientsProvider

public SnsIO.Write withAWSClientsProvider(java.lang.String awsAccessKey,
                                          java.lang.String awsSecretKey,
                                          com.amazonaws.regions.Regions region)

Specify credential details and region to be used to write to SNS. If you need more sophisticated credential protocol, then you should look at withAWSClientsProvider(AwsClientsProvider).

withAWSClientsProvider

public SnsIO.Write withAWSClientsProvider(java.lang.String awsAccessKey,
                                          java.lang.String awsSecretKey,
                                          com.amazonaws.regions.Regions region,
                                          java.lang.String serviceEndpoint)

Specify credential details and region to be used to write to SNS. If you need more sophisticated credential protocol, then you should look at withAWSClientsProvider(AwsClientsProvider).

The serviceEndpoint sets an alternative service host. This is useful to execute the tests with Kinesis service emulator.

withRetryConfiguration

public SnsIO.Write withRetryConfiguration(SnsIO.RetryConfiguration retryConfiguration)

Provides configuration to retry a failed request to publish a message to SNS. Users should consider that retrying might compound the underlying problem which caused the initial failure. Users should also be aware that once retrying is exhausted the error is surfaced to the runner which may then opt to retry the current partition in entirety or abort if the max number of retries of the runner is completed. Retrying uses an exponential backoff algorithm, with minimum backoff of 5 seconds and then surfacing the error once the maximum number of retries or maximum configuration duration is exceeded.

Example use:

 SnsIO.write()
   .withRetryConfiguration(SnsIO.RetryConfiguration.create(5, Duration.standardMinutes(1))
   ...
 

Parameters:

retryConfiguration - the rules which govern the retry behavior

Returns:

the SnsIO.Write with retrying configured

withResultOutputTag

public SnsIO.Write withResultOutputTag(org.apache.beam.sdk.values.TupleTag<com.amazonaws.services.sns.model.PublishResult> results)

Tuple tag to store results. Mandatory field.

withFullPublishResult

public SnsIO.Write withFullPublishResult()

Encode the full PublishResult object, including sdkResponseMetadata and sdkHttpMetadata with the HTTP response headers.

withFullPublishResultWithoutHeaders

public SnsIO.Write withFullPublishResultWithoutHeaders()

Encode the full PublishResult object, including sdkResponseMetadata and sdkHttpMetadata but excluding the HTTP response headers.

withCoder

public SnsIO.Write withCoder(org.apache.beam.sdk.coders.Coder<com.amazonaws.services.sns.model.PublishResult> coder)

Encode the PublishResult with the given coder.

expand

public org.apache.beam.sdk.values.PCollectionTuple expand(org.apache.beam.sdk.values.PCollection<com.amazonaws.services.sns.model.PublishRequest> input)

Specified by:

expand in class org.apache.beam.sdk.transforms.PTransform<org.apache.beam.sdk.values.PCollection<com.amazonaws.services.sns.model.PublishRequest>,org.apache.beam.sdk.values.PCollectionTuple>