Conceitos básicos do : como criar sua primeira API do GraphQL - AWS AppSync

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 do
: como criar sua primeira API do GraphQL

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:

  1. 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.

  2. 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.

  3. 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:

  1. 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.

  2. Projetando uma API do GraphQL com um esquema em branco e sem fontes de dados ou resolvedores.

  3. Usando uma tabela do DynamoDB para importar dados e gerar os tipos e campos do esquema.

  4. Usando os recursos WebSocket do AWS AppSync e a arquitetura Pub/Sub para desenvolver APIs em tempo real.

  5. 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. Eles incluem:

  1. AWS Amplify

  2. AWS SAM

  3. AWS CloudFormation

  4. 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