Beispiele für Amazon RDS Data Service bei der Verwendung von AWS CLI - AWS Command Line Interface
Aktionen

Beispiele für Amazon RDS Data Service bei der Verwendung von AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie das AWS Command Line Interface mit Amazon RDS Data Service nutzen.

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

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie batch-execute-statement verwendet wird.

AWS CLI

So führen Sie eine Batch-SQL-Anweisung aus

Im folgenden Beispiel für batch-execute-statement wird eine Batch-SQL-Anweisung für ein Daten-Array 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 Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie begin-transaction verwendet wird.

AWS CLI

So starten Sie eine SQL-Transaktion

Im folgenden Beispiel für begin-transaction wird eine SQL-Transaktion gestartet.

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 Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie commit-transaction verwendet wird.

AWS CLI

So übergeben Sie eine SQL-Transaktion

Im folgenden Beispiel für commit-transaction wird die angegebene SQL-Transaktion beendet und die von Ihnen als Teil der Transaktion vorgenommen Änderungen werden übergeben.

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 Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie execute-statement verwendet wird.

AWS CLI

Beispiel 1: So führen Sie eine SQL-Anweisung aus, die Teil einer Transaktion ist

Im folgenden Beispiel für execute-statement 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: So führen Sie eine SQL-Anweisung mit Parametern aus

Im folgenden Beispiel für execute-statement 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 Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie rollback-transaction verwendet wird.

AWS CLI

So machen Sie eine SQL-Transaktion rückgängig

Im folgenden Beispiel für rollback-transaction 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 Benutzerhandbuch zu Amazon RDS.