Amazon DynamoDB
開発者ガイド (API バージョン 2012-08-10)

AWS SDK for .NET オブジェクト永続性モデルを使用した、DynamoDB での任意データのマッピング

サポートされている .NET 型 (「サポートされているデータの種類」を参照) に加えて、DynamoDB 型に直接マッピングされない型を、アプリケーションで使用できます。オブジェクト永続性モデルでは、任意の型から DynamoDB 型に、またはその反対にデータを変換できるコンバーターがある限り、任意の型のデータを格納できます。コンバーターコードによって、オブジェクトの保存およびロード中にデータが変換されます。

クライアント側ではどのような型でも作成できますが、テーブルに格納されているデータは DynamoDB 型の一種であり、クエリおよびスキャンでは、データの比較は DynamoDB に格納されているデータに対して行われます。

次の C# コード例では、BookIdTitle、および ISBN プロパティを使用して Dimension クラスを定義しています。Dimension プロパティは、DimensionTypeHeight、および Width プロパティを記述する Thickness に含まれています。このコード例では、コンバーターメソッド ToEntry および FromEntry によって、DimensionType と DynamoDB 文字列型との間でデータが変換されています。たとえば Book インスタンスを保存する場合には、コンバーターによって "8.5x11x.05" などの書籍の寸法文字列が作成され、書籍を取り出す場合には、文字列が DimensionType インスタンスに変換されます。

この例では、Book 型を ProductCatalog テーブルにマッピングしています。説明のために、サンプルの Book インスタンスを保存し、取り出し、寸法を更新し、更新された Book を再度保存しています。

次のサンプルをテストするための詳しい手順については、『.NET コードサンプル』を参照してください。

using System; using System.Collections.Generic; using Amazon.DynamoDBv2; using Amazon.DynamoDBv2.DataModel; using Amazon.DynamoDBv2.DocumentModel; using Amazon.Runtime; using Amazon.SecurityToken; namespace com.amazonaws.codesamples { class HighLevelMappingArbitraryData { private static AmazonDynamoDBClient client = new AmazonDynamoDBClient(); static void Main(string[] args) { try { DynamoDBContext context = new DynamoDBContext(client); // 1. Create a book. DimensionType myBookDimensions = new DimensionType() { Length = 8M, Height = 11M, Thickness = 0.5M }; Book myBook = new Book { Id = 501, Title = "AWS SDK for .NET Object Persistence Model Handling Arbitrary Data", ISBN = "999-9999999999", BookAuthors = new List<string> { "Author 1", "Author 2" }, Dimensions = myBookDimensions }; context.Save(myBook); // 2. Retrieve the book. Book bookRetrieved = context.Load<Book>(501); // 3. Update property (book dimensions). bookRetrieved.Dimensions.Height += 1; bookRetrieved.Dimensions.Length += 1; bookRetrieved.Dimensions.Thickness += 0.2M; // Update the book. context.Save(bookRetrieved); Console.WriteLine("To continue, press Enter"); Console.ReadLine(); } catch (AmazonDynamoDBException e) { Console.WriteLine(e.Message); } catch (AmazonServiceException e) { Console.WriteLine(e.Message); } catch (Exception e) { Console.WriteLine(e.Message); } } } [DynamoDBTable("ProductCatalog")] public class Book { [DynamoDBHashKey] //Partition key public int Id { get; set; } [DynamoDBProperty] public string Title { get; set; } [DynamoDBProperty] public string ISBN { get; set; } // Multi-valued (set type) attribute. [DynamoDBProperty("Authors")] public List<string> BookAuthors { get; set; } // Arbitrary type, with a converter to map it to DynamoDB type. [DynamoDBProperty(typeof(DimensionTypeConverter))] public DimensionType Dimensions { get; set; } } public class DimensionType { public decimal Length { get; set; } public decimal Height { get; set; } public decimal Thickness { get; set; } } // Converts the complex type DimensionType to string and vice-versa. public class DimensionTypeConverter : IPropertyConverter { public DynamoDBEntry ToEntry(object value) { DimensionType bookDimensions = value as DimensionType; if (bookDimensions == null) throw new ArgumentOutOfRangeException(); string data = string.Format("{1}{0}{2}{0}{3}", " x ", bookDimensions.Length, bookDimensions.Height, bookDimensions.Thickness); DynamoDBEntry entry = new Primitive { Value = data }; return entry; } public object FromEntry(DynamoDBEntry entry) { Primitive primitive = entry as Primitive; if (primitive == null || !(primitive.Value is String) || string.IsNullOrEmpty((string)primitive.Value)) throw new ArgumentOutOfRangeException(); string[] data = ((string)(primitive.Value)).Split(new string[] { " x " }, StringSplitOptions.None); if (data.Length != 3) throw new ArgumentOutOfRangeException(); DimensionType complexData = new DimensionType { Length = Convert.ToDecimal(data[0]), Height = Convert.ToDecimal(data[1]), Thickness = Convert.ToDecimal(data[2]) }; return complexData; } } }