Referenz zu Operationen mit der Amazon-RDS-Daten-API - Amazon Aurora

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 command

Beschreibung

ExecuteStatement

aws rds-data execute-statement

Führt eine SQL-Anweisung in einer Datenbank aus.

BatchExecuteStatement

aws rds-data batch-execute-statement

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 command

Beschreibung

BeginTransaction

aws rds-data begin-transaction

Startet eine SQL-Transaktion.

CommitTransaction

aws rds-data commit-transaction

Beendet eine SQL-Transaktion und schreibt die Änderungen fest.

RollbackTransaction

aws rds-data rollback-transaction

Führt ein Rollback einer Transaktion durch.

Für die Operationen zur Ausführung von SQL-Anweisungen und zur Unterstützung von Transaktionen werden die folgenden allgemeinen Daten-API-Parameter und AWS CLI-Optionen verwendet. 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 im selben AWS-Konto befinden wie die IAM-Rolle oder der Benutzer, 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 | UNSIGNED]

  • MEDIUMINT [SIGNED | UNSIGNED]

  • INT [SIGNED | UNSIGNED]

  • BIGINT [SIGNED | 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 von ExecuteStatement und BatchExecuteStatement, sowie bei Ausführung der AWS CLI-Befehle execute-statement und batch-execute-statement verwenden. 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 diese Vorgehensweise, um einen Präzisionsverlust bei extrem großen Zahlen zu vermeiden, was bei der Arbeit mit JavaScript vorkommen kann.

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.