BatchExecuteStatementRequest

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

The cluster identifier. This parameter is required when connecting to a cluster and authenticating using either Secrets Manager or temporary credentials.

The name of the database. This parameter is required when authenticating using either Secrets Manager or temporary credentials.

The database user name. This parameter is required when connecting to a cluster as a database user and authenticating using temporary credentials.

Determines how the SQL statements in the batch are run. If set to TRANSACTION (the default), all SQL statements are run as a single transaction and they are committed or rolled back together. If set to AUTO_COMMIT, each SQL statement is committed individually, and a failure of one statement does not affect the others.

The parameters for the SQL statements. The parameters are available to all SQL statements in the batch. Each statement can reference any subset of the provided parameters. Each provided parameter must be referenced by at least one SQL statement in the batch.

The data format of the result of the SQL statement. If no format is specified, the default is JSON.

The name or ARN of the secret that enables access to the database. This parameter is required when authenticating using Secrets Manager.

The session identifier of the query.

The number of seconds to keep the session alive after the query finishes. The maximum time a session can keep alive is 24 hours. After 24 hours, the session is forced closed and the query is terminated.

One or more SQL statements to run. The SQL statements run serially in the order of the array. Subsequent SQL statements don't start until the previous statement in the array completes. By default, the SQL statements are run as a single transaction. If any SQL statement fails, all work is rolled back. To change this behavior, see the ExecutionMode parameter.

The name of the SQL statements. You can name the SQL statements when you create them to identify the query.

The number of seconds to wait for all SQL statements in the batch to complete execution before returning the response. If the SQL statements do not complete within the specified time, the response returns the current status. The maximum value is 30 seconds.

A value that indicates whether to send an event to the Amazon EventBridge event bus after the SQL statements run.

The serverless workgroup name or Amazon Resource Name (ARN). This parameter is required when connecting to a serverless workgroup and authenticating using either Secrets Manager or temporary credentials.