AWSの Mobile SDK for Xamarin が、AWS SDK for .NETに含まれるようになりました。このガイドでは、Mobile SDK for Xamarin のアーカイブバージョンについて説明します。

DynamoDB でデータの保存と取り出し

Amazon DynamoDB は、拡張性と可用性に優れた、費用効果の高い、高速な非リレーショナルデータベースサービスです。DynamoDB により、データストレージに対して低いレイテンシーと予測可能なパフォーマンスを維持しながら、従来の拡張性の限界を排除できます。

以下のチュートリアルでは、DynamoDB オブジェクト永続モデルを、DynamoDB にオブジェクトを格納するアプリと統合する方法について説明します。

プロジェクトのセットアップ

前提条件

このチュートリアルを開始する前に、必ず「AWS Mobile SDK for .NET and Xamarin をセットアップする」の手順をすべて完了する必要があります。

DynamoDB テーブルの作成

DynamoDB データベースにデータを読み書きするには、テーブルを作成する必要があります。テーブルを作成するには、プライマリキーを指定する必要があります。プライマリキーは、ハッシュ属性とオプションの範囲属性で構成されます。プライマリおよび範囲属性の使用方法の詳細については、「テーブルの操作」を参照してください。

DynamoDB のアクセス許可を設定する

ID プールが Amazon DynamoDB にアクセスを可能にするには、ID プールのロールを変更する必要があります。

DynamoDB の NuGet パッケージをプロジェクトに追加する

「AWS Mobile SDK for .NET and Xamarin のセットアップ」のステップ 4 に従って、DynamoDB NuGet パッケージをプロジェクトに追加します。

Initialize AmazonDynamoDBClient

初期化された Amazon Cognito の認証情報プロバイダーとリージョンを AmazonDynamoDB コンストラクタに渡し、クライアントを DynamoDBContext に渡します。

var client = new AmazonDynamoDBClient(credentials,region);
DynamoDBContext context = new DynamoDBContext(client);

クラスの作成

行をテーブルに書き込むには、行データを保持するクラスを定義します。クラスは、属性を保持するプロパティも含まれていますが、コンソールで作成された DynamoDB テーブルにマップされます。次のクラス宣言はそのようなクラスを示しています。

[DynamoDBTable("Books")]
public class Book
{
    [DynamoDBHashKey]    // Hash key.
    public int Id { get; set; }
    public string Title { get; set; }
    public string ISBN { get; set; }
    public int Price { get; set; }
    public string PageCount { get; set; }
    public string Author{ get; set; }
}

項目の保存

項目を保存するには、最初にオブジェクトを作成します。

Book songOfIceAndFire = new Book()
{
    Id=1,
    Title="Game Of Thrones",
    ISBN="978-0553593716",
    Price=4,
    PageCount="819",
    Author="GRRM"
};

次に、保存します。

context.Save(songOfIceAndFire);

行を更新するには、DDTableRow クラスのインスタンスを変更し、上記のように AWSDynamoObjectMapper.save() を呼び出します。

項目の取得

プライマリキーを使用して項目を取得

Book retrievedBook = context.Load<Book>(1);

項目の更新

項目を更新するには:

Book retrievedBook = context.Load<Book>(1);
retrievedBook.ISBN = "978-0553593716";
context.Save(retrievedBook);

項目の削除

項目を削除するには:

Book retrievedBook = context.Load<Book>(1);
context.Delete(retrievedBook);

Xamarin アプリケーションから DynamoDB へのアクセスの詳細については、「Amazon DynamoDB」を参照してください。