Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.

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
<a name="cli_2_rds-data_code_examples"></a>

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 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 Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.

**Topics**
+ [Aktionen](#actions)

## Aktionen
<a name="actions"></a>

### `batch-execute-statement`
<a name="rds-data_BatchExecuteStatement_cli_2_topic"></a>

Das folgende Codebeispiel zeigt, wie Sie`batch-execute-statement`.

**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](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) im *Benutzerhandbuch für Amazon RDS*.  
+  Einzelheiten zur API finden Sie [BatchExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/batch-execute-statement.html)in der *AWS CLI Befehlsreferenz*. 

### `begin-transaction`
<a name="rds-data_BeginTransaction_cli_2_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung`begin-transaction`.

**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](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) im *Benutzerhandbuch für Amazon RDS*.  
+  Einzelheiten zur API finden Sie [BeginTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/begin-transaction.html)in der *AWS CLI Befehlsreferenz*. 

### `commit-transaction`
<a name="rds-data_CommitTransaction_cli_2_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung`commit-transaction`.

**AWS CLI**  
**So übergeben Sie eine SQL-Transaktion**  
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](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) im *Benutzerhandbuch für Amazon RDS*.  
+  Einzelheiten zur API finden Sie [CommitTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/commit-transaction.html)in der *AWS CLI Befehlsreferenz*. 

### `execute-statement`
<a name="rds-data_ExecuteStatement_cli_2_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung`execute-statement`.

**AWS CLI**  
**Beispiel 1: So führen Sie eine SQL-Anweisung aus, 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: 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](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) im *Benutzerhandbuch für Amazon RDS*.  
+  Einzelheiten zur API finden Sie [ExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/execute-statement.html)in der *AWS CLI Befehlsreferenz*. 

### `rollback-transaction`
<a name="rds-data_RollbackTransaction_cli_2_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung`rollback-transaction`.

**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](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) im *Benutzerhandbuch für Amazon RDS*.  
+  Einzelheiten zur API finden Sie [RollbackTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/rollback-transaction.html)in der *AWS CLI Befehlsreferenz*.