La Guida di riferimento dell'API AWS SDK for JavaScript V3 descrive in dettaglio tutte le operazioni API per la AWS SDK for JavaScript versione 3 (V3).
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à.
Creazione e utilizzo di tabelle in DynamoDB
Questo esempio di codice di Node.js illustra:
Come creare e gestire le tabelle utilizzate per archiviare e recuperare dati da DynamoDB.
Lo scenario
Analogamente ad altri sistemi di database, DynamoDB archivia i dati in tabelle. Una tabella DynamoDB è una raccolta di dati organizzata in elementi analoghi alle righe. Per archiviare o accedere ai dati in DynamoDB, devi creare e lavorare con le tabelle.
In questo esempio, si utilizza una serie di moduli Node.js per eseguire operazioni di base con una tabella DynamoDB. Il codice utilizza l'SDK per JavaScript creare e lavorare con le tabelle utilizzando questi metodi della DynamoDB
classe client:
Attività prerequisite
Per configurare ed eseguire questo esempio, è necessario completare queste attività:
-
Configura l'ambiente di progetto per eseguire questi esempi di Node.js e installa i moduli richiesti AWS SDK for JavaScript e di terze parti. Segui le istruzioni su GitHub
. Installa SDK per il client JavaScript DynamoDB. Per ulteriori informazioni, consulta Cosa c'è di nuovo nella versione 3.
Creazione di un file di configurazione condiviso con le credenziali utente. Per ulteriori informazioni sulla fornitura di un file di credenziali condiviso, consulta File di configurazione e credenziali condivisi nella Guida di riferimento agli SDK e agli AWS strumenti.
Importante
Questi esempi utilizzano ECMAScript6 (ES6). Ciò richiede la versione 13.x o successiva di Node.js. Per scaricare e installare la versione più recente di Node.js, consulta Node.js downloads
Tuttavia, se preferisci utilizzare la sintassi CommonJS, fai riferimento a. JavaScript Sintassi ES6/CommonJS
Nota
Per informazioni sui tipi di dati utilizzati in questi esempi, consulta Tipi di dati e regole di denominazione supportati in Amazon DynamoDB.
Creazione di una tabella
Crea un modulo Node.js con il nome del file create-table.js
. Assicurati di configurare l'SDK come mostrato in precedenza, incluso il download dei client e dei pacchetti richiesti. Per accedere a DynamoDB, crea DynamoDB
un oggetto servizio client. Crea un oggetto JSON che contiene i parametri necessari per creare una tabella, che in questo esempio include il nome e il tipo di dati per ogni attributo, lo schema chiave, il nome della tabella e le unità di throughput sui cui effettuare il provisioning. Chiama il CreateTableCommand
metodo dell'oggetto servizio DynamoDB.
import { CreateTableCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient({}); export const main = async () => { const command = new CreateTableCommand({ TableName: "EspressoDrinks", // For more information about data types, // see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html#HowItWorks.DataTypes and // https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.LowLevelAPI.html#Programming.LowLevelAPI.DataTypeDescriptors AttributeDefinitions: [ { AttributeName: "DrinkName", AttributeType: "S", }, ], KeySchema: [ { AttributeName: "DrinkName", KeyType: "HASH", }, ], ProvisionedThroughput: { ReadCapacityUnits: 1, WriteCapacityUnits: 1, }, }); const response = await client.send(command); console.log(response); return response; };
Per eseguire l'esempio, immettete quanto segue al prompt dei comandi.
node create-table.js
Questo codice di esempio può essere trovato qui su GitHub
Elencare i tavoli
Crea un modulo Node.js con il nome del file list-tables.js
. Assicurati di configurare l'SDK come mostrato in precedenza, incluso il download dei client e dei pacchetti richiesti. Per accedere a DynamoDB, crea DynamoDB
un oggetto servizio client. Creare un oggetto JSON che contiene i parametri necessari per elencare le tabelle, che in questo esempio limita il numero di tabelle elencate a 10. Chiama il ListTablesCommand
metodo dell'oggetto servizio DynamoDB.
import { ListTablesCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient({}); export const main = async () => { const command = new ListTablesCommand({}); const response = await client.send(command); console.log(response); return response; };
Per eseguire l'esempio, immettete quanto segue al prompt dei comandi.
node list-tables.js
Questo codice di esempio può essere trovato qui su GitHub
Descrizione di una tabella
Crea un modulo Node.js con il nome del file describe-table.js
. Assicurati di configurare l'SDK come mostrato in precedenza, incluso il download dei client e dei pacchetti richiesti. Per accedere a DynamoDB, crea DynamoDB
un oggetto servizio client. Crea un oggetto JSON contenente i parametri necessari per descrivere un DescribeTableCommand
metodo dell'oggetto servizio DynamoDB.
import { DescribeTableCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient({}); export const main = async () => { const command = new DescribeTableCommand({ TableName: "Pastries", }); const response = await client.send(command); console.log(`TABLE NAME: ${response.Table.TableName}`); console.log(`TABLE ITEM COUNT: ${response.Table.ItemCount}`); return response; };
Per eseguire l'esempio, immettere quanto segue al prompt dei comandi.
node describe-table.js
Questo codice di esempio può essere trovato qui su GitHub
Eliminazione di una tabella
Crea un modulo Node.js con il nome del file delete-table.js
. Assicurati di configurare l'SDK come mostrato in precedenza, incluso il download dei client e dei pacchetti richiesti. Per accedere a DynamoDB, crea DynamoDB
un oggetto servizio client. Crea un oggetto JSON che contiene i parametri necessari per eliminare una tabella, che in questo esempio include il nome della tabella fornito come parametro della riga di comando. Chiama il DeleteTableCommand
metodo dell'oggetto servizio DynamoDB.
import { DeleteTableCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient({}); export const main = async () => { const command = new DeleteTableCommand({ TableName: "DecafCoffees", }); const response = await client.send(command); console.log(response); return response; };
Per eseguire l'esempio, immettete quanto segue al prompt dei comandi.
node delete-table.js
Questo codice di esempio può essere trovato qui su GitHub