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à.
Importante
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
Per la documentazione sull'attuale livello bassoAPI, consulta Amazon DynamoDB Reference API.
Descrizione
L'operazione CreateTable
aggiunge una nuova tabella all'account.
Il nome della tabella deve essere unico 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 DynamoDB di basso livello 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} }
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 di servizio, account e tabelle 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 |
Data in cui la tabella è stata creata in UNIXepoca storica 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 ( Usa il DescribeTables API 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 di servizio, account e tabelle 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 di AWS SDK, vedereUtilizzo di tabelle e dati in DynamoDB.
Richiesta di esempio
// This header is abbreviated. // For a sample of a complete header, see DynamoDB di basso livello 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} }
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"
}
}