Trabalhar com o modelo de persistência de objetos do .NET e o DynamoDB

O AWS SDK for .NET fornece um modelo de persistência de objetos que permite mapear classes do cliente em tabelas do Amazon DynamoDB. Em seguida, cada instância de objeto é mapeada para um item nas tabelas correspondentes. Para salvar objetos no lado do cliente nas tabelas, o modelo de persistência de objetos fornece a classe DynamoDBContext, um ponto de entrada para o DynamoDB. Esta classe fornece uma conexão ao DynamoDB e permite que você acesse tabelas, execute várias operações CRUD e realize consultas.

O modelo de persistência de objetos fornece um conjunto de atributos para mapear classes no lado do cliente para tabelas e propriedades/campos para atributos de tabela.

O exemplo a seguir mostra como o modelo de persistência de objetos funciona. Ele começa com a tabela ProductCatalog. Id é a chave primária.

ProductCatalog(Id, ...)

Suponha que você tenha uma classe Book com propriedades Title, ISBN e Authors. É possível mapear a classe Book na tabela ProductCatalog adicionando os atributos definidos pelo modelo de persistência de objetos, conforme mostrado no trecho de código C# a seguir.

[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; }
  }

No exemplo anterior, o atributo DynamoDBTable mapeia a classe Book na tabela ProductCatalog.

O modelo de persistência objeto oferece suporte a tipos de mapeamento explícito e padrão entre propriedades de classe e atributos de tabela.

Não é necessário mapear cada propriedade de classe. Identifique essas propriedades adicionando o atributo DynamoDBIgnore. Quando você salva uma instância de Book na tabela, DynamoDBContext não inclui a propriedade CoverPage. Ele também não retorna essa propriedade quando você recupera a instância de livro.

É possível mapear propriedades de tipos primitivos do .NET, como int e string. Também é possível mapear qualquer tipo de dados arbitrário, desde que você forneça um conversor apropriado para mapear os dados arbitrários em um do tipos do DynamoDB. Para saber mais sobre o mapeamento de tipos arbitrários, consulte Mapear dados arbitrários com o DynamoDB usando o modelo de persistência de objetos do AWS SDK for .NET.

O modelo de persistência objetos oferece suporte a bloqueio otimista. Durante uma operação de atualização, isso garante que você tenha a cópia mais recente do item que está prestes a atualizar. Para ter mais informações, consulte Bloqueio positivo usando o DynamoDB e o modelo de persistência de objetos do AWS SDK for .NET.

Para obter mais informações, consulte os tópicos abaixo:

Tipos de dados compatíveis

O modelo de persistência de objetos oferece suporte a um conjunto de tipos de dados primitivos do .NET, coleções e tipos de dados arbitrários. O modelo é compatível com os seguintes tipos de dados primitivos.

O modelo de persistência de objetos também oferece suporte aos tipos de coleção .NET. DynamoDBContext é capaz de converter tipos de coleção concretos e objetos CLR básicos (POCOs).

A tabela a seguir resume o mapeamento dos tipos .NET anteriores nos tipos do DynamoDB.

O modelo de persistência de objetos também oferece suporte a tipos de dados arbitrários. No entanto, você deve fornecer o código de conversor para mapear os tipos complexos em tipos do DynamoDB.