Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateTable
Importante
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
Per informazioni sull'API di basso livello corrente, consulta la Amazon DynamoDB API Reference.
Descrizione
L'operazione CreateTable
aggiunge una nuova tabella all'account.
Il nome della tabella deve essere univoco tra quelli associati all' AWS account che emette la richiesta e alla AWS regione che riceve la richiesta (ad esempio dynamodb.us-west-2.amazonaws.com). Ogni endpoint DynamoDB è completamente indipendente. Ad esempio, se hai due tabelle chiamate "»MyTable, una in dynamodb.us-west-2.amazonaws.com e una in dynamodb.us-west-1.amazonaws.com, sono completamente indipendenti e non condividono alcun dato.
L'operazione CreateTable
attiva un flusso di lavoro asincrono per iniziare a creare la tabella. DynamoDB restituisce immediatamente lo stato della tabella (CREATING
) fino a quando la tabella si trova nello stato ACTIVE
. Una volta che la tabella si trova nello stato ACTIVE
, è possibile eseguire le operazioni del piano dati.
Utilizza l'operazione DescribeTables per visualizzare lo stato della tabella.
Richieste
Sintassi
// This header is abbreviated. // For a sample of a complete header, see API DynamoDB di basso livello. 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} }
Nome | Descrizione | Richiesto |
---|---|---|
TableName
|
Nome della tabella da creare. I caratteri consentiti sono a-z, A-Z, 0-9, '_' (sottolineatura), '-' (trattino) e '.' (punto). I nomi possono contenere un numero di caratteri compreso tra 3 e 255 caratteri. Tipo: stringa |
Sì |
KeySchema
|
La struttura della chiave primaria (semplice o composita) per la tabella. Una coppia nome-valore per I nomi degli elementi della chiave primaria possono contenere un massimo di 255 caratteri, senza alcuna limitazione. I valori possibili per le AttributeType sono «S» (stringa), «N» (numerico) o «B» (binario). Tipo: mappa di |
Sì |
ProvisionedThroughput
|
La nuova velocità effettiva per la tabella specificata, costituita dai valori per ReadCapacityUnits e WriteCapacityUnits . Per informazioni dettagliate, consultare Modalità di capacità fornita da DynamoDB. NotaPer i valori massimi e minimi correnti, consulta Quote in Amazon DynamoDB. Tipo: Array |
Sì |
ProvisionedThroughput :
ReadCapacityUnits |
Imposta il numero minimo di Le operazioni di lettura a consistenza finale richiedono meno sforzo rispetto a un'operazione di lettura consistente, quindi un'impostazione di 50 Tipo: numero |
Sì |
ProvisionedThroughput :
WriteCapacityUnits |
Imposta il numero minimo di WriteCapacityUnits consumate al secondo per la tabella specificata prima che DynamoDB bilanci il carico con altre operazioni. Tipo: numero |
Sì |
Risposte
Sintassi
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" } }
Nome | Descrizione |
---|---|
TableDescription
|
Un container per le proprietà della tabella. |
CreationDateTime |
La data in cui la tabella è stata creata in formato orario epoch UNIX Tipo: numero |
KeySchema
|
La struttura della chiave primaria (semplice o composita) per la tabella. Una coppia nome-valore per Tipo: mappa di |
ProvisionedThroughput
|
Velocità effettiva per la tabella specificata, costituita dai valori per Tipo: Array |
ProvisionedThroughput
:ReadCapacityUnits |
Il numero minimo di Tipo: numero |
ProvisionedThroughput
:WriteCapacityUnits |
Il numero minimo di Tipo: numero |
TableName
|
Il nome della tabella creata. Tipo: stringa |
TableStatus
|
Lo stato corrente della tabella ( Utilizza l'API DescribeTables per controllare lo stato della tabella. Tipo: stringa |
Errori speciali
Errore | Descrizione |
---|---|
ResourceInUseException
|
Tentativo di creare nuovamente una tabella già esistente. |
LimitExceededException
|
Il numero di richieste di tabella simultanee (numero cumulativo di tabelle nello stato NotaPer i valori massimi e minimi correnti, consulta Quote in Amazon DynamoDB. |
Esempi
Nell'esempio seguente viene creata una tabella con una chiave primaria composita contenente una stringa e un numero. Per esempi di utilizzo dell' AWS SDK, consulta. Utilizzo di tabelle e dati in DynamoDB
Richiesta di esempio
// This header is abbreviated. // For a sample of a complete header, see API DynamoDB di basso livello. 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} }
Risposta di esempio
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" } }