# Cómo ejecutar los ejemplos de código de esta guía para desarrolladores
Los SDK de AWS proporcionan un amplio soporte para Amazon DynamoDB en los siguientes lenguajes:
+ [ 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/)
+ [iOS](https://aws.amazon.com/mobile/sdk/)
Los ejemplos de código de esta guía para desarrolladores ofrecen una cobertura más exhaustiva de las operaciones de DynamoDB en los siguientes lenguajes de programación:
+ [Ejemplos de código Java](CodeSamples.Java.md)
+ [Ejemplos de código .NET](CodeSamples.DotNet.md)
Antes de comenzar con este ejercicio, es preciso crear una cuenta de AWS, obtener la clave de acceso y la clave secreta, y configurar la AWS Command Line Interface (AWS CLI) en el ordenador. Para obtener más información, consulte [Configuración de DynamoDB (servicio web)](SettingUp.DynamoWebService.md).
**nota**
Si va a utilizar la versión descargable de DynamoDB, debe utilizar la AWS CLI para crear las tablas y los ejemplos de datos. Asimismo, debe especificar el parámetro `--endpoint-url` en cada comando de la AWS CLI. Para obtener más información, consulte [Configuración del punto de conexión local](DynamoDBLocal.UsageNotes.md#DynamoDBLocal.Endpoint).
# Creación de tablas y carga de datos para ejemplos de código en DynamoDB
Consulte a continuación los conceptos básicos sobre la creación de tablas en DynamoDB, la carga de un conjunto de datos de ejemplo, la consulta de los datos y su actualización.
+ [Paso 1: crear una tabla en DynamoDB](getting-started-step-1.md)
+ [Paso 2: escribir datos en una tabla de DynamoDB](getting-started-step-2.md)
+ [Paso 3: leer datos de una tabla de DynamoDB](getting-started-step-3.md)
+ [Paso 4: actualizar los datos de una tabla de DynamoDB](getting-started-step-4.md)
# Ejemplos de código Java
**Topics**
+ [Java: configuración de las credenciales de AWS](#CodeSamples.Java.Credentials)
+ [Java: configuración de la región y del punto de conexión de AWS](#CodeSamples.Java.RegionAndEndpoint)
Esta Guía para desarrolladores contiene fragmentos de código Java y programas listos para ejecutarlos. Encontrará estos ejemplos de código en las secciones siguientes:
+ [Uso de elementos y atributos en DynamoDB](WorkingWithItems.md)
+ [Uso de tablas y datos en DynamoDB](WorkingWithTables.md)
+ [Consulta de tablas en DynamoDB](Query.md)
+ [Análisis de tablas en DynamoDB](Scan.md)
+ [Mejora del acceso con índices secundarios en DynamoDB](SecondaryIndexes.md)
+ [Java 1.x: DynamoDBMapper](DynamoDBMapper.md)
+ [Captura de datos de cambios para DynamoDB Streams](Streams.md)
Puede comenzar rápidamente a trabajar con Eclipse y [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/). Además de un IDE completo, obtendrá AWS SDK para Java con actualizaciones automáticas y plantillas preconfiguradas para crear aplicaciones de AWS.
**Para ejecutar los ejemplos de código Java (con Eclipse)**
1. Descargue e instale el IDE de [Eclipse](http://www.eclipse.org).
1. Descargue e instale el [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/).
1. Inicie Eclipse y, en el menú **Eclipse**, elija **File (Archivo)**, **New (Nuevo)** y después **Other (Otro)**.
1. En **Seleccionar un asistente**, elija **AWS**, **Proyecto de Java de AWS** y, después, **Siguiente**.
1. En **Crear una instancia de Java de AWS**, haga lo siguiente:
1. En **Nombre del proyecto**, introduzca un nombre para el proyecto.
1. En **Select Account (Seleccionar cuenta)**, elija su perfil de credenciales en la lista.
Si es la primera vez que utiliza [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/), elija **Configurar cuentas de AWS** para configurar las credenciales de AWS.
1. Elija **Finish (Finalizar)** para crear el proyecto.
1. En el menú **Eclipse**, elija **File (Archivo)**, **New (Nuevo)** y después **Class (Clase)**.
1. En **Java Class (Clase Java)**, introduzca un nombre para la clase en **Name (Nombre)** (use el mismo nombre que en el ejemplo de código que desea ejecutar) y, a continuación, elija **Finish (Finalizar)** para crear la clase.
1. Copie el ejemplo de código de la página de documentación en el editor de Eclipse.
1. Para ejecutar el código, elija **Run (Ejecutar)** en el menú Eclipse.
El SDK para Java proporciona clientes seguros para subprocesos con el fin de trabajar con DynamoDB. Como práctica recomendada, sus aplicaciones deben crear un cliente y reutilizar el cliente entre subprocesos.
Para obtener más información, consulte la [AWS SDK para Java](https://aws.amazon.com/sdk-for-java).
**nota**
Los ejemplos de código de esta guía se han diseñado para utilizarlos con la última versión del AWS SDK para Java.
Si utiliza AWS Toolkit for Eclipse, puede configurar las actualizaciones automáticas para el SDK para Java. Para hacer esto en Eclipse, vaya a **Preferences (Preferencias)** y elija **AWS Toolkit**, **AWS SDK para Java**, **Download new SDKs automatically (Descargar nuevos SDK automáticamente)**.
## Java: configuración de las credenciales de AWS
El SDK para Java requiere que proporcione las credenciales de AWS a su aplicación en tiempo de ejecución. En los ejemplos de código de esta guía se supone que se usa un archivo de credenciales de AWS, tal como se describe en [Configuración de las credenciales de AWS](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/set-up-creds.html) en la *Guía para desarrolladores de AWS SDK para Java*.
A continuación se muestra un ejemplo de archivo de credenciales de AWS denominado `~/.aws/credentials`, donde el carácter de tilde (`~`) representa su directorio de inicio.
```
[default]
aws_access_key_id = AWS access key ID goes here
aws_secret_access_key = Secret key goes here
```
## Java: configuración de la región y del punto de conexión de AWS
De forma predeterminada, los ejemplos de código acceden a DynamoDB en la región EE. UU. Oeste (Oregón). Puede cambiar la región modificando las propiedades de `AmazonDynamoDB`.
En el siguiente ejemplo de código se crea una nueva instancia de `AmazonDynamoDB`.
```
import software.amazon.dynamodb.AmazonDynamoDBClientBuilder;
import com.amazonaws.regions.Regions;
...
// This client will default to US West (Oregon)
AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard()
.withRegion(Regions.US_WEST_2)
.build();
```
Puede usar el método `withRegion` para ejecutar el código en DynamoDB en cualquier región donde se encuentre disponible. Para obtener una lista completa, consulte [Regiones de AWS y puntos de conexión](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region) en la *Referencia general de Amazon Web Services*.
Si desea ejecutar los ejemplos de código en DynamoDB localmente en su ordenador, configure el punto de enlace como se indica a continuación.
### AWSSDK de V1
```
AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard().withEndpointConfiguration(
new AwsClientBuilder.EndpointConfiguration("http://localhost:8000", "us-west-2"))
.build();
```
### AWSSDK de V2
```
DynamoDbClient client = DynamoDbClient.builder()
.endpointOverride(URI.create("http://localhost:8000"))
// The region is meaningless for local DynamoDb but required for client builder validation
.region(Region.US_EAST_1)
.credentialsProvider(StaticCredentialsProvider.create(
AwsBasicCredentials.create("dummy-key", "dummy-secret")))
.build();
```
# Ejemplos de código .NET
**Topics**
+ [.NET: configuración de las credenciales de AWS](#CodeSamples.DotNet.Credentials)
+ [.NET: configuración de la región y del punto de conexión de AWS](#CodeSamples.DotNet.RegionAndEndpoint)
Esta guía contiene fragmentos de código .NET y programas listos para ejecutarlos. Encontrará estos ejemplos de código en las secciones siguientes:
+ [Uso de elementos y atributos en DynamoDB](WorkingWithItems.md)
+ [Uso de tablas y datos en DynamoDB](WorkingWithTables.md)
+ [Consulta de tablas en DynamoDB](Query.md)
+ [Análisis de tablas en DynamoDB](Scan.md)
+ [Mejora del acceso con índices secundarios en DynamoDB](SecondaryIndexes.md)
+ [Uso del modelo de documento de .NET en DynamoDB](DotNetSDKMidLevel.md)
+ [Uso del modelo de persistencia de objetos de .NET y DynamoDB](DotNetSDKHighLevel.md)
+ [Captura de datos de cambios para DynamoDB Streams](Streams.md)
Puede comenzar rápidamente a trabajar utilizando AWS SDK para .NET con Toolkit for Visual Studio.
**Para ejecutar los ejemplos de código .NET (mediante Visual Studio)**
1. Descargue e instale [Microsoft Visual Studio](https://www.visualstudio.com).
1. (Opcional) Descargue e instale [Toolkit for Visual Studio](https://aws.amazon.com/visualstudio/).
1. Configure sus credenciales de AWS. Configure un perfil de credenciales en su archivo de credenciales de AWS compartido (`~/.aws/credentials`). Para obtener más información, consulte [Configuración de credenciales de AWS](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html) en la *Guía para desarrolladores de AWS SDK para .NET*.
1. Inicie Visual Studio. Elija **File (Archivo)**, **New (Nuevo)**, **Project (Proyecto)**.
1. Busque la **Aplicación de consola**, seleccione la plantilla de C\$1 destinada a .NET y, a continuación, elija **Siguiente**. Configure el nombre y la ubicación del proyecto y, a continuación, seleccione **Crear**.
1. Agregue el paquete AWS SDK para DynamoDB NuGet al proyecto:
1. En el Explorador de soluciones, abra el menú contextual (haga clic con el botón derecho) del proyecto y elija **Administrar paquetes NuGet**.
1. En Administrador de paquetes NuGet, elija **Examinar**.
1. En el cuadro de búsqueda, introduzca **AWSSDK.DynamoDBv2** y espere a que se lleve a cabo la búsqueda.
1. Elija **AWSSDK.DynamoDBv2** y después elija **Install (Instalar)**.
1. En el proyecto de Visual Studio, abra `Program.cs`. Sustituya el contenido por el código de ejemplo de la página de documentación que desee ejecutar.
1. Para ejecutar el código, elija **Iniciar** en la barra de herramientas de Visual Studio.
SDK para .NET proporciona clientes seguros para subprocesos con el fin de trabajar con DynamoDB. Como práctica recomendada, sus aplicaciones deben crear un cliente y reutilizar el cliente entre subprocesos.
Para obtener más información, consulte [AWS SDK para .NET](https://aws.amazon.com/sdk-for-net).
**nota**
Los ejemplos de código de esta guía se han diseñado para utilizarlos con la última versión del AWS SDK para .NET.
## .NET: configuración de las credenciales de AWS
SDK para .NET requiere que proporcione las credenciales de AWS a su aplicación en tiempo de ejecución. En los ejemplos de código de esta guía se supone que se usa el SDK Store para administrar el archivo de credenciales de AWS, tal como se describe en [Uso del SDK Store](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html#sdk-store) en la *Guía para desarrolladores de AWS SDK para .NET*.
Toolkit for Visual Studio admite varios conjuntos de credenciales de cualquier cantidad de cuentas. Cada conjunto se conoce como *perfil*. Visual Studio agrega entradas al archivo `App.config` del proyecto, para que la aplicación encuentre las credenciales de AWS en tiempo de ejecución.
En el siguiente ejemplo se muestra el archivo `App.config` predeterminado que se genera al crear un nuevo proyecto con Toolkit for Visual Studio.
```
```
En tiempo de ejecución, el programa usa el conjunto `default` de credenciales de AWS, según lo especificado en la entrada `AWSProfileName`. Las credenciales de AWS en sí se conservan en SDK Store, cifradas. Toolkit for Visual Studio proporciona una interfaz gráfica de usuario para administrar las credenciales, todo ello desde Visual Studio. Para obtener más información, consulte [Especificación de credenciales](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/tkv_setup.html#creds) en la *Guía del usuario de AWS Toolkit for Visual Studio*.
**nota**
De forma predeterminada, los ejemplos de código acceden a DynamoDB en la región EE. UU. Oeste (Oregón). Puede cambiar la región modificando la entrada `AWSRegion` en el archivo App.config. Puede establecer `AWSRegion` en cualquier región donde DynamoDB esté disponible. Para obtener una lista completa, consulte [Regiones de AWS y puntos de conexión](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region) en la *Referencia general de Amazon Web Services*.
## .NET: configuración de la región y del punto de conexión de AWS
De forma predeterminada, los ejemplos de código acceden a DynamoDB en la región EE. UU. Oeste (Oregón). Puede cambiar la región modificando la entrada `AWSRegion` en el archivo `App.config`. O bien puede cambiar la región modificando las propiedades de `AmazonDynamoDBClient`.
En el siguiente ejemplo de código se crea una nueva instancia de `AmazonDynamoDBClient`. El cliente se modifica de tal forma que el código se ejecute en DynamoDB en otra región.
```
AmazonDynamoDBConfig clientConfig = new AmazonDynamoDBConfig();
// This client will access the US East 1 region.
clientConfig.RegionEndpoint = RegionEndpoint.USEast1;
AmazonDynamoDBClient client = new AmazonDynamoDBClient(clientConfig);
```
Para obtener una lista completa de las regiones, consulte [Regiones de AWS y puntos de conexión](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region) en la *Referencia general de Amazon Web Services*.
Si desea ejecutar los ejemplos de código en DynamoDB localmente en su ordenador, configure el punto de enlace como se indica a continuación.
```
AmazonDynamoDBConfig clientConfig = new AmazonDynamoDBConfig();
// Set the endpoint URL
clientConfig.ServiceURL = "http://localhost:8000";
AmazonDynamoDBClient client = new AmazonDynamoDBClient(clientConfig);
```