Création de requêtes de base (VTL)

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

1. Dans le APIstableau de bord, choisissez votre GraphQLAPI.

2. Dans la barre latérale, choisissez Schema.

Sur le côté droit de la page, il y a une fenêtre appelée Resolvers. Cette zone contient une liste des types et des champs tels que définis dans votre fenêtre de schéma sur le côté gauche de la page. Vous pouvez associer des résolveurs aux champs. Par exemple, sous le type de requête, choisissez Joindre à côté du getTodos champ.

Sur la page Create Resolver, choisissez la source de données que vous avez créée dans le guide Joindre une source de données. Dans la fenêtre Configurer les modèles de mappage, vous pouvez choisir à la fois les modèles de mappage de demande et de réponse génériques à l'aide de la liste déroulante de droite ou écrire le vôtre.

Pour les cas d'utilisation courants, la AWS AppSync console possède des modèles intégrés que vous pouvez utiliser pour obtenir des éléments à partir de sources de données (par exemple, toutes les requêtes relatives aux articles, les recherches individuelles, etc.). Par exemple, dans la version simple du schéma de Designing your schema where getTodos didn't have pagination, le modèle de mappage des demandes pour la liste des éléments est le suivant :

{
    "version" : "2017-02-28",
    "operation" : "Scan"
}

Vous avez toujours besoin d'un modèle de mappage des réponses pour accompagner la demande. La console fournit un modèle par défaut avec la valeur de transmission suivante pour les listes :

$util.toJson($ctx.result.items)

Dans cet exemple, l'objet context (dont l'alias est $ctx) pour les listes d'éléments se présente sous la forme $context.result.items. Si votre opération GraphQL renvoie un seul élément, ce sera le cas. $context.result AWS AppSync fournit des fonctions d'assistance pour les opérations courantes, telles que la $util.toJson fonction répertoriée précédemment, afin de formater correctement les réponses. Pour une liste complète des fonctions, consultez la référence de l'utilitaire de modèle de mappage Resolver.

Choisissez Save Resolver.

Créez un objet résolveur en appelant le CreateResolverAPI.

Vous pouvez modifier les champs de votre résolveur en appelant le UpdateResolverAPI.

Créez un résolveur en exécutant la create-resolvercommande.

Vous devez saisir 6 paramètres pour cette commande particulière :

Voici un exemple de commande :

aws appsync create-resolver --api-id abcdefghijklmnopqrstuvwxyz --type-name Query --field-name getTodos --data-source-name TodoTable --request-mapping-template "{ "version" : "2017-02-28", "operation" : "Scan", }" --response-mapping-template ""$"util.toJson("$"ctx.result.items)"

Une sortie sera renvoyée dans leCLI. Voici un exemple :

{
    "resolver": {
        "kind": "UNIT",
        "dataSourceName": "TodoTable",
        "requestMappingTemplate": "{ version : 2017-02-28, operation : Scan, }",
        "resolverArn": "arn:aws:appsync:us-west-2:107289374856:apis/abcdefghijklmnopqrstuvwxyz/types/Query/resolvers/getTodos",
        "typeName": "Query",
        "fieldName": "getTodos",
        "responseMappingTemplate": "$util.toJson($ctx.result.items)"
    }
}

Pour modifier les champs et/ou les modèles de mappage d'un résolveur, exécutez la update-resolvercommande.

À l'exception du api-id paramètre, les paramètres utilisés dans la create-resolver commande seront remplacés par les nouvelles valeurs de la update-resolver commande.

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

1. Dans le APIstableau de bord, choisissez votre GraphQLAPI.

2. Dans la barre latérale, choisissez Schema.

Sous le type de mutation, choisissez Attacher à côté du addTodo champ.

Sur la page Create Resolver, choisissez la source de données que vous avez créée dans le guide Joindre une source de données.

Dans la fenêtre Configurer les modèles de mappage, vous devez modifier le modèle de demande car il s'agit d'une mutation dans laquelle vous ajoutez un nouvel élément à DynamoDB. Utilisez le modèle de mappage de demande suivant :

{
    "version" : "2017-02-28",
    "operation" : "PutItem",
    "key" : {
        "id" : $util.dynamodb.toDynamoDBJson($ctx.args.id)
    },
    "attributeValues" : $util.dynamodb.toMapValuesJson($ctx.args)
}

AWS AppSync convertit automatiquement les arguments définis dans le addTodo champ à partir de votre schéma GraphQL en opérations DynamoDB. L'exemple précédent stocke les enregistrements dans DynamoDB à l'aide d'une clé id de, qui est transmise par l'argument de mutation sous la forme. $ctx.args.id Tous les autres champs que vous traversez sont automatiquement mappés aux attributs DynamoDB avec. $util.dynamodb.toMapValuesJson($ctx.args)

Pour ce résolveur, utilisez ensuite le modèle de mappage de réponse suivant :

$util.toJson($ctx.result)

AWS AppSync prend également en charge les flux de travail de test et de débogage pour l'édition de résolveurs. Vous pouvez utiliser un objet context simulé pour afficher la valeur transformée du modèle avant l'appel. Le cas échéant, vous pouvez afficher l'intégralité de l'exécution de la requête sur une source de données de façon interactive lorsque vous exécutez une requête. Pour plus d'informations, consultez les sections Tester et déboguer les résolveurs et Surveillance et journalisation.

Choisissez Save Resolver.

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

1. Dans le APIstableau de bord, choisissez votre GraphQLAPI.

2. Dans la barre latérale, choisissez Schema.

Sous le type Todo, choisissez Joindre à côté du comments champ.

Sur la page Créer un résolveur, choisissez la source de données de votre table de commentaires. Le nom par défaut du tableau des commentaires dans les guides de démarrage rapide estAppSyncCommentTable, mais il peut varier en fonction du nom que vous lui avez donné.

Ajoutez l'extrait suivant à votre modèle de mappage de demandes :

{
    "version": "2017-02-28",
    "operation": "Query",
    "index": "todoid-index",
    "query": {
        "expression": "todoid = :todoid",
        "expressionValues": {
            ":todoid": {
                "S": $util.toJson($context.source.id)
            }
        }
    }
}

Le context.source fait référence à l'objet parent du champ actif en cours de résolution. Dans cet exemple, source.id fait référence à l'objet Todo individuel, qui est ensuite utilisé pour l'expression de la requête.

Vous pouvez utiliser le modèle de mappage de réponse de transmission, comme suit :

$util.toJson($ctx.result.items)

Choisissez Save Resolver.

Enfin, revenez sur la page Schéma de la console, attachez un résolveur au addComment champ et spécifiez la source de données de la Comments table. Dans ce cas, le modèle de mappage de requête est un simple PutItem avec le todoid spécifique qui est commenté en tant qu'argument, mais vous utilisez l'utilitaire $utils.autoId() pour créer une clé de tri unique pour le commentaire de la façon suivante :

{
    "version": "2017-02-28",
    "operation": "PutItem",
    "key": {
        "todoid": { "S": $util.toJson($context.arguments.todoid) },
        "commentid": { "S": "$util.autoId()" }
    },
    "attributeValues" : $util.dynamodb.toMapValuesJson($ctx.args)
}

Utilisez un modèle de réponse de transmission comme suit :

$util.toJson($ctx.result)