cubrid_query
(PECL CUBRID >= 8.3.1)
cubrid_query — Надсилання запиту CUBRID
Опис
cubrid_query(string $query, resource $conn_identifier = ?): resource
Функцияcubrid_query() посилає унікальний запит (множинні запити не підтримуються) поточної активної бази даних, заданої ідентифікатором з'єднання conn_identifier
Список параметрів
query
SQL-запит
Дані у запиті мають бути коректно екрановані
conn_identifier
Ідентифікатор з'єднання. Якщо не встановлено, то буде використано останнє, відкрите за допомогою cubrid_connect()соединение.
Значення, що повертаються
Для SELECT, SHOW, DESCRIBE, EXPLAIN та інших запитів, що повертають результуючий набір, cubrid_query() повертає resource у разі успішного виконання та **false**в случае возникновения ошибки.
Для інших типів SQL-запитів, INSERT, UPDATE, DELETE, DROP і т.д. cubrid_query() повертає true або false залежно від успішності виконання.
Повернутий результат можна передавати у функцію cubrid_fetch_array() і їй подібні до роботи з отриманими даними.
Используйтеcubrid_num_rows() для визначення кількості повернутих оператором SELECT рядків або cubrid_affected_rows() для визначення кількості порушених рядків, для запитів, що змінюють дані, таких як DELETE, INSERT, REPLACE та UPDATE.
cubrid_query() також може завершитися з помилкою та повернути false, якщо користувач не має права на доступ до таблиці, яка використовується у запиті.
Приклади
Приклад #1 Некоректний запит
Наступний запит містить синтаксичну помилку, тому cubrid_query() поверне false
Приклад #2 Коректний запит
Наступний запит коректний, тож cubrid_query() поверне ресурс.
Дивіться також
- cubrid_connect() - Відкриває з'єднання з сервером CUBRID
- cubrid_error() - Повертає текст останньої помилки, що відбулася.
- cubrid_real_escape_string() - Екранування спеціальних символів у SQL-запиті
- cubrid_result() - Отримати значення із заданого стовпця заданого рядка
- cubrid_fetch_assoc() - Витягти рядок із результуючого набору у вигляді асоціативного масиву
- cubrid_unbuffered_query() - Виконання запиту без завантаження результату на згадку