Amazon Kinesis data output

This article provides an introduction to Amazon Kinesis along with a guide on creating an Amazon Kinesis data output using Upsolver.

What is Amazon Kinesis Stream?

Amazon Kinesis Data Streams (KDS) is a real-time data streaming service.

KDS can continuously capture gigabytes of data per second from hundreds of thousands of sources such as website clickstreams, database event streams, financial transactions, social media feeds, IT logs, and location-tracking events. The data collected is available in milliseconds to enable real-time analytics use cases such as real-time dashboards, real-time anomaly detection, dynamic pricing, and more.

Create an Amazon Kinesis data output

1. Go to the Outputs page and click New.

2. Select Amazon Kinesis as your output type.

3. Name your output and select whether the output should be Tabular or Hierarchical. After adding your Data Sources, click Next.

Click Properties to review this output's properties. See: Output properties

4. Click the information iconin the fields tree to view information about a field. The following will be displayed:

Density in Events

How many of the events in this data source include this field, expressed as a percentage (e.g. 20.81%).

Density in Data

The density in the hierarchy (how many of the events in this branch of the data hierarchy include this field), expressed a percentage.

Distinct Values

How many unique values appear in this field.

Total Values

The total number of values ingested for this field.

First Seen

The first time this field included a value, for example, a year ago.

Last Seen

The last time this field included a value, for example, 2 minutes ago.

Value Distribution

The percentage distribution of the field values. These distribution values can be exported by clicking Export.

Field Content Samples Over Time

A time-series graph of the total number of events that include the selected field.

Selected

The most recent data values for the selected field and columns. You can change the columns that appear by clicking Choose Columns.

5. Click the information iconnext to a hierarchy element (such as the overall data) to review the following metrics:

# of Fields

The number of fields in the selected hierarchy.

# of Keys

The number of keys in the selected hierarchy.

# of Arrays

The number of arrays in the selected hierarchy.

Fields Breakdown

A stacked bar chart (by data type) of the number of fields versus the density/distinct values or a stacked bar chart of the number of fields by data type.

Fields Statistics

A list of the fields in the hierarchy element, including Type, Density, Top Values, Key, Distinct Values, Array, First Seen, and Last Seen.

6. Click the plus iconin the fields tree to add a field from the data source to your output. The Data Source Field will be added to the Schema tab. If required, modify the Output Column Name.

Toggle from UI to SQL at any point to view the corresponding SQL code for your selected output.

You can also edit your output directly in SQL. See: Transform with SQL

7. Add any required calculated fields and review them in the Calculated Fields tab. See: Adding Calculated Fields

8. Add any required lookups and review them under the Calculated Fields tab.

Adding Lookups

• from data sources

• from lookup tables

• from reference data

9. Through the Filters tab, add a filter like WHERE in SQL to the data source. See: Adding Filters

10. Click Make Aggregated to turn the output into an aggregated output. Read the warning before clicking OK and then add the required aggregation. This aggregation field will then be added to the Schema tab. See: Aggregation Functions

11. In the Aggregation Calculated Fields area under the Calculated Fields tab, add any required calculated fields on aggregations. See: Functions, Aggregation Functions

Click Preview at any time to view a preview of your current output.

12. Click Run and fill out the following fields:

• Kinesis Connection: How to create an Amazon Kinesis connection

• Stream Name

• Intermediate Storage: Where Upsolver stores the intermediate bulk files before loading it into Kinesis

See: Running an Output

14. Click Next and complete the following:

Compute Cluster

Select the compute cluster to run the calculation on. Alternatively, click the drop-down and create a new compute cluster.

Processing Time Range

The range of data to process. This can start from the data source beginning, now, or a custom date and time. This can never end, end now or end at a custom date and time.

15. Finally, click Deploy to run the output. It will show as Running in the output panel and is now live in production and consumes compute resources.

If you experience errors while running your output, you may need to add a policy to allow the Upsolver role to read from and write to Kinesis from your AWS IAM.