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á.
Conceitos básicos: como criar sua primeira API GraphQL no AWS AppSync
Você pode usar o console do AWS AppSync para configurar e iniciar uma API do GraphQL. As APIs do GraphQL geralmente exigem três componentes:
-
Esquema do GraphQL: trata-se do esquema da API. Ele define os tipos e campos que você pode solicitar quando uma operação é executada. Para preencher o esquema com dados, você deve conectar as fontes de dados à API do GraphQL. Neste guia de início rápido, criaremos um esquema usando um modelo predefinido.
-
Fontes de dados: são os recursos que contêm os dados para preencher a API do GraphQL. Pode ser uma tabela do DynamoDB, uma função do Lambda etc. AWS O AppSync aceita diversas fontes de dados para criar APIs do GraphQL robustas e escaláveis. As fontes de dados estão vinculadas aos campos no esquema. Sempre que uma solicitação é executada em um campo, os dados da fonte preenchem o campo. Esse mecanismo é controlado pelo resolvedor. Neste guia de início rápido, criaremos uma fonte de dados usando um modelo predefinido juntamente com o esquema.
-
Resolvedores: os resolvedores são responsáveis por vincular o campo do esquema à fonte de dados. Eles recuperam os dados da fonte e, em seguida, retornam o resultado com base no que foi definido pelo campo. AWS O AppSync aceita o JavaScript e o VTL para gravar resolvedores para as APIs do GraphQL. Neste guia de início rápido, os resolvedores serão gerados automaticamente com base no esquema e na fonte de dados. Não vamos nos aprofundar nisso nesta seção.
O AWS AppSync suporta a criação e a configuração de todos os componentes do GraphQL. Ao abrir o console, você pode usar os seguintes métodos para criar a API:
-
Projetar uma API do GraphQL personalizada gerando-a por meio de um modelo predefinido e configurando uma nova tabela do DynamoDB (fonte de dados) para suportá-la.
-
Projetando uma API do GraphQL com um esquema em branco e sem fontes de dados ou resolvedores.
-
Usando uma tabela do DynamoDB para importar dados e gerar os tipos e campos do esquema.
-
Usando os recursos WebSocket do AWS AppSync e a arquitetura Pub/Sub para desenvolver APIs em tempo real.
-
Usando APIs do GraphQL existentes (APIs de origem) para vincular a uma API mesclada.
nota
Recomendamos ler a seção Criar um esquema antes de trabalhar com ferramentas mais avançadas. Esses guias explicarão exemplos mais simples que você pode usar conceitualmente para criar aplicativos mais complexos no AWS AppSync.
O AWS AppSync também oferece suporte a várias opções que não são de console para criar APIs do GraphQL. Isso inclui:
-
AWS Amplify
AWS SAM
-
AWS CloudFormation
-
O CDK
O exemplo a seguir mostrará como criar os componentes básicos de uma API do GraphQL usando modelos predefinidos e o DynamoDB.
Tópicos
