Skip to content

Stream CDC into an Amazon S3 data lake in Apache Iceberg table format with AWS Glue Streaming and DMS

License

Notifications You must be signed in to change notification settings

aws-samples/transactional-datalake-using-apache-iceberg-on-aws-glue

Transactional Data Lake using Apache Iceberg with AWS Glue Streaming and DMS

This repository provides you cdk scripts and sample code on how to implement end to end data pipeline for transactional data lake by ingesting stream change data capture (CDC) from MySQL DB to Amazon S3 in Apache Iceberg format through Amazon Kinesis using Amazon Data Migration Service(DMS) and Glue Streaming.

Stream CDC into an Amazon S3 data lake in Apache Iceberg format with AWS Glue Streaming and DMS

Below diagram shows what we are implementing.

transactional-datalake-arch

The cdk.json file tells the CDK Toolkit how to execute your app.

This project is set up like a standard Python project. The initialization process also creates a virtualenv within this project, stored under the .venv directory. To create the virtualenv it assumes that there is a python3 (or python for Windows) executable in your path with access to the venv package. If for any reason the automatic creation of the virtualenv fails, you can create the virtualenv manually.

To manually create a virtualenv on MacOS and Linux:

$ python3 -m venv .venv

After the init process completes and the virtualenv is created, you can use the following step to activate your virtualenv.

$ source .venv/bin/activate

If you are a Windows platform, you would activate the virtualenv like this:

% .venv\Scripts\activate.bat

Once the virtualenv is activated, you can install the required dependencies.

(.venv) $ pip install -r requirements.txt

To add additional dependencies, for example other CDK libraries, just add them to your setup.py file and rerun the pip install -r requirements.txt command.

Prerequisites

Before synthesizing the CloudFormation,

  • You set up Apache Iceberg connector for AWS Glue to use Apache Iceberg with AWS Glue jobs. (For more information, see References (2)). Then glue_connections_name of cdk.context.json configuration file should be set by Apache Iceberg connector name like this:

    { "glue_connections_name": "iceberg-connection" }
    
  • You create a S3 bucket for a glue job script and upload the glue job script file into the s3 bucket. Then glue_assets_s3_bucket_name and glue_job_script_file_name of cdk.context.json configuration file should be set by the S3 bucket name and the glue job script file name like this:

     {
        "glue_assets_s3_bucket_name": "aws-glue-assets-123456789012-us-east-1",
        "glue_job_script_file_name": "spark_sql_merge_into_iceberg.py"
     }
     

Then you set other remaining configurations of the cdk context configuration file cdk.context.json accordingly.

For example:

{
  "db_cluster_name": "dms-source-db",
  "dms_data_source": {
    "database_name": "testdb",
    "table_name": "retail_trans"
  },
  "kinesis_stream_name": "cdc_retail_trans_stream",
  "glue_assets_s3_bucket_name": "aws-glue-assets-123456789012-us-east-1",
  "glue_job_script_file_name": "spark_sql_merge_into_iceberg.py",
  "glue_job_name": "cdc_based_upsert_to_iceberg_table",
  "glue_job_input_arguments": {
    "--catalog": "job_catalog",
    "--database_name": "cdc_iceberg_demo_db",
    "--table_name": "retail_trans_iceberg",
    "--primary_key": "trans_id",
    "--kinesis_table_name": "cdc_retail_trans_stream",
    "--starting_position_of_kinesis_iterator": "LATEST",
    "--iceberg_s3_path": "s3://glue-iceberg-demo-us-east-1/cdc_iceberg_demo_db/retail_trans_iceberg",
    "--lock_table_name": "iceberg_lock",
    "--aws_region": "us-east-1",
    "--window_size": "100 seconds",
    "--extra-jars": "s3://aws-glue-assets-123456789012-us-east-1/extra-jars/aws-sdk-java-2.17.224.jar",
    "--user-jars-first": "true"
  },
  "glue_connections_name": "iceberg-connection",
  "glue_kinesis_table": {
    "database_name": "cdc_iceberg_demo_db",
    "table_name": "cdc_retail_trans_stream"
  }
}

ℹ️ --primary_key of glue_job_input_arguments should be set by Iceberg table's primary column name. So, it is better to set the primary key of RDS table.

ℹ️ --extra-jars and --user-jars-first of glue_job_input_arguments is used in the 4th step of Set up Glue Streaming Job.

At this point you can now synthesize the CloudFormation template for this code.

(.venv) $ export CDK_DEFAULT_ACCOUNT=$(aws sts get-caller-identity --query Account --output text)
(.venv) $ export CDK_DEFAULT_REGION=$(aws configure get region)
(.venv) $ cdk synth --all

Now let's try to deploy.

Creating Aurora MySQL cluster

(.venv) $ cdk deploy TransactionalDataLakeVpc AuroraMysqlAsDMSDataSource

Confirm that binary logging is enabled

In order to set up the Aurora MySQL, you need to connect the Aurora MySQL cluster on either your local PC or a EC2 instance.

  1. (Optional) Create an EC2 Instance

     (.venv) $ cdk deploy AuroraMysqlBastionHost
    
  2. Connect to the Aurora cluster writer node.

    ℹ️ The Aurora MySQL username and password are stored in the AWS Secrets Manager as a name such as DatabaseSecret-xxxxxxxxxxxx.

    To retrieve a secret (AWS console)

    • (Step 1) Open the Secrets Manager console at https://console.aws.amazon.com/secretsmanager/.
    • (Step 2) In the list of secrets, choose the secret you want to retrieve.
    • (Step 3) In the Secret value section, choose Retrieve secret value.
      Secrets Manager displays the current version (AWSCURRENT) of the secret. To see other versions of the secret, such as AWSPREVIOUS or custom labeled versions, use the AWS CLI.

    Once you're ready to connect to the Aurora cluster, log into the bastion host.

     $ sudo pip install ec2instanceconnectcli
     $ export BASTION_HOST_ID=$(aws cloudformation describe-stacks --stack-name AuroraMysqlBastionHost | jq -r '.Stacks[0].Outputs.[] | select(.OutputKey == "EC2InstanceId") | .OutputValue')
     $ mssh --region "your-region-name (e.g., us-east-1)" ec2-user@${BASTION_HOST_ID}
     [ec2-user@ip-172-31-7-186 ~]$ mysql -hdb-cluster-name.cluster-xxxxxxxxxxxx.region-name.rds.amazonaws.com -uadmin -p
     Enter password:
     Welcome to the MariaDB monitor.  Commands end with ; or \g.
     Your MySQL connection id is 20
     Server version: 8.0.23 Source distribution
    
     Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
    
     Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    
     MySQL [(none)]>
    

    ℹ️ AuroraMysqlBastionHost is a CDK Stack to create the bastion host.

    ℹ️ You can also connect to an EC2 instance using the EC2 Instance Connect CLI. For more information, see Connect using the EC2 Instance Connect CLI. For example,

    $ sudo pip install ec2instanceconnectcli
    $ mssh ec2-user@i-001234a4bf70dec41EXAMPLE # ec2-instance-id
    

  3. At SQL prompt run the below command to confirm that binary logging is enabled:

     MySQL [(none)]> SHOW GLOBAL VARIABLES LIKE "log_bin";
     +---------------+-------+
     | Variable_name | Value |
     +---------------+-------+
     | log_bin       | ON    |
     +---------------+-------+
     1 row in set (0.00 sec)
    
  4. Also run this to AWS DMS has bin log access that is required for replication

     MySQL [(none)]> CALL mysql.rds_set_configuration('binlog retention hours', 24);
     Query OK, 0 rows affected (0.01 sec)
    

Create a sample database and table

  1. Run the below command to create the sample database named testdb.
     MySQL [(none)]> SHOW DATABASES;
     +--------------------+
     | Database           |
     +--------------------+
     | information_schema |
     | mysql              |
     | performance_schema |
     | sys                |
     +--------------------+
     4 rows in set (0.00 sec)
    
     MySQL [(none)]> CREATE DATABASE IF NOT EXISTS testdb;
     Query OK, 1 row affected (0.01 sec)
    
     MySQL [(none)]> USE testdb;
     Database changed
     MySQL [testdb]> SHOW tables;
     Empty set (0.00 sec)
    
  2. Also run this to create the sample table named retail_trans
     MySQL [testdb]> CREATE TABLE IF NOT EXISTS testdb.retail_trans (
               trans_id BIGINT(20) AUTO_INCREMENT,
               customer_id VARCHAR(12) NOT NULL,
               event VARCHAR(10) DEFAULT NULL,
               sku VARCHAR(10) NOT NULL,
               amount INT DEFAULT 0,
               device VARCHAR(10) DEFAULT NULL,
               trans_datetime DATETIME DEFAULT CURRENT_TIMESTAMP,
               PRIMARY KEY(trans_id),
               KEY(trans_datetime)
            ) ENGINE=InnoDB AUTO_INCREMENT=0;
     Query OK, 0 rows affected, 1 warning (0.04 sec)
    
     MySQL [testdb]> SHOW tables;
     +------------------+
     | Tables_in_testdb |
     +------------------+
     | retail_trans     |
     +------------------+
     1 row in set (0.00 sec)
    
     MySQL [testdb]> DESC retail_trans;
     +----------------+-------------+------+-----+-------------------+-------------------+
     | Field          | Type        | Null | Key | Default           | Extra             |
     +----------------+-------------+------+-----+-------------------+-------------------+
     | trans_id       | bigint      | NO   | PRI | NULL              | auto_increment    |
     | customer_id    | varchar(12) | NO   |     | NULL              |                   |
     | event          | varchar(10) | YES  |     | NULL              |                   |
     | sku            | varchar(10) | NO   |     | NULL              |                   |
     | amount         | int         | YES  |     | 0                 |                   |
     | device         | varchar(10) | YES  |     | NULL              |                   |
     | trans_datetime | datetime    | YES  | MUL | CURRENT_TIMESTAMP | DEFAULT_GENERATED |
     +----------------+-------------+------+-----+-------------------+-------------------+
     7 rows in set (0.00 sec)
    
     MySQL [testdb]>
    

After setting up the Aurora MySQL, you should come back to the terminal where you are deploying stacks.

Create Amazon Kinesis Data Streams for AWS DMS target endpoint

  (.venv) $ cdk deploy DMSTargetKinesisDataStream
  

Create AWS DMS Replication Task

In the previous step we already we already created the sample database (i.e., testdb) and table (i.e., retail_trans)

Now let's create a migration task.

  (.venv) $ cdk deploy DMSRequiredIAMRolesStack DMSTaskAuroraMysqlToKinesis
  

Set up Glue Streaming Job

  1. Make sure Apache Iceberg connector for AWS Glue ready to use Apache Iceberg with AWS Glue jobs.

  2. Create a S3 bucket for Apache Iceberg table

    (.venv) $ cdk deploy GlueStreamingCDCtoIcebergS3Path
    
  3. Define a schema for the streaming data

    (.venv) $ cdk deploy GlueTableSchemaOnKinesisStream
    

    Running cdk deploy GlueTableSchemaOnKinesisStream command is like that we create a schema manually using the AWS Glue Data Catalog as the following steps:

    (1) On the AWS Glue console, choose Data Catalog.
    (2) Choose Databases, and click Add database.
    (3) Create a database with the name cdc_iceberg_demo_db.
    (4) On the Data Catalog menu, Choose Tables, and click Add Table.
    (5) For the table name, enter cdc_retail_trans_stream.
    (6) Select cdc_iceberg_demo_db as a database.
    (7) Choose Kinesis as the type of source.
    (8) Enter the name of the stream.
    (9) For the classification, choose JSON.
    (10) Choose Finish

  4. Upload AWS SDK for Java 2.x jar file into S3

    (.venv) $ wget https://repo1.maven.org/maven2/software/amazon/awssdk/aws-sdk-java/2.17.224/aws-sdk-java-2.17.224.jar
    (.venv) $ aws s3 cp aws-sdk-java-2.17.224.jar s3://aws-glue-assets-123456789012-atq4q5u/extra-jars/aws-sdk-java-2.17.224.jar
    

    A Glue Streaming Job might fail because of the following error:

    py4j.protocol.Py4JJavaError: An error occurred while calling o135.start.
    : java.lang.NoSuchMethodError: software.amazon.awssdk.utils.SystemSetting.getStringValueFromEnvironmentVariable(Ljava/lang/String;)Ljava/util/Optional
    

    We can work around the problem by starting the Glue Job with the additional parameters:

    --extra-jars s3://path/to/aws-sdk-for-java-v2.jar
    --user-jars-first true
    

    In order to do this, we might need to upload AWS SDK for Java 2.x jar file into S3.

  5. Create Glue Streaming Job

    • (step 1) Select one of Glue Job Scripts and upload into S3

      (.venv) $ ls src/main/python/
       spark_sql_merge_into_iceberg.py
      (.venv) $ aws s3 mb s3://aws-glue-assets-123456789012-atq4q5u --region us-east-1
      (.venv) $ aws s3 cp src/main/python/spark_sql_merge_into_iceberg.py s3://aws-glue-assets-123456789012-atq4q5u/scripts/
      
    • (step 2) Provision the Glue Streaming Job

      (.venv) $ cdk deploy GlueStreamingCDCtoIcebergJobRole \
                           GrantLFPermissionsOnGlueJobRole \
                           GlueStreamingCDCtoIceberg
      
  6. Make sure the glue job to access the Kinesis Data Streams table in the Glue Catalog database, otherwise grant the glue job to permissions

    Wec can get permissions by running the following command:

    (.venv) $ aws lakeformation list-permissions | jq -r '.PrincipalResourcePermissions[] | select(.Principal.DataLakePrincipalIdentifier | endswith(":role/GlueStreamingJobRole-Iceberg"))'
    

    If not found, we need manually to grant the glue job to required permissions by running the following command:

    (.venv) $ aws lakeformation grant-permissions \
                --principal DataLakePrincipalIdentifier=arn:aws:iam::{account-id}:role/GlueStreamingJobRole-Iceberg \
                --permissions SELECT DESCRIBE ALTER INSERT DELETE \
                --resource '{ "Table": {"DatabaseName": "cdc_iceberg_demo_db", "TableWildcard": {}} }'
    

Create a table with partitioned data in Amazon Athena

Go to Athena on the AWS Management console.

  • (step 1) Create a database

    In order to create a new database called cdc_iceberg_demo_db, enter the following statement in the Athena query editor and click the Run button to execute the query.

     CREATE DATABASE IF NOT EXISTS cdc_iceberg_demo_db;
     
  • (step 2) Create a table

    Copy the following query into the Athena query editor, replace the xxxxxxx in the last line under LOCATION with the string of your S3 bucket, and execute the query to create a new table.

     CREATE TABLE cdc_iceberg_demo_db.retail_trans_iceberg (
        trans_id int,
        customer_id string,
        event string,
        sku string,
        amount int,
        device string,
        trans_datetime timestamp
     )
     PARTITIONED BY (`event`)
     LOCATION 's3://glue-iceberg-demo-xxxxxxx/cdc_iceberg_demo_db/retail_trans_iceberg'
     TBLPROPERTIES (
        'table_type'='iceberg'
     );
     

    If the query is successful, a table named retail_trans_iceberg is created and displayed on the left panel under the Tables section.

    If you get an error, check if (a) you have updated the LOCATION to the correct S3 bucket name, (b) you have mydatabase selected under the Database dropdown, and (c) you have AwsDataCatalog selected as the Data source.

    ℹ️ If you fail to create the table, give Athena users access permissions on cdc_iceberg_demo_db through AWS Lake Formation, or you can grant anyone using Athena to access cdc_iceberg_demo_db by running the following command:

     (.venv) $ aws lakeformation grant-permissions \
                   --principal DataLakePrincipalIdentifier=arn:aws:iam::{account-id}:user/example-user-id \
                   --permissions CREATE_TABLE DESCRIBE ALTER DROP \
                   --resource '{ "Database": { "Name": "cdc_iceberg_demo_db" } }'
     (.venv) $ aws lakeformation grant-permissions \
                   --principal DataLakePrincipalIdentifier=arn:aws:iam::{account-id}:user/example-user-id \
                   --permissions SELECT DESCRIBE ALTER INSERT DELETE DROP \
                   --resource '{ "Table": {"DatabaseName": "cdc_iceberg_demo_db", "TableWildcard": {}} }'
     

Run Test

  1. Start the DMS Replication task by replacing the ARN in below command.

    (.venv) $ DMS_REPLICATION_TASK_ID=$(aws cloudformation describe-stacks --stack-name DMSTaskAuroraMysqlToKinesis | jq -r '.Stacks[0].Outputs.[] | select(.OutputKey == "DMSReplicationTaskId") | .OutputValue | ascii_downcase')
    (.venv) $ DMS_REPLICATION_TASK_ARN=$(aws dms describe-replication-tasks | jq -r ".ReplicationTasks[] | select(.ReplicationTaskIdentifier == \"${DMS_REPLICATION_TASK_ID}\") | .ReplicationTaskArn")
    (.venv) $ aws dms start-replication-task \
                  --replication-task-arn ${DMS_REPLICATION_TASK_ARN} \
                  --start-replication-task-type start-replication
    
  2. Run glue job to load data from Kinesis Data Streams into S3

    (.venv) $ GLUE_JOB_NAME=$(aws cloudformation describe-stacks --stack-name GlueStreamingCDCtoIceberg | jq -r '.Stacks[0].Outputs.[] | select(.OutputKey == "GlueJobName") | .OutputValue')
    (.venv) $ aws glue start-job-run --job-name ${GLUE_JOB_NAME}
    
  3. Generate test data.

     $ export BASTION_HOST_ID=$(aws cloudformation describe-stacks --stack-name AuroraMysqlBastionHost | jq -r '.Stacks[0].Outputs | .[] | select(.OutputKey | endswith("EC2InstanceId")) | .OutputValue')
     $ mssh --region "your-region-name (e.g., us-east-1)" ec2-user@${BASTION_HOST_ID}
     [ec2-user@ip-172-31-7-186 ~]$ pip3 install -U boto3==1.33.13 dataset==1.5.2 Faker==13.3.1 PyMySQL==1.1.1
     [ec2-user@ip-172-31-7-186 ~]$ python3 gen_fake_mysql_data.py \
                                     --database your-database-name \
                                     --table your-table-name \
                                     --user user-name \
                                     --password password \
                                     --host db-cluster-name.cluster-xxxxxxxxxxxx.region-name.rds.amazonaws.com \
                                     --max-count 10
    

    In the Data Viewer in the Amazon Kinesis Management Console, you can see incomming records. amazon-kinesis-data-viewer

    After filling data into the MySQL table, connect to the Aurora cluster writer node and run some DML(insert, update, delete) queries.

    For example, update some records.

     $ mysql -hdb-cluster-name.cluster-xxxxxxxxxxxx.region-name.rds.amazonaws.com -uadmin -p
     Enter password:
     Welcome to the MariaDB monitor.  Commands end with ; or \g.
     Your MySQL connection id is 20
     Server version: 8.0.23 Source distribution
    
     Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
    
     Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    
     MySQL [(none)]> USE testdb;
     Database changed
    
     MySQL [testdb]> SELECT * FROM retail_trans LIMIT 10;
     +----------+--------------+----------+------------+--------+--------+---------------------+
     | trans_id | customer_id  | event    | sku        | amount | device | trans_datetime      |
     +----------+--------------+----------+------------+--------+--------+---------------------+
     |        1 | 460104780596 | cart     | IQ6879MMTB |      8 | mobile | 2023-01-16 06:08:06 |
     |        2 | 758933025159 | like     | RL1573WWLT |      1 | tablet | 2023-01-16 06:17:21 |
     |        3 | 754384589074 | like     | PX4135DYNT |      1 | mobile | 2023-01-16 06:08:52 |
     |        4 | 602811489876 | purchase | PI7913TREO |     66 | pc     | 2023-01-16 06:01:07 |
     |        5 | 222732129586 | like     | AS6987HGLN |      1 | mobile | 2023-01-16 06:09:06 |
     |        6 | 387378799012 | list     | AI6161BEFX |      1 | pc     | 2023-01-16 06:10:27 |
     |        7 | 843982894991 | cart     | DA7930CJBR |     81 | pc     | 2023-01-16 06:11:41 |
     |        8 | 818177069814 | like     | JS6166YPTE |      1 | pc     | 2023-01-16 06:17:08 |
     |        9 | 248083404876 | visit    | AS8552DVOO |      1 | pc     | 2023-01-16 06:24:39 |
     |       10 | 731184658511 | visit    | XZ9997LSJN |      1 | tablet | 2023-01-16 06:12:18 |
     +----------+--------------+----------+------------+--------+--------+---------------------+
     10 rows in set (0.00 sec)
    
     MySQL [testdb]> UPDATE retail_trans SET amount = 3 WHERE trans_id=6;
     Query OK, 1 rows affected (0.00 sec)
     Rows matched: 1  Changed: 1  Warnings: 0
    
     MySQL [testdb]> UPDATE retail_trans SET amount = 39 WHERE trans_id=19;
     Query OK, 1 rows affected (0.00 sec)
     Rows matched: 1  Changed: 1  Warnings: 0
    
     MySQL [testdb]> UPDATE retail_trans SET amount = 60 WHERE trans_id=21;
     Query OK, 1 rows affected (0.00 sec)
     Rows matched: 1  Changed: 1  Warnings: 0
    
     MySQL [testdb]> UPDATE retail_trans SET amount = 4 WHERE trans_id=23;
     Query OK, 1 rows affected (0.00 sec)
     Rows matched: 1  Changed: 1  Warnings: 0
    
     MySQL [testdb]> UPDATE retail_trans SET amount = 42 WHERE trans_id=24;
     Query OK, 1 rows affected (0.00 sec)
     Rows matched: 1  Changed: 1  Warnings: 0
    

    Delete some records.

     MySQL [testdb]> DELETE FROM retail_trans WHERE trans_id=6;
     Query OK, 1 rows affected (0.00 sec)
    
     MySQL [testdb]> DELETE FROM retail_trans WHERE trans_id=33;
     Query OK, 1 rows affected (0.00 sec)
    
     MySQL [testdb]> DELETE FROM retail_trans WHERE trans_id=23;
     Query OK, 1 rows affected (0.00 sec)
    

    Insert some new records.

     MySQL [testdb]> INSERT INTO retail_trans (customer_id, event, sku, amount, device) VALUES
     -> ("818177069814", "like", "JS6166YPTE", 1, "mobile"),
     -> ("387378799012", "list", "AI6161BEFX", 1, "pc"),
     -> ("839828949919", "purchase", "AC2306JBRJ", 5, "tablet"),
     -> ("248083404876", "visit", "AS8552DVOO", 1, "pc"),
     -> ("731184658511", "like", "XZ9997LSJN", 1, "tablet");
     Query OK, 5 rows affected (0.00 sec)
     Records: 5  Duplicates: 0  Warnings: 0
    
  4. Check streaming data in S3

    After 3~5 minutes, you can see that the streaming data have been delivered from Kinesis Data Streams to S3.

    iceberg-table iceberg-table iceberg-table iceberg-table

  5. Run test query using Amazon Athena

    Enter the following SQL statement and execute the query.

    SELECT COUNT(*)
    FROM cdc_iceberg_demo_db.retail_trans_iceberg;
    

Clean Up

  1. Stop the DMS Replication task by replacing the ARN in below command.

    (.venv) $ aws dms stop-replication-task --replication-task-arn dms-task-arn
    
  2. Stop the glue job by replacing the job name in below command.

    (.venv) $ JOB_RUN_IDS=$(aws glue get-job-runs \
                --job-name cdc_based_upsert_to_iceberg_table | jq -r '.JobRuns[] | select(.JobRunState=="RUNNING") | .Id' \
                | xargs)
    (.venv) $ aws glue batch-stop-job-run \
                --job-name cdc_based_upsert_to_iceberg_table \
                --job-run-ids $JOB_RUN_IDS
    
  3. Delete the CloudFormation stack by running the below command.

    (.venv) $ cdk destroy --all
    

Useful commands

  • cdk ls list all stacks in the app
  • cdk synth emits the synthesized CloudFormation template
  • cdk deploy deploy this stack to your default AWS account/region
  • cdk diff compare deployed stack with current state
  • cdk docs open CDK documentation

Enjoy!

References

Related Works

Troubleshooting

  • Granting database or table permissions error using AWS CDK

    • Error message:

      AWS::LakeFormation::PrincipalPermissions | CfnPrincipalPermissions Resource handler returned message: "Resource does not exist or requester is not authorized to access requested permissions. (Service: LakeFormation, Status Code: 400, Request ID: f4d5e58b-29b6-4889-9666-7e38420c9035)" (RequestToken: 4a4bb1d6-b051-032f-dd12-5951d7b4d2a9, HandlerErrorCode: AccessDenied)
      
    • Solution:

      The role assumed by cdk is not a data lake administrator. (e.g., cdk-hnb659fds-deploy-role-12345678912-us-east-1)
      So, deploying PrincipalPermissions meets the error such as:

      Resource does not exist or requester is not authorized to access requested permissions.

      In order to solve the error, it is necessary to promote the cdk execution role to the data lake administrator.
      For example, https://github.com/aws-samples/data-lake-as-code/blob/mainline/lib/stacks/datalake-stack.ts#L68

    • Reference:

      https://github.com/aws-samples/data-lake-as-code - Data Lake as Code

  • dms-vpc-role is not configured properly: When first trying to deploy a DMS instance to an account using aws-dms.CfnReplicationInstance() the following error might occur:

    • Error message:

      | CREATE_FAILED | AWS::DMS::ReplicationInstance  |
      Instance The IAM Role arn:aws:iam::123412341234:role/dms-vpc-role is not configured properly. (Service: AWSDatabaseMigrationService; Status Code: 400; Error Code: AccessDeniedFault; Request ID: 39cbef67-2365-4f1e-89c9-e3704c35481b)
      
    • Solution:

      If you use the AWS CLI or the AWS DMS API for your database migration, you must add three IAM roles to your AWS account before you can use the features of AWS DMS. Two of these are dms-vpc-role and dms-cloudwatch-logs-role. If you use Amazon Redshift as a target database, you must also add the IAM role dms-access-for-endpoint to your AWS account.

      Check out the following reference document to create the IAM roles.

    • Reference:

      Creating the IAM roles to use with the AWS CLI and AWS DMS API

Security

See CONTRIBUTING for more information.

License

This library is licensed under the MIT-0 License. See the LICENSE file.