Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de Amazon DynamoDB en AWS CLI

El AWS Command Line Interface (AWS CLI) proporciona soporte para todos los servicios de AWS bases de datos, incluido Amazon DynamoDB. Puede usarlo AWS CLI para operaciones improvisadas, como crear una tabla. También puede usarla para incluir operaciones de DynamoDB en scripts de utilidades.

Para obtener más información sobre el uso AWS CLI de DynamoDB, dynamodb consulte la Referencia de comandos.AWS CLI

Para ver una lista de los AWS CLI comandos de DynamoDB, utilice el siguiente comando.

$ aws dynamodb help

Requisitos previos

Para ejecutar los comandos de dynamodb, necesitará:

Creación y uso de tablas de DynamoDB

El formato de la línea de comandos se compone de un nombre de comando de DynamoDB, seguido de los parámetros de dicho comando. AWS CLI Admite la sintaxis CLI abreviada de los valores de los parámetros y es completa. JSON

En el siguiente ejemplo, se crea una tabla llamada MusicCollection.

$ aws dynamodb create-table \
    --table-name MusicCollection \
    --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S \
    --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=1,WriteCapacityUnits=1

A continuación, puede añadir nuevas líneas a la tabla con comandos similares a los que se muestran en el siguiente ejemplo. En estos ejemplos se utiliza una combinación de sintaxis abreviada y. JSON

$ aws dynamodb put-item \
    --table-name MusicCollection \
    --item '{
        "Artist": {"S": "No One You Know"},
        "SongTitle": {"S": "Call Me Today"} ,
        "AlbumTitle": {"S": "Somewhat Famous"} 
      }' \
    --return-consumed-capacity TOTAL
{
    "ConsumedCapacity": {
        "CapacityUnits": 1.0,
        "TableName": "MusicCollection"
    }
}

$ aws dynamodb put-item \
    --table-name MusicCollection \
    --item '{ 
        "Artist": {"S": "Acme Band"}, 
        "SongTitle": {"S": "Happy Day"} , 
        "AlbumTitle": {"S": "Songs About Life"} 
      }' \
    --return-consumed-capacity TOTAL
{
    "ConsumedCapacity": {
        "CapacityUnits": 1.0,
        "TableName": "MusicCollection"
    }
}

Puede resultar difícil redactar de forma válida JSON en un comando de una sola línea. Para hacerlo más fácil, AWS CLI pueden leer JSON archivos. Por ejemplo, considere el siguiente JSON fragmento, que está almacenado en un archivo denominado. expression-attributes.json

{
  ":v1": {"S": "No One You Know"},
  ":v2": {"S": "Call Me Today"}
}

Puede utilizar ese archivo para emitir una solicitud de query mediante la AWS CLI. En el siguiente ejemplo, se usa el contenido del archivo expression-attributes.json como valor del parámetro --expression-attribute-values.

$ aws dynamodb query --table-name MusicCollection \
    --key-condition-expression "Artist = :v1 AND SongTitle = :v2" \
    --expression-attribute-values file://expression-attributes.json
{
    "Count": 1,
    "Items": [
        {
            "AlbumTitle": {
                "S": "Somewhat Famous"
            },
            "SongTitle": {
                "S": "Call Me Today"
            },
            "Artist": {
                "S": "No One You Know"
            }
        }
    ],
    "ScannedCount": 1,
    "ConsumedCapacity": null
}

Uso de DynamoDB Local

Además de DynamoDB, puede usarlo AWS CLI con DynamoDB Local. DynamoDB Local es un pequeño servidor y base de datos del lado del cliente que imita el servicio de DynamoDB. DynamoDB Local le permite escribir aplicaciones que utilizan DynamoDB sin manipular ninguna tabla o dato del API servicio web de DynamoDB. En su lugar, todas las API acciones se redirigen a una base de datos local. lo que le permite ahorrar en rendimiento aprovisionado, almacenamiento de datos y tarifas de transferencia de datos.

Para obtener más información sobre DynamoDB Local y cómo usarlo con, consulte las siguientes secciones de AWS CLI la Guía para desarrolladores de Amazon DynamoDB:

Recursos

AWS CLI referencia:

Referencia de servicio: