

# Acceso a DynamoDB
<a name="AccessingDynamoDB"></a>

 Puede acceder a Amazon DynamoDB mediante la Consola de administración de AWS, la AWS Command Line Interface (AWS CLI) o la API de DynamoDB.

**Topics**
+ [Uso de la consola](#ConsoleDynamoDB)
+ [Uso de AWS CLI](#Tools.CLI)
+ [Uso de la API](#Using.API)
+ [Uso de NoSQL Workbench para DynamoDB](#Using.Workbench)
+ [Rangos de direcciones IP](#Using.IPRanges)
+ [Puntos de conexión de doble pila para el protocolo de Internet versión 6 (IPv6)](#dual-stackipv4-6)

## Uso de la consola
<a name="ConsoleDynamoDB"></a>

Puede acceder a la Consola de administración de AWS para Amazon DynamoDB en [https://console.aws.amazon.com/dynamodb/home](https://console.aws.amazon.com/dynamodb/home).

A continuación, se muestran algunas de las acciones que puede realizar en la consola de DynamoDB:
+ **Administrar las tablas**: cree, actualice y elimine las tablas. La calculadora de capacidad puede ayudar a estimar los requisitos de capacidad.
+ **Interactuar con los datos**: consulte, agregue, actualice y elimine elementos de las tablas. Administre la configuración del tiempo de vida (TTL).
+ **Supervisar y analizar**: consulte los paneles, supervise y configure las alarmas y analice las métricas y las alertas de las tablas de DynamoDB.
+ **Optimizar y ampliar**: administre índices secundarios, transmisiones, desencadenadores, capacidad reservada y otras características avanzadas para mejorar el uso de DynamoDB.

La consola de DynamoDB proporciona una interfaz completa para administrar los recursos de DynamoDB. Le recomendamos que acceda a la consola e interactúe con ella para obtener más información.

## Uso de AWS CLI
<a name="Tools.CLI"></a>

 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](SettingUp.DynamoWebService.md#SettingUp.DynamoWebService.GetCredentials). 

Para obtener un listado completo de todos los comandos disponibles para DynamoDB en la AWS CLI, consulte la [Referencia de comandos de AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/dynamodb/index.html).

**Topics**

### Descarga y configuración de la AWS CLI
<a name="Tools.CLI.DownloadingAndRunning"></a>

La AWS CLI está disponible en [http://aws.amazon.com/cli](https://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](https://docs.aws.amazon.com/cli/latest/userguide/).

1. Siga las instrucciones de [Instalación de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) y [Configuración de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html).

### Uso de la AWS CLI con DynamoDB
<a name="Tools.CLI.UsingWithDDB"></a>

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 *Artist* y la de ordenación, *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 \
    --billing-mode PAY_PER_REQUEST \
    --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 la AWS CLI con DynamoDB local
<a name="Tools.CLI.UsingWithDDBLocal"></a>

La AWS CLI también puede interactuar con la versión local de DynamoDB (descargable) que se ejecuta en su equipo. 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**  
La AWS CLI no puede utilizar la versión local de DynamoDB (descargable) como punto de conexión predeterminado. Por lo tanto, debe especificar `--endpoint-url` con cada comando. 

## Uso de la API
<a name="Using.API"></a>

 Puede utilizar la Consola de administración de AWS y la AWS Command Line Interface para trabajar de manera interactiva con Amazon DynamoDB. Sin embargo, para sacar el máximo partido de DynamoDB, puede escribir el código de aplicación mediante los SDK de AWS.

Los SDK de AWS ofrecen una amplia compatibilidad con DynamoDB en [Java](https://aws.amazon.com/sdk-for-java), [JavaScript en el navegador](https://aws.amazon.com/sdk-for-browser), [.NET](https://aws.amazon.com/sdk-for-net), [Node.js](https://aws.amazon.com/sdk-for-node-js), [PHP](https://aws.amazon.com/sdk-for-php), [Python](https://aws.amazon.com/sdk-for-python), [Ruby](https://aws.amazon.com/sdk-for-ruby), [C\$1\$1](https://aws.amazon.com/sdk-for-cpp), [Go](https://aws.amazon.com/sdk-for-go), [Android](https://aws.amazon.com/mobile/sdk/) e [iOS](https://aws.amazon.com/mobile/sdk/).

Para poder utilizar los SDK de AWS con DynamoDB, debe obtener un ID de clave de acceso de AWS y una clave de acceso secreta. Para obtener más información, consulte [Configuración de DynamoDB (servicio web)](SettingUp.DynamoWebService.md). 

 Para obtener información general sobre la programación de aplicaciones de DynamoDB con los SDK de AWS, consulte [Programación con DynamoDB y los SDK de AWS](Programming.md). 

## Uso de NoSQL Workbench para DynamoDB
<a name="Using.Workbench"></a>

También puede acceder a DynamoDB por medio de la descarga y el uso de [NoSQL Workbench para DynamoDB](workbench.md).

NoSQL Workbench para Amazon DynamoDB es una aplicación GUI de cliente multiplataforma que puede usar para el desarrollo moderno de bases de datos y operaciones. Está disponible para Windows, macOS y Linux. NoSQL Workbench es una herramienta de desarrollo visual que proporciona características de modelado de datos, visualización de datos y desarrollo de consultas para ayudarle a diseñar, crear, consultar y administrar tablas de DynamoDB. NoSQL Workbench ahora incluye DynamoDB local como parte opcional del proceso de instalación, lo que facilita el modelado de los datos en DynamoDB local. Para obtener más información sobre DynamoDB local y sus requisitos, consulte [Configuración de la versión de DynamoDB local (versión descargable)](DynamoDBLocal.md).

**nota**  
NoSQL Workbench para DynamoDB actualmente no admite inicios de sesión de AWS configurados con la autenticación de dos factores (2FA).

**Modelado de datos**  
Con NoSQL Workbench para DynamoDB, puede crear nuevos modelos de datos o diseñar modelos basados en modelos de datos existentes que satisfagan los patrones de acceso a datos de su aplicación. También puede importar y exportar el modelo de datos diseñado al final del proceso. Para obtener más información, consulte [Creación de modelos de datos con NoSQL Workbench](workbench.Modeler.md).

**Generación de operaciones**  
NoSQL Workbench proporciona una completa interfaz gráfica de usuario rica para que desarrolle y pruebe las consultas. Puede utilizar el *generador de operaciones* para visualizar, explorar y consultar conjuntos de datos en directo. También puede utilizar el generador de operaciones estructurado para crear y realizar operaciones de plano de datos. Admite expresiones de proyección y condición, y le permite generar código de muestra en varios idiomas. Para obtener más información, consulte [Exploración de conjuntos de datos y creación de operaciones con NoSQL Workbench](workbench.querybuilder.md).

## Rangos de direcciones IP
<a name="Using.IPRanges"></a>

Amazon Web Services (AWS) publica sus rangos de direcciones IP actuales en formato JSON. Para ver los rangos actuales, descargue [ip-ranges.json](https://ip-ranges.amazonaws.com/ip-ranges.json). Para obtener más información, consulte [Rangos de direcciones IP de AWS](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html) en Referencia general de AWS.

Para conocer los rangos de direcciones IP que se pueden utilizar para [acceder a tablas e índices de DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Operations_Amazon_DynamoDB.html), busque la siguiente cadena en el archivo ip-ranges.json: `"service": "DYNAMODB"`.

**nota**  
Los rangos de direcciones IP no se aplican a DynamoDB Streams ni a DynamoDB Accelerator (DAX). 

## Puntos de conexión de doble pila para el protocolo de Internet versión 6 (IPv6)
<a name="dual-stackipv4-6"></a>

DynamoDB ofrece puntos de conexión de doble pila compatibles con IPv4 e IPv6. Las convenciones de nomenclatura de los puntos de conexión son:
+ `dynamodb.<region>.api.aws`
+ `<account-id>.ddb.<region>.api.aws`
+ `streams-dynamodb.<region>.api.aws`
+ `dax.<region>.api.aws`
+ `dynamodb-fips.<region>.api.aws`

Para obtener una lista completa de los puntos de conexión y disponibilidad regional de DynamoDB, consulte [Puntos de conexión y cuotas de Amazon DynamoDB](https://docs.aws.amazon.com/general/latest/gr/ddb.html) en la *Guía de referencia general de AWS*.

Para obtener más información sobre la configuración de la CLI de AWS para usar puntos de conexión de doble pila, consulte la sección [Configurar el uso de puntos de conexión de doble pila para todos los servicios de AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-endpoints.html#endpoints-dual-stack) en la *Guía de interfaz de línea de comandos de AWS*.

Para obtener más información sobre la configuración de los clientes del SDK para que utilicen puntos de conexión de doble pila, consulte el tema sobre [Puntos de conexión de doble pila y FIPS](https://docs.aws.amazon.com/sdkref/latest/guide/feature-endpoints.html) en la *Guía de herramientas y AWS SDK*.

Antes de usar DynamoDB con IPv6, debe actualizar el rol de usuario de IAM o las políticas basadas en recursos que usa para el filtrado de direcciones IP para incluir los rangos de direcciones IPv6. Las políticas de filtrado de direcciones IP que no tienen en cuenta la dirección IPv6 pueden provocar problemas de acceso. Para obtener más información, consulte [Operadores de condición de dirección IP](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_IPAddress) en la *Guía de AWS Identity and Access Management*.