1С ADO: что это такое и как использовать подключение к внешним базам данных

1С ADO — это способ обращения из встроенного языка 1С к внешним базам данных через технологию Microsoft ActiveX Data Objects (ADO). В коде это выглядит как создание COM-объектов ADODB.Connection и ADODB.Recordset через конструктор Новый COMОбъект(). Технология позволяет напрямую выполнять SQL-запросы к Microsoft SQL Server, Access, Excel, MySQL и другим источникам, для которых существует OLE DB-провайдер или ODBC-драйвер.

Подход активно применялся в конфигурациях на платформе 1С:Предприятие 7.7 и 8.x для интеграции с учётными системами, выгрузки данных из сторонних программ и прямого чтения таблиц без промежуточных файлов. Несмотря на появление современных альтернатив — HTTP-сервисов, веб-сервисов, внешних источников данных, — ADO-подключения до сих пор встречаются во многих работающих решениях, и разработчику важно понимать, как они устроены.

Ниже разобрано, как устроена работа с ADO в 1С, какие объекты используются, как формируется строка подключения, где технология уместна, а где создаёт риски для стабильности и безопасности системы.

Что такое ADO и как она связана с 1С

ADO (ActiveX Data Objects) — компонентная технология Microsoft для доступа к данным. Она представляет собой надстройку над OLE DB и предоставляет простой объектную модель: подключение, команда, набор записей. Приложение обращается к данным через провайдера — драйвер, который «умеет» общаться с конкретной СУБД или форматом файла.

Платформа 1С:Предприятие умеет создавать COM-объекты через конструкцию Новый COMОбъект("ADODB.Connection"). Это и есть точка входа: 1С выступает клиентом, который через ADO отправляет SQL-запросы внешней базе и читает результаты построчно. Сама платформа при этом ничего не знает о структуре чужой базы — вся логика, включая синтаксис SQL, ложится на разработчика.

Важно понимать ограничение: COM-технология доступна только в Windows-окружении. Код с ADO не выполнится на сервере 1С под Linux и в веб-клиенте. Если база 1С работает в клиент-серверном варианте, COM-объект создаётся на той машине, где исполняется код — и именно там должен быть установлен нужный драйвер.

Какие объекты ADO используются в коде 1С

Работа строится вокруг трёх основных объектов. Первый — ADODB.Connection: хранит строку подключения, открывает и закрывает сеанс, позволяет выполнять команды напрямую методом Execute(). Второй — ADODB.Command: описывает параметризованную команду с текстом запроса и параметрами, что снижает риск SQL-инъекций. Третий — ADODB.Recordset: результат выборки, по которому проходят циклом.

Типичный цикл чтения данных выглядит так: создать соединение, открыть его, выполнить запрос, получить Recordset, перебрать записи через MoveNext() до признака конца EOF, закрыть набор и соединение. Пропуск закрытия объектов — частая причина утечек памяти и зависших сессий на стороне SQL Server.

Соединение = Новый COMОбъект("ADODB.Connection");
Соединение.ConnectionString = "Provider=SQLOLEDB;Data Source=SERVER;Initial Catalog=Shop;User ID=user;Password=pass;";
Соединение.Open();
Набор = Соединение.Execute("SELECT Code, Name FROM Goods");
Пока НЕ Набор.EOF Цикл
    Сообщить(Набор.Fields("Name").Value);
    Набор.MoveNext();
КонецЦикла;
Набор.Close();
Соединение.Close();

Поля записи доступны через коллекцию Fields по имени или индексу. Следует учитывать, что значения приходят в типах COM: даты, числа и NULL из внешней базы нужно аккуратно приводить к типам 1С, иначе возможны ошибки преобразования или неявная потеря данных.

Строка подключения: из чего состоит и как её собрать

Строка подключения (ConnectionString) — ключевой элемент, в котором чаще всего кроются ошибки. Она состоит из пар «параметр=значение», разделённых точкой с запятой. Минимальный набор: провайдер (Provider), сервер (Data Source), база данных (Initial Catalog) и способ аутентификации.

Для SQL Server с провайдером SQLOLEDB аутентификация бывает двух видов: SQL-аутентификация с явным логином и паролем (User ID=...;Password=...) или Windows-аутентификация (Integrated Security=SSPI). Второй вариант безопаснее — пароль не хранится в коде, но требует, чтобы у учётной записи, под которой работает 1С, были права на целевую базу.

Для файловых источников строка отличается. Для Excel применяется провайдер Microsoft ACE OLEDB с параметром Extended Properties="Excel 12.0;HDR=YES", где HDR=YES означает, что первая строка — заголовки. Для старых форматов и Access используется Jet-провайдер, который существует только в 32-битной версии — это критично при выборе разрядности клиента 1С.

Порядок настройки подключения и проверка результата

Прежде чем писать код, проверьте подключение вне 1С. Самый быстрый способ — создать пустой файл с расширением .udl, открыть его, выбрать провайдера, заполнить параметры и нажать «Проверить подключение». Если тест проходит, готовую строку можно скопировать из файла в код 1С — это исключает ошибки в синтаксисе.

1. 1
   Определите СУБД источника и установите подходящий OLE DB/ODBC-драйвер той же разрядности, что и клиент 1С
2. 2
   Проверьте подключение через UDL-файл или тестовый ODBC-источник вне 1С
3. 3
   Создайте в коде COMОбъект ADODB.Connection и задайте строку подключения
4. 4
   Откройте соединение, выполните тестовый SELECT с ограничением числа строк
5. 5
   Переберите Recordset, преобразуйте значения полей к типам 1С
6. 6
   Закройте Recordset и Connection, обернув работу в Попытка/Исключение с гарантированным закрытием

Обязательно оборачивайте работу с ADO в конструкцию Попытка ... Исключение ... КонецПопытки. Сетевые сбои, отсутствие драйвера и неверные права проявляются как исключения COM, и без обработки пользователь получит непонятную системную ошибку. В блоке исключения фиксируйте текст ошибки и закрывайте объекты, если они были открыты.

Типичные ошибки и ограничения технологии

Самая распространённая проблема — несовпадение разрядности. 64-битный клиент 1С не увидит 32-битный драйвер Jet или ACE, и наоборот. Симптом — ошибка «провайдер не зарегистрирован» при физически установленном драйвере. Решение: ставить драйвер нужной разрядности или запускать код на клиенте соответствующей архитектуры.

Ещё одно ограничение — производительность. COM-вызовы медленнее нативных механизмов платформы, а построчный перебор Recordset на больших объёмах становится узким местом. Для регулярной загрузки сотен тысяч записей ADO подходит плохо: лучше рассмотреть выгрузку в файл или прямой обмен на уровне СУБД.

Когда ADO оправдан, а когда лучше выбрать альтернативу

ADO остаётся рабочим вариантом для разовых миграций, чтения данных из унаследованных систем и быстрых интеграций в закрытом Windows-контуре, где обе стороны под контролем. Технология проста, не требует доработки второй стороны и даёт прямой доступ к таблицам.

Для новых постоянных интеграций у платформы есть более надёжные механизмы. Внешние источники данных позволяют подключить таблицы SQL Server как объекты конфигурации и работать с ними штатным языком запросов 1С. HTTP- и веб-сервисы убирают зависимость от драйверов и работают на любой платформе. Планы обмена и форматы EnterpriseData подходят для регулярной синхронизации между учётными системами.

Безопасность и права доступа

ADO-подключение обходит все механизмы прав 1С: ограничения действуют только на стороне целевой СУБД. Поэтому учётная запись для подключения должна иметь минимально необходимые права — как правило, SELECT на конкретные таблицы или представления. Никогда не подключайтесь под владельцем базы или администратором сервера.

Дополнительно ограничьте доступ к самой обработке в 1С. Код, содержащий строки подключения, должен выполняться на сервере или у ограниченного круга пользователей. Пароли предпочтительно хранить вне кода: в защищённых настройках, доступных только администраторам.

Часто задаваемые вопросы