GetItem - AWS AppSync
GetItem camposExemplo

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

GetItem

A GetItem solicitação permite que você instrua a função do AWS AppSync DynamoDB a fazer uma GetItem solicitação ao DynamoDB e permite que você especifique:

  • A chave do item no DynamoDB

  • Se deve usar uma leitura consistente ou não

A solicitação GetItem tem a seguinte estrutura:

type DynamoDBGetItem = {
  operation: 'GetItem';
  key: { [key: string]: any };
  consistentRead?: ConsistentRead;
  projection?: {
    expression: string;
    expressionNames?: { [key: string]: string };
  };
};

Os campos são definidos da seguinte forma:

GetItem campos

operation

A operação do DynamoDB para execução. Para executar a operação GetItem do DynamoDB, ela deve ser definida como GetItem. Este valor é obrigatório.

key

A chave do item no DynamoDB. Os itens do DynamoDB podem ter uma única chave de hash ou uma chave de hash e uma chave de classificação, dependendo da estrutura da tabela. Para obter mais informações sobre como especificar um "valor digitado", consulte Sistema de tipo (Mapeamento de solicitação). Este valor é obrigatório.

consistentRead

Se deve ou não realizar uma leitura altamente consistente com o DynamoDB. Isso é opcional e usa como padrão false.

projection

Uma projeção usada para especificar os atributos a serem retornados da operação do DynamoDB. Para obter mais informações sobre projeções, consulte Projeções. Esse campo é opcional.

O item retornado do DynamoDB é automaticamente convertido em GraphQL e tipos primitivos JSON e está disponível no contexto result (). context.result

Para obter mais informações sobre a conversão de tipo do DynamoDB, consulte Sistema de tipo (mapeamento da resposta).

Para obter mais informações sobre JavaScript resolvedores, consulte a visão geral dos JavaScript resolvedores.

Exemplo

O exemplo a seguir é um manipulador de solicitação de função para uma consulta getThing(foo: String!, bar: String!) GraphQL:

export function request(ctx) {
  const {foo, bar} = ctx.args
  return {
    operation : "GetItem",
    key : util.dynamodb.toMapValues({foo, bar}),
    consistentRead : true
  }
}

Para obter mais informações sobre o DynamoDB, consulte a GetItem API documentação do DynamoDB. API