CreateTable - Amazon DynamoDB
DeskripsiPermintaanResponsKesalahan khususContohTindakan terkait

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

CreateTable

penting

Bagian ini mengacu pada API versi 2011-12-05, yang sudah usang dan tidak boleh digunakan untuk aplikasi baru.

Untuk dokumentasi tentang API tingkat rendah saat ini, lihat Referensi API Amazon DynamoDB.

Deskripsi

Operasi CreateTable menambahkan tabel baru ke akun Anda.

Nama tabel harus unik di antara yang terkait dengan AWS Akun yang mengeluarkan permintaan, dan AWS wilayah yang menerima permintaan (seperti dynamodb.us-west-2.amazonaws.com). Setiap titik akhir DynamoDB bersifat independen sepenuhnya. Misalnya, jika Anda memiliki dua tabel yang disebut "MyTable,” satu di dynamodb.us-west-2.amazonaws.com dan satu di dynamodb.us-west-1.amazonaws.com, mereka sepenuhnya independen dan tidak berbagi data apa pun.

Operasi CreateTable memicu alur kerja asinkron untuk mulai membuat tabel. DynamoDB segera mengembalikan status tabel (CREATING) hingga tabel berada dalam status ACTIVE. Setelah tabel berada dalam status ACTIVE, Anda dapat melakukan operasi bidang data.

Gunakan operasi DescribeTables untuk memeriksa status tabel.

Permintaan

Sintaks

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB tingkat rendah API.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.CreateTable 
content-type: application/x-amz-json-1.0 

{"TableName":"Table1",
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}
Nama Deskripsi Wajib
TableName

Nama tabel yang akan dibuat.

Karakter yang diperbolehkan adalah a-z, A-Z, 0-9, '_' (garis bawah), '-' (tanda pisah), dan '.' (titik). Nama bisa berisi antara 3 dan 255 karakter.

Jenis: String

 Ya
KeySchema

Struktur kunci primer (sederhana atau komposit) untuk tabel. Pasangan nama-nilai untuk HashKeyElement diperlukan, dan pasangan nama-nilai untuk RangeKeyElement bersifat opsional (hanya diperlukan untuk kunci primer komposit). Untuk informasi selengkapnya tentang kunci primer, lihat Kunci primer.

Nama elemen kunci primer dapat berisi antara 1 dan 255 karakter tanpa batasan karakter.

Nilai yang mungkin untuk AttributeType adalah “S” (string), “N” (numerik), atau “B” (biner).

Jenis: Peta HashKeyElement, atau HashKeyElement dan RangeKeyElement untuk kunci primer komposit.

 Ya
ProvisionedThroughput Throughput baru untuk tabel yang ditentukan, yang terdiri dari nilai-nilai untuk ReadCapacityUnits dan WriteCapacityUnits. Untuk rincian selengkapnya, lihat DynamoDB menyediakan mode kapasitas.
catatan

Untuk nilai maksimum/minimum saat ini, lihat Layanan, akun, dan tabel kuota di Amazon DynamoDB.

Jenis: Array

Ya
ProvisionedThroughput: ReadCapacityUnits

Menetapkan jumlah minimum ReadCapacityUnits yang konsisten digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya.

Operasi bacaan akhir konsisten memerlukan lebih sedikit usaha daripada operasi baca konsisten, jadi pengaturan 50 ReadCapacityUnits yang konsisten per detik akan menghasilkan 100 ReadCapacityUnits akhir konsisten per detik.

Jenis: Angka

Ya
ProvisionedThroughput: WriteCapacityUnits Menetapkan jumlah minimum WriteCapacityUnits yang digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya.

Jenis: Angka

Ya

Respons

Sintaks

HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT

{"TableDescription":
    {"CreationDateTime":1.310506263362E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableStatus":"CREATING"
    }
}
Nama Deskripsi
TableDescription Kontainer untuk properti tabel.
CreationDateTime

Tanggal ketika tabel dibuat di jangka waktu UNIX.

Jenis: Angka
KeySchema

Struktur kunci primer (sederhana atau komposit) untuk tabel. Pasangan nama-nilai untuk HashKeyElement diperlukan, dan pasangan nama-nilai untuk RangeKeyElement bersifat opsional (hanya diperlukan untuk kunci primer komposit). Untuk informasi selengkapnya tentang kunci primer, lihat Kunci primer.

Jenis: Peta HashKeyElement, atau HashKeyElement dan RangeKeyElement untuk kunci primer komposit.
ProvisionedThroughput

Throughput untuk tabel yang ditentukan, yang terdiri dari nilai-nilai untuk ReadCapacityUnits dan WriteCapacityUnits. Lihat DynamoDB menyediakan mode kapasitas.

Jenis: Array

ProvisionedThroughput :ReadCapacityUnits

Jumlah minimum ReadCapacityUnits yang digunakan per detik sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya

Jenis: Angka

ProvisionedThroughput :WriteCapacityUnits

Jumlah minimum ReadCapacityUnits yang digunakan per detik sebelum WriteCapacityUnits menyeimbangkan beban dengan operasi lainnya

Jenis: Angka

TableName

Nama tabel yang dibuat.

Jenis: String
TableStatus

Status tabel saat ini (CREATING). Setelah tabel berada dalam status ACTIVE, Anda dapat menempatkan data di dalamnya.

Gunakan API DescribeTables untuk memeriksa status tabel.

Jenis: String

Kesalahan khusus

Kesalahan Deskripsi
ResourceInUseException Mencoba untuk membuat kembali tabel yang sudah ada.
LimitExceededException

Jumlah permintaan tabel simultan (jumlah kumulatif tabel dalam status CREATING, DELETING atau UPDATING) melampaui jumlah maksimum yang diizinkan.

catatan

Untuk nilai maksimum/minimum saat ini, lihat Layanan, akun, dan tabel kuota di Amazon DynamoDB.

.

Contoh

Contoh berikut membuat tabel dengan kunci primer komposit yang berisi string dan angka. Untuk contoh menggunakan AWS SDK, lihatBekerja dengan tabel dan data di DynamoDB.

Permintaan sampel

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB tingkat rendah API.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.CreateTable 
content-type: application/x-amz-json-1.0


{"TableName":"comp-table",
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}

Respons sampel

HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT

{"TableDescription":
    {"CreationDateTime":1.310506263362E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
    "TableName":"comp-table",
    "TableStatus":"CREATING"
    }
}