Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
penting
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
Untuk dokumentasi tentang level rendah saat iniAPI, lihat Referensi Amazon DynamoDB API.
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 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 |
Ya |
ProvisionedThroughput
|
Throughput baru untuk tabel yang ditentukan, yang terdiri dari nilai-nilai untuk ReadCapacityUnits dan WriteCapacityUnits. Untuk detailnya, lihat DynamoDB menyediakan mode kapasitas. catatanUntuk nilai maksimum/minimum saat ini, lihat Layanan, akun, dan tabel kuota di Amazon DynamoDB. Jenis: Array |
Ya |
ProvisionedThroughput:
ReadCapacityUnits |
Menetapkan jumlah minimum Operasi bacaan akhir konsisten memerlukan lebih sedikit usaha daripada operasi baca konsisten, jadi pengaturan 50 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 dalam waktu UNIX zaman Jenis: Angka |
KeySchema
|
Struktur kunci primer (sederhana atau komposit) untuk tabel. Pasangan nama-nilai untuk Jenis: Peta |
ProvisionedThroughput
|
Throughput untuk tabel yang ditentukan, yang terdiri dari nilai-nilai untuk Jenis: Array |
ProvisionedThroughput
:ReadCapacityUnits |
Jumlah minimum Jenis: Angka |
ProvisionedThroughput
:WriteCapacityUnits |
Jumlah minimum Jenis: Angka |
TableName
|
Nama tabel yang dibuat. Jenis: String |
TableStatus
|
Status tabel saat ini ( Gunakan tombol DescribeTables API untuk memeriksa status tabel. Tipe: String |
Kesalahan khusus
| Kesalahan | Deskripsi |
|---|---|
ResourceInUseException
|
Mencoba untuk membuat kembali tabel yang sudah ada. |
LimitExceededException
|
Jumlah permintaan tabel simultan (jumlah kumulatif tabel dalam status catatanUntuk 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"
}
}Tindakan terkait
