# Creación de modelos de datos con NoSQL Workbench
<a name="workbench.Modeler"></a>

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
<a name="workbench.Modeler.CreateNew"></a>

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
<a name="workbench.Modeler.ImportExisting"></a>

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
<a name="workbench.Modeler.Edit"></a>

**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
<a name="workbench.Modeler.AddData"></a>

**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
<a name="workbench.Modeler.AccessPatterns"></a>

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
<a name="workbench.Modeler.ImportCSV"></a>

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
<a name="workbench.Modeler.Facets"></a>

 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
<a name="workbench.Modeler.AggregateView"></a>

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
<a name="workbench.Modeler.ExportModel"></a>

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
<a name="workbench.Modeler.Commit"></a>

 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**.