db2_conn_error
(PECL ibm_db2 >= 1.0.0)
db2_conn_error — Повертає рядок, який містить значення SQLSTATE, повернене останньою спробою підключення
Опис
db2_conn_error(?resource $connection = null): string
Повертає значення SQLSTATE, що становить причину, через яку остання спроба підключення до бази даних завершилася невдачею. Оскільки db2_connect() повертає false у разі невдалої спроби підключення, не потрібно передавати жодних параметрів у **db2_conn_error()**для получения значения SQLSTATE.
Однак, якщо з'єднання було успішним, але згодом стало недійсним, можна передати параметр connection, щоб отримати значення SQLSTATE для конкретного з'єднання.
Щоб дізнатися, що означає SQLSTATE, можна ввести наступну команду в командному рядку DB2 Command Line Processor: db2 '? `sqlstate-value`'. Також можна викликати db2_conn_errormsg(), щоб отримати явне повідомлення про помилку та відповідне значення SQLCODE.
Список параметрів
connection
Ресурс підключення, пов'язаний із підключенням, яке спочатку було успішним, але згодом стало недійсним.
Значення, що повертаються
Повертає значення SQLSTATE, отримане внаслідок невдалої спроби підключення. Повертає порожній рядок, якщо під час останньої спроби з'єднання помилок не виникло.
Приклади
Приклад #1 Отримання SQLSTATE для невдалої спроби підключення
У цьому прикладі показано, як повернути значення SQLSTATE після навмисної передачі неприпустимих параметрів db2_connect()
Результат виконання наведеного прикладу:
SQLSTATE value: 08001
Дивіться також
- db2_conn_errormsg() - Повертає останнє повідомлення про помилку підключення та значення SQLCODE
- db2_connect() - Повертає з'єднання з базою даних
- db2_stmt_error() - Повертає рядок, що містить SQLSTATE, повернутий SQL-оператором
- db2_stmt_errormsg() - Повертає рядок, що містить останнє повідомлення про помилку SQL-виразу