« db2\_execdb2\_fetch\_array »PHP ManualФункції IBM DB2

db2_execute

(PECL ibm_db2 >= 1.0.0)

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

Опис

db2_execute(resource $stmt, array $parameters = []): bool

db2_execute() виконує SQL-запит, підготовлений за допомогою db2_prepare()

Якщо SQL-запит повертає набір результатів, наприклад, інструкція SELECT або CALL для процедури, що зберігається, яка повертає один або кілька наборів результатів, ви можете отримати рядок як масив з ресурсу stmt, используяdb2_fetch_assoc() db2_fetch_both() або db2_fetch_array(). Як альтернативу ви можете використовувати db2_fetch_row() для переміщення покажчика набору результатів на наступний рядок та вибірки стовпця з цього рядка за допомогою db2_result()

Обратитесь кdb2_prepare()для краткого обсуждения преимуществ использованияdb2_prepare()иdb2_execute() замість db2_exec()

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

stmt

Підготовлений запит, який повертається функцією db2_prepare()

parameters

Масив вхідних параметрів, які відповідають будь-яким маркерам параметрів, що містяться в підготовленому запиті.

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

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

Приклади

Приклад #1 Підготовка та виконання SQL-запиту з маркерами параметрів

У наступному прикладі готується запит INSERT, який приймає чотири маркери параметрів, а потім виконує ітерацію масивів, що містять вхідні значення, які необхідно передати в db2_execute()

Loading...

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

Успешно добавлен новый питомец.

Приклад #2 Виклик збереженої процедури з параметром OUT

У наступному прикладі готується запит CALL, який приймає один маркер параметра, що представляє параметр OUT, пов'язує змінну PHP $my_petsс параметром с помощьюdb2_bind_param(), а потім викликає db2_execute() для виконання запиту CALL. Після виконання запиту CALL процедури, що зберігається значення $num_pets змінюється, щоб відобразити значення, що повертається процедурою, що зберігається для цього параметра OUT.

Loading...

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

У меня 7 домашних животных!

Приклад #3 Повернення XML-даних як SQL ResultSet

У цьому прикладі показано, як працювати з документами, що зберігаються в стовпці XML за допомогою бази даних SAMPLE. Використовуючи досить простий SQL/XML, цей приклад повертає деякі вузли в XML-документі у форматі SQL ResultSet, з яким знайома більшість користувачів.

Loading...

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

1000     Kathy Smith     416-555-1358
1001     Kathy Smith     905-555-7258

Приклад #4 Виконання "JOIN" з даними XML

Наступний приклад працює з документами, що зберігаються у 2 різних стовпцях XML у базі даних SAMPLE. Він створює 2 тимчасові таблиці з XML-документів із 2 різних стовпців і повертає SQL ResultSet з інформацією про статус доставки для клієнта.

Loading...

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

1001     Kathy Smith     905-555-7258     5002     Shipped

Приклад #5 Повернення SQL-даних як частини великого XML-документа

Наступний приклад працює з частиною документів PRODUCT.DESCRIPTION у базі даних SAMPLE. Він створює XML-документ, що містить опис продукту (дані XML) та інформацію про ціни (дані SQL).

Loading...

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

<promoList xmlns="http://posample.org">
    <promoitem>
    <product pid="100-100-01">
        <description>
            <name>Snow Shovel, Basic 22 inch</name>
            <details>Basic Snow Shovel, 22 inches wide, straight handle with D-Grip</details>
            <price>9.99</price>
            <weight>1 kg</weight>
        </description>
    </product>
    <startdate>2004-11-19</startdate>
    <enddate>2004-12-19</enddate>
    <promoprice>7.25</promoprice>
    </promoitem>
</promoList>

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

  • db2_exec() - Виконує SQL-запит безпосередньо
  • db2_fetch_array() - Повертає масив, індексований за положенням стовпця, що представляє рядок у наборі результатів
  • db2_fetch_assoc() - Повертає масив, індексований на ім'я стовпця, що представляє рядок у наборі результатів
  • db2_fetch_both() - Повертає масив, індексований як на ім'я стовпця, так і за позицією, що представляє рядок у наборі результатів
  • db2_fetch_row() - Встановлює вказівник набору результатів на наступний рядок або запрошений рядок
  • db2_prepare() - готує SQL-запит до виконання
  • db2_result() - Повертає один стовпець з рядка у наборі результатів