Référence des opérations de l’API de données Amazon RDS - Amazon Aurora

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Référence des opérations de l’API de données Amazon RDS

L’API de données Amazon RDS fournit les opérations suivantes pour exécuter les instructions SQL.

Opération d’API de données

AWS CLI commande

Description

ExecuteStatement

aws rds-data execute-statement

Exécute une instruction SQL sur une base de données.

BatchExecuteStatement

aws rds-data batch-execute-statement

Exécute une instruction SQL par lots sur un tableau de données pour les opérations d’insertion et de mise à jour en bloc. Vous pouvez exécuter une instruction en langage de manipulation de données (DML) avec un tableau de jeux de paramètres. Une instruction SQL par lots peut nettement améliorer les performances sur des instructions d’insertion et de mise à jour.

Vous pouvez utiliser l’une ou l’autre des opérations pour exécuter des instructions SQL individuelles ou des transactions. Pour les transactions, l’API de données fournit les opérations suivantes.

Opération d’API de données

AWS CLI commande

Description

BeginTransaction

aws rds-data begin-transaction

Démarre une transaction SQL.

CommitTransaction

aws rds-data commit-transaction

Termine une transaction SQL et valide les modifications.

RollbackTransaction

aws rds-data rollback-transaction

Restaure une transaction.

Les opérations pour effectuer les instructions SQL et pour la prise en charge des transactions comportent les mêmes options AWS CLI et paramètres d’API de données indiqués ci-après. Certaines opérations prennent en charge d’autres paramètres et options.

Paramètre d’opération d’API de données

AWS CLIOption de la commande

Obligatoire

Description

resourceArn

--resource-arn

Oui

Amazon Resource Name (ARN) du cluster de bases de données Aurora. Le cluster doit être dans le même Compte AWS que le rôle IAM ou l’utilisateur IAM qui invoque l’API de données. Pour accéder à un cluster dans un autre compte, vous devez endosser un rôle dans ce compte.

secretArn

--secret-arn

Oui

Nom ou ARN du secret qui active l’accès au cluster de bases de données.

L’API de données RDS prend en charge les types de données suivants pour 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)

L’API de données RDS prend en charge les types scalaires Aurora PostgreSQL suivants :

  • 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

L’API de données RDS prend en charge les types de tableaux Aurora PostgreSQL suivants :

  • BOOL[], BIT[]

  • DATE[]

  • DECIMAL[], NUMERIC[]

  • FLOAT8[], DOUBLE PRECISION[]

  • INT[], INT4[]

  • INT2[]

  • INT8[], BIGINT[]

  • JSON[]

  • REAL[], FLOAT[]

  • TEXT[], CHAR(N)[], VARCHAR[], NAME[]

  • TIME[]

  • TIMESTAMP[]

  • UUID[]

Vous pouvez utiliser les paramètres dans les appels d’API de données pour ExecuteStatement et BatchExecuteStatement, et lorsque vous exécutez les commandes AWS CLI execute-statement et batch-execute-statement. Pour utiliser un paramètre, spécifiez une paire nom-valeur dans le type de données SqlParameter. Vous devez spécifier la valeur avec le type de données Field. Le tableau suivant associe les types de données Java Database Connectivity (JDBC) aux types de données que vous spécifiez dans les appels d’API de données.

Type de données JDBC

Type de données API de données

INTEGER, TINYINT, SMALLINT, BIGINT

LONG (ou STRING)

FLOAT, REAL, DOUBLE

DOUBLE

DECIMAL

STRING

BOOLEAN, BIT

BOOLEAN

BLOB, BINARY, LONGVARBINARY, VARBINARY

BLOB

CLOB

STRING

Autres types (y compris les types liés à la date et à l’heure)

STRING
Note

Vous pouvez spécifier le type de données LONG ou STRING dans votre appel d’API de données pour les valeurs LONG renvoyées par la base de données. Nous vous recommandons de le faire pour éviter de perdre en précision pour les très grands nombres, ce qui peut se produire lorsque vous travaillez avec JavaScript.

Certains types, tels que DECIMAL et TIME, nécessitent un indice pour que l’API de données transmette les valeurs String à la base de données en tant que type correct. Pour utiliser un indice, incluez des valeurs pour typeHint dans le type de données SqlParameter. Les valeurs possibles pour typeHint sont les suivantes :

  • DATE – La valeur de paramètre String correspondante est envoyée en tant qu’objet de type DATE à la base de données. Le format accepté est YYYY-MM-DD.

  • DECIMAL – La valeur de paramètre String correspondante est envoyée en tant qu’objet de type DECIMAL à la base de données.

  • JSON – La valeur de paramètre String correspondante est envoyée en tant qu’objet de type JSON à la base de données.

  • TIME – La valeur de paramètre String correspondante est envoyée en tant qu’objet de type TIME à la base de données. Le format accepté est HH:MM:SS[.FFF].

  • TIMESTAMP – La valeur de paramètre String correspondante est envoyée en tant qu’objet de type TIMESTAMP à la base de données. Le format accepté est YYYY-MM-DD HH:MM:SS[.FFF].

  • UUID – La valeur de paramètre String correspondante est envoyée en tant qu’objet de type UUID à la base de données.

    Note

    Actuellement, l’API de données ne prend pas en charge les tableaux d’identifiants uniques universels (UUID).

Note

Pour Amazon Aurora PostgreSQL, l’API de données renvoie toujours le type de données Aurora PostgreSQL TIMESTAMPTZ dans le fuseau horaire UTC.