sqlsrv_query
(No version information available, might only be in Git)
sqlsrv_query — Підготовка та виконання запиту
Опис
sqlsrv_query( resource $conn, string $sql, array $params = ?, array $options = ?): mixed
Підготовляє та виконує запит.
Список параметрів
conn
Ресурс підключення, що повертається sqlsrv_connect()
sql
Рядок, що визначає запит, який потрібно підготувати та виконати.
params
Масив, що визначає інформацію про параметри під час параметризованого запиту. Елементи масиву можуть бути будь-якими з наступних:
- Строкового значення
- Змінної PHP
- Масиву з наступною структурою: array($value[, $direction[, $phpType[, $sqlType]]]) .
У наступній таблиці описані елементи у структурі масиву вище:
Структура масиву
| Элемент | Опис |
|---|---|
| $value | Рядкове значення, змінна PHP або змінна PHP, передана за посиланням. |
| $direction (optional) | Одна з наступних констант SQLSRV, що використовуються для вказівки напряму параметра: SQLSRV_PARAM_IN, SQLSRV_PARAM_OUT, SQLSRV_PARAM_INOUT. Значення за промовчанням - SQLSRV_PARAM_IN. |
| $phpType (optional) | Константа SQLSRV_PHPTYPE_*, що вказує тип даних PHP значення, що повертається. |
| $sqlType (optional) | Константа SQLSRV_SQLTYPE_*вказує тип даних SQL Server вхідного значення. |
options
Масив, визначальний параметри властивостей запиту. Ключі, що підтримуються, описані в наступній таблиці:
Властивості запиту
| Ключ | Значения | Опис |
|---|---|---|
| QueryTimeout | Позитивне ціле значення. | Встановлює час очікування в секундах. За замовчуванням драйвер чекатиме на результати нескінченно. |
| SendStreamParamsAtExec | true або false (за замовчуванням true) . | Налаштовує драйвер для надсилання всіх даних потоку під час виконання (true) або для надсилання даних потоку частинами (false). За замовчуванням встановлено значення true. . Для отримання додаткової інформації дивіться sqlsrv_send_stream_data() |
| Scrollable | SQLSRV_CURSOR_FORWARD, SQLSRV_CURSOR_STATIC, SQLSRV_CURSOR_DYNAMIC, або SQLSRV_CURSOR_KEYSET | Смотрите» Вказівка типу курсору та вибір рядківв документации Microsoft SQLSRV. |
Значення, що повертаються
Повертає ресурс виразу у разі успішного виконання або **false**в случае возникновения ошибки.
Приклади
Приклад #1 Приклад використання sqlsrv_query()****
Примітки
Для операторів, які ви плануєте виконати лише один раз, використовуйте sqlsrv_query(). Якщо ви маєте намір повторно виконати вираз з іншими параметрами, використовуйте комбінацію sqlsrv_prepare() і sqlsrv_execute()
Дивіться також
- sqlsrv_prepare() - готує запит до виконання
- sqlsrv_execute() - Виконує запит підготовлений за допомогою sqlsrv_prepare