Menu Docs
Página inicial do Docs
/
Atlas
/
Acesso programático
/
Infraestrutura como código

Gerencie dados em seu cluster do Atlas usando os resolvedores Lambda do Amazon Web Services AppSync

Você pode gerenciar dados em seu cluster do Atlas usando resolvedores diretos do Lambda doAmazon Web Services AppSync. A função Lambda, servindo como um resolvedor para a GraphQL API do Amazon Web Services AppSync, permite operações CRUD contínuas em seus dados em seu Atlas cluster. A integração do Atlas com o Amazon Web Services AppSync oferece uma solução poderosa e flexível para criar APIs GraphQL escaláveis e sem servidor.

Essa integração não apenas reduz a complexidade do gerenciamento de várias fontes de dados, mas também melhora a experiência de desenvolvimento ao fornecer uma plataforma unificada e flexível para arquiteturas modernas de aplicação . Esteja você lidando com operações CRUD ou otimizando cargas úteis, essa integração permite que você crie APIs escaláveis, eficientes e econômicas.

Esta página orienta você pelas seguintes etapas:

  1. Implemente a pilha do CloudFormation que contém a função Serverless Lambda e uma GraphQL API gerenciada pela Amazon Web Services.

  2. Teste a API AppSync executando queries no console da API AppSync do Amazon Web Services ou Postman.

Pré-requisitos

Antes de começar, você deve fazer o seguinte:

  • Implemente um Atlas cluster

  • Configurar o banco de dados para segurança e acesso de rede

  • Configurar uma conta do Amazon Web Services com acesso ao Console de gerenciamento do Amazon Web Services

Procedimento

1

Crie a função Lambda sem servidor no Amazon Web Services.

  1. Faça login no Console de gerenciamento do Amazon Web Services e navegue até Applications, que está localizado na barra lateral esquerda dentro do console do Amazon Web Services Lambda.

  2. Clique em Create application e selecione a guia Serverless application.

  3. Digite MongoDB-AppSync-App na barra de pesquisa e marque a caixa de seleção para mostrar aplicativos que criam funções de IAM personalizadas ou políticas de recursos.

  4. Clique no aplicativo MongoDB-AppSync-App nos resultados da pesquisa.

  5. Cole a string de conexão do Atlas no campo AtlasConnectionString, em Application settings.

  6. Marque a caixa de seleção para criar roles do IAM e clique em Deploy para implantar a pilha do CloudFormation.

    A pilha do CloudFormation inicia a criação de:

    • Uma função Lambda contendo a lógica essencial necessária para resolver queries da API do AppSync.

    • Uma GraphQL API contendo um esquema que define consultas e mutações. Essas queries e mutações estão vinculadas à função Lambda estabelecida pela pilha do CloudFormation.

    Quando a implantação for concluída, copie o seguinte na seção Outputs da pilha do CloudFormation:

    • GraphQLApiKey, que é a chave da API AppSync

    • GraphQLAPIURL, que é o URL da API AppSync

    • LambdaFunction, que é o ARN da função Lambda

2

Teste a API do AppSync com um resolvedor Lambda como fonte de dados.

Você pode usar o console do Amazon Web Services AppSync ou o Postman para testar a API do AppSync.

As cargas úteis de solicitação e resposta da API devem estar no formato MongoDB Atlas Data API (v1). Cada query deve incluir a query de solicitação necessária e os parâmetros do corpo. Para saber mais sobre a sintaxe da Data API, consulte MongoDB Atlas Data API (v1):

  1. Faça login no Console de gerenciamento do Amazon Web Services e navegue até a página do Amazon Web Services AppSync.

  2. Clique no link para o MongoDB-AppSync-SAM_API.

  3. Clique em Queries na navegação à esquerda, em MongoDB-AppSync-SAM_API.

  4. Selecione o Explorer (terceiro ícone) em Queries.

  5. Selecione o tipo de query e insira a query.

    Você pode executar qualquer um dos seguintes tipos de query:

    • aggregate

    • find e a findOne

    • insertOne e a insertMany

    • updateOne e a updateMany

    • deleteOne e a deleteMany

    Se você digitar a query no campo input, os caracteres de escape serão adicionados automaticamente à sua query.

  6. Clique no botão de reprodução para executar a consulta.

    A saída contém caracteres de sequência de escape. Recomendamos implementar uma lógica em seu aplicação para converter a sequência de escape em JSON.

  1. Baixe a coleção do Postman chamada postman.json no Github.

  2. Abra o Postman e clique em Import.

  3. Conclua as etapas para importar o arquivo postman.json baixado.

  4. Para query, faça o seguinte:

    • Envie POST solicitação para GraphQLAPIURL.

    • Autenticar com GraphQLApiKey.

  5. Clique em Try para executar a query.

Voltar

Exemplo verificado do Terraform HashiCorp

Próximo

Migrar para clusters flexíveis

Nesta página