« cubrid\_error\_msgcubrid\_fetch »PHP ManualФункції CUBRID

cubrid_execute

(PECL CUBRID >= 8.3.0)

cubrid_execute - Виконує підготовлений SQL-оператор

Опис

cubrid_execute(resource $conn_identifier, string $sql, int $option = 0): resource

cubrid_execute(resource $request_identifier, int $option = 0): bool

Функцияcubrid_execute() використовується для виконання цього SQL-оператора. Вона виконує запит, використовуючи conn_identifier та SQL, а потім повертає створений ідентифікатор запиту. Функція використовується для простого виконання запиту, коли не потрібно. Крім того, функція cubrid_execute() використовується для виконання підготовленого оператора за допомогою cubrid_prepare() і cubrid_bind(). У цей час вам необхідно вказати аргументи request_identifierиoption

Параметрoption використовується для визначення, чи слід отримувати OID після виконання запиту та чи слід виконувати запит у синхронному або асинхронному режимі. Константа CUBRID_INCLUDE_OID і CUBRID_ASYNC(или**CUBRID_EXEC_QUERY_ALL**Якщо необхідно виконати кілька SQL-операторів) можна вказати за допомогою побітового оператора АБО. Якщо не вказано, жодного з них не вибрано. Якщо встановлено прапор CUBRID_EXEC_QUERY_ALL, для отримання результатів запиту використовується синхронний режим (sync_mode) і в таких випадках застосовуються такі правила:

  • Значення, що повертається - результат першого запиту.
  • Якщо у будь-якому запиті виникає помилка, виконання обробляється як збій.
  • У запиті, що складається з q1 q2 q3, якщо помилка виникає q2 після успішного виконання q1, результат q1 залишається дійсним. Тобто попереднє успішне виконання запиту не відкочується у разі помилки.
  • У разі успішного виконання запиту, результат другого запиту можна отримати за допомогоюcubrid_next_result()

Якщо першим аргументом є request_identifier для виконання функції cubrid_prepare() можна вказати тільки CUBRID_ASYNC

Список параметрів

conn_identifier

Ідентифікатор з'єднання.

sql

SQL для виконання.

option

Варіант виконання запиту: CUBRID_INCLUDE_OID CUBRID_ASYNC CUBRID_EXEC_QUERY_ALL

request_identifier

Ідентифікатор cubrid_prepare()

Значення, що повертаються

Ідентифікатор запиту у разі успішного виконання запиту і якщо першим параметром є conn_identifier;true, у разі успішного виконання запиту та першим аргументом request_identifier или**false**в случае возникновения ошибки.

список змін

ВерсияОпис
8.4.0Додано новий параметр CUBRID_EXEC_QUERY_ALL

Приклади

Приклад #1 Приклад використання cubrid_execute()****

Loading...

Результат виконання наведеного прикладу:

athlete              host_year score      unit
Phelps Michael       2004      51.25      time

Дивіться також

  • cubrid_prepare() - Підготовляє SQL-вираз до виконання
  • cubrid_bind() - пов'язує змінні із підготовленим запитом
  • cubrid_next_result() - Отримує результат наступного запиту під час виконання кількох SQL-операторів
  • cubrid_close_request() - Закриває обробник запиту
  • cubrid_commit() - підтвердження транзакції
  • cubrid_rollback() - Відкат транзакції