Method new

src/sql-server-util/src/lib.rs:359–378

(client: &'a mut Client)

impl<'a> Transaction<'a> {
    async fn new(client: &'a mut Client) -> Result<Self, SqlServerError> {
        // Construct the guard *before* awaiting BEGIN to avoid a potential race where
        // transaction is started on remote, but the transaction is cancelled before returning.
        let tx = Transaction {
            client,
            closed: false,
        };
        let results = tx
            .client
            .simple_query("BEGIN TRANSACTION")
            .await
            .context("begin")?;
        if !results.is_empty() {
            Err(SqlServerError::InvariantViolated(format!(
                "expected empty result from BEGIN TRANSACTION. Got: {results:?}"
            )))
        } else {
            Ok(tx)
        }
    }

    /// Creates a savepoint via `SAVE TRANSACTION` with the provided name.
    /// Creating a savepoint forces a write to the transaction log, which will associate an