Set Up an Amazon Kinesis Connection
Create an Amazon Kinesis connection to pull in data from Kinesis data streams into Data Cloud.
User Permissions Needed | |
---|---|
To create an Amazon Kinesis connection: | System Administrator |
Before you begin:
- Make sure the Amazon Kinesis connector is enabled. For more information, see Enable Data Cloud Features.
- Review the IP addresses to make sure the Amazon Kinesis connection has the necessary access.
-
In Data Cloud, click Setup, and select Data Cloud Setup.
-
Under External Integrations, select More Connectors.
-
Click New.
-
On the Source tab, select Amazon Kinesis and click Next.
-
Enter a connection name and connection API name, and provide the authentication and connection details.
-
Enter the AWS access key ID and secret access key to authenticate.
You must use the ID and secret access key together.
-
Enter the name of your Kinesis stream for the AWS account that you want Data Cloud to read data from.
-
Enter the region where your AWS Kinesis exists.
-
Enter the Amazon Kinesis data stream service endpoint to connect programmatically to an AWS service.
-
-
To review your configuration, click Test Connection.
-
Click Save.
After the connector details are accepted, the connection is created and ready to use. It’s listed under More Connectors.
A Data Aware Specialist can now create data streams.
When working with the Amazon Kinesis connector, keep these behaviors in mind.
- The Amazon Kinesis connector can’t read nested JSON.
- An Amazon Kinesis connector can have only a single object in its schema.
- You can’t reuse an Amazon Kinesis source in multiple Amazon Kinesis connections in Data Cloud.
- An Amazon Kinesis stream can contain only the type of data that’s selected when the data stream is created. Any variation in data that doesn’t match the schema causes the data stream to fail.