Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création de modèles de données avec NoSQL Workbench
<a name="workbench.Modeler"></a>

Vous pouvez utiliser l'outil de modélisation de données de NoSQL Workbench pour Amazon DynamoDB pour créer de nouveaux modèles de données ou pour concevoir des modèles basés sur des modèles de données existants qui répondent aux modèles d'accès aux données de votre application. Le modélisateur de données comprend quelques exemples de modèles de données pour vous aider à démarrer.

**Topics**
+ [Création d’un modèle de données](workbench.Modeler.CreateNew.md)
+ [Importation d’un modèle de données existant](workbench.Modeler.ImportExisting.md)
+ [Modification d’un modèle de données existant](workbench.Modeler.Edit.md)
+ [Ajout d’un exemple de données à un modèle de données](workbench.Modeler.AddData.md)
+ [Ajouter et valider des modèles d'accès](workbench.Modeler.AccessPatterns.md)
+ [Importation des exemples de données à partir d’un fichier CSV](workbench.Modeler.ImportCSV.md)
+ [Facettes](workbench.Modeler.Facets.md)
+ [Affichage de toutes les tables dans un modèle de données à l’aide de la vue d’agrégation](workbench.Modeler.AggregateView.md)
+ [Exportation d’un modèle de données](workbench.Modeler.ExportModel.md)
+ [Validation d’un modèle de données dans DynamoDB](workbench.Modeler.Commit.md)

# Création d’un modèle de données
<a name="workbench.Modeler.CreateNew"></a>

Procédez comme suit pour créer un modèle de données dans Amazon DynamoDB à l’aide de NoSQL Workbench.

**Pour créer un modèle de données**

1.  Ouvrez NoSQL Workbench, puis sur l'écran principal, sélectionnez **Créer un** modèle manuellement. 

    Une nouvelle page s'ouvrira avec une configuration vide pour votre première table. **NoSQL Workbench crée tous les nouveaux modèles de données avec un nom par défaut (c'est-à-dire untitled-2) et les ajoute au dossier du projet Drafts.** 

1.  Sur l'**écran de configuration de la table**, spécifiez les éléments suivants : 
   +  **Table name (Nom de table)** – Saisissez un nom unique pour la table. 
   +  **Clé de partition** : entrez le nom de la clé de partition et spécifiez son type. De même, vous pouvez éventuellement sélectionner un format de type de données plus détaillé pour la génération de données d’exemple. 
   +  Si vous souhaitez ajouter une **clé de tri**, spécifiez le nom de la clé de tri et son type. Vous pouvez éventuellement sélectionner un format de type de données plus détaillé pour la génération de données d’exemple. 
**Note**  
 Pour en savoir plus sur la conception des clés primaires, la conception et l’utilisation efficaces des clés de partition et l’utilisation des clés de tri, consultez les rubriques suivantes :   
 [Clé primaire](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey) 
 [Bonnes pratiques pour la conception et l’utilisation performantes de clés de partition dans DynamoDB](bp-partition-key-design.md) 
 [Bonnes pratiques concernant l’utilisation de clés de tri pour organiser les données dans DynamoDB](bp-sort-keys.md) 

1. Vous pouvez ajouter d'autres attributs pour valider plus clairement votre modèle et vos modèles d'accès. Pour ajouter d'autres attributs :
   +  Choisissez **Ajouter un attribut**. 
   +  Spécifiez le nom de l’attribut et son type. 
   +  Vous pouvez éventuellement sélectionner un format de type de données plus détaillé pour la génération de données d’exemple. 

1.  Si vous souhaitez ajouter un index secondaire global, choisissez **Add global secondary index (Ajouter un index secondaire global)**. Spécifiez le **Global secondary index name (Nom de l’index secondaire global)**, l’attribut **Partition key (Clé de partition)** et le **Projection type (Type de projection)**. 

   Pour plus d’informations sur l’utilisation des index secondaires globaux dans DynamoDB, consultez [Index secondaires globaux](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html).

1.  **Ajoutez éventuellement une facette.** Une facette est une construction virtuelle dans NoSQL Workbench. Il ne s'agit pas d'une construction fonctionnelle dans DynamoDB. Les facettes de NoSQL Workbench vous aident à visualiser les différents modèles d'accès aux données d'une application pour DynamoDB avec uniquement un sous-ensemble des données d'une table. 
**Note**  
 Nous vous recommandons de l'utiliser [Ajouter et valider des modèles d'accès](workbench.Modeler.AccessPatterns.md) pour visualiser la manière dont votre application accèdera aux données dans DynamoDB plutôt que dans Facets. Les modèles d'accès reflètent les interactions réelles de votre base de données et vous aident à créer le modèle de données adapté à votre cas d'utilisation, tandis que les facettes sont des visualisations non fonctionnelles. 

    Choisissez **Add Facet (Ajouter une facette)**. Spécifiez les paramètres suivants : 
   +  Le **nom de la facette**. 
   +  Un **alias de clé de partition** pour mieux distinguer la vue de cette facette. 
   +  Un **alias de clé de tri** si vous avez fourni une **clé de tri** pour la table. 
   +  Choisissez les **attributs** qui font partie de cette facette. 

    Répétez cette étape si vous souhaitez ajouter d’autres facettes. 

1.  Enfin, cliquez sur le bouton **Enregistrer** pour créer le tableau. 

1.  Si vous avez besoin d'autres **tables** ou **index secondaires globaux**, cliquez sur l'**icône\$1** au-dessus de la table que vous venez de créer. 

# Importation d’un modèle de données existant
<a name="workbench.Modeler.ImportExisting"></a>

Vous pouvez utiliser NoSQL Workbench pour Amazon DynamoDB afin de générer un modèle de données en important et en modifiant un modèle existant. Vous pouvez importer des modèles de données au format de modèle NoSQL Workbench ou au [Format de modèle JSON AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html).

**Pour importer un modèle existant**

1.  **Ouvrez NoSQL Workbench, puis sur l'écran principal, sélectionnez Importer le modèle.** Vous pouvez importer un format de modèle NoSQL Workbench ou CloudFormation un modèle JSON. 

1.  Vous pouvez ajouter le modèle importé à un projet existant ou créer un nouveau projet. Si vous ne choisissez pas un autre projet, votre modèle sera ajouté au dossier des brouillons du projet. 

1.  Cliquez sur **Parcourir votre bureau** et choisissez un modèle à importer depuis votre ordinateur. 

# Modification d’un modèle de données existant
<a name="workbench.Modeler.Edit"></a>

**Pour modifier un modèle existant**

1. Pour commencer à apporter des modifications à un modèle existant, ouvrez le modèle dans la page du modeleur.

1. Dans le panneau de sélection des ressources, vous verrez la liste des **tables** et des **index secondaires globaux**.

1. Pour modifier une **table** ou un **index secondaire global**, cliquez d'abord sur son nom dans le panneau de sélection des ressources, puis utilisez les icônes d'action situées en haut. Les actions disponibles sont **Supprimer**, **Dupliquer** et **Modifier**.

1. Si vous souhaitez modifier les **détails du modèle**, cliquez sur l'icône à trois points à côté du nom du modèle.

1. À partir de là, vous pouvez cliquer sur **Modifier les détails du modèle** et modifier les informations en conséquence.

1. Vous pouvez également **dupliquer**, **déplacer**, **supprimer** et **exporter** le modèle à partir du même menu.

1. Pour passer à un autre modèle, vous pouvez soit passer à nouveau par l'écran principal, soit utiliser le menu déroulant de sélection du modèle. 

# Ajout d’un exemple de données à un modèle de données
<a name="workbench.Modeler.AddData"></a>

**Pour générer automatiquement des échantillons de données**

1. Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle auquel vous souhaitez ajouter des exemples de données.

1. Cliquez sur les actions supplémentaires (icône à trois points) dans la barre d'outils de contenu principale et sélectionnez **Ajouter des exemples de données**.

1. Entrez le nombre d'échantillons de données que vous souhaitez générer, puis sélectionnez **Confirmer**.

1. La génération automatique d'échantillons de données vous permet de générer entre 1 et 5 000 lignes de données pour une utilisation immédiate. Vous pouvez spécifier un type de données d’exemple détaillé pour créer des données réalistes en fonction de vos besoins de conception et de test. Pour pouvoir générer des données réalistes, vous devez spécifier le format du type de données d’exemple pour vos attributs dans le modélisateur de données. Voir [Création d’un modèle de données](workbench.Modeler.CreateNew.md) pour spécifier des exemples de formats de type de données.

**Pour ajouter des exemples de données, un élément à la fois**

1. Ouvrez le modèle que vous souhaitez modifier, puis choisissez la table à laquelle vous souhaitez ajouter des exemples de données. Cliquez sur les actions supplémentaires (icône à trois points) dans la barre d'outils de contenu principale et sélectionnez **Modifier les données**.

1. Vous pouvez désormais ajouter, supprimer et modifier des lignes. Après avoir apporté les modifications nécessaires, cliquez sur le bouton **Enregistrer**.

# Ajouter et valider des modèles d'accès
<a name="workbench.Modeler.AccessPatterns"></a>

*Vous pouvez utiliser NoSQL Workbench pour Amazon DynamoDB pour créer, stocker et valider des modèles d'accès.*

**Note**  
 Voir [Identifier vos modèles d'accès aux données](https://docs.aws.amazon.com/prescriptive-guidance/latest/dynamodb-data-modeling/step3.html) pour plus de détails sur l'identification des bons modèles d'accès. 

**Pour créer un modèle d'accès**

1.  Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle auquel vous souhaitez ajouter des modèles d'accès. 

1.  Sur le côté gauche, choisissez l'onglet **Modèles d'accès**, puis cliquez sur l'icône **\$1**. 

1.  Sur l'écran suivant, indiquez un **nom**, une **description** facultative, le **type** du modèle d'accès et la **table** ou l'**index secondaire global** par rapport auxquels tester le modèle d'accès. 
**Note**  
 NoSQL Workbench prend actuellement en charge les opérations suivantes pour les modèles d'accès :`Scan`,,, `Query``GetItem`,`PutItem`. `UpdateItem` `DeleteItem` Amazon DynamoDB prend en charge une liste plus étendue d'opérations. 

1.  Après avoir créé un modèle d'accès, vous pouvez passer à l'onglet **Valider** pour vérifier que votre modèle de données est conçu pour renvoyer les résultats attendus pour le modèle d'accès. Consultez [Ajout d’un exemple de données à un modèle de données](workbench.Modeler.AddData.md) pour plus de détails sur la façon de générer automatiquement des exemples de données pour vos tables. Différents types de modèles d'accès prendront en charge différents paramètres d'entrée. 
**Note**  
Pour valider les modèles d'accès, NoSQL Workbench démarre une base de données locale DynamoDB distincte sur le port `8001` (par défaut) avec des tables et des index stockés en mémoire.  
NoSQL Workbench ajoute automatiquement les exemples de données de votre modèle aux tables temporaires.
Si vous modifiez les exemples de données ou le modèle de données lui-même, NoSQL Workbench met à jour les tables temporaires.
Cette base de données temporaire est effacée lorsque vous fermez l'application.

**Pour modifier vos modèles d'accès**

1.  Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle pour lequel vous souhaitez modifier les modèles d'accès. 

1.  Sur le côté gauche, choisissez l'onglet **Modèles d'accès**. 

1. Pour modifier un modèle d'accès, sélectionnez-le dans la liste de gauche.

1. Dans la barre supérieure, cliquez sur le bouton d'action **Modifier**.

# Importation des exemples de données à partir d’un fichier CSV
<a name="workbench.Modeler.ImportCSV"></a>

Si vous avez des exemples de données préexistants dans un fichier CSV, vous pouvez les importer dans NoSQL Workbench. Cela vous permet de remplir rapidement votre modèle avec des exemples de données sans avoir à les saisir ligne par ligne.

Les noms de colonnes du fichier CSV doivent correspondre aux noms d’attributs de votre modèle de données. Ils ne doivent pas nécessairement être dans le même ordre. Par exemple, si votre modèle de données comporte des attributs appelés `LoginAlias`, `FirstName` et `LastName`, vos colonnes CSV peuvent être `LastName`, `FirstName` et `LoginAlias`.

Vous pouvez importer jusqu'à 150 lignes à la fois à partir d'un fichier CSV.

**Pour importer des données à partir d’un fichier CSV dans NoSQL Workbench**

1. Pour importer des données CSV dans un **tableau**, cliquez d'abord sur le nom du tableau dans le panneau des ressources, puis sur les actions supplémentaires (icône à trois points) dans la barre d'outils de contenu principale.

1. Sélectionnez **Importer des échantillons de données**.

1. Sélectionnez le fichier CVS, puis choisissez **Ouvrir**. Les données CSV sont ajoutées à votre tableau.

# Facettes
<a name="workbench.Modeler.Facets"></a>

 Dans NoSQL Workbench, les *facettes* vous permettent de visualiser un sous-ensemble des données d'une table, sans avoir à consulter les enregistrements qui ne répondent pas aux contraintes de la facette. Les facettes sont considérées comme un outil de modélisation de données visuelles et n’existent pas en tant que construction utilisable dans DynamoDB, car elles sont purement une aide à la modélisation des modèles d’accès. 

**Note**  
 Nous vous recommandons de l'utiliser [Ajouter et valider des modèles d'accès](workbench.Modeler.AccessPatterns.md) pour visualiser la manière dont votre application accèdera aux données dans DynamoDB plutôt que dans Facets. Les modèles d'accès reflètent les interactions réelles de votre base de données et vous aident à créer le modèle de données adapté à votre cas d'utilisation, tandis que les facettes sont des visualisations non fonctionnelles. 

**Pour créer une facette**

1. Dans le panneau de sélection des ressources, choisissez le **tableau** que vous souhaitez modifier

1. Dans la barre supérieure, cliquez sur l'icône **Modifier** l'action.

1. Faites défiler la page jusqu'à la section **Filtres à facettes**.

1.  Choisissez **Add Facet (Ajouter une facette)**. Spécifiez les paramètres suivants : 
   +  Le **nom de la facette**. 
   +  Un **alias de clé de partition** pour mieux distinguer la vue de cette facette. 
   +  Un **alias de clé de tri** si vous avez fourni une **clé de tri** pour la table. 
   +  Choisissez les **attributs** qui font partie de cette facette. 

    Répétez cette étape si vous souhaitez ajouter d’autres facettes. 

# Affichage de toutes les tables dans un modèle de données à l’aide de la vue d’agrégation
<a name="workbench.Modeler.AggregateView"></a>

La vue agrégée de NoSQL Workbench pour Amazon DynamoDB vous permet de visualiser toutes les tables et tous les index d'un modèle de données. Pour chaque table, les informations suivantes s’affichent :
+ Nom des colonnes de la table
+ Exemples de données
+ Tous les index secondaires globaux associés à la table. NoSQL Workbench affiche les informations suivantes pour chaque index :
  + Noms des colonnes de l’index
  + Exemples de données

**Pour afficher les informations de toutes les tables**

1. Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle que vous souhaitez ouvrir.

1. Dans la barre supérieure, cliquez sur **Vue agrégée**. Vous verrez les données de toutes les tables et de tous les index sur le même écran.

**Pour exporter une vue agrégée sous forme d'images**

1. Lorsque la **vue agrégée** est sélectionnée, cliquez sur l'icône à trois points et choisissez **Exporter la vue agrégée**

1. Une archive contenant des images PNG de toutes les tables et de tous les index sera présentée en téléchargement.

# Exportation d’un modèle de données
<a name="workbench.Modeler.ExportModel"></a>

Après avoir créé un modèle de données à l’aide de NoSQL Workbench pour Amazon DynamoDB, vous pouvez enregistrer et exporter le modèle au format de modèle NoSQL Workbench ou au [Format de fichier JSON AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html).

**Pour exporter un modèle de données**

1. Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle que vous souhaitez modifier.

1. Cliquez sur l'icône à trois points à côté du nom du modèle de données et sélectionnez **Exporter le modèle**.

1.  Choisissez d'exporter votre modèle de données au format de modèle NoSQL Workbench ou au format de modèle CloudFormation JSON. 
   +  Choisissez le format de modèle **NoSQL Workbench si vous souhaitez partager votre modèle** avec d'autres membres de l'équipe à l'aide de NoSQL Workbench ou l'importer ultérieurement dans NoSQL Workbench. 
   +  Choisissez le format de **modèle CloudFormation JSON** si vous souhaitez déployer votre modèle directement dans votre infrastructure-as-code flux de travail AWS ou l'intégrer à celui-ci. 

# Validation d’un modèle de données dans DynamoDB
<a name="workbench.Modeler.Commit"></a>

 Lorsque vous êtes satisfait de votre modèle de données, vous pouvez valider le modèle dans Amazon DynamoDB. 

**Note**  
Cette action crée des ressources côté serveur AWS pour les tables et les index secondaires globaux représentés dans le modèle de données.
NoSQL Workbench crée des tables et des index dotés d'une capacité à la demande par défaut.

**Pour valider le modèle de données dans DynamoDB**

1. Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle que vous souhaitez valider.

1. Dans la barre supérieure, cliquez sur **Valider**.

1. Choisissez une connexion existante ou créez-en une nouvelle en cliquant sur le bouton **Ajouter une nouvelle connexion**.
   + Pour ajouter une nouvelle connexion, spécifiez les informations suivantes.
     + **Alias du compte**
     + **AWS Région**
     + **ID de clé d’accès**
     + **Clé d’accès secrète**

     Pour plus d'informations sur l'obtention des clés d'accès, voir [Obtenir une clé d' AWS accès](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html#SettingUp.DynamoWebService.GetCredentials).
   + Le cas échéant, vous pouvez spécifier les options suivantes :
     + [Le **jeton de session**](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)
     + [L’**ARN du rôle IAM**](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns)

1. Si vous préférez utiliser [DynamoDB local](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html) :

   1. Choisissez l'onglet **Connexion locale**.

   1. Cliquez sur le bouton **Ajouter une nouvelle connexion**.

   1. Spécifiez le **Nom de la connexion** et le **Port**.
**Note**  
 Pour utiliser DynamoDB local, vous devez l'activer en utilisant le bouton **DynamoDB** local en bas à gauche de l'écran NoSQL Workbench. 

1. Cliquez sur **Valider**.