# Generación de operaciones complejas 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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).