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. # Referenz zu Operationen mit der Amazon-RDS-Daten-API Die Amazon-RDS-Daten-API bietet die folgenden Operationen zur Ausführung von SQL-Anweisungen. **** | Daten-API-Operation | AWS CLI Befehl | Description | | --- | --- | --- | | [https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_ExecuteStatement.html](https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_ExecuteStatement.html) | [https://docs.aws.amazon.com/cli/latest/reference/rds-data/execute-statement.html](https://docs.aws.amazon.com/cli/latest/reference/rds-data/execute-statement.html) | Führt eine SQL-Anweisung in einer Datenbank aus. | | [https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_BatchExecuteStatement.html](https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_BatchExecuteStatement.html) | [https://docs.aws.amazon.com/cli/latest/reference/rds-data/batch-execute-statement.html](https://docs.aws.amazon.com/cli/latest/reference/rds-data/batch-execute-statement.html) | Führt eine Batch-SQL-Anweisung über ein Array von Daten für Massen-Update- und -Einfügeoperationen aus. Sie können eine DML-Anweisung (Data Manipulation Language) mit einem Array von Parametersätzen ausführen. Eine Batch-SQL-Anweisung kann gegenüber einzelnen Einfügungs- und Aktualisierungsanweisungen eine erhebliche Leistungsverbesserung bieten. | Sie können beide Vorgänge verwenden, um einzelne SQL-Anweisungen oder Transaktionen auszuführen. Für Transaktionen bietet die Daten-API die folgenden Operationen. **** | Daten-API-Operation | AWS CLI Befehl | Description | | --- | --- | --- | | [https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_BeginTransaction.html](https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_BeginTransaction.html) | [https://docs.aws.amazon.com/cli/latest/reference/rds-data/begin-transaction.html](https://docs.aws.amazon.com/cli/latest/reference/rds-data/begin-transaction.html) | Startet eine SQL-Transaktion. | | [https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_CommitTransaction.html](https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_CommitTransaction.html) | [https://docs.aws.amazon.com/cli/latest/reference/rds-data/commit-transaction.html](https://docs.aws.amazon.com/cli/latest/reference/rds-data/commit-transaction.html) | Beendet eine SQL-Transaktion und schreibt die Änderungen fest. | | [https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_RollbackTransaction.html](https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_RollbackTransaction.html) | [https://docs.aws.amazon.com/cli/latest/reference/rds-data/rollback-transaction.html](https://docs.aws.amazon.com/cli/latest/reference/rds-data/rollback-transaction.html) | Führt ein Rollback einer Transaktion durch. | Die Operationen zur Ausführung von SQL-Anweisungen und zur Unterstützung von Transaktionen haben die folgenden gemeinsamen Daten-API-Parameter und AWS CLI -Optionen. Einige Operationen unterstützen andere Parameter oder Optionen. **** | Daten-API-Operationsparameter | AWS CLI Befehlsoption | Erforderlich | Beschreibung | | --- | --- | --- | --- | | `resourceArn` | `--resource-arn` | Ja | Der Amazon-Ressourcenname (ARN) für den Aurora-DB-Cluster. Der Cluster muss sich in derselben AWS-Konto IAM-Rolle oder dem IAM-Benutzer befinden, der die Daten-API aufruft. Um auf einen Cluster in einem anderen Konto zuzugreifen, nehmen Sie eine Rolle in diesem Konto an. | | `secretArn` | `--secret-arn` | Ja | Der Name oder ARN des Secrets, das Zugriff auf das DB-Cluster ermöglicht. | Die RDS-Daten-API unterstützt die folgenden Datentypen für Aurora MySQL: + `TINYINT(1)`, `BOOLEAN`, `BOOL` + `TINYINT` + `SMALLINT` [`SIGNED` \$1 `UNSIGNED`] + `MEDIUMINT` [`SIGNED` \$1 `UNSIGNED`] + `INT` [`SIGNED` \$1 `UNSIGNED`] + `BIGINT` [`SIGNED` \$1 `UNSIGNED`] + `FLOAT` + `DOUBLE` + `VARCHAR`, `CHAR`, `TEXT`, `ENUM` + `VARBINARY`, `BINARY`, `BLOB` + `DATE`, `TIME`, `DATETIME`, `TIMESTAMP` + `DECIMAL` + `JSON` + `BIT`, `BIT(N)` Die RDS-Daten-API unterstützt die folgenden skalaren Typen für Aurora-PostgreSQL: + `BOOL` + `BYTEA` + `DATE` + `CIDR` + `DECIMAL`, `NUMERIC` + `ENUM` + `FLOAT8`, `DOUBLE PRECISION` + `INET` + `INT`, `INT4`, `SERIAL` + `INT2`, `SMALLINT`, `SMALLSERIAL` + `INT8`, `BIGINT`, `BIGSERIAL` + `JSONB`, `JSON` + `REAL`, `FLOAT` + `TEXT`, `CHAR(N)`, `VARCHAR`, `NAME` + `TIME` + `TIMESTAMP` + `UUID` + `VECTOR` Die RDS-Daten-API unterstützt die folgenden Array-Typen für Aurora PostgreSQL: + `BOOL[]`, `BIT[]` + `DATE[]` + `DECIMAL[]`, `NUMERIC[]` + `FLOAT8[]`, `DOUBLE PRECISION[]` + `INT[]`, `INT4[]` + `INT2[]` + `INT8[]`, `BIGINT[]` + `JSON[]` + `REAL[]`, `FLOAT[]` + `TEXT[]`, `CHAR(N)[]`, `VARCHAR[]`, `NAME[]` + `TIME[]` + `TIMESTAMP[]` + `UUID[]` Sie können Parameter in Daten-API-Aufrufen an `ExecuteStatement` und und verwenden`BatchExecuteStatement`, wenn Sie die AWS CLI Befehle `execute-statement` und ausführen. `batch-execute-statement` Um einen Parameter zu verwenden, geben Sie ein Name-Wert-Paar im Datentyp `SqlParameter` an. Den Wert geben Sie mit dem Datentyp `Field` an. In der folgenden Tabelle sind den Datentypen, die Sie in Daten-API-Aufrufen angeben, JDBC-Datentypen (Java Database Connectivity) zugeordnet. **** | JDBC-Datentyp | Daten-API-Datentyp | | --- | --- | | `INTEGER, TINYINT, SMALLINT, BIGINT` | `LONG` (oder `STRING`) | | `FLOAT, REAL, DOUBLE` | `DOUBLE` | | `DECIMAL` | `STRING` | | `BOOLEAN, BIT` | `BOOLEAN` | | `BLOB, BINARY, LONGVARBINARY, VARBINARY` | `BLOB` | | `CLOB` | `STRING` | | Andere Typen (einschließlich datums- und zeitbezogener Typen) | `STRING` | **Anmerkung** Sie können den Datentyp `LONG` oder `STRING` in Ihrem Daten-API-Aufruf für von der Datenbank zurückgegebene `LONG`-Werte angeben. Wir empfehlen Ihnen, dies zu tun, um zu vermeiden, dass bei extrem großen Zahlen die Genauigkeit verloren geht, was bei der Arbeit mit auftreten kann JavaScript. Bestimmte Typen, wie `DECIMAL` und `TIME`, erfordern einen Hinweis, damit die Daten-API `String`-Werte als richtigen Typ an die Datenbank weiterleitet. Um einen Hinweis zu verwenden, schließen Sie Werte für `typeHint` in den Datentyp `SqlParameter` ein. Die folgenden Werte sind für `typeHint` möglich: + `DATE` – Der entsprechende `String`-Parameter wird als Objekt des Typs `DATE` an die Datenbank gesendet. Das akzeptierte Format ist `YYYY-MM-DD`. + `DECIMAL` – Der entsprechende `String`-Parameter wird als Objekt des Typs `DECIMAL` an die Datenbank gesendet. + `JSON` – Der entsprechende `String`-Parameter wird als Objekt des Typs `JSON` an die Datenbank gesendet. + `TIME` – Der entsprechende `String`-Parameter wird als Objekt des Typs `TIME` an die Datenbank gesendet. Das akzeptierte Format ist `HH:MM:SS[.FFF]`. + `TIMESTAMP` – Der entsprechende `String`-Parameter wird als Objekt des Typs `TIMESTAMP` an die Datenbank gesendet. Das akzeptierte Format ist `YYYY-MM-DD HH:MM:SS[.FFF]`. + `UUID` – Der entsprechende `String`-Parameter wird als Objekt des Typs `UUID` an die Datenbank gesendet. **Anmerkung** Derzeit unterstützt die Daten-API keine Arrays von Universal Unique Identifiers ()UUIDs. **Anmerkung** Für Amazon Aurora PostgreSQL gibt die Daten-API immer den Aurora PostgreSQL Datentyp `TIMESTAMPTZ` in der UTC-Zeitzone zurück.