Package software.amazon.awscdk.services.dsql.alpha

@Stability(Experimental) package software.amazon.awscdk.services.dsql.alpha

Amazon Aurora DSQL Construct Library

---

cdk-constructs: Experimental

The APIs of higher level constructs in this module are experimental and under active development. They are subject to non-backward compatible changes or removal in any future version. These are not subject to the Semantic Versioning model and breaking changes will be announced in the release notes. This means that while you may use them, you may need to update your source code when upgrading to a newer version of this package.

Amazon Aurora DSQL is a serverless, distributed relational database service optimized for transactional workloads. Aurora DSQL offers virtually unlimited scale and doesn't require you to manage infrastructure. The active-active highly available architecture provides 99.99% single-Region and 99.999% multi-Region availability.

The @aws-cdk/aws-dsql-alpha package contains primitives for setting up Aurora DSQL clusters. 

 import software.amazon.awscdk.services.dsql.alpha.*;

Creating an Aurora DSQL Cluster

To create an Aurora DSQL cluster, define a Cluster: 

 Cluster cluster = Cluster.Builder.create(this, "Cluster")
         .clusterName("my-dsql-cluster")
         .deletionProtection(true)
         .build();

Granting Connect Access

You can grant IAM principals the ability to connect to the cluster: 

 Role role = Role.Builder.create(this, "DBRole").assumedBy(new AccountPrincipal(this.account)).build();
 Cluster cluster = new Cluster(this, "Cluster");
 
 // Use one of the following statements to grant the role the necessary permissions
 cluster.grantConnect(role); // Grant the role dsql:DbConnect
 cluster.grantConnectAdmin(role); // Grant the role dsql:DbConnectAdmin
 cluster.grant(role, "dsql:DbConnect");