db2_conn_error

함수

(PECL ibm_db2 >= 1.0.0)

db2_conn_error — 마지막 연결 시도에서 반환된 SQLSTATE가 포함된 문자열을 반환합니다.


설명

db2_conn_error(resource $connection = ?): string

db2_conn_error()는 데이터베이스에 대한 마지막 연결 시도가 실패한 이유를 나타내는 SQLSTATE 값을 리턴합니다. 연결 시도가 실패한 경우 db2_connect()가 false를 리턴하므로 SQLSTATE 값을 검색하기 위해 db2_conn_error()에 매개변수를 전달하지 않습니다.

그러나 연결에 성공했지만 시간이 지남에 따라 유효하지 않게 된 경우 connection 매개변수를 전달하여 특정 연결에 대한 SQLSTATE 값을 검색할 수 있습니다.

SQLSTATE 값의 의미를 알아보기 위해 DB2 명령행 처리기 프롬프트에서 다음 명령을 실행할 수 있습니다. db2 '? sqlstate-value'. db2_conn_errormsg()를 호출하여 명시적 오류 메시지 및 연관된 SQLCODE 값을 검색할 수도 있습니다.


매개변수
connection
처음에는 성공했지만 시간이 지나면서 유효하지 않게 된 연결과 관련된 연결 리소스입니다.

반환 값

실패한 연결 시도로 인한 SQLSTATE 값을 반환합니다. 마지막 연결 시도와 관련된 오류가 없으면 빈 문자열을 반환합니다.


Examples

예제 #1 실패한 연결 시도에 대한 SQLSTATE 값 검색

다음 예는 의도적으로 유효하지 않은 매개변수를 db2_connect()에 전달한 후 SQLSTATE 값을 리턴하는 방법을 보여줍니다.

                  
<?php
$conn = db2_connect('badname', 'baduser', 'badpassword');
if (!$conn) {
    print "SQLSTATE value: " . db2_conn_error();
}
?>

위의 예는 다음을 출력합니다.

SQLSTATE value: 08001

기타
  • db2_conn_errormsg() - 마지막 연결 오류 메시지 및 SQLCODE 값을 반환합니다.
  • db2_connect() - 데이터베이스에 대한 연결을 반환합니다.
  • db2_stmt_error() - SQL 문에 의해 반환된 SQLSTATE를 포함하는 문자열을 반환합니다.
  • db2_stmt_errormsg() - 마지막 SQL 문 오류 메시지가 포함된 문자열을 반환합니다.

PHP

웹학교

참조