Как подключиться к базе данных SQL из 1С

Подключение 1С к внешней базе данных SQL требуется, когда нужно читать или записывать данные напрямую, минуя промежуточные файлы: выгрузить остатки из учётной системы, забрать заказы с сайта, сверить справочники с другой конфигурацией. В зависимости от задачи используются разные механизмы — прямое подключение через ADODB, внешние источники данных или COM-соединение с другой базой 1С.

Выбор способа зависит от трёх факторов: тип СУБД (MS SQL Server, PostgreSQL, MySQL), режим работы 1С (файловый или клиент-серверный) и направление обмена (только чтение или чтение с записью). Ниже разобраны основные сценарии с примерами кода, настройкой прав и проверкой результата.

Прежде чем писать код, убедитесь, что сам SQL-сервер доступен с компьютера, где работает 1С: проверьте сетевую связь, открытый порт и учётные данные. Большинство проблем с подключением возникает не из-за ошибок в коде, а из-за закрытого брандмауэра или отключённого протокола TCP/IP на стороне сервера.

Какой способ подключения выбрать

В 1С нет единственного «правильного» метода работы с SQL. Прямое подключение через ADODB даёт полный контроль: вы выполняете произвольные запросы, хранимые процедуры, управляете транзакциями. Минус — весь код нужно писать вручную и сопровождать самостоятельно.

Внешние источники данных — штатный механизм платформы. Вы описываете таблицы SQL-базы в конфигураторе, и 1С работает с ними почти как с собственными объектами: можно строить запросы на встроенном языке, выводить данные в отчёты СКД. Ограничение — требуется настройка ODBC-драйвера, а производительность при больших объёмах ниже, чем у прямых запросов.

Если источник данных — другая информационная база 1С, правильнее использовать COM-соединение (V83.COMConnector), а не лезть в её SQL-таблицы напрямую. Структура таблиц 1С на уровне СУБД недокументирована и меняется между релизами, поэтому прямые запросы к базе 1С — ненадёжное решение.

Подготовка: доступы, драйверы и сеть

До написания кода проверьте три вещи. Первое — сетевая доступность: с машины, где выполняется код 1С (это может быть сервер 1С, а не ваш компьютер), должен быть доступен сервер СУБД по нужному порту. Для MS SQL это обычно 1433, для PostgreSQL — 5432, для MySQL — 3306. Проверить можно командой telnet или Test-NetConnection в PowerShell.

Второе — учётная запись. Создайте в SQL-базе отдельного пользователя с минимально необходимыми правами: для чтения достаточно SELECT по конкретным таблицам или представлениям. Не используйте административные учётные записи вроде sa в коде обмена — это прямой риск для данных.

Третье — провайдер данных. Для ADODB на компьютере, где исполняется код, должен быть установлен OLE DB-провайдер или ODBC-драйвер соответствующей СУБД. Для MS SQL обычно доступен встроенный SQLOLEDB или более современный MSOLEDBSQL. Для PostgreSQL и MySQL драйвер нужно установить отдельно, причём разрядность драйвера должна совпадать с разрядностью процесса 1С.

Подключение через ADODB: пошагово

Самый универсальный способ — создать COM-объект ADODB.Connection и выполнить запрос. Код работает в толстом клиенте и на сервере 1С (в Windows-окружении). В тонком и веб-клиенте COM-объекты недоступны — там подключение нужно выносить на сервер.

Типовой порядок действий: создать объект соединения, открыть его со строкой подключения, выполнить запрос через объект Recordset, обойти результат построчно, закрыть соединение. Обязательно оборачивайте код в попытку-исключение и закрывайте соединение в любом случае, иначе на SQL-сервере будут копиться зависшие сессии.

Попытка
	Соединение = Новый COMОбъект("ADODB.Connection");
	СтрокаПодключения = "Provider=SQLOLEDB;Data Source=SQLSERVER;Initial Catalog=ExchangeDB;User ID=reader;Password=Secret123;";
	Соединение.Open(СтрокаПодключения);
	Набор = Соединение.Execute("SELECT Code, Name FROM dbo.Goods");
	Пока НЕ Набор.EOF Цикл
		Сообщить(Набор.Fields("Code").Value + " — " + Набор.Fields("Name").Value);
		Набор.MoveNext();
	КонецЦикла;
	Соединение.Close();
Исключение
	Сообщить("Ошибка подключения: " + ОписаниеОшибки());
КонецПопытки;

Строка подключения различается в зависимости от СУБД и провайдера. Для MS SQL с Windows-аутентификацией вместо логина и пароля указывается параметр Integrated Security=SSPI — тогда используются права учётной записи, под которой работает процесс 1С. Для PostgreSQL и MySQL строка строится через ODBC-драйвер с указанием его имени.

При передаче параметров в запрос не склеивайте их в текст запроса конкатенацией — это открывает путь к SQL-инъекциям и ломается на спецсимволах. Используйте объект ADODB.Command с параметрами или, минимум, экранируйте строковые значения.

Настройка внешних источников данных

Внешние источники данных настраиваются в конфигураторе: ветка «Общие» — «Внешние источники данных». При добавлении источника указывается тип СУБД, строка подключения и список таблиц, которые нужно видеть в 1С. Платформа считывает структуру таблиц и создаёт их описание в метаданных.

После публикации конфигурации таблицы внешнего источника доступны в конструкторе запросов и в СКД наравне со справочниками и регистрами. Это удобно для отчётов: пользователь строит отчёт по внешним данным обычными средствами, не зная о том, что данные лежат в другой СУБД.

Учтите ограничения: внешние источники требуют ODBC-драйвер на каждом рабочем месте (или на сервере 1С в клиент-серверном режиме), соединение открывается при первом обращении, а при недоступности SQL-сервера пользователь получит ошибку в момент обращения к данным. Для критичных отчётов предусмотрите обработку такой ситуации.

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

Начинайте отладку с минимального запроса, который гарантированно возвращает результат, — например, SELECT 1 или выбор одной строки из заведомо существующей таблицы. Если минимальный запрос не выполняется, проблема в соединении: сети, драйвере или правах. Если выполняется, а рабочий запрос падает — проблема в самом запросе или правах на конкретные объекты.

Полезная практика — логировать факт подключения, время выполнения запроса и количество полученных записей. Это позволяет отличить «данных нет в источнике» от «запрос не выполнился», которые внешне выглядят одинаково — пустой результат.

Типичные ошибки и их устранение

Ошибка «Поставщик данных не найден» означает, что OLE DB-провайдер или ODBC-драйвер не установлен либо не той разрядности. Проверьте разрядность процесса 1С и установите соответствующую версию драйвера. Ошибка «Вход пользователя не выполнен» — неверный логин, пароль или у SQL-логина нет доступа к указанной базе.

Ошибки тайм-аута при удалённом сервере чаще всего связаны с закрытым портом или тем, что MS SQL слушает только локальные подключения. В конфигураторе SQL Server должен быть включён протокол TCP/IP, а служба браузера SQL Server — запущена, если используется именованный экземпляр.

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

Выделите для обмена отдельную SQL-учётную запись с правами только на чтение нужных таблиц или представлений. Если требуется запись, ограничьте её конкретными таблицами-приёмниками. Храните параметры подключения не в коде, а в настройках, доступных ограниченному кругу лиц, — например, в защищённых константах или во внешнем файле настроек с ограниченным доступом.

По производительности: выбирайте только нужные поля и строки (WHERE на стороне SQL), а не выгружайте таблицу целиком с последующей фильтрацией в 1С. При больших объёмах используйте пакетную обработку — читайте данные порциями. Для регулярных обменов оформляйте код как регламентное задание с обработкой ошибок и уведомлением администратора о сбоях.

Частые вопросы