Uso del modelo de persistencia de objetos de .NET y DynamoDB

El AWS SDK for .NET proporciona un modelo de persistencia de objetos que le permite mapear las clases en el cliente a una tabla de Amazon DynamoDB. A continuación, cada instancia de objeto se mapea a un elemento en las tablas correspondientes. Para guardar los objetos del lado del cliente en las tablas, el modelo de persistencia de objetos proporciona la clase DynamoDBContext, un punto de entrada a DynamoDB. Esta categoría le ofrece una conexión a DynamoDB y le permite obtener acceso a tablas, realizar diversas operaciones CRUD y ejecutar consultas.

El modelo de persistencia de objetos proporciona un conjunto de atributos para mapear las clases del lado del cliente a tablas, y las propiedades/campos a atributos de tabla.

En el ejemplo siguiente se muestra cómo funciona el modelo de persistencia de objetos. Comienza con la tabla ProductCatalog. Su clave principal es Id.

ProductCatalog(Id, ...)

Suponga que tiene una clase Book con las propiedades Title, ISBN y Authors. Puede mapear la clase Book a la tabla ProductCatalog agregando los atributos definidos por el modelo de persistencia de objetos, como se muestra en el siguiente ejemplo de código C#.

[DynamoDBTable("ProductCatalog")]
  public class Book
  {
    [DynamoDBHashKey]
    public int Id { get; set; }

    public string Title { get; set; }
    public int ISBN { get; set; }

    [DynamoDBProperty("Authors")]
    public List<string> BookAuthors { get; set; }

    [DynamoDBIgnore]
    public string CoverPage { get; set; }
  }

En el ejemplo anterior, el atributo DynamoDBTable mapea la clase Book a la tabla ProductCatalog.

El modelo de persistencia de objetos admite el mapeo tanto explícito como predeterminado entre las propiedades de clase y los atributos de tabla.

No tiene que mapear cada propiedad de clase. Puede identificar estas propiedades agregando el atributo DynamoDBIgnore. Al guardar una instancia de Book en la tabla, DynamoDBContext no incluye la propiedad CoverPage. Tampoco se devolverá esta propiedad cuando se recupere la instancia del libro.

Puede mapear propiedades de tipos primitivos de .NET, como int o string. También puede mapear cualquier tipo de datos arbitrarios, siempre y cuando proporcione un convertidor adecuado para mapear los datos arbitrarios a uno de los tipos de DynamoDB. Para obtener más información sobre cómo mapear tipos arbitrarios, consulte Mapeo de datos arbitrarios con DynamoDB mediante el modelo de persistencia de objetos de AWS SDK for .NET.

El modelo de persistencia de objetos admite el bloqueo optimista. Durante una operación de actualización, esto garantiza que se disponga de la última copia del elemento que se va a actualizar. Para obtener más información, consulte Bloqueo positivo mediante DynamoDB y el modelo de persistencia de objetos de AWS SDK for .NET.

Para obtener más información, consulte los siguientes temas.

Tipos de datos compatibles

El modelo de persistencia de objetos admite un conjunto de tipos de datos, colecciones y tipos de datos arbitrarios de .NET primitivos. El modelo admite los siguientes tipos de datos primitivos.

El modelo de persistencia de objetos también admite los tipos de colección de .NET. DynamoDBContext puede convertir tipos de colección concretos y objetos CLR estándar (POCO, por sus siglas en inglés) simples.

En la tabla siguiente se resume el mapeo de los tipos de .NET anteriores a los tipos de DynamoDB.

El modelo de persistencia de objetos también admite los tipos de datos arbitrarios. Sin embargo, debe proporcionar el código de convertidor para mapear los tipos complejos a los tipos de DynamoDB.