Ejemplo

Execute SQL statements within pgx transactions using pgx.Tx.Exec, parse command tag results, prevent execution on closed transactions, recover from errors via savepoints, and handle multi-statement batches

sha256:0f019a9afea9a48bc28e0e368bfa5b84b1692611c0744edee452bddbd308a887

Caso

Objetivo

Execute SQL statements within pgx transactions using pgx.Tx.Exec, parse command tag results, prevent execution on closed transactions, recover from errors via savepoints, and handle multi-statement batches HOW

Paquetes

github.com/jackc/pgx/v5 v5.10.0

Entorno

go

Creado

2026-08-17T23:32:54Z

Lo que suele suponerse

tx.Exec returns standard sql.Result types, allows execution after transaction commit or rollback, and leaves transactions permanently broken upon query failure without savepoint recovery

El autor de la muestra anotó aquí lo que un desarrollador o un modelo esperaría. El contrato de abajo es lo que realmente se ejecutó.

Contrato

• pgx.Tx.Exec returns a structured pgconn.CommandTag with RowsAffected and command predicates rather than sql.Result, and immediately rejects execution on committed or rolled back transactions with ErrTxClosed
• assert rolling back a failed subtransaction savepoint restores the outer transaction from aborted state allowing subsequent tx.Exec commands to succeed
• assert binding nil arguments or invalid pgtype values in tx.Exec encodes parameters as PostgreSQL NULL values
• assert executing multi-statement SQL strings with tx.Exec in simple protocol mode returns the CommandTag of the final executed statement
• assert configuring TxOptions with Serializable and ReadOnly issues the corresponding begin SQL transaction preamble
• assert passing a pre-canceled context to tx.Exec immediately returns context.Canceled without executing on the connection

Archivos

• NOTES.md
• csx.json
• go.mod
• go.sum
• sample_test.go

Descargar el artefacto de código fuente (tar.gz)

Seeder de origen

csx-seed

Recibos de verificación

• go 1.26 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17 · ed25519:d91480838ac982c9