Avvio di uno schema nella console AWS AppSync

In questo esempio, creerai uno Todo API che consente agli utenti di creare Todo articoli per promemoria delle faccende quotidiane come Finish task oppure Pick up groceries. Questo API dimostrerà come utilizzare le operazioni GraphQL in cui lo stato persiste in una tabella DynamoDB.

Concettualmente, ci sono tre passaggi principali per creare il tuo primo GraphQL. API È necessario definire lo schema (tipi e campi), collegare le fonti di dati ai campi, quindi scrivere il resolver che gestisca la logica aziendale. Tuttavia, l'esperienza della console cambia l'ordine. Inizieremo definendo come vogliamo che la nostra fonte di dati interagisca con il nostro schema, quindi definiremo lo schema e il resolver in un secondo momento.

Per creare il tuo GraphQL API

1. Accedi a AWS Management Console e apri la AppSync console.

2. Nella dashboard, scegli Crea API.

3. Mentre GraphQL APIs è selezionato, scegli Design da zero. Quindi, seleziona Next (Successivo).

4. Per APInome, modifica il nome precompilato inTodo API, quindi scegli Avanti.

   Nota

   Qui sono presenti anche altre opzioni, ma non le useremo per questo esempio.

5. Nella sezione Specificare le risorse GraphQL, procedi come segue:

   1. Scegli ora Crea tipo supportato da una tabella DynamoDB.

      Nota

      Ciò significa che creeremo una nuova tabella DynamoDB da allegare come origine dati.

   2. Nel campo Nome modello, immettere. Todo

      Nota

      Il nostro primo requisito è definire il nostro schema. Questo nome del modello sarà il nome del tipo, quindi quello che stai realmente facendo è creare una type chiamata Todo che esisterà nello schema:

      type Todo {}

   3. In Campi, procedi come segue:

      1. Create un campo denominatoid, con il tipo ID e il campo obbligatorio impostato suYes.

         Nota

         Questi sono i campi che esisteranno nell'ambito del tuo Todo tipo. Il nome del tuo campo qui verrà chiamato id con un tipo diID!:

         type Todo {
         	id: ID!
         }

         AWS AppSync supporta più valori scalari per diversi casi d'uso.

      2. Utilizzando Aggiungi nuovo campo, crea quattro campi aggiuntivi con i Name valori impostati suname, whenwhere, edescription. TypeI loro valori sarannoString, e i Required valori Array and saranno entrambi impostati suNo. Corrisponderà a quanto segue:

         

         Nota

         Il tipo completo e i relativi campi avranno il seguente aspetto:

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

         Poiché stiamo creando uno schema utilizzando questo modello predefinito, verrà inoltre popolato con diverse mutazioni standard basate sul tipo, ad esempio createdelete, e update per aiutarti a popolare facilmente la tua fonte di dati.

   4. In configura la tabella del modello, inserisci un nome di tabella, ad esempio. TodoAPITable Imposta la chiave primaria suid.

      Nota

      Stiamo essenzialmente creando una nuova tabella DynamoDB chiamata TodoAPITable che verrà allegata API come fonte di dati principale. La nostra chiave primaria è impostata id sul campo richiesto che abbiamo definito in precedenza. Nota che questa nuova tabella è vuota e non contiene nulla tranne la chiave di partizione.

   5. Scegli Next (Successivo).

6. Controlla le modifiche e scegli Crea API. Attendi un momento e lascia che il AWS AppSync servizio finisca di creare il tuoAPI.

Hai creato con successo un GraphQL API con il relativo schema e l'origine dati DynamoDB. Per riassumere i passaggi precedenti, abbiamo scelto di creare un GraphQL API completamente nuovo. Abbiamo definito il nome diAPI, quindi aggiunto la nostra definizione dello schema aggiungendo il nostro primo tipo. Abbiamo definito il tipo e i relativi campi, quindi abbiamo scelto di allegare un'origine dati a uno dei campi creando una nuova tabella DynamoDB senza dati.