Referenz zu Amazon RDS-Daten-API-Vorgängen - 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 Amazon RDS-Daten-API-Vorgängen

Die Amazon RDS-Daten-API bietet die folgenden Operationen zur Ausführung von SQL-Anweisungen.

Daten-API-Operation

AWS CLI Befehl

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 Befehl

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.

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) des Aurora-DB-Clusters. 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 Data 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 Data API unterstützt die folgenden Aurora PostgreSQL-Skalartypen:

  • 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 Data API unterstützt die folgenden Aurora PostgreSQL-Arraytypen:

  • 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 verwendenBatchExecuteStatement, 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.

Für bestimmte Typen, wie z. B. DECIMAL undTIME, ist ein Hinweis erforderlich, damit die Daten-API String Werte als den richtigen Typ an die Datenbank weitergibt. 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.