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à.
Distribuzione di DynamoDB in locale sul computer
Importante
Il jar locale di DynamoDB può essere scaricato dai AWS CloudFront nostri link di distribuzione a cui si fa riferimento qui. A partire dal 1° gennaio 2025, i vecchi bucket di distribuzione S3 non saranno più attivi e DynamoDB locale verrà distribuito solo tramite link di distribuzione. CloudFront
Nota
-
Sono disponibili due versioni principali di DynamoDB locale: DynamoDB local v2.x (Current) e DynamoDB local v1.x (Legacy). I clienti devono utilizzare la versione 2.x (Current) quando possibile, poiché supporta le versioni più recenti di Java Runtime Environment ed è compatibile con lo spazio dei nomi jakarta.* per il progetto Maven. La versione 1.x locale di DynamoDB raggiungerà la fine del supporto standard a partire dal 1° gennaio 2025. Dopo questa data, la v1.x non riceverà più aggiornamenti o correzioni di bug.
-
DynamoDB local
AWS_ACCESS_KEY_ID
può contenere solo lettere (A–Z, a–z) e numeri (0-9).
Completare la procedura riportata di seguito per configurare ed eseguire DynamoDB sul proprio computer.
Come configurare DynamoDB sul computer
-
Scarica DynamoDB local gratuitamente da una delle seguenti posizioni.
Collegamenti per il download Checksum Importante
Per eseguire DynamoDB v2.6.0 o superiore sul computer, è necessario disporre della versione 17.x o successiva di Java Runtime Environment (JRE). L'applicazione non verrà eseguita nelle versioni di JRE precedenti.
-
Dopo aver scaricato l'archivio, estrai i contenuti e copia la directory estratta in una ubicazione a scelta.
-
Per avviare DynamoDB sul computer, aprire una finestra del prompt dei comandi, spostarsi nella directory in cui è stato estratto
DynamoDBLocal.jar
, quindi immettere il comando seguente.java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -sharedDb
Nota
Se utilizzi Windows PowerShell, assicurati di includere il nome del parametro o l'intero nome e valore in questo modo:
java -D"java.library.path=./DynamoDBLocal_lib" -jar DynamoDBLocal.jar
DynamoDB esegue le richieste in arrivo fino al suo arresto. Per arrestare DynamoDB, digitare Ctrl+C al prompt dei comandi.
DynamoDB utilizza la porta 8000 per impostazione predefinita. Se la porta 8000 non è disponibile, il comando genera un'eccezione. Per un elenco completo delle opzioni di runtime di DynamoDB, incluso
-port
, immettere il comando seguente.java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -help
-
Prima di poter accedere a AWS Command Line Interface in modo programmatico o tramite (AWS CLI), è necessario configurare le credenziali per abilitare l'autorizzazione per le applicazioni. Perché possa funzionare, la versione scaricabile di DynamoDB richiede le credenziali, come mostrato nell'esempio seguente.
AWS Access Key ID: "fakeMyKeyId" AWS Secret Access Key: "fakeSecretAccessKey" Default Region Name: "fakeRegion"
È possibile utilizzare il comando
aws configure
di AWS CLI per impostare le credenziali. Per ulteriori informazioni, consulta Utilizzando il AWS CLI. -
Inizia a scrivere le applicazioni. Per accedere a DynamoDB in esecuzione localmente con, utilizzare AWS CLI il parametro.
--endpoint-url
Ad esempio, per elencare le tabelle DynamoDB utilizzare il seguente comando:aws dynamodb list-tables --endpoint-url http://localhost:8000
La versione scaricabile di Amazon DynamoDB è disponibile come parte dell'immagine Docker. Per ulteriori informazioni, consulta dynamodb-local
java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -version
Per un esempio di utilizzo di DynamoDB local come parte di un'applicazione REST basata su AWS SAM(), consulta Applicazione SAM DynamoDB
Se desideri eseguire un'applicazione multi-container che utilizza anche il container DynamoDB Local, utilizza Docker Compose per definire ed eseguire tutti i servizi nell'applicazione, incluso DynamoDB Local.
Per installare ed eseguire DynamoDB in locale con Docker Compose:
-
Scarica e installa Docker Desktop
. -
Copiare il codice seguente in un file e salvarlo con nome
docker-compose.yml
.services: dynamodb-local: command: "-jar DynamoDBLocal.jar -sharedDb -dbPath ./data" image: "amazon/dynamodb-local:latest" container_name: dynamodb-local ports: - "8000:8000" volumes: - "./docker/dynamodb:/home/dynamodblocal/data" working_dir: /home/dynamodblocal
Se vuoi che l'applicazione e DynamoDB locale si trovino in container separati, utilizza il file yaml seguente.
version: '3.8' services: dynamodb-local: command: "-jar DynamoDBLocal.jar -sharedDb -dbPath ./data" image: "amazon/dynamodb-local:latest" container_name: dynamodb-local ports: - "8000:8000" volumes: - "./docker/dynamodb:/home/dynamodblocal/data" working_dir: /home/dynamodblocal app-node: depends_on: - dynamodb-local image: amazon/aws-cli container_name: app-node ports: - "8080:8080" environment: AWS_ACCESS_KEY_ID: 'DUMMYIDEXAMPLE' AWS_SECRET_ACCESS_KEY: 'DUMMYEXAMPLEKEY' command: dynamodb describe-limits --endpoint-url http://dynamodb-local:8000 --region us-west-2
Lo script docker-compose.yml crea un container
app-node
e un containerdynamodb-local
. Lo script esegue un comando nel containerapp-node
che utilizza la AWS CLI per connettersi al containerdynamodb-local
e descrive i limiti di account e tabelle.Per utilizzarlo con la propria immagine dell'applicazione, sostituire il valore
image
nell'esempio seguente con quello dell'applicazione:version: '3.8' services: dynamodb-local: command: "-jar DynamoDBLocal.jar -sharedDb -dbPath ./data" image: "amazon/dynamodb-local:latest" container_name: dynamodb-local ports: - "8000:8000" volumes: - "./docker/dynamodb:/home/dynamodblocal/data" working_dir: /home/dynamodblocal app-node: image:
location-of-your-dynamodb-demo-app:latest
container_name: app-node ports: - "8080:8080" depends_on: - "dynamodb-local" links: - "dynamodb-local" environment: AWS_ACCESS_KEY_ID: 'DUMMYIDEXAMPLE' AWS_SECRET_ACCESS_KEY: 'DUMMYEXAMPLEKEY' REGION: 'eu-west-1'Nota
Gli script YAML richiedono di specificare una chiave di AWS accesso e una chiave AWS segreta, ma non devono essere AWS chiavi valide per accedere a DynamoDB locale.
-
Emettere il seguente comando dalla riga di comando:
docker-compose up
Completare la seguente procedura per utilizzare Amazon DynamoDB nell'applicazione come dipendenza.
Come distribuire DynamoDB come repository Apache Maven
-
Scarica e installa Apache Maven. Per ulteriori informazioni, consulta le pagine relative al download di Apache Maven
e all'installazione di Apache Maven . -
Aggiungi il repository Maven DynamoDB al file POM (Project Object Model) dell'applicazione:
<!--Dependency:--> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>DynamoDBLocal</artifactId> <version>2.6.0</version> </dependency> </dependencies>
Modello di esempio da utilizzare con Spring Boot 3 Spring Framework 6: and/or
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>org.example</groupId> <artifactId>SpringMavenDynamoDB</artifactId> <version>1.0-SNAPSHOT</version> <properties> <spring-boot.version>3.0.1</spring-boot.version> <maven.compiler.source>17</maven.compiler.source> <maven.compiler.target>17</maven.compiler.target> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.0.1</version> </parent> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>DynamoDBLocal</artifactId> <version>2.6.0</version> </dependency> <!-- Spring Boot --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> <version>${spring-boot.version}</version> </dependency> <!-- Spring Web --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <version>${spring-boot.version}</version> </dependency> <!-- Spring Data JPA --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> <version>${spring-boot.version}</version> </dependency> <!-- Other Spring dependencies --> <!-- Replace the version numbers with the desired version --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>6.0.0</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>6.0.0</version> </dependency> <!-- Add other Spring dependencies as needed --> <!-- Add any other dependencies your project requires --> </dependencies> </project>
Nota
Puoi anche utilizzare l'URL di Maven Central Repository
.
AWS CloudShell è una shell preautenticata basata su browser che puoi avviare direttamente da. AWS Management ConsoleÈ possibile accedere AWS CloudShell da diversi modi AWS Management Console . Per ulteriori informazioni, consulta Guida introduttiva AWS CloudShell.
Segui questi passaggi per eseguire DynamoDB localmente ovunque AWS CloudShell nel. AWS Management Console
Per eseguire DynamoDB localmente nel tuo AWS CloudShellAWS Management Console
-
Avvia AWS CloudShell dall'interfaccia della console, scegli una shell disponibile Regione AWS e passa alla shell preferita, come Bash o la shell PowerShell Z.
-
Per sceglierne una Regione AWS, vai al menu Seleziona una regione e seleziona una supportata Regione AWS. (Le regioni disponibili sono evidenziate.)
-
Da AWS Management Console, avvia AWS CloudShell scegliendo una delle seguenti opzioni:
-
Nella barra di navigazione, scegli l'AWS CloudShellicona.
-
Nella casella Cerca, inserisci la parola CloudShell, quindi scegli CloudShell.
-
Nel widget Visitato di recente, scegli CloudShell.
-
Dalla barra degli strumenti della console, scegli CloudShell.
-
-
Per eseguire DynamoDB AWS CloudShell in locale puoi usare l'alias.
dynamodb-local
È possibile specificare opzioni aggiuntive della riga di comando per modificare le impostazioni locali di DynamoDB. Vedi Note per l'utilizzo locale di DynamoDB per le opzioni disponibili.Nota
Per eseguire DynamoDB in locale in background, esegui DynamoDB local utilizzando:. AWS CloudShell
dynamodb-local &
-
Per accedere a DynamoDB AWS CloudShell in esecuzione localmente con, utilizzare AWS CLI il parametro.
--endpoint-url
Ad esempio, utilizzate il seguente comando per elencare le tabelle DynamoDB:aws dynamodb list-tables --endpoint-url http://localhost:8000