Creazione di interrogazioni di base () VTL

Accedi a AWS Management Console e apri la AppSync console.

1. Nella APIsdashboard, scegli il tuo GraphQLAPI.

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. È possibile allegare resolver ai campi. Ad esempio, nella sezione 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 modelli di mappatura, puoi scegliere sia il modello generico di mappatura di richiesta che quello di risposta 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 è possibile utilizzare per recuperare elementi dalle fonti di dati (ad esempio, le query su tutti gli elementi, le ricerche individuali, ecc.). Ad esempio, nella versione semplice dello schema di Designing your schema in cui getTodos non c'era l'impaginazione, il modello di mappatura delle richieste per elencare gli articoli è il seguente:

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

È sempre necessario un modello di mappatura delle risposte da allegare alla 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, lo sarebbe. $context.result AWS AppSync fornisce funzioni di supporto per operazioni comuni, come la $util.toJson funzione elencata in precedenza, per formattare correttamente le risposte. Per un elenco completo delle funzioni, vedere il riferimento all'utilità del modello di mappatura Resolver.

Scegli Save Resolver.

Crea un oggetto resolver chiamando il. CreateResolverAPI

Puoi modificare i campi del tuo resolver chiamando il. UpdateResolverAPI

Crea un resolver eseguendo il comando. create-resolver

Dovrai digitare 6 parametri per questo particolare comando:

Un comando di esempio può essere simile al seguente:

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

Un output verrà restituito inCLI. 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 campi e/o i modelli di mappatura 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 a AWS Management Console e apri la AppSync console.

1. Nella APIsdashboard, scegli il tuo GraphQLAPI.

2. Nella barra laterale, scegli Schema.

Nella sezione Tipo di mutazione, scegli Allega accanto al addTodo campo.

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

Nella finestra Configura modelli di mappatura, è necessario modificare il modello di richiesta perché si tratta di una mutazione in cui si aggiunge 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 archivia i record in DynamoDB utilizzando una chiave id of, che viene passata dall'argomento di mutazione as. $ctx.args.id Tutti gli altri campi che passi attraverso vengono mappati automaticamente 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 e debug resolvers e Monitoraggio e registrazione.

Scegli Save Resolver.

Accedi a AWS Management Console e apri la AppSync console.

1. Nella APIsdashboard, scegli il tuo GraphQLAPI.

2. Nella barra laterale, scegli Schema.

Nel tipo Todo, scegli Allega accanto al comments campo.

Nella pagina Create Resolver, scegli l'origine dati della tabella Commenti. Il nome predefinito per la tabella Commenti delle guide di avvio rapido èAppSyncCommentTable, ma può variare a seconda del nome 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 Save 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)