Como usar transações explícitas¶

Para executar instruções SQL em uma transação explícita, você deve usar uma única solicitação HTTP para especificar o início, o fim e as instruções na transação. Por exemplo:

{
  "statement": "begin transaction; insert into table2 (i) values (1); commit; select i from table1 order by i",
  ...
  "parameters": {
      "MULTI_STATEMENT_COUNT": "4"
  }
  ...
}

Assim como ocorre quando você especifica instruções múltiplas em uma solicitação, se a solicitação tiver sido processada com sucesso, o Snowflake retornará uma resposta contendo o campo statementHandles, que é definido como uma array de identificadores para as instruções na solicitação (incluindo as instruções BEGIN TRANSACTION e COMMIT).

HTTP/1.1 200 OK
Content-Type: application/json

{
  "resultSetMetaData" : {
    "numRows" : 1,
    "format" : "jsonv2",
    "rowType" : [ {
      "name" : "multiple statement execution",
      "database" : "",
      "schema" : "",
      "table" : "",
      "type" : "text",
      "byteLength" : 16777216,
      "scale" : null,
      "precision" : null,
      "nullable" : false,
      "collation" : null,
      "length" : 16777216
    } ]
  },
  "data" : [ [ "Multiple statements executed successfully." ] ],
  "code" : "090001",
  "statementHandles" : [ "019d6ed0-0502-3101-0000-096d00421082", "019d6ed0-0502-3101-0000-096d00421086", "019d6ed0-0502-3101-0000-096d0042108a", "019d6ed0-0502-3101-0000-096d0042108e" ],
  "statementStatusUrl" : "/api/v2/statements/019d6ed0-0502-3101-0000-096d0042107e?requestId=066920fa-e589-43c6-8cca-9dcb2d4be978",
  "sqlState" : "00000",
  "statementHandle" : "019d6ed0-0502-3101-0000-096d0042107e",
  "message" : "Statement executed successfully.",
  "createdOn" : 1625684162876
}

Os identificadores no campo statementHandles correspondem às instruções na solicitação. Neste exemplo, as instruções e seus respectivos identificadores são:

BEGIN TRANSACTION (019d6ed0-0502-3101-0000-096d00421082)
INSERT (019d6ed0-0502-3101-0000-096d00421086)
COMMIT (019d6ed0-0502-3101-0000-096d0042108a)
SELECT (019d6ed0-0502-3101-0000-096d0042108e)

Você pode usar esses identificadores para verificar o status de cada instrução.