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 | | --- | --- | --- | | [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) | Exécute une instruction SQL sur une base de données. | | [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) | 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 | | --- | --- | --- | | [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) | Démarre une transaction SQL. | | [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) | Termine une transaction SQL et valide les modifications. | | [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) | Restaure une transaction. | Les opérations permettant d'exécuter des instructions SQL et de prendre en charge les transactions ont les paramètres et AWS CLI options communs suivants de l'API de données. Certaines opérations prennent en charge d’autres paramètres et options. **** | Paramètre d’opération d’API de données | AWS CLI option de commande | Obligatoire | Description | | --- | --- | --- | --- | | `resourceArn` | `--resource-arn` | Oui | Amazon Resource Name (ARN) du cluster de bases de données Aurora. Le cluster doit être identique Compte AWS au rôle ou à l'utilisateur IAM qui appelle 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` \$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)` 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 des paramètres dans les appels de l'API de données vers `ExecuteStatement` et`BatchExecuteStatement`, et lorsque vous exécutez les AWS CLI commandes `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 afin d'éviter de perdre en précision pour des nombres extrêmement élevés, 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 ()UUIDs. **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.