db2_autocommit

(PECL ibm_db2 >= 1.0.0)

db2_autocommit Retorna ou define o estado AUTOCOMMIT para uma conexão de banco de dados

Descrição

db2_autocommit(resource $connection, int $value = ?): int|bool

Define ou obtém o comportamento AUTOCOMMIT do recurso de conexão especificado.

Parâmetros

connection

Uma variável de recurso de conexão de banco de dados válida, conforme retornada de db2_connect() ou db2_pconnect().

value

Uma das seguintes constantes:

DB2_AUTOCOMMIT_OFF

Desativa o AUTOCOMMIT.

DB2_AUTOCOMMIT_ON

Ativa o AUTOCOMMIT.

Valor Retornado

Quando db2_autocommit() recebe apenas o parâmetro connection, ele retorna o estado atual de AUTOCOMMIT para a conexão solicitada como um valor inteiro. Um valor de DB2_AUTOCOMMIT_OFF indica que AUTOCOMMIT está desligado, enquanto um valor de DB2_AUTOCOMMIT_ON indica que AUTOCOMMIT está ligado.

Quando db2_autocommit() recebe o parâmetro connection e o parâmetro autocommit, ele tenta definir o estado AUTOCOMMIT da conexão solicitada para o estado correspondente. Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Exemplo #1 Recuperando o valor AUTOCOMMIT para uma conexão

No exemplo a seguir, uma conexão que foi criada com AUTOCOMMIT desativado é testada com a função db2_autocommit().

<?php
$options
= array('autocommit' => DB2_AUTOCOMMIT_OFF);
$conn = db2_connect($database, $user, $password, $options);
$ac = db2_autocommit($conn);
if (
$ac == DB2_AUTOCOMMIT_OFF) {
print
"$ac -- AUTOCOMMIT está desativado.";
} else {
print
"$ac -- AUTOCOMMIT está ativado.";
}
?>

O exemplo acima produzirá:

0 -- AUTOCOMMIT está desativado.

Exemplo #2 Definindo o valor AUTOCOMMIT para uma conexão

No exemplo a seguir, uma conexão que foi inicialmente criada com AUTOCOMMIT desativado tem seu comportamento alterado para ativar AUTOCOMMIT.

<?php
$options
= array('autocommit' => DB2_AUTOCOMMIT_OFF);
$conn = db2_connect($database, $user, $password, $options);

// Ativa o AUTOCOMMIT
$rc = db2_autocommit($conn, DB2_AUTOCOMMIT_ON);
if (
$rc) {
print
"Ativação do AUTOCOMMIT bem sucedida.\n";
}

// Verifica o estado do AUTOCOMMIT
$ac = db2_autocommit($conn);
if (
$ac == DB2_AUTOCOMMIT_OFF) {
print
"$ac -- AUTOCOMMIT está desativado.";
} else {
print
"$ac -- AUTOCOMMIT está ativado.";
}
?>

O exemplo acima produzirá:

Ativação do AUTOCOMMIT bem sucedida.
1 -- AUTOCOMMIT está ativado.

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top