## Amazon DynamoDB Construct Library
<!--BEGIN STABILITY BANNER-->---
![cfn-resources: Stable](https://img.shields.io/badge/cfn--resources-stable-success.svg?style=for-the-badge)
![cdk-constructs: Stable](https://img.shields.io/badge/cdk--constructs-stable-success.svg?style=for-the-badge)
---
<!--END STABILITY BANNER-->
Here is a minimal deployable DynamoDB table definition:
```python
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_dynamodb as dynamodb
table = dynamodb.Table(self, "Table",
partition_key=Attribute(name="id", type=dynamodb.AttributeType.STRING)
)
```
### Importing existing tables
To import an existing table into your CDK application, use the `Table.fromTableName`, `Table.fromTableArn` or `Table.fromTableAttributes`
factory method. This method accepts table name or table ARN which describes the properties of an already
existing table:
```python
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
table = Table.from_table_arn(self, "ImportedTable", "arn:aws:dynamodb:us-east-1:111111111:table/my-table")
# now you can just call methods on the table
table.grant_read_write_data(user)
```
If you intend to use the `tableStreamArn` (including indirectly, for example by creating an
`@aws-cdk/aws-lambda-event-source.DynamoEventSource` on the imported table), you *must* use the
`Table.fromTableAttributes` method and the `tableStreamArn` property *must* be populated.
### Keys
When a table is defined, you must define it's schema using the `partitionKey`
(required) and `sortKey` (optional) properties.
### Billing Mode
DynamoDB supports two billing modes:
* PROVISIONED - the default mode where the table and global secondary indexes have configured read and write capacity.
* PAY_PER_REQUEST - on-demand pricing and scaling. You only pay for what you use and there is no read and write capacity for the table or its global secondary indexes.
```python
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_dynamodb as dynamodb
table = dynamodb.Table(self, "Table",
partition_key=Attribute(name="id", type=dynamodb.AttributeType.STRING),
billing_mode=dynamodb.BillingMode.PAY_PER_REQUEST
)
```
Further reading:
https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.
### Configure AutoScaling for your table
You can have DynamoDB automatically raise and lower the read and write capacities
of your table by setting up autoscaling. You can use this to either keep your
tables at a desired utilization level, or by scaling up and down at preconfigured
times of the day:
Auto-scaling is only relevant for tables with the billing mode, PROVISIONED.
```python
# Example automatically generated. See https://github.com/aws/jsii/issues/826
read_scaling = table.auto_scale_read_capacity(min_capacity=1, max_capacity=50)
read_scaling.scale_on_utilization(
target_utilization_percent=50
)
read_scaling.scale_on_schedule("ScaleUpInTheMorning",
schedule=appscaling.Schedule.cron(hour="8", minute="0"),
min_capacity=20
)
read_scaling.scale_on_schedule("ScaleDownAtNight",
schedule=appscaling.Schedule.cron(hour="20", minute="0"),
max_capacity=20
)
```
Further reading:
https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/AutoScaling.html
https://aws.amazon.com/blogs/database/how-to-use-aws-cloudformation-to-configure-auto-scaling-for-amazon-dynamodb-tables-and-indexes/
### Amazon DynamoDB Global Tables
You can create DynamoDB Global Tables by setting the `replicationRegions` property on a `Table`:
```python
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_dynamodb as dynamodb
global_table = dynamodb.Table(self, "Table",
partition_key=Attribute(name="id", type=dynamodb.AttributeType.STRING),
replication_regions=["us-east-1", "us-east-2", "us-west-2"]
)
```
When doing so, a CloudFormation Custom Resource will be added to the stack in order to create the replica tables in the
selected regions.
### Encryption
All user data stored in Amazon DynamoDB is fully encrypted at rest. When creating a new table, you can choose to encrypt using the following customer master keys (CMK) to encrypt your table:
* AWS owned CMK - By default, all tables are encrypted under an AWS owned customer master key (CMK) in the DynamoDB service account (no additional charges apply).
* AWS managed CMK - AWS KMS keys (one per region) are created in your account, managed, and used on your behalf by AWS DynamoDB (AWS KMS chages apply).
* Customer managed CMK - You have full control over the KMS key used to encrypt the DynamoDB Table (AWS KMS charges apply).
Creating a Table encrypted with a customer managed CMK:
```python
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_dynamodb as dynamodb
table = dynamodb.Table(stack, "MyTable",
partition_key=Attribute(name="id", type=dynamodb.AttributeType.STRING),
encryption=TableEncryption.CUSTOMER_MANAGED
)
# You can access the CMK that was added to the stack on your behalf by the Table construct via:
table_encryption_key = table.encryption_key
```
You can also supply your own key:
```python
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_dynamodb as dynamodb
import aws_cdk.aws_kms as kms
encryption_key = kms.Key(stack, "Key",
enable_key_rotation=True
)
table = dynamodb.Table(stack, "MyTable",
partition_key=Attribute(name="id", type=dynamodb.AttributeType.STRING),
encryption=TableEncryption.CUSTOMER_MANAGED,
encryption_key=encryption_key
)
```
In order to use the AWS managed CMK instead, change the code to:
```python
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_dynamodb as dynamodb
table = dynamodb.Table(stack, "MyTable",
partition_key=Attribute(name="id", type=dynamodb.AttributeType.STRING),
encryption=TableEncryption.AWS_MANAGED
)
```
没有合适的资源?快使用搜索试试~ 我知道了~
PyPI 官网下载 | aws-cdk.aws-dynamodb-1.65.0.tar.gz
1.该资源内容由用户上传,如若侵权请联系客服进行举报
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
版权申诉
0 下载量 141 浏览量
2022-01-26
13:29:34
上传
评论
收藏 167KB GZ 举报
温馨提示
共15个文件
txt:4个
py:3个
pkg-info:2个
资源来自pypi官网。 资源全名:aws-cdk.aws-dynamodb-1.65.0.tar.gz
资源推荐
资源详情
资源评论
收起资源包目录
aws-cdk.aws-dynamodb-1.65.0.tar.gz (15个子文件)
aws-cdk.aws-dynamodb-1.65.0
setup.cfg 38B
README.md 6KB
PKG-INFO 8KB
src
aws_cdk.aws_dynamodb.egg-info
dependency_links.txt 1B
PKG-INFO 8KB
SOURCES.txt 458B
top_level.txt 8B
requires.txt 267B
aws_cdk
aws_dynamodb
MANIFEST.in 23B
pyproject.toml 102B
setup.py 2KB
共 15 条
- 1
资源评论
挣扎的蓝藻
- 粉丝: 13w+
- 资源: 15万+
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功