Creazione di domande di base (VTL)

Accedi Console di gestione AWS e apri la AppSync console.

1. Nella dashboard delle API, scegli la tua API GraphQL.

2. Nella barra laterale, scegli Schema.

Sul lato destro della pagina, c'è una finestra chiamata Resolvers. Questa casella contiene un elenco dei tipi e dei campi definiti nella finestra Schema sul lato sinistro della pagina. Puoi allegare risolutori ai campi. Ad esempio, nel tipo di query, scegli Allega accanto al campo. getTodos

Nella pagina Create Resolver, scegli l'origine dati che hai creato nella guida Allegare una fonte di dati. Nella finestra Configura i modelli di mappatura, puoi scegliere sia i modelli generici di mappatura delle richieste che quelli delle risposte utilizzando l'elenco a discesa a destra o scriverne uno personalizzato.

Per i casi d'uso più comuni, la AWS AppSync console dispone di modelli integrati che puoi utilizzare per ottenere elementi da origini dati (ad esempio, tutte le query sugli elementi, ricerche individuali, ecc.). Ad esempio, nella versione semplice dello schema di Designing your schema where getTodos didn't have pagination, il modello di mappatura delle richieste per elencare gli elementi è il seguente:

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

È sempre necessario un modello di mappatura delle risposte per accompagnare la richiesta. La console ne fornisce uno predefinito con il valore di passthrough seguente per elenchi:

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

In questo esempio, l'oggetto context (con alias $ctx) per gli elenchi di elementi presenta la forma $context.result.items. Se l'operazione GraphQL restituisce un singolo elemento, sarebbe $context.result. AWS AppSync fornisce funzioni di helper per operazioni comuni, ad esempio la funzione $util.toJson elencata in precedenza, per formattare le risposte correttamente. Per un elenco completo delle funzioni, consulta Resolver Mapping Template Utility Reference.

Scegli Salva Resolver.

Crea un oggetto resolver chiamando l'API. CreateResolver

Puoi modificare i campi del tuo resolver chiamando l'API. UpdateResolver

Crea un resolver eseguendo il comando. create-resolver

Dovrai digitare 6 parametri per questo particolare comando:

Un comando di esempio può essere simile a questo:

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)"

Verrà restituito un output nella CLI. Ecco un esempio:

{
    "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)"
    }
}

Per modificare i modelli di and/or mappatura dei campi di un resolver, esegui il comando. update-resolver

Ad eccezione del api-id parametro, i parametri utilizzati nel create-resolver comando verranno sovrascritti dai nuovi valori del comando. update-resolver

Accedi Console di gestione AWS e apri la AppSync console.

1. Nella dashboard delle API, scegli la tua API GraphQL.

2. Nella barra laterale, scegli Schema.

Sotto il tipo di mutazione, scegli Allega accanto al campo. addTodo

Nella pagina Create Resolver, scegli l'origine dati che hai creato nella guida Allegare una fonte di dati.

Nella finestra Configura i modelli di mappatura, dovrai modificare il modello di richiesta perché si tratta di una mutazione in cui aggiungi un nuovo elemento a DynamoDB. Usa modello di mappatura della richiesta seguente:

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

AWS AppSync converte automaticamente gli argomenti definiti nel addTodo campo dallo schema GraphQL in operazioni DynamoDB. L'esempio precedente memorizza i record in DynamoDB utilizzando una chiave diid, che viene trasmessa dall'argomento di mutazione as. $ctx.args.id Tutti gli altri campi che passi vengono automaticamente mappati agli attributi DynamoDB con. $util.dynamodb.toMapValuesJson($ctx.args)

Per questo resolver, usare il seguente modello di mappatura della risposta:

$util.toJson($ctx.result)

AWS AppSync supporta anche flussi di lavoro di test e debug per la modifica dei resolver. È possibile utilizzare un oggetto context fittizio per visualizzare il valore trasformato del modello prima di effettuare la chiamata. Eventualmente, è possibile visualizzare l'esecuzione di richiesta completa a un'origine dati in modo interattivo quando si esegue una query. Per ulteriori informazioni, consulta Test and debug resolver e Monitoraggio e registrazione. Monitoring and Logging

Scegli Salva Resolver.

Accedi Console di gestione AWS e apri la AppSync console.

1. Nella dashboard delle API, scegli la tua API GraphQL.

2. Nella barra laterale, scegli Schema.

Sotto il tipo Todo, scegli Allega accanto al campo. comments

Nella pagina Create Resolver, scegli l'origine dati della tabella Commenti. Il nome predefinito per la tabella Commenti nelle guide di avvio rapido èAppSyncCommentTable, ma può variare a seconda del nome che le hai assegnato.

Aggiungi il seguente frammento al modello di mappatura della richiesta:

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

context.source fa riferimento all'oggetto padre del campo corrente che viene risolto. In questo esempio, source.id si riferisce al singolo oggetto Todo, che viene quindi utilizzato per l'espressione di query.

Puoi usare il modello di mappatura della risposta passthrough come segue:

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

Scegli Salva Resolver.

Infine, torna alla pagina Schema della console, collega un resolver al addComment campo e specifica l'origine dati per la tabella. Comments Il modello di mappatura della richiesta in questo caso è un semplice oggetto PutItem con il todoid specifico commentato su un argomento, ma puoi utilizzare l'utilità $utils.autoId() per creare una chiave di ordinamento per il commento, come segue:

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

Usa un modello di risposta passthrough come segue:

$util.toJson($ctx.result)