Etapa 2: fazer um tour pelo AWS AppSync console

Antes de adicionarmos dados à nossa tabela do DynamoDB, devemos analisar os recursos básicos da experiência do AWS AppSync console. A guia do AWS AppSync console 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 AWS AppSync fornecem:

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:

1. O editor de código tem recursos de verificação de erros e lint que podem ser usados ao gravar seus próprios aplicativos.

2. O lado direito do console mostra os tipos do GraphQL que foram criados e os resolvedores em diferentes tipos de nível superior, como consultas.

3. Ao adicionar novos tipos a um esquema (por exemplo,type User {...}), você pode AWS AppSync provisionar recursos do DynamoDB para você. Eles incluem a chave primária, a chave de classificação e o design de índice adequados para melhor corresponder ao padrão de acesso aos dados do GraphQL. Se escolher Criar recursos na parte superior e selecionar um desses tipos definidos pelo usuário no menu, você poderá escolher opções de campo diferentes no design do esquema. Abordaremos isso na seção Criar um 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á escrever seu código de resolução. AWS AppSync suporta ambos VTL e JavaScript tempos de execução, que podem ser alterados na parte superior da página escolhendo Ações e, em seguida, Atualizar Tempo de Execução. 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 AWS AppSync serviço a um recurso existente. Você ainda precisa criar o recurso em sua conta usando o serviço relevante antes de AWS AppSync reconhecê-lo.

Consultas

Escolha Consultas para ver suas consultas e mutações. Quando criamos nosso GraphQL API usando nosso modelo, geramos AWS AppSync 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 seu GraphQLAPI. 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.

nota

O modo de autorização padrãoAPI_KEY,, usa uma API chave para testar o aplicativo. Essa é a autorização básica concedida a todo o APIs GraphQL recém-criado. Recomendamos usar outro método de produção. Para fins de exemplo nesta seção, usaremos somente a API chave. Para obter mais informações sobre os métodos de autorização aceitos, consulte Segurança.