Beispiele für Amazon RDS Data Service mit AWS CLI - AWS Command Line Interface

Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von. Dokumentation zu Version 2 von finden Sie im Benutzerhandbuch für Version 2. AWS CLI

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.

Beispiele für Amazon RDS Data Service mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon RDS Data Service Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Servicefunktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien und serviceübergreifenden Beispiele sehen.

Szenarien sind Codebeispiele, die Ihnen zeigen, wie Sie eine bestimmte Aufgabe ausführen können, indem Sie mehrere Funktionen innerhalb desselben Services aufrufen.

Jedes Beispiel enthält einen Link zu GitHub, wo Sie Anweisungen zur Einrichtung und Ausführung des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungbatch-execute-statement.

AWS CLI

Um eine Batch-SQL-Anweisung auszuführen

Im folgenden batch-execute-statement Beispiel wird eine Batch-SQL-Anweisung über ein Datenarray mit einem Parametersatz ausgeführt.

aws rds-data batch-execute-statement \ --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \ --database "mydb" \ --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \ --sql "insert into mytable values (:id, :val)" \ --parameter-sets "[[{\"name\": \"id\", \"value\": {\"longValue\": 1}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueOne\"}}], [{\"name\": \"id\", \"value\": {\"longValue\": 2}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueTwo\"}}], [{\"name\": \"id\", \"value\": {\"longValue\": 3}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueThree\"}}]]"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden der Daten-API für Aurora Serverless im Amazon RDS-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungbegin-transaction.

AWS CLI

Um eine SQL-Transaktion zu starten

Das folgende begin-transaction Beispiel startet eine SQL-Transaktion.

aws rds-data begin-transaction \ --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \ --database "mydb" \ --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret"

Ausgabe:

{ "transactionId": "ABC1234567890xyz" }

Weitere Informationen finden Sie unter Verwenden der Daten-API für Aurora Serverless im Amazon RDS-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungcommit-transaction.

AWS CLI

Um eine SQL-Transaktion festzuschreiben

Das folgende commit-transaction Beispiel beendet die angegebene SQL-Transaktion und überträgt die Änderungen, die Sie als Teil der Transaktion vorgenommen haben.

aws rds-data commit-transaction \ --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \ --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \ --transaction-id "ABC1234567890xyz"

Ausgabe:

{ "transactionStatus": "Transaction Committed" }

Weitere Informationen finden Sie unter Verwenden der Daten-API für Aurora Serverless im Amazon RDS-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungexecute-statement.

AWS CLI

Beispiel 1: Um eine SQL-Anweisung auszuführen, die Teil einer Transaktion ist

Im folgenden execute-statement Beispiel wird eine SQL-Anweisung ausgeführt, die Teil einer Transaktion ist.

aws rds-data execute-statement \ --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \ --database "mydb" \ --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \ --sql "update mytable set quantity=5 where id=201" \ --transaction-id "ABC1234567890xyz"

Ausgabe:

{ "numberOfRecordsUpdated": 1 }

Beispiel 2: Um eine SQL-Anweisung mit Parametern auszuführen

Im folgenden execute-statement Beispiel wird eine SQL-Anweisung mit Parametern ausgeführt.

aws rds-data execute-statement \ --resource-arn "arn:aws:rds:us-east-1:123456789012:cluster:mydbcluster" \ --database "mydb" \ --secret-arn "arn:aws:secretsmanager:us-east-1:123456789012:secret:mysecret" \ --sql "insert into mytable values (:id, :val)" \ --parameters "[{\"name\": \"id\", \"value\": {\"longValue\": 1}},{\"name\": \"val\", \"value\": {\"stringValue\": \"value1\"}}]"

Ausgabe:

{ "numberOfRecordsUpdated": 1 }

Weitere Informationen finden Sie unter Verwenden der Daten-API für Aurora Serverless im Amazon RDS-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungrollback-transaction.

AWS CLI

Um eine SQL-Transaktion rückgängig zu machen

Im folgenden rollback-transaction Beispiel wird die angegebene SQL-Transaktion rückgängig gemacht.

aws rds-data rollback-transaction \ --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \ --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \ --transaction-id "ABC1234567890xyz"

Ausgabe:

{ "transactionStatus": "Rollback Complete" }

Weitere Informationen finden Sie unter Verwenden der Daten-API für Aurora Serverless im Amazon RDS-Benutzerhandbuch.