

# Exploración de conjuntos de datos y creación de operaciones con NoSQL Workbench
<a name="workbench.querybuilder"></a>

NoSQL Workbench para Amazon DynamoDB proporciona una completa interfaz gráfica de usuario para desarrollar y probar consultas. Puede utilizar el generador de operaciones en NoSQL Workbench para ver, explorar y consultar conjuntos de datos en directo. El generador de operaciones estructuradas admite la expresión de proyecciones y de condiciones y, además, genera código de muestra en varios idiomas. Puede clonar tablas directamente de una cuenta de Amazon DynamoDB en otra en distintas regiones. También puede clonar tablas directamente entre DynamoDB local y una cuenta de Amazon DynamoDB para copiar más rápidamente el esquema de claves de la tabla (y, opcionalmente, el esquema y los elementos de GSI) entre sus entornos de desarrollo. Puede guardar hasta 50 operaciones de datos de DynamoDB en el generador de operaciones.

**Topics**
+ [Conexión a conjuntos de datos en directo](workbench.querybuilder.connect.md)
+ [Generación de operaciones complejas](workbench.querybuilder.operationbuilder.md)
+ [Clonación de tablas con NoSQL Workbench](workbench.querybuilder.cloning-tables.md)
+ [Exportación de datos a un archivo CSV](workbench.querybuilder.exportcsv.md)

# Conexión a conjuntos de datos en directo
<a name="workbench.querybuilder.connect"></a>

Para conectarse a las tablas de Amazon DynamoDB con NoSQL Workbench, primero se debe conectar a la cuenta de AWS.

**Para añadir una conexión a su base de datos**

1. En NoSQL Workbench, en el panel de navegación de la izquierda, seleccione el icono **Operation builder (Generador de operaciones)**.

1. Elija **Agregar conexión**.

1. Especifique la siguiente información:
   + **Connection name**
   + **AWS Región de**
   + **ID de clave de acceso**
   + **Clave de acceso secreta**

   Para obtener más información sobre cómo obtener las claves de acceso, consulte [Obtención de una clave de acceso de AWS](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html#SettingUp.DynamoWebService.GetCredentials).

   Si lo desea, puede especificar lo siguiente:
   + [https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)
   + [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns)

1. Elija **Conectar**.

    Si no desea registrarse para obtener una cuenta de nivel gratuito y prefiere usar [DynamoDB Local (versión descargable)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html): 

   1. Elija la pestaña **Local** en la pantalla de conexión.

   1. Especifique la siguiente información:
      + **Connection name**
      + **Puerto**

   1. Seleccione el botón **Connect (Conectar)**.
**nota**  
Para conectarse a DynamoDB local, inicie DynamoDB local manualmente desde su terminal (consulte [implementación de DynamoDB localmente en el equipo](DynamoDBLocal.DownloadingAndRunning.md)) o inicie DynamoDB local directamente mediante el conmutador DDB local del menú de navegación de NoSQL Workbench. Asegúrese de que el puerto de conexión sea el mismo que el puerto local de DynamoDB.

1. En la conexión creada, elija **Open (Abrir)**.

Después de conectarse a su base de datos de DynamoDB, la lista de tablas disponibles aparece en el panel izquierdo. Elija una de las tablas para devolver una muestra de los datos almacenados en la tabla.

Ahora puede ejecutar consultas en la tabla seleccionada.

Para ejecutar consultas en una tabla, consulte la siguiente sección sobre operaciones de creación, consulte [Generación de operaciones complejas](workbench.querybuilder.operationbuilder.md).

# Generación de operaciones complejas
<a name="workbench.querybuilder.operationbuilder"></a>

El generador de operaciones en NoSQL Workbench para Amazon DynamoDB proporciona una interfaz visual donde puede realizar operaciones complejas de planos de datos. Incluye compatibilidad con expresiones de proyección y de condición. Una vez que haya creado una operación, puede guardarla para su uso posterior (se pueden guardar hasta 50 operaciones). A continuación, puede examinar una lista de las operaciones de plano de datos utilizadas con frecuencia en la pestaña **Operaciones guardadas** y utilízalos para rellenar y generar automáticamente una nueva operación. También puede generar el código de muestra para estas operaciones en varios idiomas.

NoSQL Workbench admite la creación de instrucciones [PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html) para DynamoDB, que le permite interactuar con DynamoDB utilizando un lenguaje de consulta compatible con SQL. NoSQL Workbench también admite la creación de operaciones de la API CRUD de DynamoDB.

Para usar NoSQL Workbench para crear operaciones, en el panel de navegación de la izquierda, elija el icono **Operation builder** (Generador de operaciones).

**Topics**
+ [Creación de instrucciones PartiQL](workbench.querybuilder.partiql.md)
+ [Generación de operaciones API](workbench.querybuilder.operationbuilder.api.md)

# Creación de instrucciones PartiQL
<a name="workbench.querybuilder.partiql"></a>

Para utilizar NoSQL Workbench para crear instrucciones [PartiQL para DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html) elija **Editor de PartiQL** junto a la parte superior de la interfaz de usuario de NoSQL Workbench.

Puede crear los siguientes tipos de instrucciones PartiQL en el generador de operaciones.

**Topics**
+ [Instrucciones Singleton](#workbench.querybuilder.partiql.single)
+ [Transacciones](#workbench.querybuilder.partiql.transaction)
+ [Lote](#workbench.querybuilder.partiql.batch)

## Instrucciones Singleton
<a name="workbench.querybuilder.partiql.single"></a>

Para ejecutar o generar código para una instrucción PartiQL, haga lo siguiente.

1. Elija el **editor de PartiQL** junto a la parte superior de la ventana.

1. Ingrese una [Instrucción PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) válida.

1. Si la instrucción utiliza parámetros:

   1. Elegir **Parámetros de solicitudes opcionales**.

   1. Elegir **Agregar parámetro nuevo**.

   1. Ingrese el tipo de atributo y el valor.

   1. Si desea añadir parámetros adicionales, repita los pasos b y c.

1. Si desea generar código, seleccione **Generate code (Generar código)**.

   Seleccione el idioma que desee en las pestañas mostradas. Ahora puede copiar este código y utilizarlo en su aplicación.

1. Si desea que la operación se ejecute inmediatamente, seleccione **Execute (Ejecutar)**.

1. Si desea guardar esta operación para su uso posterior, elija **Save operation** (Guardar operación). A continuación, escriba un nombre para la operación y elija **Save** (Guardar).

## Transacciones
<a name="workbench.querybuilder.partiql.transaction"></a>

Para ejecutar o generar el código para una transacción PartiQL, haga lo siguiente.

1. Elija **PartiQLTransaction** del menú desplegable **Más operaciones**.

1. Elegir **Agregar una nueva instrucción**.

1. Ingrese una [Instruccción PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) válida.
**nota**  
Las operaciones de lectura y escritura no se admiten en la misma solicitud de transacción PartiQL. Una instrucción SELECT no puede estar en la misma solicitud con las instrucciones INSERT, UPDATE y DELETE. Consulte [Realización de transacciones con PartiQL para DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.transactions.html) para obtener más información.

1. Si su instrucción utiliza parámetros

   1. Elegir **Parámetros de solicitudes opcionales**.

   1. Elegir **Agregar parámetro nuevo**.

   1. Ingrese el tipo de atributo y el valor.

   1. Si desea añadir parámetros adicionales, repita los pasos b y c.

1. Si desea agregar más instrucciones, repita los pasos 2 a 4.

1. Si desea generar código, seleccione **Generate code (Generar código)**.

   Seleccione el idioma que desee en las pestañas mostradas. Ahora puede copiar este código y utilizarlo en su aplicación.

1. Si desea que la operación se ejecute inmediatamente, seleccione **Execute (Ejecutar)**.

1. Si desea guardar esta operación para su uso posterior, elija **Save operation** (Guardar operación). A continuación, escriba un nombre para la operación y elija **Save** (Guardar).

## Lote
<a name="workbench.querybuilder.partiql.batch"></a>

Para ejecutar o generar código para un lote de PartiQL, haga lo siguiente.

1. Elija **PartiQLBatch** del menú desplegable **Más operaciones**.

1. Elegir **Agregar una nueva instrucción**.

1. Ingrese una [Instrucción PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) válida.
**nota**  
 Las operaciones de lectura y escritura no se admiten en la misma solicitud por lotes PartiQL, lo que significa que una instrucción SELECT no puede estar en la misma solicitud con instrucciones INSERT, UPDATE y DELETE. No se permiten operaciones de escritura en el mismo elemento. Al igual que con la operación BatchGetItem, solo se admiten operaciones de lectura singleton. No se admiten las operaciones de análisis y consulta. Consulte [Ejecución de operaciones por lote con PartiQL para DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.batching.html) para obtener más información.

1. Si la instrucción utiliza parámetros:

   1. Elegir **Parámetros de solicitudes opcionales**.

   1. Elegir **Agregar parámetro nuevo**.

   1. Ingrese el tipo de atributo y el valor.

   1. Si desea añadir parámetros adicionales, repita los pasos b y c.

1. Si desea agregar más instrucciones, repita los pasos 2 a 4.

1. Si desea generar código, seleccione **Generate code (Generar código)**.

   Seleccione el idioma que desee en las pestañas mostradas. Ahora puede copiar este código y utilizarlo en su aplicación.

1. Si desea que la operación se ejecute inmediatamente, seleccione **Execute (Ejecutar)**.

1. Si desea guardar esta operación para su uso posterior, elija **Save operation** (Guardar operación). A continuación, escriba un nombre para la operación y elija **Save** (Guardar).

# Generación de operaciones API
<a name="workbench.querybuilder.operationbuilder.api"></a>

Para utilizar NoSQL Workbench para crear API CRUD de DynamoDB, seleccione **Creador de operaciones** de la izquierda de la interfaz de usuario de NoSQL Workbench.

A continuación, seleccione **Abierto** y elija una conexión.

Puede realizar las siguientes operaciones en el generador de operaciones.
+ [Eliminar tabla](#workbench.querybuilder.operationbuilder.DeleteTable)
+ [Crear tabla](#workbench.querybuilder.operationbuilder.CreateTable)
+ [Actualizar tabla](#workbench.querybuilder.operationbuilder.UpdateTable)
+ [Poner elemento](#workbench.querybuilder.operationbuilder.Put)
+ [Actualizar elemento](#workbench.querybuilder.operationbuilder.update)
+ [Eliminar elemento](#workbench.querybuilder.operationbuilder.Delete)
+ [Query](#workbench.querybuilder.operationbuilder.Query)
+ [Examen](#workbench.querybuilder.operationbuilder.scan)
+ [Transacción de obtención de elementos](#workbench.querybuilder.operationbuilder.transactget)
+ [Transacción de escritura de elementos](#workbench.querybuilder.operationbuilder.transactwrite)

## Eliminar tabla
<a name="workbench.querybuilder.operationbuilder.DeleteTable"></a>

Para ejecutar una operación `Delete Table`, siga los pasos que se muestran a continuación.

1. Encuentre la tabla que desea eliminar en la sección **Tablas**.

1. Seleccione **Eliminación de tabla** en el menú de puntos suspensivos horizontales.

1. Confirme que desea eliminar la tabla ingresando el **Nombre de la tabla**.

1. Seleccione **Eliminar**.

Para obtener más información acerca de esta operación, consulte [Eliminar tabla](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html) en la *Referencia de la API de Amazon DynamoDB*. 

## Eliminación de GSI
<a name="workbench.querybuilder.operationbuilder.DeleteGSI"></a>

Para ejecutar una operación `Delete GSI`, siga los pasos que se muestran a continuación.

1. Encuentre el GSI de una tabla que desea eliminar de la sección **Tablas**.

1. Seleccione **Eliminación de GSI** en el menú de puntos suspensivos horizontales.

1. Confirme que desea eliminar GSI ingresando el **Nombre de GSI**.

1. Seleccione **Eliminar**.

Para obtener más información acerca de esta operación, consulte [Eliminar tabla](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html) en la *Referencia de la API de Amazon DynamoDB*. 

## Crear tablas
<a name="workbench.querybuilder.operationbuilder.CreateTable"></a>

Para ejecutar una operación `Create Table`, siga los pasos que se muestran a continuación.

1. Elija el icono **\$1** junto a la sección **Tablas**.

1. Ingrese el nombre de tabla que desee.

1. Cree una clave de partición.

1. Opcional: cree una clave de clasificación.

1. Para personalizar la configuración de capacidad y desmarcar la casilla que hay junto a **Uso de la configuración de capacidad predeterminada**.
   + Ahora puede seleccionar **Provisioned (Aprovisionada)** o **On-demand capacity (Capacidad bajo demanda)**.

     Si se selecciona Provisioned (Aprovisionada), puede establecer el mínimo y el máximo de las unidades de capacidad de lectura y escritura. También puede habilitar o deshabilitar el escalado automático.
   + Si la tabla está configurada actualmente en Bajo demanda, no podrá especificar un rendimiento aprovisionado.
   + Si cambia el rendimiento de Bajo demanda a Aprovisionado, el escalado automático se aplicará automáticamente a todos los GSI con mínimo: 1, máximo: 10; destino: 70 %.

1. Seleccione **Omisión de GSI y creación** para crear esta tabla sin un GSI. Si lo desea, puede seleccionar **Siguiente** para crear un GSI con esta nueva tabla.

Para obtener más información acerca de esta operación, consulte [Crear tabla](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html) en la *Referencia de la API de Amazon DynamoDB*. 

## Creación de GSI
<a name="workbench.querybuilder.operationbuilder.CreateGSI"></a>

Para ejecutar una operación `Create GSI`, siga los pasos que se muestran a continuación.

1. Encuentre una tabla a la que quiera agregar un GSI.

1. En el menú de puntos suspensivos horizontales, seleccione **Creación de GSI**.

1. Asigne un nombre al GSI en **Nombre de índice**.

1. Cree una clave de partición.

1. Opcional: cree una clave de clasificación.

1. Elija una opción de tipo de proyección en el menú desplegable.

1. Seleccione **Creación de GSI**.

Para obtener más información acerca de esta operación, consulte [Crear tabla](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html) en la *Referencia de la API de Amazon DynamoDB*. 

## Actualizar tabla
<a name="workbench.querybuilder.operationbuilder.UpdateTable"></a>

Para actualizar la configuración de capacidad de una tabla con una operación `Update Table`, haga lo siguiente.

1. Encuentre la tabla para la que desea actualizar la configuración de capacidad.

1. En el menú de puntos suspensivos horizontales, seleccione **Actualización de la configuración de capacidad**.

1. Seleccione **Aprovisionada** o **capacidad Bajo demanda.**

   Si se selecciona **Aprovisionada**, puede establecer el mínimo y el máximo de las unidades de capacidad de lectura y escritura. También puede habilitar o deshabilitar el escalado automático.

1. Seleccione **Update (Actualizar)**.

Para obtener más información acerca de esta operación, consulte [Actualizar tabla](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html) en la *Referencia de la API de Amazon DynamoDB*.

## Actualización de GSI
<a name="workbench.querybuilder.operationbuilder.UpdateGSI"></a>

Para actualizar la configuración de capacidad de GSI con una operación `Update Table`, haga lo siguiente.

**nota**  
De forma predeterminada, los índices secundarios globales heredan la configuración de capacidad de la tabla base. Los índices secundarios globales pueden tener un modo de capacidad diferente solo cuando la tabla base está en el modo de capacidad aprovisionada. Al crear un índice secundario global en una tabla en modo aprovisionado, debe especificar las unidades de capacidad de lectura y escritura para la carga de trabajo prevista de ese índice. Para obtener más información, consulte [Consideraciones sobre el rendimiento aprovisionado para los índices secundarios globales](GSI.md#GSI.ThroughputConsiderations).

1. Encuentre el GSI para el que desea actualizar la configuración de capacidad.

1. En el menú de puntos suspensivos horizontales, seleccione **Actualización de la configuración de capacidad**.

1. Ahora puede seleccionar **Provisioned (Aprovisionada)** o **On-demand capacity (Capacidad bajo demanda)**.

   Si se selecciona **Aprovisionada**, puede establecer el mínimo y el máximo de las unidades de capacidad de lectura y escritura. También puede habilitar o deshabilitar el escalado automático.

1. Seleccione **Update (Actualizar)**.

Para obtener más información acerca de esta operación, consulte [Actualizar tabla](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html) en la *Referencia de la API de Amazon DynamoDB*.

## Poner elemento
<a name="workbench.querybuilder.operationbuilder.Put"></a>

Se crea un elemento mediante la operación `Put Item`. Para ejecutar o generar código para una operación `Put Item`, haga lo siguiente.

1. Encuentre la tabla en la que desea crear un elemento.

1. En el menú desplegable de **Acciones**, seleccione **Creación de elemento**.

1. Escriba el valor de la clave de partición.

1. Escriba el valor de la clave de clasificación, si hay una.

1. Si desea añadir atributos que no sean de clave, haga lo siguiente:

   1. Seleccione **\$1 Agregación de otros atributos**.

   1. Especifique los valores de **Attribute name (Nombre de atributo)**, **Type (Tipo)** y **Value (Valor)**. 

1. Si debe satisfacerse una expresión de condición para que la operación `Put Item` se realice correctamente, haga lo siguiente:

   1. Elija **Condition (Condición)**.

   1. Especifique el nombre de atributo, el operador de comparación, el tipo de atributo y el valor de atributo.

   1. Si se necesitan otras condiciones, seleccione **Condition (Condición)** de nuevo.

   Para obtener más información, consulte [Ejemplo de la CLI de expresión de condición de DynamoDB](Expressions.ConditionExpressions.md).

1. Si desea generar código, seleccione **Generate code (Generar código)**.

   Seleccione el idioma que desee en las pestañas mostradas. Ahora puede copiar este código y utilizarlo en su aplicación.

1. Si desea que la operación se ejecute inmediatamente, seleccione **Execute (Ejecutar)**.

1. Si desea guardar esta operación para su uso posterior, elija **Save operation** (Guardar la operación), escriba el nombre de la operación y elija **Save (Guardar)**.

Para obtener más información acerca de esta operación, consulte [PutItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html) en la *Referencia de la API de Amazon DynamoDB*. 

## Actualizar elemento
<a name="workbench.querybuilder.operationbuilder.update"></a>

Para ejecutar o generar código para una operación `Update Item`, haga lo siguiente:

1. Encuentre la tabla en la que desea actualizar un elemento.

1. Seleccione el elemento.

1. Escriba el nombre y el valor del atributo para la expresión seleccionada.

1. Si desea agregar más expresiones, elija otra de la lista desplegable **Actualización de expresión** y, a continuación, seleccione el icono **\$1**.

1. Si debe satisfacerse una expresión de condición para que la operación `Update Item` se realice correctamente, haga lo siguiente:

   1. Elija **Condition (Condición)**.

   1. Especifique el nombre de atributo, el operador de comparación, el tipo de atributo y el valor de atributo.

   1. Si se necesitan otras condiciones, seleccione **Condition (Condición)** de nuevo.

   Para obtener más información, consulte [Ejemplo de la CLI de expresión de condición de DynamoDB](Expressions.ConditionExpressions.md).

1. Si desea generar código, seleccione **Generate code (Generar código)**.

   Elija la pestaña del idioma que desee. Ahora puede copiar este código y utilizarlo en su aplicación.

1. Si desea que la operación se ejecute inmediatamente, seleccione **Execute (Ejecutar)**.

1. Si desea guardar esta operación para su uso posterior, elija **Save operation** (Guardar la operación), escriba el nombre de la operación y elija **Save (Guardar)**.

Para obtener más información acerca de esta operación, consulte [UpdateItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateItem.html) en la *Referencia de la API de Amazon DynamoDB*. 

## Eliminar elemento
<a name="workbench.querybuilder.operationbuilder.Delete"></a>

Para ejecutar una operación `Delete Item`, siga los pasos que se muestran a continuación.

1. Encuentre la tabla de la que desea eliminar un elemento. 

1. Seleccione el elemento.

1. Del menú desplegable **Acciones**, seleccione **Eliminación de elemento**.

1. Confirme que desea eliminar el elemento seleccionando **Eliminación**.

Para obtener más información acerca de esta operación, consulte [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html) en la *Referencia de la API de Amazon DynamoDB*.

## Duplicado de elemento
<a name="workbench.querybuilder.operationbuilder.Duplicate"></a>

Puede duplicar un elemento creando uno nuevo con los mismos atributos. Para duplicar un elemento, haga lo siguiente.

1. Encuentre la tabla en la que desea duplicar un elemento.

1. Seleccione el elemento.

1. Del menú desplegable **Acciones**, seleccione **Duplicación de elemento**.

1. Especifique una nueva clave de partición.

1. Especifique una nueva clave de clasificación (si es necesario).

1. Seleccione **Ejecución**.

Para obtener más información acerca de esta operación, consulte [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html) en la *Referencia de la API de Amazon DynamoDB*.

## Consultar
<a name="workbench.querybuilder.operationbuilder.Query"></a>

Para ejecutar o generar código para una operación `Query`, haga lo siguiente.

1. Seleccione **Consulta** en la parte superior de la interfaz de usuario de NoSQL Workbench.

1. Especifique el valor de la clave de partición.

1. Si se necesita una clave de clasificación para la operación `Query`:

   1. Seleccione **Sort key (Clave de ordenación)**.

   1. Especifique el operador de comparación y el valor de atributo.

1. Seleccione **Consulta** para ejecutar esta operación de consulta. Si necesita más opciones, compruebe la casilla de verificación **Más opciones** y siga con los pasos siguientes.

1. Si no se deben devolver todos los atributos con el resultado de la operación, seleccione **Projection expression (Expresión de proyección)**.

1. Elija el icono **\$1**.

1. Escriba el atributo que se devolverá con el resultado de la consulta.

1. Si se necesitan más atributos, seleccione **\$1 **.

1. Si debe satisfacerse una expresión de condición para que la operación `Query` se realice correctamente, haga lo siguiente:

   1. Elija **Condition (Condición)**.

   1. Especifique el nombre de atributo, el operador de comparación, el tipo de atributo y el valor de atributo.

   1. Si se necesitan otras condiciones, seleccione **Condition (Condición)** de nuevo.

   Para obtener más información, consulte [Ejemplo de la CLI de expresión de condición de DynamoDB](Expressions.ConditionExpressions.md).

1. Si desea generar código, seleccione **Generate code (Generar código)**.

   Elija la pestaña del idioma que desee. Ahora puede copiar este código y utilizarlo en su aplicación.

1. Si desea que la operación se ejecute inmediatamente, seleccione **Execute (Ejecutar)**.

1. Si desea guardar esta operación para su uso posterior, elija **Save operation** (Guardar la operación), escriba el nombre de la operación y elija **Save (Guardar)**.

Para obtener más información acerca de esta operación, consulte [Consulta](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Query.html) en la *Referencia de la API de Amazon DynamoDB*. 

## Examen
<a name="workbench.querybuilder.operationbuilder.scan"></a>

Para ejecutar o generar código para una operación `Scan`, haga lo siguiente.

1. Seleccione **Escaneo** en la parte superior de la interfaz de usuario de NoSQL Workbench.

1. Seleccione el botón **Escanear** para realizar esta operación de escaneo básica. Si necesita más opciones, compruebe la casilla de verificación **Más opciones** y siga con los pasos siguientes.

1. Especifique un nombre de atributo para filtrar los resultados del escaneo.

1. Si no se deben devolver todos los atributos con el resultado de la operación, seleccione **Projection expression (Expresión de proyección)**.

1. Si debe satisfacerse una expresión de condición para que la operación de examen se realice correctamente, haga lo siguiente:

   1. Elija **Condition (Condición)**.

   1. Especifique el nombre de atributo, el operador de comparación, el tipo de atributo y el valor de atributo.

   1. Si se necesitan otras condiciones, seleccione **Condition (Condición)** de nuevo. 

   Para obtener más información, consulte [Ejemplo de la CLI de expresión de condición de DynamoDB](Expressions.ConditionExpressions.md).

1. Si desea generar código, seleccione **Generate code (Generar código)**.

   Elija la pestaña del idioma que desee. Ahora puede copiar este código y utilizarlo en su aplicación.

1. Si desea que la operación se ejecute inmediatamente, seleccione **Execute (Ejecutar)**.

1. Si desea guardar esta operación para su uso posterior, elija **Save operation** (Guardar la operación), escriba el nombre de la operación y elija **Save (Guardar)**.

## TransactGetItems
<a name="workbench.querybuilder.operationbuilder.transactget"></a>

Para ejecutar o generar código para una operación `TransactGetItems`, haga lo siguiente.

1. Del menú desplegable **Más operaciones** en la parte superior de la interfaz de usuario de NoSQL Workbench, elija **TransactGetItems**.

1. Elija el icono **\$1** junto a **TransactGetItem**.

1. Especifique una clave de partición.

1. Especifique una clave de clasificación (si es necesario).

1. Seleccione **Ejecución** para realizar la operación, **Guardado de operación** para guardarla o **Generación de código** para generar código para ella.

Para obtener más información sobre las transacciones, consulte [Transacciones de Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html).

## TransactWriteItems
<a name="workbench.querybuilder.operationbuilder.transactwrite"></a>

Para ejecutar o generar código para una operación `TransactWriteItems`, haga lo siguiente.

1. Del menú desplegable **Más operaciones** en la parte superior de la interfaz de usuario de NoSQL Workbench, elija **TransactWriteItems**.

1. Elija una operación del menú desplegable **Acciones**.

1. Elija el icono **\$1** cerca de **TransactWriteItem**.

1. En el menú desplegable **Actions**, elija la operación que desea realizar.
   + Para `DeleteItem`, siga las instrucciones de la operación [Eliminar elemento](#workbench.querybuilder.operationbuilder.Delete). 
   + Para `PutItem`, siga las instrucciones de la operación [Poner elemento](#workbench.querybuilder.operationbuilder.Put). 
   + Para `UpdateItem`, siga las instrucciones de la operación [Actualizar elemento](#workbench.querybuilder.operationbuilder.update).

   Para cambiar el orden de las acciones, seleccione una acción en la lista de la izquierda y, a continuación, elija las flechas hacia arriba o hacia abajo para subirla o bajarla en la lista. 

   Para eliminar una acción, seleccione la acción de la lista y, a continuación, el icono **Delete (Eliminar)** (papelera). 

1. Seleccione **Ejecución** para realizar la operación, **Guardado de operación** para guardarla o **Generación de código** para generar código para ella.

Para obtener más información sobre las transacciones, consulte [Transacciones de Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html).

# Clonación de tablas con NoSQL Workbench
<a name="workbench.querybuilder.cloning-tables"></a>

Al clonar tablas, se copiará el esquema de claves de una tabla (y, opcionalmente, el esquema y los elementos de GSI) entre los entornos de desarrollo. Puede clonar una tabla entre DynamoDB local en una cuenta de Amazon DynamoDB e incluso clonar una tabla de una cuenta en otra en distintas regiones para acelerar la experiencia.

**Cancelar una tabla**

1. En **Generador de operaciones**, seleccione su conexión y su región (la selección de región no está disponible para DynamoDB local).

1. Cuando esté conectado a DynamoDB, examine las tablas y seleccione la tabla que desee clonar.

1. En el menú de puntos suspensivos horizontales, seleccione la opción **Clonación**.

1. Especifique la información del destino del clon:

   1. Seleccione una conexión.

   1. Seleccione una región (la región no está disponible para DynamoDB local).

   1. Escriba un nombre de tabla nuevo.

   1. Elija una opción de clonación:

      1. La opción **Esquema de claves** está seleccionada de forma predeterminada y no se puede desmarcar. De forma predeterminada, al clonar una tabla, se copiarán la clave principal y la clave de clasificación, si están disponibles.

      1. La opción **Esquema de GSI** se selecciona de forma predeterminada si la tabla que se va a clonar tiene un GSI. Al clonar una tabla, se copiarán la clave principal y la clave de clasificación del GSI, si están disponibles. Tiene la opción de desmarcar el esquema de GSI para impedir que se clone. Al clonar una tabla, la configuración de capacidad de la tabla base se copiará como la configuración de capacidad del GSI. Puede utilizar la operación `UpdateTable` del Generador de operaciones para actualizar la configuración de capacidad del GSI de la tabla una vez finalizada la clonación.

1. Introduzca el número de elementos que se debe clonar. Para clonar solo el esquema de claves y, opcionalmente, el esquema de GSI, puede mantener el valor de **Elementos que se van a clonar** en 0. El número máximo de elementos que puede clonar es 5000.

1. Elija un modo de capacidad:

   1. El **modo bajo demanda** está seleccionado de forma predeterminada. DynamoDB bajo demanda ofrece precios de pago por solicitud para las solicitudes de lectura y escritura. De este modo, solo tendrá que pagar por aquello que utilice. Para obtener más información, consulte [Modo bajo demanda de DynamoDB](capacity-mode.md#capacity-mode-on-demand).

   1. El **modo aprovisionado** le permite especificar el número de lecturas y escrituras por segundo que necesita para la aplicación. Puede utilizar el escalado automático para ajustar automáticamente la capacidad aprovisionada de la tabla en respuesta a los patrones de tráfico. Para obtener más información, consulte [Modo aprovisionado de DynamoDB](provisioned-capacity-mode.md).

1. Seleccione **Clonar** para empezar a clonar.

1. El proceso de clonación se ejecutará en segundo plano. La pestaña **Generador de operaciones** mostrará una notificación cuando se produzca un cambio en el estado de la tabla de clonación. Para acceder a este estado, seleccione la pestaña **Generador de operaciones** y, a continuación, el botón de flecha. El botón de flecha se encuentra en el widget de estado de la tabla de clonación, ubicado cerca de la parte inferior de la barra lateral del menú.

# Exportación de datos a un archivo CSV
<a name="workbench.querybuilder.exportcsv"></a>

Puede exportar los resultados de una consulta desde el Generador de operaciones a un archivo CSV. Esto le permite cargar los datos en una hoja de cálculo o procesarlos utilizando el lenguaje de programación preferido.

**Exportación a CSV**

1. En el Generador de operaciones, ejecute una operación de su elección, como un análisis o una consulta.
**nota**  
Solo puede exportar los resultados de las operaciones de lectura de la API y de las instrucciones PartiQL a un archivo CSV. No puede exportar los resultados de las instrucciones de lectura de transacciones.
Actualmente, puede exportar los resultados página por página a un archivo CSV. Si hay varias páginas de resultados, debe exportar cada página individualmente.

1. Seleccione los elementos que desea exportar de los resultados.

1. En el menú desplegable **Acciones**, elija **Exportación como CSV**.

1. Elija un nombre de archivo y una ubicación para el archivo CSV y seleccione **Save** (Guardar).