# Exemplos do DynamoDB Streams usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a AWS Command Line Interface com o DynamoDB Streams.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `describe-stream`
O código de exemplo a seguir mostra como usar `describe-stream`.
**AWS CLI**
**Para obter informações sobre um fluxo do DynamoDB**
O comando `describe-stream` a seguir exibe informações sobre o fluxo do DynamoDB específico.
```
aws dynamodbstreams describe-stream \
--stream-arn arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576
```
Resultado:
```
{
"StreamDescription": {
"StreamArn": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576",
"StreamLabel": "2019-10-22T18:02:01.576",
"StreamStatus": "ENABLED",
"StreamViewType": "NEW_AND_OLD_IMAGES",
"CreationRequestDateTime": 1571767321.571,
"TableName": "Music",
"KeySchema": [
{
"AttributeName": "Artist",
"KeyType": "HASH"
},
{
"AttributeName": "SongTitle",
"KeyType": "RANGE"
}
],
"Shards": [
{
"ShardId": "shardId-00000001571767321804-697ce3d2",
"SequenceNumberRange": {
"StartingSequenceNumber": "4000000000000642977831",
"EndingSequenceNumber": "4000000000000642977831"
}
},
{
"ShardId": "shardId-00000001571780995058-40810d86",
"SequenceNumberRange": {
"StartingSequenceNumber": "757400000000005655171150"
},
"ParentShardId": "shardId-00000001571767321804-697ce3d2"
}
]
}
}
```
Para obter mais informações, consulte [Capturar atividades de tabela com o DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) no *Guia do desenvolvedor do Amazon DynamoDB*.
+ Consulte detalhes da API em [DescribeStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/describe-stream.html) na *Referência de comandos da AWS CLI*.
### `get-records`
O código de exemplo a seguir mostra como usar `get-records`.
**AWS CLI**
**Para obter registros de um fluxo do Dynamodb**
O comando `get-records` a seguir recupera registros usando o iterador de fragmento especificado do Amazon DynamoDB.
```
aws dynamodbstreams get-records \
--shard-iterator "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576|1|AAAAAAAAAAGgM3YZ89vLZZxjmoQeo33r9M4x3+zmmTLsiL86MfrF4+B4EbsByi52InVmiONmy6xVW4IRcIIbs1zO7MNIlqZfx8WQzMwVDyINtGG2hCLg78JKbYxFasXeePGlApTyf3rJxR765uyOVaBvBHAJuwF2TXIuxhaAlOupNGHr52qAC3a49ZOmf+CjNPlqQjnyRSAnfOwWmKhL1/KNParWSfz2odf780oOObIDIWRRMkt7+Hyzh9SD+hFxFAWR5C7QIlOXPc8mRBfNIazfrVCjJK8/jsjCzsqNyXKzJbhh+GXCoxYN+Kpmg4nyj1EAsYhbGL35muvHFoHjcyuynbsczbWaXNfThDwRAyvoTmc8XhHKtAWUbJiaVd8ZPtQwDsThCrmDRPIdmTRGWllGfUr5ezN5LscvkQezzgpaU5p8BgCqRzjv5Vl8LB6wHgQWNG+w/lEGS05ha1qNP+Vl4+tuhz2TRnhnJo/pny9GI/yGpce97mWvSPr5KPwy+Dtcm5BHayBs+PVYHITaTliInFlT+LCwvaz1QH3MY3b8A05Z800wjpktm60iQqtMeDwN4NX6FrcxR34JoFKGsgR8XkHVJzz2xr1xqSJ12ycpNTyHnndusw=="
```
Resultado:
```
{
"Records": [
{
"eventID": "c3b5d798eef6215d42f8137b19a88e50",
"eventName": "INSERT",
"eventVersion": "1.1",
"eventSource": "aws:dynamodb",
"awsRegion": "us-west-1",
"dynamodb": {
"ApproximateCreationDateTime": 1571849028.0,
"Keys": {
"Artist": {
"S": "No One You Know"
},
"SongTitle": {
"S": "Call Me Today"
}
},
"NewImage": {
"AlbumTitle": {
"S": "Somewhat Famous"
},
"Artist": {
"S": "No One You Know"
},
"Awards": {
"N": "1"
},
"SongTitle": {
"S": "Call Me Today"
}
},
"SequenceNumber": "700000000013256296913",
"SizeBytes": 119,
"StreamViewType": "NEW_AND_OLD_IMAGES"
}
},
{
"eventID": "878960a6967867e2da16b27380a27328",
"eventName": "INSERT",
"eventVersion": "1.1",
"eventSource": "aws:dynamodb",
"awsRegion": "us-west-1",
"dynamodb": {
"ApproximateCreationDateTime": 1571849029.0,
"Keys": {
"Artist": {
"S": "Acme Band"
},
"SongTitle": {
"S": "Happy Day"
}
},
"NewImage": {
"AlbumTitle": {
"S": "Songs About Life"
},
"Artist": {
"S": "Acme Band"
},
"Awards": {
"N": "10"
},
"SongTitle": {
"S": "Happy Day"
}
},
"SequenceNumber": "800000000013256297217",
"SizeBytes": 100,
"StreamViewType": "NEW_AND_OLD_IMAGES"
}
},
{
"eventID": "520fabde080e159fc3710b15ee1d4daa",
"eventName": "MODIFY",
"eventVersion": "1.1",
"eventSource": "aws:dynamodb",
"awsRegion": "us-west-1",
"dynamodb": {
"ApproximateCreationDateTime": 1571849734.0,
"Keys": {
"Artist": {
"S": "Acme Band"
},
"SongTitle": {
"S": "Happy Day"
}
},
"NewImage": {
"AlbumTitle": {
"S": "Updated Album Title"
},
"Artist": {
"S": "Acme Band"
},
"Awards": {
"N": "10"
},
"SongTitle": {
"S": "Happy Day"
}
},
"OldImage": {
"AlbumTitle": {
"S": "Songs About Life"
},
"Artist": {
"S": "Acme Band"
},
"Awards": {
"N": "10"
},
"SongTitle": {
"S": "Happy Day"
}
},
"SequenceNumber": "900000000013256687845",
"SizeBytes": 170,
"StreamViewType": "NEW_AND_OLD_IMAGES"
}
}
],
"NextShardIterator": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-23T16:41:08.740|1|AAAAAAAAAAEhEI04jkFLW+LKOwivjT8d/IHEh3iExV2xK00aTxEzVy1C1C7Kbb5+ZOW6bT9VQ2n1/mrs7+PRiaOZCHJu7JHJVW7zlsqOi/ges3fw8GYEymyL+piEk35cx67rQqwKKyq+Q6w9JyjreIOj4F2lWLV26lBwRTrIYC4IB7C3BZZK4715QwYdDxNdVHiSBRZX8UqoS6WOt0F87xZLNB9F/NhYBLXi/wcGvAcBcC0TNIOH+N0NqwtoB/FGCkNrf8YZ0xRoNN6RgGuVWHF3pxOhxEJeFZoSoJTIKeG9YcYxzi5Ci/mhdtm7tBXnbw5c6xmsGsBqTirNjlDyJLcWl8Cl0UOLX63Ufo/5QliztcjEbKsQe28x8LM8o7VH1Is0fF/ITt8awSA4igyJS0P87GN8Qri8kj8iaE35805jBHWF2wvwT6Iy2xGrR2r2HzYps9dwGOarVdEITaJfWzNoL4HajMhmREZLYfM7Pb0PvRMO7JkENyPIU6e2w16W1CvJO2EGFIxtNk+V04i1YIeHMXJfcwetNRuIbdQXfJht2NQZa4PVV6iknY6d19MrdbSTMKoqAuvp6g3Q2jH4t7GKCLWgodcPAn8g5+43DaNkh4Z5zKOfNw=="
}
```
Para obter mais informações, consulte [Capturar atividades de tabela com o DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) no *Guia do desenvolvedor do Amazon DynamoDB*.
+ Para ver detalhes da API, consulte [GetRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/get-records.html) na *Referência de comandos da AWS CLI*.
### `get-shard-iterator`
O código de exemplo a seguir mostra como usar `get-shard-iterator`.
**AWS CLI**
**Para obter um iterador de fragmentos**
O comando `get-shard-iterator` a seguir recupera um iterador de fragmentos para o fragmento especificado.
```
aws dynamodbstreams get-shard-iterator \
--stream-arn arn:aws:dynamodb:us-west-1:12356789012:table/Music/stream/2019-10-22T18:02:01.576 \
--shard-id shardId-00000001571780995058-40810d86 \
--shard-iterator-type LATEST
```
Resultado:
```
{
"ShardIterator": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576|1|AAAAAAAAAAGgM3YZ89vLZZxjmoQeo33r9M4x3+zmmTLsiL86MfrF4+B4EbsByi52InVmiONmy6xVW4IRcIIbs1zO7MNIlqZfx8WQzMwVDyINtGG2hCLg78JKbYxFasXeePGlApTyf3rJxR765uyOVaBvBHAJuwF2TXIuxhaAlOupNGHr52qAC3a49ZOmf+CjNPlqQjnyRSAnfOwWmKhL1/KNParWSfz2odf780oOObIDIWRRMkt7+Hyzh9SD+hFxFAWR5C7QIlOXPc8mRBfNIazfrVCjJK8/jsjCzsqNyXKzJbhh+GXCoxYN+Kpmg4nyj1EAsYhbGL35muvHFoHjcyuynbsczbWaXNfThDwRAyvoTmc8XhHKtAWUbJiaVd8ZPtQwDsThCrmDRPIdmTRGWllGfUr5ezN5LscvkQezzgpaU5p8BgCqRzjv5Vl8LB6wHgQWNG+w/lEGS05ha1qNP+Vl4+tuhz2TRnhnJo/pny9GI/yGpce97mWvSPr5KPwy+Dtcm5BHayBs+PVYHITaTliInFlT+LCwvaz1QH3MY3b8A05Z800wjpktm60iQqtMeDwN4NX6FrcxR34JoFKGsgR8XkHVJzz2xr1xqSJ12ycpNTyHnndusw=="
}
```
Para obter mais informações, consulte [Capturar atividades de tabela com o DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) no *Guia do desenvolvedor do Amazon DynamoDB*.
+ Para ver detalhes da API, consulte [GetShardIterator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/get-shard-iterator.html) na *Referência de comandos da AWS CLI*.
### `list-streams`
O código de exemplo a seguir mostra como usar `list-streams`.
**AWS CLI**
**Para listar fluxos do DynamoDB**
O comando `list-streams` a seguir lista todos os fluxos existentes do Amazon DynamoDB dentro da região da AWS padrão.
```
aws dynamodbstreams list-streams
```
Resultado:
```
{
"Streams": [
{
"StreamArn": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576",
"TableName": "Music",
"StreamLabel": "2019-10-22T18:02:01.576"
}
]
}
```
Para obter mais informações, consulte [Capturar atividades de tabela com o DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) no *Guia do desenvolvedor do Amazon DynamoDB*.
+ Consulte detalhes da API em [ListStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/list-streams.html) na *Referência de comandos da AWS CLI*.