DescribeTables - Amazon DynamoDB
DescrizioneRichiesteRisposteErrori specialiEsempiOperazioni correlate

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à.

DescribeTables

Importante

In questa sezione si fa riferimento alla versione API 2011-12-05, che è obsoleta e non deve essere utilizzata per le nuove applicazioni.

Per informazioni sull'API di basso livello corrente, consulta la Amazon DynamoDB API Reference.

Descrizione

Restituisce informazioni sulla tabella, inclusi lo stato corrente della tabella, lo schema della chiave primaria e la data di creazione della tabella. I risultati di DescribeTable sono a consistenza finale. Se si utilizza DescribeTable troppo presto nel processo di creazione di una tabella, DynamoDB restituisce una ResourceNotFoundException. Se si utilizza DescribeTable troppo presto nel processo di aggiornamento di una tabella, i nuovi valori potrebbero non essere immediatamente disponibili.

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.DescribeTable
content-type: application/x-amz-json-1.0

{"TableName":"Table1"}
Nome Descrizione Richiesto
TableName

Il nome della tabella da descrivere.

Tipo: string

Sì

Risposte

Sintassi

HTTP/1.1 200 
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
Content-Length: 543


{"Table":
    {"CreationDateTime":1.309988345372E9,
    ItemCount:1,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
    "ProvisionedThroughput":{"LastIncreaseDateTime": Date, "LastDecreaseDateTime": Date, "ReadCapacityUnits":10,"WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableSizeBytes":1,
    "TableStatus":"ACTIVE"
    }
}
Nome Descrizione
Table

Un container per la tabella descritta.

Tipo: string
CreationDateTime La data in cui la tabella è stata creata in formato orario epoch UNIX.
ItemCount

Il numero di elementi nella tabella specificata. DynamoDB aggiorna questo valore ogni sei ore circa. Le modifiche recenti potrebbero non essere riflesse in questo valore.

Tipo: numero
KeySchema La struttura della chiave primaria (semplice o composita) per la tabella. Una coppia nome-valore per HashKeyElement è obbligatoria mentre una coppia nome-valore per RangeKeyElement è facoltativa (richiesta solo per le chiavi primarie composite). La dimensione massima della chiave hash è 2048 byte. La dimensione massima della chiave di intervallo è 1024 byte. Entrambi i limiti sono applicati separatamente (cioè è possibile avere una chiave hash + intervallo combinato, ovvero 2048+1024). Per ulteriori informazioni sulle chiavi primarie, vedere Chiave primaria.
ProvisionedThroughput Velocità effettiva assegnata, costituita dai valori per LastIncreaseDateTime(se applicabile), LastDecreaseDateTime (se applicabile),ReadCapacityUnits e WriteCapacityUnits. Se la velocità effettiva della tabella non è mai stata aumentata o ridotta, DynamoDB non restituisce valori per tali elementi. Consultare Modalità con capacità allocata di DynamoDB.

Tipo: Array

TableName

Il nome della tabella richiesta.

Tipo: string
TableSizeBytes

La dimensione totale della tabella specificata in byte. DynamoDB aggiorna questo valore ogni sei ore circa. Le modifiche recenti potrebbero non essere riflesse in questo valore.

Tipo: numero
TableStatus Lo stato corrente della tabella (CREATING, ACTIVE, DELETING o UPDATING). Una volta che la tabella si trova nello stato ACTIVE, è possibile aggiungere i dati.

Errori speciali

Non esiste alcun errore specifico per questa operazione.

Esempi

Gli esempi seguenti mostrano una richiesta POST HTTP e una risposta tramite l'operazione DescribeTable per una tabella denominata "comp-table". La tabella dispone di una chiave primaria composita.

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.DescribeTable
content-type: application/x-amz-json-1.0

{"TableName":"users"}

Risposta di esempio

HTTP/1.1 200 
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 543

{"Table":
    {"CreationDateTime":1.309988345372E9,
    "ItemCount":23,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":{"LastIncreaseDateTime": 1.309988345384E9, "ReadCapacityUnits":10,"WriteCapacityUnits":10},
    "TableName":"users",
    "TableSizeBytes":949,
    "TableStatus":"ACTIVE"
    }
}