Lancement d'un schéma dans la AWS AppSync console - AWS AppSync

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.

Lancement d'un schéma dans la AWS AppSync console

Dans cet exemple, vous allez créer un Todo API qui permet aux utilisateurs de créer des Todo éléments pour les rappels de corvées quotidiennes, tels que Finish task or Pick up groceries. Cela API montrera comment utiliser les opérations GraphQL lorsque l'état persiste dans une table DynamoDB.

Conceptuellement, la création de votre premier GraphQL API comporte trois étapes principales. Vous devez définir le schéma (types et champs), associer vos sources de données à vos champs, puis écrire le résolveur qui gère la logique métier. Toutefois, l'expérience de la console modifie l'ordre des choses. Nous allons commencer par définir la manière dont nous voulons que notre source de données interagisse avec notre schéma, puis définirons le schéma et le résolveur ultérieurement.

Pour créer votre GraphQL API

  1. Connectez-vous à la AppSync console AWS Management Console et ouvrez-la.

  2. Dans le tableau de bord, choisissez Create API.

  3. Lorsque GraphQL APIs est sélectionné, choisissez Design from scratch. Ensuite, choisissez Suivant.

  4. Pour APIle nom, remplacez le nom prérempli parTodo API, puis choisissez Next.

    Note

    D'autres options sont également présentes ici, mais nous ne les utiliserons pas dans cet exemple.

  5. Dans la section Spécifier les ressources GraphQL, procédez comme suit :

    1. Choisissez maintenant Créer un type basé sur une table DynamoDB.

      Note

      Cela signifie que nous allons créer une nouvelle table DynamoDB à joindre en tant que source de données.

    2. Dans le champ Nom du modèle, entrezTodo.

      Note

      Notre première exigence est de définir notre schéma. Ce nom de modèle sera le nom du type, donc ce que vous faites réellement est de créer un type appel Todo qui existera dans le schéma :

      type Todo {}

    3. Sous Champs, procédez comme suit :

      1. Créez un champ nomméid, avec le type et ID le champ requis définis surYes.

        Note

        Ce sont les champs qui existeront dans le cadre de votre Todo type. Le nom de votre champ ici sera appelé id avec un type de ID! :

        type Todo {
	id: ID!
}

        AWS AppSync prend en charge plusieurs valeurs scalaires pour différents cas d'utilisation.

      2. À l'aide de l'option Ajouter un nouveau champ, créez quatre champs supplémentaires avec les Name valeurs définies sur name whenwhere,, etdescription. Leurs Type valeurs serontString, et les Required valeurs Array et seront toutes deux définies surNo. Il doit ressembler à ce qui suit :

        Model information form showing fields for a Todo model with ID, name, when, where, and description.
        Note

        Le type complet et ses champs ressembleront à ceci :

        type Todo {
	id: ID!
	name: String
	when: String
	where: String
	description: String
}

        Comme nous créons un schéma à l'aide de ce modèle prédéfini, il sera également rempli de plusieurs mutations standard basées sur le typecreate, telles quedelete, et update pour vous aider à remplir facilement votre source de données.

    4. Sous Configurer la table du modèle, entrez un nom de table, tel queTodoAPITable. Définissez la clé primaire surid.

      Note

      Nous créons essentiellement une nouvelle table DynamoDB appelée TodoAPITable qui sera rattachée au en API tant que source de données principale. Notre clé primaire est définie sur le id champ obligatoire que nous avons défini auparavant. Notez que cette nouvelle table est vide et ne contient rien d'autre que la clé de partition.

    5. Choisissez Suivant.

  6. Passez en revue vos modifications et choisissez Créer API. Attendez un moment pour que le AWS AppSync service finisse de créer votreAPI.

Vous avez créé avec succès un GraphQL API avec son schéma et sa source de données DynamoDB. Pour résumer les étapes ci-dessus, nous avons choisi de créer un tout nouveau GraphQLAPI. Nous avons défini le nom duAPI, puis ajouté notre définition de schéma en ajoutant notre premier type. Nous avons défini le type et ses champs, puis choisi d'associer une source de données à l'un des champs en créant une nouvelle table DynamoDB ne contenant aucune donnée.