As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Como iniciar um esquema no console do AWS AppSync
Neste exemplo, você criará uma API do Todo que permite aos usuários criar itens do Todo para lembretes de tarefas diárias, como Concluir tarefa ou Retirar mantimentos. Essa API demonstrará como usar operações do GraphQL em que o estado é mantido em uma tabela do DynamoDB.
Conceitualmente, há três etapas principais para criar sua primeira API do GraphQL. 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 a API do GraphQL
-
Faça login no Console de gerenciamento da AWS e abra o Console do AppSync
. -
No Painel, escolha Criar API.
-
Enquanto as APIs do GraphQL estiverem selecionadas, escolha Criar do zero. Em seguida, escolha Avançar.
-
Em Nome da API, altere o nome pré-preenchido para
Todo APIe escolha Avançar.nota
Também há outras opções presentes aqui, mas não as usaremos neste exemplo.
-
Na seção Especificar recursos do GraphQL, faça o seguinte:
-
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.
-
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
typechamadaTodoque existirá no esquema:type Todo {} -
Em Campos, faça o seguinte:
-
Crie um campo chamado
id, com o tipoIDe obrigatório definido comoYes.nota
Esses são os campos que estarão dentro do escopo do tipo
Todo. O nome do campo aqui será chamado deidcom o tipoID!:type Todo { id: ID! }O AWS AppSync oferece suporte a vários valores escalares para casos de uso diferentes.
-
Em Adicionar novo campo, crie quatro campos adicionais com os valores de
Namedefinidos comoname,when,whereedescription. Os valores deTypeserãoString, e os valores deArrayeRequiredserãoNo. 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,deleteeupdatepara ajudar você a preencher sua fonte de dados com facilidade.
-
-
Em configurar tabela de modelo, insira um nome de tabela, como
TodoAPITable. Defina a Chave primária comoid.nota
Basicamente, estamos criando uma tabela do DynamoDB chamada
TodoAPITableque será anexada à API como nossa fonte de dados primária. Nossa chave primária é definida como o campoidobrigató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. -
Escolha Avançar.
-
-
Verifique suas alterações e selecione Criar API. Aguarde um momento para que o serviço AWS AppSync termine de criar a API.
Você criou com sucesso uma API do GraphQL com o esquema e a fonte de dados do DynamoDB. Para resumir as etapas acima, optamos por criar uma API do GraphQL completamente nova. Definimos o nome da API e, em seguida, adicionamos nossa definição de esquema adicionando o 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.