Amazon Redshift User Manual (English)

To Next Page

To Previous Page

Note

The AWS SDK for Java provides thread-safe clients for accessing Amazon Redshift. As a best

practice, your applications should create one client and reuse the client between threads.

The AmazonRedshiftClient class defines methods that map to underlying Amazon Redshift Query

API actions. (These actions are described in the Amazon Redshift API Reference).When you call a

method, you must create a corresponding request object and response object.The request object includes

information that you must pass with the actual request.The response object include information returned

from Amazon Redshift in response to the request.

For example, the AmazonRedshiftClient class provides the createCluster method to provision a

cluster.This method maps to the underlying CreateCluster API action.You create a

CreateClusterRequest object to pass information with the createCluster method.

AmazonRedshiftClient client = new AmazonRedshiftClient(credentials);

client.setEndpoint("https://redshift.us-east-1.amazonaws.com/");

CreateClusterRequest request = new CreateClusterRequest()

.withClusterIdentifier("exampleclusterusingjava")

.withMasterUsername("masteruser")

.withMasterUserPassword("12345678Aa")

.withNodeType("dw.hs1.xlarge")

.withNumberOfNodes(2);

Cluster createResponse = client.createCluster(request);

System.out.println("Created cluster " + createResponse.getClusterIdentifier());

Running Java Examples for Amazon Redshift

Using Eclipse

General Process of Running Java Code Examples Using Eclipse

1. Create a new AWS Java Project in Eclipse.

Follow the steps in Setting Up the AWS Toolkit for Eclipse in the AWS Toolkit for Eclipse Getting

Started Guide.These steps include configuring the AwsCredentials.properties file that contains

your AWS security credentials.

2. Copy the sample code from the section of this document that you are reading and paste it into your

project as a new Java class file.

3. Run the code.

Running Java Examples for Amazon Redshift from

the Command Line

General Process of Running Java Code Examples from the Command Line

1. Set up and test your environment as follows:

a. Create a directory to work in and in it create src, bin, and sdk subfolders.

b. Download the AWS SDK for Java and unzip it to the sdk subfolder you created. After you unzip the

SDK, you should have four subdirectories in the sdk folder, including a lib and third-party

folder.

API Version 2012-12-01

118

Amazon Redshift Management Guide

Running Java Examples Using Eclipse

Need help?

Do you have a question about the Amazon Redshift and is the answer not in the manual?

Amazon Redshift Specifications

General

Provider	Amazon Web Services (AWS)
Query Language	SQL
Data Storage	Columnar storage
Security	Encryption at rest and in transit, VPC, IAM
Backup	Automated and manual snapshots
Deployment	Cloud-based
Type	Cloud-based data warehouse service
Primary Use	Data warehousing, analytics
Integration	Integrates with AWS services, BI tools, and ETL tools
Pricing Model	On-demand and reserved instance pricing
Data Compression	Columnar storage with data compression
Performance Optimization	Query optimization