AWS Mobile SDK for Xamarin sekarang disertakan dalam AWS SDK for .NET. Panduan ini menjadi referensi versi yang diarsipkan dari Mobile SDK for Xamarin.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Amazon DynamoDB

Apa itu Amazon DynamoDB?

Amazon DynamoDB adalah layanan basis data yang cepat, sangat dapat diskalakan dan bukan relasional. DynamoDB menghilangkan keterbatasan skalabilitas tradisional pada penyimpanan data sekaligus mempertahankan performa latensi rendah dan dapat diprediksi.

Konsep kunci

Konsep model data DynamoDB termasuk tabel, item, dan atribut.

Tabel

Di Amazon DynamoDB, basis data adalah kumpulan tabel. Sebuah tabel adalah kumpulan item, dan setiap item adalah kumpulan atribut.

Dalam basis data relasional, tabel memiliki skema yang telah ditetapkan seperti nama tabel, kunci utama, daftar nama kolom dan jenis data mereka. Semua catatan yang disimpan dalam tabel harus memiliki set kolom yang sama. Sebaliknya, DynamoDB hanya mengharuskan tabel memiliki kunci utama, tetapi tidak mengharuskan Anda untuk menentukan semua nama atribut dan jenis data di muka.

Untuk mem-pelajari selengkapnya tentang cara menggunakan tabel, lihat Cara Menggunakan Tabel di DynamoDB.

Item dan Atribut

Sebuah item dalam tabel DynamoDB dapat memiliki sejumlah atribut, meskipun ukuran item terbatas pada 400 KB. Ukuran item adalah jumlah dari panjang nama dan nilai atributnya (panjang biner dan UTF-8).

Setiap atribut dalam sebuah item adalah pasangan nama-nilai. Atribut dapat berupa set nilai-tunggal atau multi-nilai. Misalnya, item buku dapat memiliki atribut judul dan penulis. Setiap buku memiliki satu judul tetapi dapat memiliki banyak penulis. Atribut multinilai adalah satu set; nilai-nilai duplikat tidak diperbolehkan.

Misalnya, anggap Anda akan menyimpan katalog produk di DynamoDB. Anda dapat membuat tabel,ProductCatalog, dengan atribut Id sebagai kunci primer. Kunci utama tersebut secara unik mengidentifikasi setiap item, sehingga tidak ada dua produk yang ada dalam tabel yang dapat memiliki ID yang sama.

Untuk mem-pelajari selengkapnya tentang cara menggunakan item, lihat Cara Menggunakan Item di DynamoDB.

Tipe Data

Amazon DynamoDB men-support tipe data berikut:

Untuk informasi lebih lanjut tentang Jenis Data skalar, Jenis Data Multi-Nilai, dan Jenis Data Dokumen, lihat Jenis data DynamoDB.

Kunci Utama

Ketika Anda membuat tabel, selain nama tabel, Anda harus menentukan kunci utama dari tabel. Kunci utama secara unik mengidentifikasi setiap item dalam tabel, sehingga tidak ada dua item dapat memiliki kunci yang sama. DynamoDB men-support dua jenis kunci utama berikut ini:

Indeks Sekunder

Bila Anda membuat tabel dengan kunci hash dan rentang, Anda secara opsional dapat menentukan satu atau lebih indeks sekunder pada tabel itu. Indeks sekunder memungkinkan Anda melakukan kueri data dalam tabel menggunakan kunci alternatif, selain kueri terhadap kunci primer.

DynamoDB men-support dua jenis indeks sekunder: indeks sekunder lokal dan indeks sekunder global.

Anda dapat menentukan hingga 5 indeks sekunder global dan 5 indeks sekunder lokal untuk setiap tabel. Untuk informasi selengkapnya, lihat Meningkatkan Akses Data dengan Indeks Sekunder dalam DynamoDB dalam Panduan Developer DynamoDB.

Melakukan Kueri dan Pemindaian

Selain menggunakan kunci primer untuk mengakses item, Amazon DynamoDB juga menyediakan dua API untuk mencari data: Kueri dan Pemindaian. Sebaiknya Anda membaca Panduan Kueri dan Pemindaian dalam Panduan Developer DynamoDB untuk membuat Anda terbiasa dengan beberapa praktik terbaik.

Kueri

Operasi Kueri mencari item dalam tabel atau indeks sekunder hanya menggunakan nilai atribut kunci primer. Anda harus memberikan nama atribut kunci hash dan nilai yang berbeda untuk mencari. Secara opsional, Anda dapat memberikan nama dan nilai atribut kunci rentang, dan menggunakan operator perbandingan untuk memperbaiki hasil pencarian.

Untuk kueri sampel, lihat:

Untuk informasi tentang Kueri, lihat Kueri di Panduan Developer DynamoDB.

Pemindaian

Operasi Pemindaian membaca setiap item dalam tabel atau indeks sekunder. Secara default, operasi Pemindaian mengembalikan semua atribut data untuk setiap item dalam tabel atau indeks. Anda dapat menggunakan ProjectionExpression parameter sehingga Pemindaian hanya mengembalikan beberapa atribut, bukan semuanya.

Untuk pemindaian sampel, lihat:

Untuk informasi tentang Pemindaian, lihat Pemindaian di Panduan Developer DynamoDB.

Penyiapan Proyek

Prasyarat

Untuk menggunakan DynamoDB dalam aplikasi Anda, Anda harus menambahkan SDK ke dalam proyek Anda. Untuk melakukannya, ikuti petunjuk di Menyiapkan AWS Mobile SDK for .NET and Xamarin.

Membuat Tabel DynamoDB

Untuk membuat tabel, buka Konsol DynamoDB dan ikuti langkah-langkah ini:

Mengatur Izin untuk DynamoDB

Untuk menggunakan DynamoDB dalam aplikasi, Anda harus mengatur izin yang benar. Kebijakan IAM berikut memungkinkan pengguna untuk menghapus, mendapatkan, menempatkan, melakukan kueri, memindai, dan memperbarui item dalam tabel DynamoDB tertentu, yang diidentifikasi oleh ARN:

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:DeleteItem",
        "dynamodb:GetItem",
        "dynamodb:PutItem",
        "dynamodb:Query",
        "dynamodb:Scan",
        "dynamodb:UpdateItem"
      ],
      "Resource": "arn:aws:dynamodb:us-west-2:123456789012:table/MyTable"
    }
  ]
}

Anda dapat mengubah kebijakan di Konsol IAM. Anda harus menambahkan atau menghapus tindakan yang diizinkan berdasarkan kebutuhan aplikasi Anda.

Untuk mem-pelajari selengkapnya tentang kebijakan IAM, lihat Menggunakan IAM.

Untuk mem-pelajari selengkapnya tentang kebijakan khusus DynamoDB, lihat Menggunakan IAM untuk Mengendalikan Akses ke Sumber Daya DynamoDB dalam Panduan Developer DynamoDB.

Mengintegrasikan DynamoDB dengan Aplikasi Anda

AWS Mobile SDK for .NET and Xamarin menyediakan perpustakaan tingkat tinggi untuk digunakan dengan DynamoDB. Anda juga dapat membuat permintaan langsung terhadap API DynamoDB tingkat rendah, tetapi untuk sebagian besar kasus penggunaan, perpustakaan tingkat tinggi lebih direkomendasikan. ParameterAmazonDynamoDBClient adalah bagian yang sangat berguna dari perpustakaan tingkat tinggi. Dengan menggunakan kelas ini, Anda dapat melakukan berbagai operasi buat, baca, perbarui, dan hapus (CRUD) dan menjalankan kueri.

AWS Mobile SDK for .NET and Xamarin memungkinkan Anda untuk membuat panggilan menggunakan API dari AWS SDK for .NET untuk digunakan dengan DynamoDB. Semua API tersedia diAWSSDK.dll. Untuk informasi tentang mengunduh AWS SDK for .NET, lihat AWS SDK for .NET.

Ada tiga cara yang dapat Anda gunakan untuk berinteraksi dengan DynamoDB dalam aplikasi Xamarin Anda:

Ketiga model ini diuraikan secara mendalam dalam topik berikut: