Um tour pelo console do AWS AppSync

Antes de adicionarmos dados à tabela do DynamoDB, devemos analisar os atributos básicos da experiência do console do AWS AppSync. A guia do console do AWS AppSync no lado esquerdo da página permite que os usuários naveguem facilmente até qualquer um dos principais componentes ou opções de configuração que o AWS AppSync fornece:

Designer do esquema

Escolha Esquema para visualizar o esquema que você acabou de criar. Se você revisar o conteúdo do esquema, notará que ele já foi carregado com várias operações auxiliares para simplificar o processo de desenvolvimento. No editor Esquema, se você percorrer o código, acabará alcançando o modelo definido na seção anterior:

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

Seu modelo passou a ser o tipo básico usado em todo o esquema. Começaremos adicionando dados à nossa fonte de dados usando mutações que foram geradas automaticamente a partir desse tipo.

Veja abaixo algumas dicas e fatos adicionais sobre o editor Esquema:

Configuração do resolvedor

No designer do esquema, a seção Resolvedores contém todos os tipos e campos do esquema. Se você percorrer a lista de campos, notará que pode anexar resolvedores a determinados campos escolhendo Anexar. Isso abrirá um editor de código no qual você poderá gravar seu código de resolução. AWS O AppSync suporta runtimes de VTL e JavaScript, que podem ser alterados na parte superior da página escolhendo Ações e, em seguida, Atualizar runtime. Na parte inferior da página, você também pode criar funções que executarão várias operações em uma sequência. No entanto, resolvedores são um tópico avançado, e não o abordaremos nesta seção.

Fontes de dados

Escolha Fontes de dados para visualizar a tabela do DynamoDB. Ao escolher a opção Resource (se disponível), você poderá visualizar a configuração da fonte de dados. No exemplo, isso leva ao console do DynamoDB. Nele, você pode editar seus dados. Também é possível editar diretamente alguns dos dados. Para isso, escolha a fonte de dados e, em seguida, Editar. Se precisar excluir a fonte de dados, você poderá escolher a fonte de dados e selecionar Excluir. Por fim, você pode criar fontes de dados escolhendo Criar fonte de dados e configurando o nome e o tipo. Observe que essa opção serve para vincular o serviço AWS AppSync a um recurso existente. Você ainda precisa criar o recurso na conta usando o serviço relevante antes que o AWS AppSync o reconheça.

Consultas

Escolha Consultas para ver suas consultas e mutações. Quando criamos a API do GraphQL usando nosso modelo, o AWS AppSync gerou automaticamente algumas mutações e consultas auxiliares para fins de teste. No editor de consultas, o lado esquerdo contém o Explorador. Trata-se de uma lista que mostra todas as mutações e consultas. Você pode habilitar facilmente as operações e os campos que deseja usar aqui clicando nos valores de nome. Isso fará com que o código apareça automaticamente na parte central do editor. Aqui, você pode editar as mutações e consultas modificando os valores. Na parte inferior do editor, há o editor Variáveis de consulta, que permite inserir os valores dos campos para as variáveis de entrada de suas operações. Ao escolher Executar na parte superior do editor, será aberta uma lista suspensa para selecionar a consulta/mutação a ser executada. A saída para essa execução aparecerá no lado direito da página. De volta à seção Explorador, na parte superior, você pode escolher uma operação (Consulta, Mutação, Assinatura) e, em seguida, escolher o símbolo + para adicionar uma nova instância da operação em questão. Na parte superior da página, haverá outra lista suspensa que contém o modo de autorização para a execução de sua consulta. No entanto, não abordaremos esse atributo nesta seção. Para obter mais informações, consulte Segurança.

Configurações

Escolha Configurações para ver algumas opções de configuração para a API do GraphQL. Aqui, você pode ativar algumas opções, como log, rastreamento e funcionalidade de firewall de aplicativos da web. Você também pode adicionar novos modos de autorização para proteger os dados contra vazamentos indesejados para o público. No entanto, essas opções são mais avançadas e não serão abordadas nesta seção.