Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# CreateTable
**penting**
**{{This section refers to API version 2011-12-05, which is deprecated and should not be used for new applications.}}**
**Untuk dokumentasi tentang API tingkat rendah saat ini, lihat [Referensi API Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).**
## 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](API_DescribeTables_v20111205.md) untuk memeriksa status tabel.
## Permintaan
### Sintaks
```
// This header is abbreviated.
// For a sample of a complete header, see API tingkat rendah DynamoDB.
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](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).
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 detailnya, lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md). Untuk nilai maksimum/minimum saat ini, lihat [Kuota di Amazon DynamoDB](ServiceQuotas.md). 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](http://www.epochconverter.com/).
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](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).
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](provisioned-capacity-mode.md).
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](API_DescribeTables_v20111205.md) 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. Untuk nilai maksimum/minimum saat ini, lihat [Kuota di Amazon DynamoDB](ServiceQuotas.md). . |
## Contoh
Contoh berikut membuat tabel dengan kunci primer komposit yang berisi string dan angka. Untuk contoh menggunakan AWS SDK, lihat[Bekerja dengan tabel dan data di DynamoDB](WorkingWithTables.md).
### Permintaan sampel
```
// This header is abbreviated.
// For a sample of a complete header, see API tingkat rendah DynamoDB.
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
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)