pyspark.streaming.kinesis.KinesisUtils.createStream

static KinesisUtils.createStream(ssc, kinesisAppName, streamName, endpointUrl, regionName, initialPositionInStream, checkpointInterval, storageLevel=StorageLevel(True, True, False, False, 2), awsAccessKeyId=None, awsSecretKey=None, decoder=<function utf8_decoder>, stsAssumeRoleArn=None, stsSessionName=None, stsExternalId=None)[source]

Create an input stream that pulls messages from a Kinesis stream. This uses the Kinesis Client Library (KCL) to pull messages from Kinesis.

Note

The given AWS credentials will get saved in DStream checkpoints if checkpointing is enabled. Make sure that your checkpoint directory is secure.

Parameters
  • ssc – StreamingContext object

  • kinesisAppName – Kinesis application name used by the Kinesis Client Library (KCL) to update DynamoDB

  • streamName – Kinesis stream name

  • endpointUrl – Url of Kinesis service (e.g., https://kinesis.us-east-1.amazonaws.com)

  • regionName – Name of region used by the Kinesis Client Library (KCL) to update DynamoDB (lease coordination and checkpointing) and CloudWatch (metrics)

  • initialPositionInStream – In the absence of Kinesis checkpoint info, this is the worker’s initial starting position in the stream. The values are either the beginning of the stream per Kinesis’ limit of 24 hours (InitialPositionInStream.TRIM_HORIZON) or the tip of the stream (InitialPositionInStream.LATEST).

  • checkpointInterval – Checkpoint interval for Kinesis checkpointing. See the Kinesis Spark Streaming documentation for more details on the different types of checkpoints.

  • storageLevel – Storage level to use for storing the received objects (default is StorageLevel.MEMORY_AND_DISK_2)

  • awsAccessKeyId – AWS AccessKeyId (default is None. If None, will use DefaultAWSCredentialsProviderChain)

  • awsSecretKey – AWS SecretKey (default is None. If None, will use DefaultAWSCredentialsProviderChain)

  • decoder – A function used to decode value (default is utf8_decoder)

  • stsAssumeRoleArn – ARN of IAM role to assume when using STS sessions to read from the Kinesis stream (default is None).

  • stsSessionName – Name to uniquely identify STS sessions used to read from Kinesis stream, if STS is being used (default is None).

  • stsExternalId – External ID that can be used to validate against the assumed IAM role’s trust policy, if STS is being used (default is None).

Returns

A DStream object