Etapa 1: Iniciando um esquema no console AWS AppSync

Neste exemplo, você criará um Todo API que permite aos usuários criar Todo itens para lembretes de tarefas diárias, como Finish task ou Pick up groceries. Isso API demonstrará como usar as operações do GraphQL em que o estado persiste em uma tabela do DynamoDB.

Conceitualmente, há três etapas principais para criar seu primeiro GraphQL. API Você deve definir o esquema (tipos e campos), anexar as fontes de dados aos campos e, em seguida, gravar o resolvedor que manipula a lógica de negócios. No entanto, a experiência do console muda essa ordem. Começaremos definindo como queremos que a fonte de dados interaja com o esquema e, em seguida, definiremos o esquema e o resolvedor posteriormente.

Para criar seu GraphQL API

1. Faça login no AWS Management Console e abra o AppSync console.

2. No Painel, escolha Criar API.

3. Enquanto o GraphQL APIs estiver selecionado, escolha Design do zero. Em seguida, escolha Próximo.

4. Em APInome, altere o nome pré-preenchido para e escolha Todo API Avançar.

   nota

   Também há outras opções presentes aqui, mas não as usaremos neste exemplo.

5. Na seção Especificar recursos do GraphQL, faça o seguinte:

   1. Escolha Criar tipo com apoio de uma tabela do DynamoDB agora.

      nota

      Isso significa que vamos criar uma tabela do DynamoDB para anexar como fonte de dados.

   2. No campo Nome do modelo, insira Todo.

      nota

      Nosso primeiro requisito é definir o esquema. O Nome do modelo será o nome do tipo. Sendo assim, você está criando uma type chamada Todo que existirá no esquema:

      type Todo {}

   3. Em Campos, faça o seguinte:

      1. Crie um campo chamado id, com o tipo ID e obrigatório definido como Yes.

         nota

         Esses são os campos que estarão dentro do escopo do tipo Todo. O nome do campo aqui será chamado de id com o tipo ID!:

         type Todo {
         	id: ID!
         }

         AWS AppSync suporta vários valores escalares para diferentes casos de uso.

      2. Em Adicionar novo campo, crie quatro campos adicionais com os valores de Name definidos como name, when, where e description. Os valores de Type serão String, e os valores de Array e Required serão No. Será algo semelhante a:

         

         nota

         O tipo completo e seus campos serão semelhantes a:

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

         Como estamos criando um esquema usando o modelo predefinido, ele também será preenchido com várias mutações padronizadas com base no tipo, como create, delete e update para ajudar você a preencher sua fonte de dados com facilidade.

   4. Em configurar tabela de modelo, insira um nome de tabela, como TodoAPITable. Defina a Chave primária como id.

      nota

      Basicamente, estamos criando uma nova tabela do DynamoDB chamada TodoAPITable que será anexada ao API como nossa principal fonte de dados. Nossa chave primária é definida como o campo id obrigatório que definimos antes disso. Observe que essa nova tabela está em branco e não contém dados, exceto a chave de partição.

   5. Escolha Avançar.

6. Revise suas alterações e escolha Criar API. Espere um momento para que o AWS AppSync serviço termine de criar seuAPI.

Você criou com sucesso um GraphQL API com seu esquema e fonte de dados do DynamoDB. Para resumir as etapas acima, optamos por criar um GraphQL API completamente novo. Definimos o nome do eAPI, em seguida, adicionamos nossa definição de esquema adicionando nosso primeiro tipo. Definimos o tipo e os respectivos campos e, em seguida, optamos por anexar uma fonte de dados a um dos campos criando uma tabela do DynamoDB sem dados.