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

Подключение 1С к базе данных Oracle — распространённая задача интеграции: например, когда учёт ведётся в 1С, а корпоративное хранилище или сторонняя система работают на Oracle. Прямого «родного» механизма подключения в платформе 1С нет, поэтому используются обходные пути: технология ADO через COM-объекты, внешние источники данных, либо промежуточные сервисы.

Выбор способа зависит от задачи. Для разового чтения данных проще всего подойдёт ADO через COM-объект ADODB.Connection. Для постоянной интеграции с чтением и записью удобнее внешние источники данных в управляемом приложении. Для высоконагруженных сценариев правильнее строить обмен через веб-сервисы или промежуточную базу.

Важно понимать ограничение: COM-подключение (ADO) работает только на Windows-клиенте или Windows-сервере 1С, на котором установлен клиент Oracle (Oracle Client или Instant Client) с провайдером OLE DB либо ODBC-драйвером. Разрядность клиента Oracle должна совпадать с разрядностью процесса 1С: 32-битная платформа требует 32-битный клиент Oracle, 64-битная — 64-битный.

Что понадобится перед подключением

Прежде чем писать код, подготовьте окружение. Без этих компонентов любой способ подключения завершится ошибкой «Провайдер не зарегистрирован» или «Невозможно создать объект».

• Oracle Client или Instant Client — установлен на компьютере, где выполняется код 1С (клиентская машина или сервер 1С, если код выполняется на сервере).
• Провайдер доступа — Oracle Provider for OLE DB (OraOLEDB.Oracle), Microsoft OLE DB Provider for Oracle (устаревший) или ODBC-драйвер Oracle.
• Настроенный TNS-алиас — запись в файле tnsnames.ora либо строка подключения в формате Easy Connect (хост:порт/сервис).
• Учётные данные — логин и пароль пользователя Oracle с правами на нужные таблицы.
• Совпадение разрядности — 32/64 бита клиента Oracle и процесса 1С должны совпадать.

Способ 1: подключение через ADO (COM-объект)

Это самый распространённый вариант для толстого клиента и серверного кода на Windows. Используется COM-объект ADODB.Connection, который обращается к Oracle через OLE DB или ODBC.

Пример кода на встроенном языке 1С:

СтрокаПодключения = "Provider=OraOLEDB.Oracle;Data Source=ORCL;User ID=user1;Password=secret;";

Попытка
Соединение = Новый COMОбъект("ADODB.Connection");
Соединение.Open(СтрокаПодключения);
Исключение
Сообщить("Ошибка подключения: " + ОписаниеОшибки());
Возврат;
КонецПопытки;

НаборЗаписей = Соединение.Execute("SELECT id, name FROM contractors WHERE rownum <= 100");

Пока НЕ НаборЗаписей.EOF Цикл
Сообщить(Строка(НаборЗаписей.Fields("id").Value) + " — " + НаборЗаписей.Fields("name").Value);
НаборЗаписей.MoveNext();
КонецЦикла;

НаборЗаписей.Close();
Соединение.Close();

Обратите внимание: в Oracle используется rownum для ограничения выборки, а не TOP, как в MS SQL. Имена полей в результирующем наборе обычно возвращаются в том регистре, в котором они созданы в базе, — учитывайте это при обращении к Fields.

Соединение = Новый COMОбъект("ADODB.Connection");
Соединение.ConnectionString = "Provider=OraOLEDB.Oracle;Data Source=host:1521/ORCL;User ID=u;Password=p;";
Соединение.Open();

Варианты строк подключения

Строка подключения зависит от выбранного провайдера и способа адресации базы:

Способ 2: внешние источники данных

Механизм внешних источников данных (ВИД) доступен в управляемом приложении и позволяет описать таблицы Oracle прямо в конфигураторе, а затем работать с ними почти как с обычными таблицами 1С: строить запросы, выводить в отчёты СКД, показывать в формах.

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

1. 1
   Установите Oracle Client нужной разрядности на сервер 1С
2. 2
   В конфигураторе создайте объект «Внешний источник данных»
3. 3
   Задайте строку подключения и проверьте соединение
4. 4
   Добавьте нужные таблицы из списка объектов схемы Oracle
5. 5
   Опубликуйте конфигурацию и проверьте чтение данных запросом

Преимущество подхода — декларативность: не нужно писать COM-код, данные доступны в СКД и динамических списках. Недостатки — требуется управляемое приложение, производительность ниже, чем у прямого ADO, а сложные типы данных Oracle могут не сопоставляться типам 1С.

Способ 3: обмен через промежуточный слой

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

• Веб-сервисы — на стороне Oracle-инфраструктуры публикуется HTTP/REST-сервис, а 1С обращается к нему через HTTPСоединение. Это самый управляемый и безопасный вариант.
• Брокеры сообщений и файловый обмен — выгрузка в CSV, XML, JSON с регламентной загрузкой в 1С.
• Промежуточная база MS SQL или PostgreSQL — данные реплицируются в неё, а 1С подключается уже к ней штатными средствами.

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

Перед отладкой кода 1С проверьте доступность базы вне 1С: утилитой tnsping ORCL проверьте TNS-алиас, а sqlplus user/pass@ORCL — фактическое соединение. Если sqlplus не подключается, проблема в клиенте Oracle или сети, а не в коде 1С.

Полезный приём: сначала проверьте ту же строку подключения через стандартный Windows-инструмент — создайте файл с расширением .udl, настройте соединение визуально и нажмите «Проверить подключение». Успешный тест там означает, что строка подключения корректна и проблему нужно искать в коде 1С.

Безопасность и ограничения

Никогда не встраивайте пароль от производственной базы Oracle напрямую в код конфигурации. Храните параметры подключения в защищённом хранилище, константах с ограниченным доступом или получайте их из внешних настроек. Учётной записи для интеграции выдавайте минимально необходимые права — для чтения справочников достаточно SELECT на конкретные таблицы или представления.

Учитывайте и ограничения производительности: COM-вызовы и построчное чтение больших выборок медленны. Если нужно перенести сотни тысяч записей, читайте данные порциями или переходите на файловый обмен. Также помните, что транзакционная целостность между 1С и Oracle через ADO не гарантируется — распределённые транзакции требуют отдельной настройки MSDTC и чаще всего неоправданны.

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