VocĂŞ pode gerenciar dados em seu cluster do Atlas usando os resolvedores diretos do Amazon 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:
Implemente a pilha do CloudFormation que contém a função Serverless Lambda e uma GraphQL APIgerenciada pela Amazon Web Services.
Teste a API do AppSync executando queries no console da API do Amazon Web Services AppSync ou do 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à rede
Configurar uma conta do Amazon Web Services com acesso ao Console de gerenciamento do Amazon Web Services
Procedimento
Crie a função Lambda sem servidor na AWS.
Faça login no Console de gerenciamento do Amazon Web Services e navegue até Applications, que está localizado na barra lateral esquerda no console do Amazon Web Services Lambda.
Clique em Create application e selecione a guia Serverless application.
Digite
MongoDB-AppSync-Appna 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.Clique no aplicativo
MongoDB-AppSync-Appnos resultados da pesquisa.Cole a string de conexĂŁo do Atlas no campo AtlasConnectionString, em Application settings.
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 AppSyncGraphQLAPIURL, que é o URL da API AppSyncLambdaFunction, que é o ARN da função Lambda
Teste a API do AppSync com um resolvedor Lambda como fonte de dados.
VocĂŞ pode usar o console do Amazon Web Services AppSync ou 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):
Faça login no Console de gerenciamento do Amazon Web Services e navegue até a página do Amazon Web Services AppSync.
Clique no link para o
MongoDB-AppSync-SAM_API.Clique em Queries na navegação à esquerda, em MongoDB-AppSync-SAM_API.
Selecione o Explorer (terceiro Ăcone) em Queries.
Selecione o tipo de query e insira a query.
VocĂŞ pode executar qualquer um dos seguintes tipos de query:
aggregatefinde afindOneinsertOnee ainsertManyupdateOnee aupdateManydeleteOnee adeleteMany
Se vocĂŞ digitar a query no campo input, os caracteres de escape serĂŁo adicionados automaticamente Ă sua query.
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.
Baixe a coleção do Postman chamada
postman.jsonno Github.Abra o Postman e clique em Import.
Conclua as etapas para importar o arquivo
postman.jsonbaixado.Para query, faça o seguinte:
Envie
POSTsolicitação paraGraphQLAPIURL.Autenticar com
GraphQLApiKey.
Clique em Try para executar a query.