Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
GetItem
La GetItem solicitud le permite indicar a la función de AWS AppSync DynamoDB que realice una GetItem solicitud a DynamoDB y le permite especificar:
-
La clave del elemento de DynamoDB
-
Si se utiliza una lectura consistente o no.
La solicitud GetItem tiene la estructura siguiente:
type DynamoDBGetItem = { operation: 'GetItem'; key: { [key: string]: any }; consistentRead?: ConsistentRead; projection?: { expression: string; expressionNames?: { [key: string]: string }; }; };
Los campos se definen de la siguiente manera:
GetItem campos
-
operation -
La operación de DynamoDB que se ha de realizar. Para ejecutar la operación de DynamoDB
GetItem, este valor se debe establecer enGetItem. Este valor es obligatorio. -
key -
La clave del elemento de DynamoDB. Los elementos de DynamoDB pueden tener solo una clave hash o una clave hash y una clave de clasificación, dependiendo de la estructura de la tabla. Para obtener más información sobre cómo especificar un “valor con tipo”, consulte Sistema de tipos (mapeo de solicitud). Este valor es obligatorio.
-
consistentRead -
Indica si se realizará o no una lectura lectura altamente coherente con DynamoDB. Este valor es opcional y de forma predeterminada es
false. projection-
Proyección que se utiliza para especificar los atributos que se devolverán de la operación de DynamoDB. Para obtener más información acerca de las proyecciones, consulte la sección Proyecciones. Este campo es opcional.
El elemento devuelto por DynamoDB se convierte automáticamente en GraphQL y tipos primitivos, JSON y está disponible en el resultado del contexto (). context.result
Para obtener más información sobre la conversión de tipos de DynamoDB, consulte la sección Sistema de tipos (mapeo de respuestas).
Ejemplo
El siguiente ejemplo es un controlador de solicitudes de función para una consulta de GraphQL getThing(foo: String!, bar: String!):
export function request(ctx) { const {foo, bar} = ctx.args return { operation : "GetItem", key : util.dynamodb.toMapValues({foo, bar}), consistentRead : true } }
Para obtener más información sobre DynamoDB, consulte la documentación de GetItem API DynamoDB. API
