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.
Avant d'ajouter des données à notre table DynamoDB, nous devons passer en revue les fonctionnalités de base de l'expérience de AWS AppSync console. L'onglet AWS AppSync console situé sur le côté gauche de la page permet aux utilisateurs de naviguer facilement vers l'un des principaux composants ou options de configuration qui AWS AppSync fournissent :

Concepteur de schémas
Choisissez Schéma pour afficher le schéma que vous venez de créer. Si vous examinez le contenu du schéma, vous remarquerez qu'il a déjà été chargé avec de nombreuses opérations d'assistance afin de rationaliser le processus de développement. Dans l'éditeur de schéma, si vous parcourez le code, vous finirez par atteindre le modèle que vous avez défini dans la section précédente :
type Todo {
id: ID!
name: String
when: String
where: String
description: String
}
Votre modèle est devenu le type de base utilisé dans l'ensemble de votre schéma. Nous allons commencer à ajouter des données à notre source de données à l'aide de mutations générées automatiquement à partir de ce type.
Voici quelques conseils et informations supplémentaires concernant l'éditeur de schéma :
-
L'éditeur de code possède des fonctionnalités de linting et de vérification des erreurs que vous pouvez utiliser lorsque vous écrivez vos propres applications.
-
Le côté droit de la console affiche les types GraphQL qui ont été créés, ainsi que des résolveurs sur différents types de niveau supérieur, comme les requêtes.
-
Lorsque vous ajoutez de nouveaux types à un schéma (par exemple,
type User {...}
), vous pouvez configurer des AWS AppSync ressources DynamoDB pour vous. Celles-ci incluent la clé primaire, la clé de tri et la conception d'index appropriées pour correspondre au mieux à votre modèle d'accès aux données GraphQL. Si vous choisissez Créer des ressources en haut, puis l'un des types définis par l'utilisateur dans le menu, vous pouvez choisir différentes options de champ dans la conception de schéma. Nous aborderons cela dans la section Conception d'un schéma.
Configuration du résolveur
Dans le concepteur de schéma, la section Résolveurs contient tous les types et champs de votre schéma. Si vous parcourez la liste des champs, vous remarquerez que vous pouvez associer des résolveurs à certains champs en choisissant Joindre. Cela ouvrira un éditeur de code dans lequel vous pourrez écrire votre code de résolution. AWS AppSync prend en charge à la JavaScript fois la VTL et les environnements d'exécution, qui peuvent être modifiés en haut de la page en choisissant Actions, puis Update Runtime. Au bas de la page, vous pouvez également créer des fonctions qui exécuteront plusieurs opérations en séquence. Cependant, les résolveurs sont un sujet avancé, et nous ne l'aborderons pas dans cette section.
Sources de données
Choisissez Sources de données pour afficher votre table DynamoDB. En choisissant l'Resource
option (si disponible), vous pouvez consulter la configuration de votre source de données. Dans notre exemple, cela mène à la console DynamoDB. À partir de là, vous pouvez modifier vos données. Vous pouvez également modifier directement certaines données en choisissant la source de données, puis en choisissant Modifier. Si vous devez supprimer votre source de données, vous pouvez choisir celle-ci, puis sélectionner Supprimer. Enfin, vous pouvez créer de nouvelles sources de données en choisissant Créer une source de données, puis en configurant le nom et le type. Notez que cette option permet de lier le AWS AppSync service à une ressource existante. Vous devez tout de même créer la ressource dans votre compte à l'aide du service approprié avant de la AWS AppSync reconnaître.
Requêtes
Choisissez Requêtes pour afficher vos requêtes et mutations. Lorsque nous avons créé notre API GraphQL à l'aide de notre modèle, nous avons généré AWS AppSync automatiquement des mutations et des requêtes auxiliaires à des fins de test. Dans l'éditeur de requêtes, le côté gauche contient l'explorateur. Il s'agit d'une liste répertoriant toutes vos mutations et requêtes. Vous pouvez facilement activer les opérations et les champs que vous souhaitez utiliser ici en cliquant sur leurs valeurs nominales. Cela fera apparaître automatiquement le code dans la partie centrale de l'éditeur. Ici, vous pouvez modifier vos mutations et requêtes en modifiant les valeurs. Au bas de l'éditeur, vous trouverez l'éditeur de variables de requête qui vous permet de saisir les valeurs de champ pour les variables d'entrée de vos opérations. En choisissant Exécuter en haut de l'éditeur, une liste déroulante s'affichera pour sélectionner la requête/mutation à exécuter. Le résultat de cette exécution apparaîtra sur le côté droit de la page. De retour dans la section Explorateur en haut, vous pouvez choisir une opération (requête, mutation, abonnement), puis choisir le symbole + pour ajouter une nouvelle instance de cette opération particulière. En haut de la page, vous trouverez une autre liste déroulante contenant le mode d'autorisation pour les exécutions de vos requêtes. Toutefois, nous n'aborderons pas cette fonctionnalité dans cette section (pour plus d'informations, voir Sécurité).
Paramètres
Choisissez Paramètres pour afficher certaines options de configuration pour votre API GraphQL. Ici, vous pouvez activer certaines options telles que la journalisation, le suivi et les fonctionnalités de pare-feu des applications Web. Vous pouvez également ajouter de nouveaux modes d'autorisation pour protéger vos données contre les fuites indésirables au public. Toutefois, ces options sont plus avancées et ne seront pas abordées dans cette section.
Note
Le mode d'autorisation par défaut utilise une clé d'API pour tester l'application. API_KEY
Il s'agit de l'autorisation de base accordée à tous les APIs GraphQL nouvellement créés. Nous vous recommandons d'utiliser une autre méthode de production. Pour les besoins de l'exemple présenté dans cette section, nous n'utiliserons que la clé API. Pour plus d'informations sur les méthodes d'autorisation prises en charge, consultez la section Sécurité.