Utilización del AWS CLI

Puede usar la AWS Command Line Interface (AWS CLI) para controlar varios servicios de AWS desde la línea de comandos y automatizarlos mediante scripts. Puede usar la AWS CLI para operaciones ad-hoc, como crear una tabla. También puede usarla para incluir operaciones de Amazon DynamoDB en scripts de utilidades.

Para poder utilizar la AWS CLI con DynamoDB, debe obtener un ID de clave de acceso y una clave de acceso secreta. Para obtener más información, consulte Concesión de acceso mediante programación .

Para obtener un listado completo de todos los comandos disponibles para DynamoDB en la AWS CLI, consulte la Referencia de comandos de AWS CLI.

Descarga y configuración de la AWS CLI

La AWS CLI está disponible en http://aws.amazon.com/cli. Se ejecuta en Windows, macOS o Linux. Después de descargar la AWS CLI, siga estos pasos para instalarla y configurarla:

1. Vaya a la Guía del usuario de la AWS Command Line Interface.

2. Siga las instrucciones de Instalación de la AWS CLI y Configuración de la AWS CLI.

Uso de la AWS CLI con DynamoDB

El formato de la línea de comandos se compone de un nombre de operación de DynamoDB seguido de los parámetros de dicha operación. La AWS CLI admite la sintaxis abreviada de los valores de los parámetros, además de JSON.

Por ejemplo, el comando siguiente crea una tabla llamada Music. La clave de partición es Artista y la clave de ordenación es SongTitle. Para facilitar la legibilidad, los comandos largos de esta sección se dividen en líneas separadas.

aws dynamodb create-table \
    --table-name Music \
    --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 \
    --table-class STANDARD

Los comandos siguientes añaden nuevos elementos a la tabla. En estos ejemplos se usa una combinación de sintaxis abreviada y JSON.

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

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

Puede ser difícil crear código JSON válido en la línea de comandos. Sin embargo, la AWS CLI puede leer archivos JSON. Por ejemplo, fíjese en el fragmento de código JSON siguiente, que se almacena en un archivo denominado key-conditions.json.

{
    "Artist": {
        "AttributeValueList": [
            {   
                "S": "No One You Know"
            }   
        ],  
        "ComparisonOperator": "EQ"
    },  
    "SongTitle": {
        "AttributeValueList": [
            {   
                "S": "Call Me Today"
            }   
        ],  
        "ComparisonOperator": "EQ"
    }
}

Ahora puede emitir una solicitud de Query con la AWS CLI. En este ejemplo, el contenido del archivo key-conditions.json se usa para el parámetro --key-conditions.

aws dynamodb query --table-name Music --key-conditions file://key-conditions.json

Uso de AWS CLI con DynamoDB local

También AWS CLI pueden interactuar con DynamoDB local (versión descargable) que se ejecuta en su ordenador. Para ello, agregue el parámetro siguiente a cada comando:

--endpoint-url http://localhost:8000

En e siguiente ejemplo se usa la AWS CLI para mostrar las tablas de una base de datos local:

aws dynamodb list-tables --endpoint-url http://localhost:8000

Si DynamoDB utiliza un número de transferencia distinto del predeterminado (8000), modifique el valor de --endpoint-url en consecuencia.

nota

No AWS CLI pueden usar DynamoDB local (versión descargable) como punto final predeterminado. Por lo tanto, debe especificar --endpoint-url con cada comando.