Referência do modelo de mapeamento do resolvedor do AWS AppSync para o DynamoDB - AWS AppSync

Referência do modelo de mapeamento do resolvedor do AWS AppSync para o DynamoDB

nota

Agora, oferecemos suporte principalmente ao runtime do APPSYNC_JS e sua documentação. Considere usar o runtime do APPSYNC_JS e seus guias disponíveis aqui.

A função do DynamoDB do AWS AppSync permite usar o GraphQL para armazenar e recuperar dados em tabelas do Amazon DynamoDB existentes na sua conta. Para isso, mapeia uma solicitação do GraphQL de entrada em uma chamada do DynamoDB e, em seguida, mapeia a resposta do DynamoDB de volta para o GraphQL. Esta seção descreve os manipuladores de solicitação e resposta para as operações do DynamoDB compatíveis:

  • GetItem: a solicitação GetItem permite orientar a função do DynamoDB a fazer uma solicitação GetItem ao DynamoDB, além de especificar a chave do item no DynamoDB e se deve ser usada uma leitura consistente ou não.

  • PutItem: o documento de mapeamento de solicitações PutItem permite orientar a função do DynamoDB a fazer uma solicitação PutItem ao DynamoDB, além de especificar a chave do item no DynamoDB, o conteúdo completo do item (composto por chave e attributeValues) e condições para que a operação seja bem-sucedida.

  • UpdateItem: a solicitação UpdateItem permite orientar a função do DynamoDB a fazer uma solicitação UpdateItem ao DynamoDB, além de especificar a chave do item no DynamoDB, uma expressão de atualização descrevendo como atualizar o item no DynamoDB e as condições para que a operação seja bem-sucedida.

  • DeleteItem: a solicitação DeleteItem permite orientar a função do DynamoDB a fazer uma solicitação DeleteItem ao DynamoDB, além de especificar a chave do item no DynamoDB e condições para que a operação seja bem-sucedida.

  • Query: o objeto de solicitação Query permite orientar o resolvedor do DynamoDB a fazer uma solicitação Query ao DynamoDB, além de especificar a expressão de chave, qual índice usar, filtros adicionais, quantos itens retornar, se deve usar leituras consistentes, direção da consulta (para a frente ou para trás) e tokens de paginação.

  • Scan: a solicitação Scan permite orientar a função do DynamoDB a fazer uma solicitação Scan ao DynamoDB, além de especificar um filtro para excluir resultados, qual índice usar, quantos itens retornar, se deve usar leituras consistentes, tokens de paginação e verificações paralelas.

  • Sync: o objeto Sync permite recuperar todos os resultados de uma tabela do DynamoDB e, depois, receber apenas os dados alterados desde a última consulta (as atualizações delta). As solicitações Sync só podem ser feitas a fontes de dados versionadas do DynamoDB. Você pode especificar um filtro para excluir resultados, quantos itens devolver, tokens de paginação e quando sua última operação de sincronização foi iniciada.

  • BatchGetItem: o objeto de solicitação BatchGetItem permite orientar a função do DynamoDB a fazer uma solicitação BatchGetItem ao DynamoDB para recuperar vários itens, potencialmente em diversas tabelas. Para esse objeto de solicitação, você deve especificar os nomes das tabelas das quais recuperar os itens e as chaves dos itens a serem recuperados de cada tabela.

  • BatchDeleteItem: o objeto de solicitação BatchDeleteItem permite orientar a função do DynamoDB a fazer uma solicitação BatchWriteItem ao DynamoDB para excluir vários itens, potencialmente em diversas tabelas. Para esse objeto de solicitação, você deve especificar os nomes das tabelas das quais excluir os itens e as chaves dos itens a serem excluídos de cada tabela.

  • BatchPutItem: o objeto de solicitação BatchPutItem permite orientar a função do DynamoDB a fazer uma solicitação BatchWriteItem ao DynamoDB para colocar vários itens, potencialmente em diversas tabelas. Para esse objeto de solicitação, você deve especificar os nomes das tabelas nas quais colocar os itens e os itens completos a serem colocados em cada tabela.

  • TransactGetItems: o objeto de solicitação TransactGetItems permite orientar a função do DynamoDB a fazer uma solicitação TransactGetItems ao DynamoDB para recuperar vários itens, potencialmente em diversas tabelas. Para esse objeto de solicitação, você deve especificar o nome da tabela de cada item de solicitação do qual recuperar o item e a chave de cada item a ser recuperado de cada tabela.

  • TransactWriteItems: o objeto de solicitação TransactWriteItems permite orientar a função do DynamoDB a fazer uma solicitação TransactWriteItems ao DynamoDB para gravar vários itens, potencialmente em diversas tabelas. Para esse objeto de solicitação, você deve especificar o nome da tabela de destino de cada item de solicitação, a operação de cada item a ser executada e a chave de cada item a ser gravada.

  • Sistema de tipos (mapeamento de solicitações): saiba mais sobre como a digitação do DynamoDB é integrada às solicitações do AWS AppSync.

  • Sistema de tipos (mapeamento de respostas): saiba mais sobre como os tipos do DynamoDB são convertidos automaticamente em GraphQL ou JSON em uma carga útil de resposta.

  • Filtros: saiba mais sobre filtros para operações de consulta e verificação.

  • Expressões de condição: saiba mais sobre expressões de condição para operações PutItem, UpdateItem e DeleteItem.

  • Expressões de condição de transação: saiba mais sobre expressões de condição para operações TransactWriteItems.

  • Projeções: saiba mais sobre como especificar atributos em operações de leitura.