Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Einrichten von DynamoDB AWS Bietet zusätzlich zum Amazon DynamoDB DynamoDB-Webservice eine herunterladbare Version von DynamoDB, die Sie auf Ihrem Computer ausführen können. Die herunterladbare Version ist nützlich für die Entwicklung und das Testen Ihres Codes. Damit können Sie Anwendungen ohne Zugriff auf den DynamoDB-Webservice lokal entwickeln und testen. Die Themen in diesem Abschnitt beschreiben, wie Sie DynamoDB (herunterladbare Version) und den DynamoDB-Webservice einrichten. **Topics** + [Einrichten von DynamoDB (Webservice)](SettingUp.DynamoWebService.md) + [Lokale Einrichtung von DynamoDB (herunterladbare Version)](DynamoDBLocal.md) # Einrichten von DynamoDB (Webservice) So verwenden Sie den Amazon-DynamoDB-Webservice: 1. [Registrieren für AWS.](#SettingUp.DynamoWebService.SignUpForAWS) 1. [Rufen Sie einen AWS Zugriffsschlüssel](#SettingUp.DynamoWebService.GetCredentials) ab (wird verwendet, um programmgesteuert auf DynamoDB zuzugreifen). **Anmerkung** Wenn Sie planen, nur über den mit DynamoDB zu interagieren AWS-Managementkonsole, benötigen Sie keinen AWS Zugriffsschlüssel, und Sie können direkt zu. [Verwenden der Konsole](AccessingDynamoDB.md#ConsoleDynamoDB) 1. [Konfigurieren der Anmeldeinformationen](#SettingUp.DynamoWebService.ConfigureCredentials) (für den programmgesteuerten Zugriff auf DynamoDB). ## Melden Sie sich an für AWS Um den DynamoDB-Dienst nutzen zu können, benötigen Sie ein AWS Konto. Wenn Sie noch kein Konto besitzen, werden Sie bei der Anmeldung aufgefordert, eines zu erstellen. Für AWS Dienste, für die Sie sich registrieren, werden Ihnen keine Gebühren berechnet, es sei denn, Sie nutzen sie. **Um sich anzumelden für AWS** 1. Öffnen Sie [https://portal.aws.amazon.com/billing/die Anmeldung.](https://portal.aws.amazon.com/billing/signup) 1. Folgen Sie den Online-Anweisungen. Während der Anmeldung erhalten Sie einen Telefonanruf oder eine Textnachricht und müssen einen Verifizierungscode über die Telefontasten eingeben. Wenn Sie sich für eine anmelden AWS-Konto, *Root-Benutzer des AWS-Kontos*wird eine erstellt. Der Root-Benutzer hat Zugriff auf alle AWS-Services und Ressourcen des Kontos. Als bewährte Sicherheitsmethode weisen Sie einem Benutzer Administratorzugriff zu und verwenden Sie nur den Root-Benutzer, um [Aufgaben auszuführen, die Root-Benutzerzugriff erfordern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). ## Erteilen programmgesteuerten Zugriffs Bevor Sie programmgesteuert oder über AWS Command Line Interface (AWS CLI) auf DynamoDB zugreifen können, benötigen Sie programmatischen Zugriff. Sie benötigen keinen programmgesteuerten Zugriff, wenn Sie nur die DynamoDB-Konsole verwenden möchten. Benutzer benötigen programmatischen Zugriff, wenn sie mit außerhalb von interagieren möchten. AWS AWS-Managementkonsole Die Art und Weise, wie programmatischer Zugriff gewährt wird, hängt von der Art des Benutzers ab, der zugreift. AWS Um Benutzern programmgesteuerten Zugriff zu gewähren, wählen Sie eine der folgenden Optionen. **** | Welcher Benutzer benötigt programmgesteuerten Zugriff? | Bis | Von | | --- | --- | --- | | IAM | (Empfohlen) Verwenden Sie Konsolenanmeldeinformationen als temporäre Anmeldeinformationen, um programmatische Anfragen an AWS CLI AWS SDKs, oder zu signieren. AWS APIs | Befolgen Sie die Anweisungen für die Schnittstelle, die Sie verwenden möchten. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html) | | Mitarbeiteridentität (Benutzer, die in IAM Identity Center verwaltet werden) | Verwenden Sie temporäre Anmeldeinformationen, um programmatische Anfragen an das AWS CLI AWS SDKs, oder AWS APIs zu signieren. | Befolgen Sie die Anweisungen für die Schnittstelle, die Sie verwenden möchten. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html) | | IAM | Verwenden Sie temporäre Anmeldeinformationen, um programmatische Anfragen an das AWS CLI AWS SDKs, oder zu signieren. AWS APIs | Folgen Sie den Anweisungen unter [Verwenden temporärer Anmeldeinformationen mit AWS Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) im IAM-Benutzerhandbuch. | | IAM | (Nicht empfohlen)Verwenden Sie langfristige Anmeldeinformationen, um programmatische Anfragen an das AWS CLI AWS SDKs, oder zu signieren. AWS APIs | Befolgen Sie die Anweisungen für die Schnittstelle, die Sie verwenden möchten. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html) | ## Konfigurieren der Anmeldeinformationen Bevor Sie programmgesteuert oder über die auf DynamoDB zugreifen können, müssen Sie Ihre Anmeldeinformationen so konfigurieren AWS CLI, dass die Autorisierung für Ihre Anwendungen aktiviert wird. Dazu stehen verschiedene Möglichkeiten zur Verfügung. Beispielsweise können Sie die Datei mit den Anmeldeinformationen zum Speichern Ihrer Zugriffsschlüssel-ID und des geheimen Zugriffsschlüssels manuell erstellen. Sie können den AWS CLI Befehl auch verwenden, um die Datei automatisch `aws configure` zu erstellen. Alternativ können Sie Umgebungsvariablen verwenden. Weitere Informationen zur Konfiguration Ihrer Anmeldeinformationen finden Sie im entwicklerspezifischen AWS SDK-Entwicklerhandbuch. Informationen zur Installation und Konfiguration von finden Sie AWS CLI unter. [Mit dem AWS CLI](AccessingDynamoDB.md#Tools.CLI) ## Integration mit anderen DynamoDB-Services Sie können DynamoDB in viele andere AWS Dienste integrieren. Weitere Informationen finden Sie hier: + [DynamoDB mit anderen Diensten verwenden AWS](OtherServices.md) + [CloudFormation für DynamoDB](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html) + [Verwendung von AWS Backup mit DynamoDB](backuprestore_HowItWorksAWS.md) + [AWS Identity and Access Management (IAM) und DynamoDB](identity-and-access-mgmt.md) + [Verwendung AWS Lambda mit Amazon DynamoDB](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html) # Lokale Einrichtung von DynamoDB (herunterladbare Version) Mit der herunterladbaren Version von Amazon DynamoDB können Sie Anwendungen entwickeln und testen, ohne auf den DynamoDB-Webservice zuzugreifen. Die Datenbank wird stattdessen als unabhängige Komponente auf Ihrem Computer ausgeführt. Wenn Sie bereit sind, Ihre Anwendung in der Produktion bereitzustellen, entfernen Sie den lokalen Endpunkt im Code. Er verweist dann auf den DynamoDB-Webservice. Mit dieser lokalen Version sind Einsparungen im Hinblick auf den Durchsatz, die Datenspeicherung und Datenübertragungsgebühren möglich. Darüber hinaus benötigen Sie für die Entwicklung der Anwendung keine Internetverbindung. Die lokale Version von DynamoDB ist als [Download](DynamoDBLocal.DownloadingAndRunning.md#DynamoDBLocal.DownloadingAndRunning.title) (erfordert JRE), als [Apache-Maven-Abhängigkeit](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.DownloadingAndRunning.html#apache-maven) oder als [Docker-Image](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.DownloadingAndRunning.html#docker) verfügbar. Wenn Sie stattdessen den Amazon-DynamoDB-Webservice verwenden möchten, finden Sie unter [Einrichten von DynamoDB (Webservice)](SettingUp.DynamoWebService.md) weitere Informationen. **Topics** + [Bereitstellen der lokalen Version von DynamoDB auf Ihrem Computer](DynamoDBLocal.DownloadingAndRunning.md) + [DynamoDB-Local-Nutzungshinweise](DynamoDBLocal.UsageNotes.md) + [Versionsverlauf für die lokale Version von DynamoDB](DynamoDBLocalHistory.md) + [Telemetrie in der lokalen Version von DynamoDB](DynamoDBLocalTelemetry.md) # Bereitstellen der lokalen Version von DynamoDB auf Ihrem Computer **Anmerkung** Die lokale Version von DynamoDB ist in drei Versionen verfügbar: v3.x (aktuell), v2.x (Legacy) und v1.x (veraltet). DynamoDB v3.x wird für Ihre lokalen Test- und Entwicklungszwecke empfohlen. Die Migration der lokalen Version von DynamoDB V2.x auf V3.x erfordert die Aktualisierung der Importanweisungen von `com.amazonaws.services.dynamodbv2` auf `software.amazon.dynamodb` und die Aktualisierung der Maven-Abhängigkeiten für Maven-Benutzer. Wenn Sie eine Anwendung zum SDK für Java 2.x migrieren, die das SDK für Java v1.x verwendet, folgen Sie den Schritten unter [AWS -SDK für Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/migration.html). ## Herunterladen der lokalen Version von DynamoDB Gehen Sie wie folgt vor, um DynamoDB einzurichten und auf Ihrem Computer auszuführen. **So richten Sie DynamoDB auf dem Computer ein** 1. Laden Sie die lokale Version von DynamoDB kostenlos von einem der folgenden Speicherorte herunter. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocal.DownloadingAndRunning.html) **Wichtig** Um DynamoDB v2.6.0 oder höher auf Ihrem Computer ausführen zu können, benötigen Sie die Java Runtime Environment (JRE) Version 17.x oder neuer. Die Anwendung kann nicht unter früheren JRE-Versionen ausgeführt werden. 1. Nachdem Sie das Archiv heruntergeladen haben, extrahieren Sie die Inhalte und kopieren Sie das entpackte Verzeichnis an einen Speicherort Ihrer Wahl. 1. Zum Starten von DynamoDB auf Ihrem Computer, öffnen Sie ein Befehlszeilenfenster, gehen Sie zu dem Verzeichnis, in das Sie `DynamoDBLocal.jar` extrahiert haben, und geben Sie den folgenden Befehl ein. ``` java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -sharedDb ``` **Anmerkung** Wenn Sie Windows verwenden, achten Sie darauf PowerShell, den Parameternamen oder den gesamten Namen und Wert wie folgt einzuschließen: ` java -D"java.library.path=./DynamoDBLocal_lib" -jar DynamoDBLocal.jar ` DynamoDB verarbeitet eingehende Anforderungen, bis Sie den Service beenden. Zum Beenden von DynamoDB geben Sie Strg\$1C in die Befehlszeile ein. DynamoDB verwendet standardmäßig Port 8000. Wenn Port 8000 nicht verfügbar ist, wird eine Ausnahme ausgelöst. Um eine vollständige Liste der DynamoDB-Laufzeitoptionen, einschließlich `-port`, zu erhalten, geben Sie folgenden Befehl ein. ` java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -help ` 1. Bevor Sie programmgesteuert oder über die AWS Command Line Interface (AWS CLI) auf DynamoDB zugreifen können, müssen Sie die Anmeldeinformationen so konfigurieren, dass die Autorisierung für die Anwendungen aktiviert wird. Die herunterladbare Version von DynamoDB benötigt Anmeldeinformationen, um arbeiten zu können, wie in dem folgenden Beispiel gezeigt. ``` AWS Access Key ID: "fakeMyKeyId" AWS Secret Access Key: "fakeSecretAccessKey" Default Region Name: "fakeRegion" ``` Sie können die Anmeldeinformationen mit dem  AWS CLI -Befehl `aws configure` einrichten. Weitere Informationen finden Sie unter [Mit dem AWS CLI](AccessingDynamoDB.md#Tools.CLI). 1. Beginnen Sie mit dem Schreiben von Anwendungen. Verwenden Sie den Parameter, um auf DynamoDB zuzugreifen AWS CLI, das lokal mit dem ausgeführt wird`--endpoint-url `. Sie können z. B. den folgenden Befehl verwenden, um DynamoDB-Tabellen aufzulisten. ``` aws dynamodb list-tables --endpoint-url http://localhost:8000 ``` ## Ausführen der lokalen Version von DynamoDB als Docker-Image Die herunterladbare Version von Amazon DynamoDB ist als Docker-Image verfügbar. Weitere Informationen finden Sie unter [dynamodb-local](https://hub.docker.com/r/amazon/dynamodb-local). Geben Sie folgenden Befehl ein, um Ihre aktuelle lokale Version von DynamoDB zu sehen: ``` java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -version ``` Ein Beispiel für die Verwendung von DynamoDB local als Teil einer REST-Anwendung, die auf der AWS Serverless Application Model (AWS SAM) aufbaut, finden Sie unter [SAM DynamoDB-Anwendung](https://github.com/aws-samples/aws-sam-java-rest) zur Verwaltung von Bestellungen. Diese Beispielanwendung demonstriert die Verwendung der lokalen Version von DynamoDB für Testzwecke. Wenn Sie eine Anwendung mit mehreren Containern ausführen möchten, die auch den lokalen DynamoDB-Container nutzt, verwenden Sie Docker Compose, um alle Services in Ihrer Anwendung zu definieren und auszuführen, einschließlich DynamoDB lokal. **So gehen Sie vor, um DynamoDB zu installieren und lokal auszuführen:** 1. Führen Sie Download und Installation von [Docker Desktop](https://www.docker.com/products/docker-desktop) durch. 1. Kopieren Sie den folgenden Code in eine Datei, und speichern Sie ihn unter `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 ``` Wenn sich Ihre Anwendung und DynamoDB lokal in separaten Containern befinden sollen, verwenden Sie die folgende YAML-Datei: ``` 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 ``` Dieses docker-compose.yml-Skript erstellt einen `app-node`-Container und einen `dynamodb-local`-Container. Das Skript führt einen Befehl im Container `app-node` aus, der mithilfe der AWS CLI eine Verbindung mit dem `dynamodb-local`-Container herstellt und die Konten- und Tabellenlimits beschreibt. Wenn Sie diesen Vorgang bei Ihrem eigenen Anwendungsimage verwenden möchten, ersetzen Sie den Wert `image` im folgenden Beispiel durch den Wert Ihrer Anwendung. ``` 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' ``` **Anmerkung** Die YAML-Skripts erfordern, dass Sie einen AWS Zugriffsschlüssel und einen AWS geheimen Schlüssel angeben, aber es müssen keine gültigen AWS Schlüssel sein, damit Sie lokal auf DynamoDB zugreifen können. 1. Führen Sie die folgende Befehlzeilen-Befehle aus: ``` docker-compose up ``` ## Ausführen der lokalen Version von DynamoDB als Apache Maven-Abhängigkeit **Anmerkung** Wenn Sie eine Anwendung zum SDK für Java 2.x migrieren, die das SDK für Java v1.x verwendet, folgen Sie den Schritten unter [AWS -SDK für Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/migration.html). Führen Sie die folgenden Schritte aus, um Amazon DynamoDB in Ihrer Anwendung als Abhängigkeit zu verwenden. **So stellen Sie DynamoDB als Apache-Maven-Repository bereit** 1. Laden Sie Apache Maven herunter und installieren Sie es. Weitere Informationen finden Sie unter [Downloading Apache Maven](https://maven.apache.org/download.cgi) und [Installing Apache Maven](https://maven.apache.org/install.html). 1. Fügen Sie das DynamoDB-Maven-Repository zur POM-Datei (Project Object Model) Ihrer Anwendung hinzu. ``` software.amazon.dynamodb DynamoDBLocal 3.3.0 ``` Beispielvorlage zur Verwendung mit Spring Boot 3 and/or Spring Framework 6: ``` 4.0.0 org.example SpringMavenDynamoDB 1.0-SNAPSHOT 3.0.1 17 17 UTF-8 org.springframework.boot spring-boot-starter-parent 3.1.0 software.amazon.dynamodb DynamoDBLocal 3.3.0 org.springframework.boot spring-boot-starter ${spring-boot.version} org.springframework.boot spring-boot-starter-web ${spring-boot.version} org.springframework.boot spring-boot-starter-data-jpa ${spring-boot.version} org.springframework spring-context 6.0.0 org.springframework spring-core 6.0.0 ``` **Anmerkung** Sie können auch die URL des [Maven Central Repository](https://mvnrepository.com/artifact/com.amazonaws/DynamoDBLocal?repo=dynamodb-local-release) verwenden. ## Führen Sie DynamoDB lokal aus in AWS CloudShell AWS CloudShell ist eine browserbasierte, vorauthentifizierte Shell, die Sie direkt von der aus starten können. AWS-Managementkonsole Sie können auf verschiedene Arten AWS CloudShell zu ihr navigieren. AWS-Managementkonsole Weitere Informationen finden Sie unter [Erste Schritte mit AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/getting-started.html). Gehen Sie wie folgt vor, um DynamoDB lokal an Ihrem AWS CloudShell beliebigen Ort in der auszuführen. AWS-Managementkonsole **Um DynamoDB lokal in Ihrem AWS CloudShell auszuführen AWS-Managementkonsole** 1. Starten Sie AWS CloudShell von der Konsolenoberfläche aus, wählen Sie eine verfügbare AWS-Region aus und wechseln Sie zu Ihrer bevorzugten Shell, z. B. Bash oder PowerShell Z-Shell. 1. Um eine auszuwählen AWS-Region, gehen **Sie zum Menü „Region auswählen**“ und wählen Sie eine [unterstützte AWS-Region](https://docs.aws.amazon.com/cloudshell/latest/userguide/supported-aws-regions.html) aus. (Verfügbare Regionen sind hervorgehoben.) 1. Starten Sie von der aus AWS-Managementkonsole, AWS CloudShell indem Sie eine der folgenden Optionen wählen: 1. Klicken Sie in der Navigationsleiste auf das **AWS CloudShell**-Symbol. 1. Geben Sie das Wort in das **Suchfeld** ein CloudShell, und wählen Sie dann **CloudShell**. 1. Wählen Sie im Widget „**Zuletzt besucht**“ **CloudShell**. 1. Wählen Sie in der Werkzeugleiste der Konsole **CloudShell**. 1. Um DynamoDB lokal in auszuführen, können AWS CloudShell Sie den `dynamodb-local` Alias verwenden. Sie können zusätzliche Befehlszeilenoptionen zum Ändern der Einstellungen Ihrer lokalen Version von DynamoDB angeben. Die verfügbaren Optionen finden Sie unter [DynamoDB-Local-Nutzungshinweise](DynamoDBLocal.UsageNotes.md). **Anmerkung** Um DynamoDB local im Hintergrund auszuführen, führen Sie DynamoDB local mit: aus. AWS CloudShell `dynamodb-local &` 1. Verwenden Sie den Parameter, um auf DynamoDB zuzugreifen AWS CLI, das lokal AWS CloudShell mit dem ausgeführt wird`--endpoint-url`. Sie können z. B. den folgenden Befehl verwenden, um DynamoDB-Tabellen aufzulisten: `aws dynamodb list-tables --endpoint-url http://localhost:8000` Ein Beispielprojekt, das verschiedene Ansätze zur Einrichtung und Nutzung der lokalen Version von DynamoDB zeigt – darunter das Herunterladen von JAR-Dateien, die Ausführung als Docker-Image und die Einbindung als Maven-Abhängigkeit – finden Sie unter [Java-Beispielprojekt für die lokale Version von DynamoDB](https://github.com/awslabs/amazon-dynamodb-local-samples/tree/main). # DynamoDB-Local-Nutzungshinweise Mit Ausnahme des Endpunkts sollten Anwendungen, die mit der herunterladbaren Version von Amazon DynamoDB ausgeführt werden, auch mit dem DynamoDB-Webservice funktionieren. Bei der lokalen Verwendung von DynamoDB sollten Sie allerdings Folgendes beachten: + *Wenn Sie die `-sharedDb` Option verwenden, erstellt DynamoDB eine einzelne Datenbankdatei mit dem Namen shared-local-instance .db.* Jedes Programm, das eine Verbindung mit DynamoDB herstellt, greift auf diese Datei zu. Wenn Sie die Datei löschen, gehen alle darin gespeicherten Daten verloren. + Wenn Sie diese Option weglassen`-sharedDb`, erhält die Datenbankdatei den Namen *myaccesskeyid\$1region.db* mit der AWS Zugriffsschlüssel-ID und AWS Region, wie sie in Ihrer Anwendungskonfiguration erscheinen. Wenn Sie die Datei löschen, gehen alle darin gespeicherten Daten verloren. + Bei Verwendung der `-inMemory`-Option schreibt DynamoDB keine Datenbankdateien. Stattdessen werden alle Daten im Arbeitsspeicher abgelegt und beim Beenden von DynamoDB nicht gespeichert. + Wenn Sie die `-inMemory`-Option verwenden, ist die `-sharedDb`-Option ebenfalls erforderlich. + Bei Verwendung der Option `-optimizeDbBeforeStartup` müssen Sie auch den `-dbPath`-Parameter angeben, damit DynamoDB die entsprechende Datenbankdatei finden kann. + Die AWS SDKs für DynamoDB erfordern, dass Ihre Anwendungskonfiguration einen Zugriffsschlüsselwert und einen AWS Regionswert angibt. DynamoDB verwendet diese Werte, um die lokale Datenbankdatei zu benennen, sofern Sie nicht die Option `-sharedDb` oder `-inMemory` verwenden. Diese Werte müssen keine gültigen AWS Werte sein, um lokal ausgeführt zu werden. Möglicherweise ist es jedoch komfortabler, gültige Werte zu verwenden, damit Sie Ihren Code später in der Cloud ausführen können, indem Sie den verwendeten Endpunkt ändern. + Die lokale Version von DynamoDB gibt für `billingModeSummary.` immer null zurück + Die lokale Version von DynamoDB `AWS_ACCESS_KEY_ID` kann nur Buchstaben (A–Z, a–z) und Zahlen (0–9) enthalten. + DynamoDB local unterstützt keine [Point-in-time Wiederherstellung (PITR](Point-in-time-recovery.md)). **Topics** + [Befehlszeilenoptionen](#DynamoDBLocal.CommandLineOptions) + [Festlegen des lokalen Endpunkts](#DynamoDBLocal.Endpoint) + [Unterschiede zwischen der herunterladbaren Version von DynamoDB und dem DynamoDB-Webservice](#DynamoDBLocal.Differences) ## Befehlszeilenoptionen Mit der herunterladbaren Version von DynamoDB können Sie die folgenden Befehlszeilenoptionen verwenden: + `-cors``value`— Aktiviert die Unterstützung für Cross-Origin Resource Sharing (CORS) für. JavaScript Sie müssen eine durch Komma getrennte Liste zum Zulassen spezifischer Domänen bereitstellen. Die Standardeinstellung für `-cors` ist ein Stern (\$1), der öffentlichen Zugriff zulässt. + `-dbPath` `value` – Das Verzeichnis, in das DynamoDB seine Datenbankdatei schreibt. Wenn Sie diese Option nicht angeben, wird die Datei in das aktuelle Verzeichnis geschrieben. Sie können nicht `-dbPath` und `-inMemory` gleichzeitig angeben. + `-delayTransientStatuses` – Veranlasst DynamoDB, Verzögerungen für bestimmte Operationen einzuführen. DynamoDB (herunterladbare Version) kann einige Aufgaben fast sofort ausführen, z. B. create/update/delete Operationen an Tabellen und Indizes. Der Service DynamoDB benötigt für diese Aufgaben jedoch mehr Zeit. Durch Festlegen dieses Parameters kann DynamoDB bei Ausführung auf einem Computer das Verhalten des DynamoDB-Webservices besser simulieren. (Gegenwärtig führt dieser Parameter Verzögerungen nur für globale sekundäre Indizes mit dem Status *CREATING* oder *DELETING* ein.) + `-help` – Druckt eine Nutzungszusammenfassung sowie Optionen. + `-inMemory` – DynamoDB wird im Speicher anstatt mit einer Datenbankdatei ausgeführt. Wenn Sie DynamoDB beenden, werden keine Daten gespeichert. Sie können nicht `-dbPath` und `-inMemory` gleichzeitig angeben. + `-optimizeDbBeforeStartup` – Optimiert die zugrunde liegenden Datenbanktabellen vor dem Start von DynamoDB auf Ihrem Computer. Wenn Sie diesen Parameter verwenden, müssen Sie außerdem `-dbPath` angeben. + `-port` `value` – Die Portnummer, die DynamoDB für die Kommunikation mit Ihrer Anwendung verwendet. Wenn Sie diese Option nicht angeben, lautet der Standardport `8000`. **Anmerkung** DynamoDB verwendet standardmäßig Port 8000. Wenn Port 8000 nicht verfügbar ist, wird eine Ausnahme ausgelöst. Mit der Option `-port` können Sie eine andere Portnummer angeben. Um eine vollständige Liste der DynamoDB-Laufzeitoptionen, einschließlich `-port`, zu erhalten, geben Sie folgenden Befehl ein: `java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -help` + `-sharedDb` – `-sharedDb` DynamoDB verwendet eine einzige Datenbankdatei anstatt separater Dateien für jede Anmeldeinformation und Region. + `-disableTelemetry`: Wenn dies angegeben ist, sendet die lokale Version von DynamoDB keine Telemetrie. + `-version` – Zeigt die Version der lokalen Version von DynamoDB. ## Festlegen des lokalen Endpunkts Standardmäßig verwenden die Tools AWS SDKs und Endpunkte für den Amazon DynamoDB DynamoDB-Webservice. Um die Tools SDKs und mit der herunterladbaren Version von DynamoDB zu verwenden, müssen Sie den lokalen Endpunkt angeben: `http://localhost:8000` ### AWS Command Line Interface Sie können die AWS Command Line Interface (AWS CLI) verwenden, um mit herunterladbarem DynamoDB zu interagieren. Verwenden Sie den `--endpoint-url`-Parameter , um auf die lokal ausgeführte DynamoDB-Version zuzugreifen. Im Folgenden finden Sie ein Beispiel für die Verwendung von AWS CLI , um die Tabellen in DynamoDB auf Ihrem Computer aufzulisten. ``` aws dynamodb list-tables --endpoint-url http://localhost:8000 ``` **Anmerkung** Die herunterladbare Version von DynamoDB AWS CLI kann nicht als Standardendpunkt verwendet werden. Daher müssen Sie `--endpoint-url` bei jedem AWS CLI Befehl angeben. ### AWS SDKs Die Art und Weise, wie Sie einen Endpunkt angeben, hängt davon ab, welche Programmiersprache und welches AWS -SDK Sie verwenden. In den folgenden Abschnitten wird die entsprechende Vorgehensweise beschrieben: + [Java: AWS Region und Endpunkt festlegen](CodeSamples.Java.md#CodeSamples.Java.RegionAndEndpoint)(DynamoDB local unterstützt das AWS SDK for Java V1 und V2) + CodeSamples.Java. RegionAndEndpoint [.NET: AWS Region und Endpunkt festlegen](CodeSamples.DotNet.md#CodeSamples.DotNet.RegionAndEndpoint) ## Unterschiede zwischen der herunterladbaren Version von DynamoDB und dem DynamoDB-Webservice Die herunterladbare Version von DynamoDB ist nur für Zwecke der Anwendungsentwicklung und Tests vorgesehen. Der DynamoDB-Webservice hingegen ist ein verwalteter Service mit Skalierbarkeits-, Verfügbarkeits- und Haltbarkeitsfunktionen, die ideal für den Einsatz in der Produktion geeignet sind. Die herunterladbare Version von DynamoDB unterscheidet sich folgendermaßen vom Webservice: + AWS-Regionen und distinct AWS-Konten werden auf Client-Ebene nicht unterstützt. + Einstellungen für den bereitgestellten Durchsatz werden in der herunterladbaren Version von DynamoDB ignoriert, auch wenn die `CreateTable`-Operation diese benötigt. Für `CreateTable` können Sie beliebige Zahlen für den bereitgestellten Lese- und Schreibdurchsatz angeben, auch wenn diese Zahlen nicht verwendet werden. Sie können `UpdateTable` beliebig oft pro Tag aufrufen. Alle Änderungen an Werten des bereitgestellten Durchsatzes werden jedoch ignoriert. + `Scan`-Operationen werden sequenziell durchgeführt. Parallele Scans werden nicht unterstützt. Die Parameter `Segment` und `TotalSegments` der `Scan`-Operation werden ignoriert. + Die Geschwindigkeit der Lese- und Schreibvorgänge in den Tabellendaten ist nur durch die Geschwindigkeit des Computers begrenzt. Die Vorgänge `CreateTable`, `UpdateTable` und `DeleteTable` werden umgehend ausgeführt und der Tabellenstatus ist jederzeit ACTIVE. `UpdateTable`-Vorgänge, die nur die Einstellungen zum bereitgestellten Durchsatz für Tabellen oder globale sekundäre Indizes ändern, werden umgehend ausgeführt. Wenn eine `UpdateTable`-Operation globale sekundäre Indizes erstellt oder löscht, durchlaufen diese Indizes die normalen Status (wie CREATING bzw. DELETING), bevor sie in den Status ACTIVE übergehen. Die Tabelle bleibt während dieser Zeit im Status ACTIVE. + Leseoperationen sind Eventually Consistent. Aufgrund der Geschwindigkeit, mit der die lokale Version von DynamoDB auf Ihrem Computer ausgeführt wird, sind die meisten Lesevorgänge allerdings tatsächlich vom Typ „Strongly Consistent”. + Elementauflistungsmetriken und Elementauflistungsgrößen werden nicht nachverfolgt. In Operationsantworten werden anstelle der Elementauflistungsmetriken Nullen zurückgegeben. + In DynamoDB gibt es für Daten, die pro Ergebnissatz zurückgegeben werden, ein Limit von 1 MB. Sowohl der DynamoDB-Webservice als auch die herunterladbare Version setzen dieses Limit durch. Beim Abfragen eines Indexes berechnet der DynamoDB-Service jedoch nur die Größe des projizierten Schlüssels und der Attribute. Im Gegensatz dazu berechnet die herunterladbare Version von DynamoDB die Größe des gesamten Elements. + Bei der Verwendung von DynamoDB Streams kann die Rate, mit der Shards erstellt werden, abweichen. Im DynamoDB-Webservice wird die Shard-Erstellung teilweise von Aktivitäten der Tabellenpartition beeinflusst. Wenn Sie DynamoDB lokal ausführen, gibt es keine Tabellenpartitionierung. In beiden Fällen sind Shards flüchtig, sodass Ihre Anwendung nicht vom Shard-Verhalten abhängt. + `TransactionConflictExceptions`werden nicht von herunterladbarem DynamoDB für Transaktionen ausgelöst. APIs Wir empfehlen die Verwendung eines Java-Mocking-Frameworks für die Simulation von `TransactionConflictExceptions` im DynamoDB-Handler, um zu prüfen, wie Ihre Anwendung auf miteinander in Konflikt stehende Transaktionen reagiert. + Im DynamoDB-Webdienst wird zwischen Groß- und Kleinschreibung unterschieden, unabhängig davon, ob auf Tabellennamen über die AWS CLI Konsole oder über zugegriffen wird. Eine Tabelle mit dem Namen `Authors` und eine mit dem Namen `authors` können als separate Tabellen vorhanden sein. In der Downloadversion muss bei Tabellennamen die Groß-/Kleinschreibung beachtet werden. Ein Versuch, diese beiden Tabellen zu erstellen, würde einen Fehler verursachen. + Tagging wird in der herunterladbaren Version von DynamoDB nicht unterstützt. + Die herunterladbare Version von DynamoDB ignoriert den [Limit-Parameter](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ExecuteStatement.html#DDB-ExecuteStatement-request-Limit) in. [ExecuteStatement](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ExecuteStatement.html) # Versionsverlauf für die lokale Version von DynamoDB In der folgenden Tabelle sind wichtige Änderungen in jeder Version von *der lokalen Version von DynamoDB* beschrieben. **** | Version | Änderungen | Beschreibung | Date | | --- | --- | --- | --- | | 3.3.0 | Unterstützung für Schlüssel mit mehreren Attributen für globale Sekundärindizes hinzufügen | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 19. Januar 2026 | | 3.2.0 | Kompatibilitätsprobleme mit mehreren Kotlin-Versionen wurden behoben | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 09. Januar 2026 | | 3.1.0 | Verbesserung der Leistung von PartiQL-Abfragen, Einbeziehung der Joda-Zeitabhängigkeit | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 14. September 2025 | | 3.0.0 | Migration von AWS SDK Java V1 zu V2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 17. Juli 2025 | | 2.6.0 | Support Tabellen-ARN als Tabellennamen in DynamoDB APIs Leistungsverbesserungen und Sicherheitsupdates | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 13. März 2025 | | 2.5.4 | Aktualisierung von Jetty-Abhängigkeiten | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 12. Dezember 2024 | | 2.5.3 | Aktualisierung von Jackson-Abhängigkeiten auf 2.17.x in Log4j Core (Behebung der Schwachstelle CVE-2022-1471) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 6. November 2024 | | 2.5.2 | Bugfix für den Workflow „Tabelle aktualisieren“ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 20. Juni 2024 | | 2.5.1 | Patch für mit der OndemandThroughPut-Feature eingeführte Fehler | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 5. Juni 2024 | | 2.5.0 | Unterstützung des konfigurierbaren maximalen Durchsatzes für On-Demand-Tabellen, `ReturnValuesOnConditionCheckFailure`, `BatchExecuteStatement` und `ExecuteTransactionRequest` | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 28. Mai 2024 | | 2.4.0 | Unterstützung von `ReturnValuesOnConditionCheckFailure` – Embedded-Modus | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 17. April 2024 | | 2.3.0 | Aktualisierung von Jetty und JDK | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 14. März 2024 | | 2.2.0 | Löschschutz für Tabellen und Parameter `ReturnValuesOnConditionCheckFailure` hinzugefügt | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 14. Dezember 2023 | | 2.1.0 | Support für SQLLite native Bibliotheken für Maven-Projekte und Hinzufügen von Telemetrie | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 23. Oktober 2023 | | 2.0.0 | Migration von Javax zu Jakarta Namespace und Support JDK11 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 5. Juli 2023 | | 1.25.1 | Aktualisierung von Jackson-Abhängigkeiten auf 2.17.x in Log4j Core (Behebung der Schwachstelle CVE-2022-1471) | Aktualisierung der Jackson-Abhängigkeiten auf 2.17.x in Log4j Core (Behebung der Schwachstelle CVE-2022-1471), um eine kritische Schwachstelle in der SnakeYAML-Bibliothek zu schließen, bei der es sich um eine transitive Abhängigkeit handelt | 6. November 2024 | | 1.25.0 | Löschschutz für Tabellen und Parameter `ReturnValuesOnConditionCheckFailure` hinzugefügt | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 18. Dezember 2023 | | 1.24.0 | Support für SQLLite native Bibliotheken für Maven-Projekte und Hinzufügen von Telemetrie | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 23. Oktober 2023 | | 1.23.0 | Umgang mit ungültigen Zugriffs- und Geheimschlüsseln beim Serverstart | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 28. Juni 2023 | | 1.22.0 | Unterstützung von Limit-Operation für PartiQL | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 08. Juni 2023 | | 1.21.0 | Unterstützung für 100 Aktionen pro Transaktion | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 26. Januar 2023 | | 1.20.0 | Unterstützung für M1 Mac hinzugefügt | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 12. September 2022 | | 1.19.0 | PartiQL-Parser aktualisiert | PartiQL-Parser und andere verwandte Bibliotheken aktualisiert | 27. Juli 2022 | | 1.18.0 | log4j-Core und Jackson-Core aktualisiert | log4j-Core auf 2.17.1 und Jackson-Core 2.10.x auf 2.12.0 aktualisiert | 10. Januar 2022 | | 1.17.2 | log4j-Core aktualisiert | log4j-Core-Abhängigkeit auf Version 2.16 aktualisiert | 16. Januar 2021 | | 1.17.1 | log4j-Core aktualisiert | log4j-core-Abhängigkeit aktualisiert, um den Zero-Day-Exploit zu patchen und die Ausführung von Code aus der Ferne zu verhindern – Log4Shel | 10. Januar 2021 | | 1.17.0 | Veraltete Javascript-Web-Shell | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 08. Januar 2021 | # Telemetrie in der lokalen Version von DynamoDB Bei AWS entwickeln und lancieren wir Dienstleistungen auf der Grundlage dessen, was wir aus Interaktionen mit Kunden lernen, und wir nutzen Kundenfeedback, um unsere Produkte zu verbessern. Bei Telemetrie handelt es sich um zusätzliche Informationen, die uns dabei helfen, die Anforderungen unserer Kunden besser zu verstehen, Probleme zu diagnostizieren und Features bereitzustellen, mit denen das Erlebnis unserer Kunden verbessert wird. Die lokale Version von DynamoDB erfasst Telemetriedaten, z. B. allgemeine Nutzungsmetriken, System- und Umgebungsinformationen sowie Fehler. Einzelheiten zu der Art der erfassten Telemetrie finden Sie unter [Arten von erfassten Informationen](#DynamoDBLocalTelemetry.TypesOfInformationCollected). Die lokale Version von DynamoDB erfasst keine personenbezogenen Daten wie Benutzernamen oder E-Mail-Adressen. Außerdem werden keine sensiblen Informationen auf Projektebene extrahiert. Als Kunde haben Sie die Kontrolle darüber, ob die Telemetrie aktiviert ist, und Sie können Ihre Einstellungen jederzeit ändern. Wenn die Telemetrie aktiviert bleibt, sendet die lokale Version von DynamoDB Telemetriedaten im Hintergrund, ohne dass eine zusätzliche Kundeninteraktion erforderlich ist. ## Telemetrie mithilfe von Befehlszeilenoptionen ausschalten Sie können Telemetrie beim Start der lokalen Version von DynamoDB mit der Option `-disableTelemetry` mithilfe von Befehlszeilenoptionen deaktivieren. Weitere Informationen finden Sie unter [Befehlszeilenoptionen](DynamoDBLocal.UsageNotes.md#DynamoDBLocal.CommandLineOptions). ## Telemetrie für eine einzelne Sitzung ausschalten In macOS- und Linux-Betriebssystemen können Sie die Telemetrie für eine einzelne Sitzung ausschalten. Um die Telemetrie für Ihre aktuelle Sitzung zu deaktivieren, führen Sie den folgenden Befehl aus, um die Umgebungsvariable `DDB_LOCAL_TELEMETRY` auf `false` festzulegen. Wiederholen Sie den Befehl für jedes neue Terminal oder jede neue Sitzung. ``` export DDB_LOCAL_TELEMETRY=0 ``` ## Telemetrie für Ihr Profil in allen Sitzungen ausschalten Führen Sie die folgenden Befehle aus, um die Telemetrie für alle Sitzungen zu deaktivieren, wenn Sie die lokale Version von DynamoDB auf Ihrem Betriebssystem ausführen. **Aktivieren von Telemetrie unter Linux** 1. Führen Sie Folgendes aus: ``` echo "export DDB_LOCAL_TELEMETRY=0" >>~/.profile ``` 1. Führen Sie Folgendes aus: ``` source ~/.profile ``` **Aktivieren von Telemetrie unter macOS** 1. Führen Sie Folgendes aus: ``` echo "export DDB_LOCAL_TELEMETRY=0" >>~/.profile ``` 1. Führen Sie Folgendes aus: ``` source ~/.profile ``` **Aktivieren von Telemetrie unter Windows** 1. Führen Sie Folgendes aus: ``` setx DDB_LOCAL_TELEMETRY 0 ``` 1. Führen Sie Folgendes aus: ``` refreshenv ``` ## Deaktivieren der Telemetrie mithilfe der lokalen eingebetteten Version von DynamoDB in Maven-Projekten Sie können die Telemetrie mithilfe der lokalen eingebetteten Version von DynamoDB in Maven-Projekten deaktivieren. ``` boolean disableTelemetry = true; // AWS SDK v1 AmazonDynamoDB amazonDynamoDB = DynamoDBEmbedded.create(disableTelemetry).amazonDynamoDB(); // AWS SDK v2 DynamoDbClient ddbClientSDKv2Local = DynamoDBEmbedded.create(disableTelemetry).dynamoDbClient(); ``` ## Arten von erfassten Informationen + **Nutzungsinformationen** — Die generische Telemetrie wie Server start/stop und die API oder Operation werden aufgerufen. + **System- und Umgebungsinformationen**: Die Java-Version, das Betriebssystem (Windows, Linux oder macOS), die Umgebung, in der die lokale Version von DynamoDB ausgeführt wird (z. B. eigenständiges JAR, Docker-Container oder als Maven-Abhängigkeit), und Hashwerte von Nutzungsattributen. ## Weitere Informationen Die Telemetriedaten, die DynamoDB local sammelt, entsprechen den AWS Datenschutzrichtlinien. Weitere Informationen finden Sie hier: + [AWS Nutzungsbedingungen](https://aws.amazon.com/service-terms/) + [Häufig gestellte Fragen zum Datenschutz](https://aws.amazon.com/compliance/data-privacy-faq/)