Использование метода Result::fetchRaw() в 1С-Битрикс

В этой статье мы подробно разберём, что делает метод `\Bitrix\Main\DB\Result::fetchRaw()`, в каких случаях его стоит использовать и как правильно работать с его результатами. Данный метод позволяет получить одну строку результата SQL-запроса в необработанном (сыром) виде – именно в том формате, в котором она хранится в базе данных.

Что такое `fetchRaw`?

Метод:

array|false public \Bitrix\Main\DB\Result::fetchRaw();

• Возвращает:
  • Ассоциативный массив (если данные найдены)
  • `false` (если данные закончились или строк нет)
• Параметров: Нет

Главное отличие от часто используемого `fetch()` состоит в том, что `fetchRaw()` возвращает именно «сырые» данные из БД, без каких-либо внутренних преобразований. Это бывает полезно, если нужно получать информацию в оригинальном формате (например, когда нужно сохранить «как есть» двоичные поля, данные в определённой кодировке и т. д.).

Сценарии использования

1. Получение необработанных данных для специализированной обработки Если вы создаёте интеграцию или пишете функционал, где важны двоичные данные, зашифрованная информация, нестандартное хранение дат и т. д., метод `fetchRaw()` будет как нельзя кстати.
2. Сравнение данных Когда важно сравнить точные значения, хранящиеся в базе, без модификаций, может быть полезно получить именно «сырые» данные.
3. Оптимизация Иногда в больших проектах, где написана своя логика обработки данных после выборки из БД, выгодно явно управлять процессом преобразования записей. `fetchRaw()` даёт вам полный контроль над преобразованием – вы можете сами решить, что и как с данными делать.

Пример использования

Ниже приведён простой пример, показывающий, как работать с `fetchRaw()`. В примере мы делаем выборку из таблицы, содержащей, предположим, пользователей, и выводим первую найденную запись в «сыром» виде.

<?php

use Bitrix\Main\Application;
use Bitrix\Main\DB\Result;

$connection = Application::getConnection();

// Пример SQL-запроса (используйте свои таблицы и условия)
$sql = "SELECT * FROM b_user WHERE ACTIVE='Y'";

$result = $connection->query($sql);
/** @var Result $result **/

// Получаем одну строку данных в «сыром» виде
$row = $result->fetchRaw();

if ($row !== false) {
    echo '<pre>';
    print_r($row);
    echo '</pre>';
} else {
    echo "Нет данных или запрос не вернул результатов.";
}

Пошаговое объяснение

1. Подключение к БД: Используем метод `Application::getConnection()`, чтобы получить объект подключения к базе данных в 1С-Битрикс.
2. Подготовка и выполнение запроса: Вызываем `$connection->query($sql)`, где в переменной `$sql` хранится обычный SQL-запрос.
3. Получение результата: Метод `fetchRaw()` возвращает первую доступную строку результата в виде ассоциативного массива, где:
   • Ключи массива соответствуют названиям полей в таблице БД,
   • Значения – «сырой» контент из этих полей.
4. Проверка на наличие данных:
   • Если строчки существуют, выведется массив.
   • Если данных нет, метод возвращает `false`.

Использование `fetchRaw` в цикле

Если нужно последовательно обойти все строки результата, можно вызывать `fetchRaw()` в цикле `while`. Код будет выглядеть так:

<?php

use Bitrix\Main\Application;
use Bitrix\Main\DB\Result;

$connection = Application::getConnection();
$sql = "SELECT * FROM b_user";
$result = $connection->query($sql);

while ($row = $result->fetchRaw()) {
    // Здесь вы можете обрабатывать строку, например, выводить данные или сохранять их в массив
    echo 'ID пользователя: ' . $row['ID'] . '<br>';
}

После того как все данные будут «перебраны», при следующем вызове `fetchRaw()` мы получим `false`.

Отличия от `fetch()`

В 1С-Битрикс есть также метод `fetch()`, который возвращает данные в более «приведённом» виде. Например, в некоторых случаях он может:

• Приводить поля к нижнему/верхнему регистру;
• Делать дополнительные преобразования чисел, дат и т. д.;
• Учитывать маппинг полей при работе с ORM-моделью (если используется соответствующий функционал).

`fetchRaw()`, напротив, возвращает массив именно с исходными значениями, лежащими в таблице. Поэтому, если вам нужно избежать каких-либо автоматических преобразований, выбирайте именно `fetchRaw()`.

Когда выбирать `fetchRaw()`?

• Вы хотите реализовать собственную логику обработки или сохранения данных без участия внутренних механизмов платформы.
• Необходимо сравнить исходные данные базы данных с чем-либо ещё (например, при импорте/экспорте).
• Нужно считать специальные поля, которые не должны меняться при выборке (двоичные поля, данные в нестандартном формате).

Важно: если вы не уверены, что хотите именно «сырые» данные, может оказаться безопаснее и проще использовать `fetch()`. В стандартных задачах 1С-Битрикс преобразование данных часто бывает полезно и избавляет от лишних ошибок.

Заключение

Метод `fetchRaw()` в 1С-Битрикс – это удобный инструмент, когда нужно работать с результатами SQL-запроса «как есть» без дополнительных преобразований. Он часто используется в «низкоуровневых» сценариях, требующих тонкого управления данными. Однако перед его применением стоит убедиться, что «сырой» формат действительно нужен, так как иногда проще использовать стандартное `fetch()` с уже приведёнными к привычному виду данными.

Надеемся, что это руководство поможет вам эффективно применять `fetchRaw()` в проектах на 1С-Битрикс и расширит понимание того, как обрабатываются данные из базы. Если у вас остались вопросы или есть интересные кейсы по использованию `fetchRaw()`, обязательно делитесь ими в комментариях к статье!