# NoSQL Workbench para DynamoDB
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 permite diseñar modelos de datos de DynamoDB, definir patrones de acceso como operaciones reales de DynamoDB y validarlos con datos de ejemplo. Además, puede organizar los modelos de datos en proyectos. NoSQL Workbench incluye DynamoDB local, que permite probar las tablas e índices antes de confirmar el modelo de datos en la nube. 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).
**Modelador de datos**
Con NoSQL Workbench para DynamoDB, puede empezar un nuevo proyecto desde cero o utilizar un proyecto de ejemplo que se adapte a su caso de uso. A continuación, diseñe tablas e índices secundarios globales, defina los atributos y configure los datos de ejemplo. También puede visualizar los patrones de acceso como operaciones reales de DynamoDB (PutItem, UpdateItem, Query, etc.) y ejecutar estas operaciones con los datos de ejemplo configurados para validar que el patrón de acceso funciona según lo previsto, lo que realiza ajustes en el modelo de datos en función de los resultados de la validación. Por último, una vez validado, debe confirmar el modelo a DynamoDB local o a la cuenta de AWS para probarlo más adelante y usarlo en producción. Para colaborar, puede importar y exportar los modelos de datos diseñados. Para obtener más información, consulte [Creación de modelos de datos con NoSQL Workbench](workbench.Modeler.md).
**Generador 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. 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. Para obtener más información, consulte [Exploración de conjuntos de datos y creación de operaciones con NoSQL Workbench](workbench.querybuilder.md).
En el siguiente vídeo, se detallan los conceptos del modelado de datos con NoSQL Workbench.
[](http://www.youtube.com/watch?v=https://www.youtube.com/embed/p5va6ZX9_o0?si=vqQuf6FjoBuK1phR)
**Topics**
+ [Descargar NoSQL Workbench para DynamoDB](workbench.settingup.md)
+ [Creación de modelos de datos con NoSQL Workbench](workbench.Modeler.md)
+ [Exploración de conjuntos de datos y creación de operaciones con NoSQL Workbench](workbench.querybuilder.md)
+ [Modelos de datos de ejemplo para NoSQL Workbench](workbench.SampleModels.md)
+ [Historial de versiones de NoSQL Workbench](WorkbenchDocumentHistory.md)
# Descargar NoSQL Workbench para DynamoDB
Siga estas instrucciones para descargar NoSQL Workbench y DynamoDB local para Amazon DynamoDB.
**Para descargar NoSQL Workbench y DynamoDB local**
+ Descargue la versión apropiada de NoSQL Workbench para su sistema operativo.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/amazondynamodb/latest/developerguide/workbench.settingup.html)
**nota**
NoSQL Workbench incluye DynamoDB local como parte del proceso de instalación.
Para ejecutar DynamoDB local se requiere una versión 17.x o más reciente del Entorno de ejecución de Java (JRE).
**nota**
NoSQL Workbench es compatible con Ubuntu 12.04, Fedora 21 y Debian 8 o cualquier versión más reciente de estas distribuciones de Linux.
Las instalaciones de Ubuntu requieren dos componentes de software: `libfuse2` y `curl`.
A partir de Ubuntu 22.04, libfuse2 ya no se instala de forma predeterminada. Para solucionar este problema, ejecute `sudo add-apt-repository universe && sudo apt install libfuse2` para instalar la versión más reciente de Ubuntu.
Para cURL, ejecute `sudo apt update && sudo apt upgrade && sudo apt install curl`.
# Creación de modelos de datos con NoSQL Workbench
Puede utilizar la herramienta del modelador de datos en NoSQL Workbench para Amazon DynamoDB con el fin de crear nuevos modelos de datos o para diseñar modelos basados en otros existentes que satisfagan los patrones de acceso a datos de las aplicaciones. El modelador de datos incluye algunos modelos de datos de muestra para ayudarle a comenzar.
**Topics**
+ [Creación de un nuevo modelo de datos](workbench.Modeler.CreateNew.md)
+ [Importación de un modelo de datos existente](workbench.Modeler.ImportExisting.md)
+ [Edición de un modelo de datos existente](workbench.Modeler.Edit.md)
+ [Incorporación de datos de muestreo a un modelo de datos](workbench.Modeler.AddData.md)
+ [Adición y validación de patrones de acceso](workbench.Modeler.AccessPatterns.md)
+ [Importación de datos de muestra de un archivo CSV](workbench.Modeler.ImportCSV.md)
+ [Facetas](workbench.Modeler.Facets.md)
+ [Visualización de todas las tablas de un modelo de datos mediante la vista agregada](workbench.Modeler.AggregateView.md)
+ [Exportación de un modelo de datos](workbench.Modeler.ExportModel.md)
+ [Confirmación de un modelo de datos en DynamoDB](workbench.Modeler.Commit.md)
# Creación de un nuevo modelo de datos
Siga estos pasos para crear un nuevo modelo de datos en Amazon DynamoDB utilizando NoSQL Workbench.
**Para crear un nuevo modelo de datos**
1. Abra NoSQL Workbench y, en la pantalla principal, seleccione **Crear modelo manualmente**.
Se abrirá una nueva página con una configuración vacía para la primera tabla. NoSQL Workbench crea todos los modelos de datos nuevos con un nombre predeterminado (es decir, untitled-2) y los agrega a la carpeta de proyectos **Borradores**.
1. En la **Pantalla de configuración de tablas**, especifique lo siguiente:
+ **Table name (Nombre de tabla)**: escriba un nombre único para la tabla.
+ **Clave de partición**: ingrese un nombre de clave de partición y especifique su tipo. Opcionalmente, también puede seleccionar un formato de tipo de datos más granular para la generación de datos de muestra.
+ Si desea agregar una **Clave de clasificación**, especifique el nombre de la clave de clasificación y su tipo. Opcionalmente, puede seleccionar un formato de tipo de datos más granular para la generación de datos de muestra.
**nota**
Para obtener más información sobre el diseño de la clave principal, el diseño y el uso eficaz de las claves de partición y el uso de las claves de clasificación, consulte lo siguiente:
[Clave principal](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey)
[Prácticas recomendadas para diseñar claves de partición y utilizarlas con eficacia en DynamoDB](bp-partition-key-design.md)
[Prácticas recomendadas sobre el uso de claves de clasificación para organizar datos en DynamoDB](bp-sort-keys.md)
1. Puede agregar otros atributos para validar con mayor claridad el modelo y los patrones de acceso. Para agregar otros atributos:
+ Elija **Agregar atributo**.
+ Especifique el nombre de atributo y su tipo.
+ Opcionalmente, puede seleccionar un formato de tipo de datos más granular para la generación de datos de muestra.
1. Si desea añadir un índice secundario global, elija **Add global secondary index (Añadir índice secundario global)**. Especifique los valores de **Global secondary index name (Nombre de índice secundario global)**, el atributo **Partition key (Clave de partición)** y **Projection type (Tipo de partición)**.
Para obtener más información sobre cómo trabajar con índices secundarios globales en DynamoDB, consulte [Índices secundarios globales](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html).
1. De forma opcional, **Agregue una faceta**. Una faceta es un constructo virtual en NoSQL Workbench. No es un constructo funcional en DynamoDB. Las facetas en NoSQL Workbench lo ayudan a visualizar los diferentes patrones de acceso a los datos de una aplicación para DynamoDB con solo un subconjunto de los datos de una tabla.
**nota**
Recomendamos que se utilice [Adición y validación de patrones de acceso](workbench.Modeler.AccessPatterns.md) para visualizar cómo accederá la aplicación a los datos en DynamoDB en lugar de en Facetas. Los patrones de acceso reflejan las interacciones reales de la base de datos y lo ayudan a crear el modelo de datos correcto para su caso de uso, mientras que las facetas son visualizaciones no funcionales.
Elija **Add facet (Agregar faceta)**. Especifique lo siguiente:
+ El nombre de la faceta en **Facet name**.
+ Un **alias de clave de partición** para distinguir esta vista de faceta.
+ Un **Alias de clave de clasificación** si proporcionó una **Clave de clasificación** para la tabla.
+ Elija los **Atributos** que forman parte de esta faceta.
Repita este paso si desea agregar más facetas.
1. Por último, haga clic en el botón **Guardar** para crear la tabla.
1. Si necesita otras **Tablas** o **Índices secundarios globales**, haga clic en el icono **\$1** situado encima de la tabla que acaba de crear.
# Importación de un modelo de datos existente
Puede utilizar NoSQL Workbench para Amazon DynamoDB con el fin de crear un modelo de datos mediante la importación y la modificación de un modelo existente. Puede importar modelos de datos en formato de modelo de NoSQL Workbench o en [Formato de plantilla JSON de AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html).
**Para importar un modelo de datos**
1. Abra NoSQL Workbench y, en la pantalla principal, seleccione **Importar modelo**. Puede importar un formato de modelo de NoSQL Workbench o una plantilla JSON de CloudFormation.
1. Puede agregar el modelo importado a un proyecto existente o crear uno nuevo. Si no elige un proyecto diferente, el modelo se agregará a la carpeta de proyectos borradores.
1. Haga clic en **Examinar el escritorio** y elija un modelo para importarlo desde el ordenador.
# Edición de un modelo de datos existente
**Para editar un modelo existente**
1. Para empezar a realizar cambios en un modelo existente, abra el modelo en la página del modelador.
1. En el panel del selector de recursos, verá la lista de **Tablas** e **Índices secundarios globales**.
1. Para editar una **Tabla** o un **Índice secundario global**, primero haga clic en su nombre en el panel de selección de recursos y, a continuación, utilice los iconos de acción de la parte superior. Las acciones disponibles son **Eliminar**, **Duplicar** y **Editar**.
1. Si desea editar los **Detalles del modelo**, haga clic en el icono de tres puntos situado junto al nombre del modelo.
1. Desde allí, puede hacer clic en **Editar detalles del modelo** y editar la información en consecuencia.
1. También puede **Duplicar**, **Mover**, **Eliminar** y **Exportar** el modelo desde el mismo menú.
1. Para cambiar a otro modelo, puede volver a pasar por la pantalla principal o utilizar el menú desplegable de selección de modelos.
# Incorporación de datos de muestreo a un modelo de datos
**Generación automática de datos de muestra**
1. Abra NoSQL Workbench y, en la pantalla principal, haga clic en el nombre del modelo al que desee agregar datos de ejemplo.
1. Haga clic en las acciones adicionales (icono de tres puntos) en la barra de herramientas de contenido principal y seleccione **Agregar datos de muestra**.
1. Ingrese el número de los elementos de datos de muestra que desea generar y, a continuación, seleccione **Confirmar**.
1. La generación automática de datos de muestra lo ayuda a generar entre 1 y 5000 filas de datos para su utilización inmediata. Puede especificar un tipo de datos de muestra granular para crear datos realistas basados en sus necesidades de diseño y pruebas. Para utilizar la capacidad de generar datos realistas, debe especificar el formato del tipo de datos de muestra para sus atributos en el modelador de datos. Consulte [Creación de un nuevo modelo de datos](workbench.Modeler.CreateNew.md) para especificar ejemplos de formatos de tipos de datos.
**Agregación de datos de muestra de un elemento a la vez**
1. Abra el modelo que desee editar y, a continuación, elija la tabla a la que desee agregar los datos de muestra. Haga clic en las acciones adicionales (icono de tres puntos) en la barra de herramientas de contenido principal y seleccione **Editar datos**.
1. Ahora puede agregar, eliminar y editar filas. Una vez realizados los cambios necesarios, haga clic en el botón **Guardar**.
# Adición y validación de patrones de acceso
Puede utilizar NoSQL Workbench para Amazon DynamoDB con el fin de crear, almacenar y validar *patrones de acceso*.
**nota**
Consulte [Identificar los patrones de acceso a los datos](https://docs.aws.amazon.com/prescriptive-guidance/latest/dynamodb-data-modeling/step3.html) para obtener más información sobre cómo identificar los patrones de acceso correctos.
**Creación de un patrón de acceso**
1. Abra NoSQL Workbench y, en la pantalla principal, haga clic en el nombre del modelo al que desee agregar patrones de acceso.
1. En el lado izquierdo, elija la pestaña **Patrones de acceso** y haga clic en el icono **\$1**.
1. En la siguiente pantalla, proporcione un **Nombre**, una **Descripción** opcional, el **Tipo** de patrón de acceso y la **Tabla** o el **Índice secundario global** para comprobar el patrón de acceso.
**nota**
NoSQL Workbench admite actualmente las siguientes operaciones para los patrones de acceso: `Scan`, `Query`, `GetItem`, `PutItem`, `UpdateItem`, `DeleteItem`. Amazon DynamoDB admite una lista de operaciones más amplia.
1. Tras crear un patrón de acceso, puede cambiar a la pestaña **Validar** para comprobar que el modelo de datos está diseñado para ofrecer los resultados esperados para el patrón de acceso. Consulte [Incorporación de datos de muestreo a un modelo de datos](workbench.Modeler.AddData.md) para obtener más información sobre cómo generar automáticamente datos de muestra para las tablas. Los diferentes tipos de patrones de acceso admitirán diferentes parámetros de entrada.
**nota**
Para validar los patrones de acceso, NoSQL Workbench inicia una base de datos local independiente de DynamoDB en el puerto `8001` (de forma predeterminada) con tablas e índices almacenados en la memoria.
NoSQL Workbench agrega automáticamente los datos de muestra del modelo a las tablas temporales.
Si edita los datos de muestra o el propio modelo de datos, NoSQL Workbench actualizará las tablas temporales.
Esta base de datos temporal se borra al cerrar la aplicación.
**Edición de los patrones de acceso**
1. Abra NoSQL Workbench y, en la pantalla principal, haga clic en el nombre del modelo para el que desee editar patrones de acceso.
1. En el lado izquierdo, elija la pestaña **Patrones de acceso**.
1. Para editar un patrón de acceso, selecciónelo de la lista de la izquierda.
1. En la barra superior, haga clic en el botón de acción **Editar**.
# Importación de datos de muestra de un archivo CSV
Si dispone de datos de muestra preexistentes en un archivo CSV, puede importarlos a NoSQL Workbench. Esto le permite rellenar rápidamente el modelo con datos de muestra sin tener que ingresarlos línea por línea.
Los nombres de columna del archivo CSV deben coincidir con los nombres de atributos del modelo de datos, pero no es necesario que estén en el mismo orden. Por ejemplo, si el modelo de datos tiene atributos denominados `LoginAlias`, `FirstName`, y `LastName`, las columnas CSV podrían ser `LastName`, `FirstName`, y `LoginAlias`.
Puede importar hasta 150 filas a la vez desde un archivo CSV.
**Para importar datos de un archivo CSV a NoSQL Workbench**
1. Para importar datos CSV a una **Tabla**, primero haga clic en el nombre de la tabla en el panel de recursos y, a continuación, haga clic en las acciones adicionales (icono de tres puntos) en la barra de herramientas de contenido principal.
1. Seleccione **Importar datos de muestra**.
1. Seleccione el archivo CSV y elija **Open** (Abrir). Los datos CSV se adjuntan a la tabla.
# Facetas
En NoSQL Workbench, las *Facetas* permiten ver un subconjunto de datos de una tabla, sin tener que ver registros que no cumplen las restricciones de la faceta. Las facetas se consideran una herramienta visual de modelado de datos y no existen como una construcción utilizable en DynamoDB, ya que son puramente una ayuda para modelar patrones de acceso.
**nota**
Recomendamos que se utilice [Adición y validación de patrones de acceso](workbench.Modeler.AccessPatterns.md) para visualizar cómo accederá la aplicación a los datos en DynamoDB en lugar de en Facetas. Los patrones de acceso reflejan las interacciones reales de la base de datos y lo ayudan a crear el modelo de datos correcto para su caso de uso, mientras que las facetas son visualizaciones no funcionales.
**Creación de una faceta**
1. En el panel del selector de recursos, elija una **Tabla** que desee editar
1. En la barra superior, haga clic en el icono de la acción **Editar**.
1. Desplácese hacia abajo hasta la sección **Filtros de faceta**.
1. Elija **Add facet (Agregar faceta)**. Especifique lo siguiente:
+ El nombre de la faceta en **Facet name**.
+ Un **alias de clave de partición** para distinguir esta vista de faceta.
+ Un **Alias de clave de clasificación** si proporcionó una **Clave de clasificación** para la tabla.
+ Elija los **Atributos** que forman parte de esta faceta.
Repita este paso si desea agregar más facetas.
# Visualización de todas las tablas de un modelo de datos mediante la vista agregada
La vista agregada en NoSQL Workbench para Amazon DynamoDB permite visualizar todas las tablas e índices de un modelo de datos. Para cada tabla, aparece la siguiente información:
+ Nombres de las columnas de la tabla
+ Datos de ejemplo
+ Todos los índices secundarios globales asociados a la tabla. NoSQL Workbench muestra la siguiente información para cada índice:
+ Nombres de las columnas del índice
+ Datos de ejemplo
**Para ver toda la información de la tabla**
1. Abra NoSQL Workbench y, en la pantalla principal, haga clic en el nombre del modelo que desee abrir.
1. En la barra superior, haga clic en **Vista agregada**. Verá los datos de todas las tablas e índices en la misma pantalla.
**Exportación de la vista agregada como imágenes**
1. Con **Vista agregada** seleccionada, haga clic en el icono de tres puntos y elija **Exportar vista agregada**
1. Se presentará para su descarga un archivo con imágenes PNG de todas las tablas e índices.
# Exportación de un modelo de datos
Después de crear un modelo de datos utilizando NoSQL Workbench para Amazon DynamoDB, puede guardarlo y exportarlo en formato de modelo NoSQL Workbench o [formato de plantilla JSON AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html).
**Para exportar un modelo de datos**
1. Abra NoSQL Workbench y, en la pantalla principal, haga clic en el nombre del modelo que desee editar.
1. Haga clic en el icono de tres puntos situado junto al nombre del modelo de datos y seleccione **Exportar modelo**.
1. Elija si desea exportar el modelo de datos en formato de modelo de NoSQL Workbench o en formato de plantilla JSON de CloudFormation.
+ Elija el formato de **modelo de NoSQL Workbench** si desea compartir su modelo con otros miembros del equipo que utilizan NoSQL Workbench o importarlo a NoSQL Workbench más adelante.
+ Elija el formato de **plantilla JSON de CloudFormation** si desea implementar su modelo directamente en AWS o integrarlo en el flujo de trabajo de infraestructura como código.
# Confirmación de un modelo de datos en DynamoDB
Cuando esté satisfecho con su modelo de datos, puede confirmar el modelo en Amazon DynamoDB.
**nota**
Esta acción crea recursos del servidor en AWS para las tablas e índices secundarios globales representados en el modelo de datos.
NoSQL Workbench crea tablas e índices con capacidad bajo demanda de forma predeterminada.
**Para confirmar un modelo de datos en DynamoDB**
1. Abra NoSQL Workbench y, en la pantalla principal, haga clic en el nombre del modelo que desea confirmar.
1. En la barra superior, haga clic en **Confirmar**.
1. Elija una conexión existente o cree una nueva haciendo clic en el botón **Agregar nueva conexión**.
+ Para añadir una nueva conexión, especifique la siguiente información:
+ **Account Alias (Alias de cuenta**
+ **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. Si prefiere usar [DynamoDB local](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html):
1. Elija la pestaña **Conexión local**.
1. Haga clic en el botón **Agregar nueva conexión**.
1. Especifique el **Connection name (Nombre de conexión)** y el **Port (Puerto)**.
**nota**
Para utilizar DynamoDB local, tendrá que activarlo mediante la opción **DynamoDB local** situada en la parte inferior izquierda de la pantalla de NoSQL Workbench.
1. Haga clic en **Confirmar**.
# Exploración de conjuntos de datos y creación de operaciones con NoSQL Workbench
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
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
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).
# Clonación de tablas con NoSQL Workbench
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
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).
# Modelos de datos de ejemplo para NoSQL Workbench
La página principal del modelador muestra una serie de modelos de ejemplo que se incluyen con NoSQL Workbench. En esta sección se describen estos modelos y sus usos potenciales.
**Topics**
+ [Modelo de datos de empleados](#workbench.SampleModels.EmployeeDataModel)
+ [Modelo de datos del foro de debate](#workbench.SampleModels.DiscussionForumDataModel)
+ [Modelo de datos de biblioteca de música](#workbench.SampleModels.MusicLibraryDataModel)
+ [Modelo de datos de la estación de esquí](#workbench.SampleModels.SkiResortDataModel)
+ [Modelo de datos de ofertas de tarjetas de crédito](#workbench.SampleModels.CreditCardOffersDataModel)
+ [Modelo de datos de marcadores](#workbench.SampleModels.BookmarksDataModel)
## Modelo de datos de empleados
Este modelo de datos es un modelo introductorio. Representa los detalles básicos de un empleado, como un alias único, nombre, apellido, designación, gerente y habilidades.
Este modelo de datos representa algunas técnicas como el manejo de atributos complejos, como tener más de una habilidad. Este modelo es también un ejemplo de relación de uno a varios a través del gerente y sus empleados subordinados que se ha logrado mediante el índice secundario DirectReports.
Los patrones de acceso que este modelo de datos facilita son:
+ Recuperación de un registro de empleado utilizando el alias de inicio de sesión del empleado, facilitada por una tabla llamada `Employee`.
+ Buscar empleados por nombre, facilitado por el índice secundario global de la tabla Empleado llamado `Name`.
+ Recuperación de todos los informes directos de un gerente utilizando el alias de inicio de sesión del gerente, facilitada por el índice secundario global de la tabla Empleado llamado `DirectReports`.
## Modelo de datos del foro de debate
Este modelo de datos representa un foro de debate. Con este modelo los clientes pueden interaccionar con la comunidad de desarrolladores, plantear preguntas y contestar a las publicaciones de otros clientes. Cada servicio de AWS tiene un foro específico. Cualquier persona puede iniciar un nuevo hilo de debate publicando un mensaje en un foro, y cada hilo recibe un cierto número de respuestas.
Los patrones de acceso que este modelo de datos facilita son:
+ Recuperación de un registro de foro utilizando el nombre del foro, facilitada por una tabla llamada `Forum`.
+ Recuperación de un hilo específico o todos los hilos de un foro, facilitada por una tabla llamada `Thread`.
+ Busque respuestas utilizando la dirección de correo electrónico del usuario de publicación, facilitado por el índice secundario global de la tabla Respuesta llamado `PostedBy-Message-Index`.
## Modelo de datos de biblioteca de música
Este modelo de datos representa una biblioteca de música que tiene una gran colección de canciones y muestra sus canciones más descargadas casi en tiempo real.
Los patrones de acceso que este modelo de datos facilita son:
+ Recuperación de un disco de canción, facilitada por una tabla llamada `Songs`.
+ Recuperación de un registro de descarga específico o todos los registros de descarga de una canción, facilitada por una tabla llamada `Songs`.
+ Recuperación de un registro de recuento mensual específico de descargas o todos los registros de recuento de descargas mensuales de una canción, facilitada por una tabla llamada `Song`.
+ Recuperación de todos los registros (incluidos los registros de canciones, los registros de descargas y los registros de recuento de descargas mensuales) de una canción, facilitada por una tabla llamada `Songs`.
+ Buscar la mayoría de las canciones descargadas, facilitado por el índice secundario global de la tabla Canciones llamado `DownloadsByMonth`.
## Modelo de datos de la estación de esquí
Este modelo de datos representa una estación de esquí que tiene una gran colección de datos para cada telesilla recopilada diariamente.
Los patrones de acceso que este modelo de datos facilita son:
+ Recuperación de todos los datos de un remonte determinado o complejo general, dinámico y estático, facilitada por una tabla llamada `SkiLifts`.
+ Recuperación de todos los datos dinámicos (incluidos los transportes únicos, la cobertura de nieve, el peligro de avalancha y el estado del ascensor) para un telesilla o el centro vacacional en una fecha específica, facilitada por una tabla llamada `SkiLifts`.
+ Recuperación de todos los datos estáticos (incluyendo si el transporte es solo para experimentados, pies verticales que el transporte se eleva y tiempo de conducción en el transporte) para un telesilla específico, facilitado por una mesa llamada `SkiLifts`.
+ Recuperación de la fecha de los datos registrados para un remonte específico o el complejo general ordenado por usuarios individuales totales, facilitada por el índice secundario global de la tabla SkiLifts llamado `SkiLiftsByRiders`.
## Modelo de datos de ofertas de tarjetas de crédito
Este modelo de datos es utilizado por una aplicación de ofertas de tarjetas de crédito.
Un proveedor de tarjeta de crédito produce ofertas a lo largo del tiempo. Estas ofertas incluyen transferencias de saldo sin cargos, mayores límites de crédito, tasas de interés más bajas, devolución de efectivo y millas aéreas. Después de que un cliente acepte o rechace estas ofertas, el estado de la oferta correspondiente se actualiza en consecuencia.
Los patrones de acceso que este modelo de datos facilita son:
+ Recuperación de registros de cuenta usando `AccountId`, según lo facilitado en la tabla principal.
+ Recuperación de todas las cuentas con pocos elementos previstos, facilitada por el índice secundario `AccountIndex`.
+ Recuperación de cuentas y todos los registros de oferta asociados con esas cuentas mediante el uso de `AccountId`, facilitado por la tabla principal.
+ Recuperación de cuentas y registros de ofertas específicas asociadas con esas cuentas mediante el uso de `AccountId` y `OfferId`, según lo facilitado en la tabla principal.
+ Recuperación de todos los registros de oferta `ACCEPTED/DECLINED` de `OfferType` específicos asociados con cuentas usando `AccountId`, `OfferType`, y `Status`, según lo facilitado por el índice secundario `GSI1`.
+ Recuperación de ofertas y registros de elementos de oferta asociados utilizando `OfferId`, según lo facilitado en la tabla principal.
## Modelo de datos de marcadores
Este modelo de datos se utiliza marcadores de tienda para los clientes.
Un cliente puede tener muchos marcadores y un marcador puede pertenecer a muchos clientes. Este modelo de datos representa una relación de muchos a muchos.
Los patrones de acceso que este modelo de datos facilita son:
+ Una sola consulta de `customerId` ahora puede devolver datos de clientes, así como marcadores.
+ Un índice `ByEmail` de consulta devuelve los datos del cliente por dirección de correo electrónico. Tenga en cuenta que este índice no recupera los marcadores.
+ Un índice de consulta `ByUrl` obtiene datos de marcadores por URL. Tenga en cuenta que tenemos customerId como clave de ordenación para el índice porque la misma URL puede ser reservada por varios clientes.
+ Un índice de consulta `ByCustomerFolder` obtiene marcadores por carpeta para cada cliente.
# Historial de versiones de NoSQL Workbench
En la tabla siguiente se describen los cambios importantes en cada versión de la herramienta cliente de *NoSQL Workbench*.
****
| Versión | Cambio | Descripción | Fecha |
| --- | --- | --- | --- |
| 3.20.0 | Nuevo modelador de datos para DynamoDB | El modelador de datos de DynamoDB tiene una experiencia de usuario actualizada. El modelador de datos de DynamoDB ahora admite patrones de acceso. | 16 de febrero de 2026 |
| 3.13.5 | El modo de capacidad para la configuración de tabla predeterminada ahora está disponible bajo demanda | Al crear una tabla con la configuración predeterminada, DynamoDB crea una tabla que usa el modo de capacidad bajo demanda en lugar del modo de capacidad aprovisionada. | 24 de febrero de 2025 |
| 3.13.0 | Mejoras en el generador de operaciones de NoSQL Workbench | NoSQL Workbench ahora incluye compatibilidad nativa para el modo oscuro. Se han mejorado las operaciones de tablas y elementos en el generador de operaciones. Los resultados de los elementos y la información de solicitud del generador de operaciones están disponibles en formato JSON. | 24 de abril de 2024 |
| 3.12.0 | Clonar tablas con NoSQL Workbench y devolver la capacidad consumida | Ahora puede clonar tablas entre DynamoDB local y una cuenta de servicio web de DynamoDB o entre cuentas de servicio web de DynamoDB para acelerar las iteraciones de desarrollo. Observa la cantidad de RCU o WCU consumidas después de ejecutar una operación con el Generador de operaciones. Hemos solucionado el problema de anulación de datos al importar desde un archivo CSV. | 26 de febrero de 2024 |
| 3.11.0 | Mejoras de DynamoDB local | Ahora puede especificar el puerto al lanzar la instancia de DynamoDB local integrada. NoSQL Workbench ahora se puede instalar en Windows sin derechos de administrador. Hemos actualizado las plantillas del modelo de datos. | 17 de enero de 2024 |
| 3.10.0 | Compatibilidad nativa con Apple Silicon | NoSQL Workbench ahora incluye compatibilidad nativa para Mac con Apple Silicon. Ahora puede configurar un formato de generación de datos de ejemplo para los atributos del tipo `Number`. | 5 de diciembre de 2023 |
| 3.9.0 | Mejoras en el modelador de datos | El visualizador ahora admite la confirmación de modelos de datos en DynamoDB local con la opción de sobrescribir las tablas existentes. | 3 de noviembre de 2023 |
| 3.8.0 | Generación de datos de muestra | NoSQL Workbench ahora admite la generación de datos de muestra para sus modelos de datos de DynamoDB. | 25 de septiembre de 2023 |
| 3.6.0 | Mejoras en el generador de operaciones | Mejoras en la administración de las conexiones en el generador de operaciones. Los nombres de los atributos en Modelador de datos pueden cambiarse ahora sin eliminar datos. Otras correcciones de errores. | 11 de abril de 2023 |
| 3.5.0 | Compatibilidad con nuevas regiones de AWS | NoSQL Workbench ahora es compatible con las regiones ap-south-2, ap-southeast-3, ap-southeast-4, eu-central-2, eu-south-2, me-central-1 y me-west-1. | 23 de febrero de 2023 |
| 3.4.0 | Compatibilidad con DynamoDB local | NoSQL Workbench admite ahora la instalación de DynamoDB local como parte del proceso de instalación. | 6 de diciembre de 2022 |
| 3.3.0 | Asistencia para operaciones del plano de control | Operation Builder admite ahora operaciones de plano de control. | 1 de junio de 2022 |
| 3.2.0 | Importación y exportación de CSV | Ahora puede importar datos de muestra desde un archivo CSV en la herramienta de visualización y también exportar los resultados de una consulta del Generador de operaciones a un archivo CSV. | 11 de octubre de 2021 |
| 3.1.0 | Guardar operaciones | El Generador de operaciones en NoSQL Workbench ahora admite operaciones de guardado para su uso posterior. | 12 de julio de 2021 |
| 3.0.0 | Configuración de la capacidad e importación/exportación de CloudFormation | NoSQL Workbench para Amazon DynamoDB ahora admite la especificación de un modo de capacidad de lectura/escritura para tablas, y ahora puede importar y exportar modelos de datos en formato CloudFormation. | 21 de abril de 2021 |
| 2.2.0 | Support con PartiQL | NoSQL Workbench para Amazon DynamoDB también admite la creación de instrucciones PartiQL para DynamoDB. | 4 de diciembre de 2020 |
| 1.1.0 | Support con Linux. | NoSQL Workbench para Amazon DynamoDB es compatible con Linux, Ubuntu, Fedora y Debian. | 4 de mayo de 2020 |
| 1.0.0 | NoSQL Workbench para Amazon DynamoDB – GA. | NoSQL Workbench for Amazon DynamoDB ya se encuentra disponible de forma general. | 2 de marzo de 2020 |
| 0.4.1 | Compatibilidad con roles de IAM y credenciales de seguridad temporales. | NoSQL Workbench para Amazon DynamoDB ahora admite los roles de AWS Identity and Access Management (IAM) y las credenciales de seguridad temporales. | 19 de diciembre de 2019 |
| 0.3.1 | Compatibilidad con [DynamoDB local (versión descargable)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html). | NoSQL Workbench ahora admite conectarse a [DynamoDB local (versión descargable)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html) para diseñar, crear, consultar y administrar tablas de DynamoDB. | 8 de noviembre de 2019 |
| 0.2.1 | Publicación de la vista previa de NoSQL Workbench. | Es la versión inicial de NoSQL Workbench para DynamoDB. Utilice NoSQL Workbench para diseñar, crear, consultar y administrar tablas DynamoDB. | 16 de septiembre de 2019 |