db2_conn_error

(PECL ibm_db2 >= 1.0.0)

db2_conn_error Retorna uma string contendo o SQLSTATE retornado pela última tentativa de conexão

Descrição

db2_conn_error(?resource $connection = null): string

db2_conn_error() retorna um valor SQLSTATE representando o motivo da falha da última tentativa de conexão com um banco de dados. Como db2_connect() retorna false no caso de uma falha na tentativa de conexão, não se passa nenhum parâmetro para db2_conn_error() para recuperar o valor SQLSTATE.

Se, no entanto, a conexão foi bem-sucedida, mas se torna inválida ao longo do tempo, pode ser passado o parâmetro connection para recuperar o valor SQLSTATE para uma conexão específica.

Para saber o que o valor SQLSTATE significa, pode ser emitido o seguinte comando em um prompt do Processador de Linha de Comando do DB2: db2 '? sqlstate-value'. Também pode ser chamada a função db2_conn_errormsg() para recuperar uma mensagem de erro explícita e o valor SQLCODE associado.

Parâmetros

connection

Um recurso de conexão associado a uma conexão que inicialmente foi bem-sucedida, mas que com o tempo se tornou inválida.

Valor Retornado

Retorna o valor SQLSTATE resultante de uma tentativa de conexão com falha. Retorna uma string vazia se não houver erro associado à última tentativa de conexão.

Exemplos

Exemplo #1 Recuperando um valor SQLSTATE para uma tentativa de conexão com falha

O exemplo a seguir demonstra como retornar um valor SQLSTATE após passar deliberadamente parâmetros inválidos para db2_connect().

<?php
$conn
= db2_connect('nome_invalido', 'usuario_invalido', 'senha_invalida');
if (!
$conn) {
print
"Valor SQLSTATE: " . db2_conn_error();
}
?>

O exemplo acima produzirá:

Valor SQLSTATE: 08001

Veja Também

  • db2_conn_errormsg() - Retorna a última mensagem de erro de conexão e o valor SQLCODE
  • db2_connect() - Retorna uma conexão com um banco de dados
  • db2_stmt_error() - Retorna uma string contendo o SQLSTATE retornado por uma instrução SQL
  • db2_stmt_errormsg() - Retorna uma string contendo a última mensagem de erro da instrução SQL

adicione uma nota

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

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