// бесплатный инструмент

Конструктор строк подключения Oracle

Создавайте строку Oracle Easy Connect, TNS-дескриптор подключения, JDBC thin URL или строку ODP.NET в одной форме или вставьте готовую, чтобы увидеть хост, порт и имя сервиса и не перепутать SID с именем сервиса. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.

Открыть это подключение в SQLly

Открывает редактор подключений SQLly с заполненными полями.

Приватность на уровне архитектуры. Конструктор и декодер — обычный JavaScript, работающий в этой вкладке. Страница никуда не отправляет то, что вы вводите, ничего не хранит (даже в вашем браузере) и продолжает работать офлайн после загрузки. Ссылка «Открыть в SQLly» ведёт из вашего браузера прямо в приложение на вашем компьютере.

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

Клиенты Oracle указывают базу данных тремя способами: Easy Connect (host:1521/service_name), полный дескриптор подключения ((DESCRIPTION=(ADDRESS=...)(CONNECT_DATA=(SERVICE_NAME=...)))), или псевдоним TNS, найденный в tnsnames.ora. JDBC thin, ODP.NET, python-oracledb и node-oracledb принимают первые два варианта.

Классическая ошибка — перепутать SID и имя службы. К подключаемым (PDB) и облачным базам данных подключаются по имени службы; Easy Connect вообще не может выразить SID, а старая форма JDBC host:port:SID завершается ошибкой ORA-12505, если вместо SID указать имя сервиса.

Easy Connect SQL*Plus, SQLcl, python-oracledb, node-oracledb, ODP.NET

db.example.com:1521/FREEPDB1

Easy Connect через TLS Easy Connect Plus

tcps://db.example.com:2484/FREEPDB1

Дескриптор подключения tnsnames.ora, каждый клиент Oracle

(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=db.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=FREEPDB1)))

JDBC thin Oracle JDBC (ojdbc)

jdbc:oracle:thin:@//db.example.com:1521/FREEPDB1

ADO.NET (ODP.NET) Oracle.ManagedDataAccess

User Id=app_user;Password=your_password;Data Source=db.example.com:1521/FREEPDB1;

URL SQLAlchemy python-oracledb

oracle+oracledb://app_user:[email protected]:1521/?service_name=FREEPDB1

Заполнители, такие как your_password — это лишь примеры: соберите свою строку в форме выше. Подробнее о подключении SQLly к Oracle: SQLly для Oracle.

Синтаксис Easy Connect (Plus)

[[protocol:]//]host[,host2][:port][/service_name][:server_type][/instance_name][?parameter=value&...]. Протокол — tcp (по умолчанию) или tcps; для обоих порт по умолчанию — 1521. SIDs в Easy Connect использовать нельзя.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
protocol - tcp tcps:// использует TLS. Прослушиватели TLS обычно используют порт 2484, зарегистрированный за Oracle, но указать его нужно вам.
port - 1521 Порт слушателя.
service_name - - Служба базы данных, например имя PDB, такое как FREEPDB1 или ORCLPDB1.
server_type - - dedicated, shared или pooled.
connect_timeout - нет Секунды на установку соединения.
transport_connect_timeout - - Секунды на само TCP-соединение.
retry_count / retry_delay - - / 0 Повторы подключения и задержка между ними.
ssl_server_dn_match - ВКЛ (клиенты 19.2+) Сверьте DN сертификата сервера с хостом.
wallet_location - - Каталог с кошельком для TCPS.

Атрибуты строки подключения ODP.NET

Стиль ADO.NET. Data Source Принимает строку Easy Connect, псевдоним TNS или полный дескриптор.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
User Id - - Пользователь базы данных.
Password - - Пароль; возьмите его в двойные кавычки, если он содержит специальные символы.
Data Source - - Easy Connect, псевдоним или дескриптор.
DBA Privilege - - SYSDBA, SYSOPER, SYSASM, SYSBACKUP, SYSDG, SYSKM, SYSRAC.
Connection Timeout - 15 Секунды ожидания соединения из пула.
Pooling - истина Пул подключений.
Max Pool Size - 100 Наибольший пул.
Min Pool Size - 1 Минимальный пул.
Incr Pool Size - 5 Подключения, которые добавляются при росте пула.
Statement Cache Size - 0 Количество кэшируемых операторов на соединение.
Validate Connection - ложь Проверять соединение из пула перед его выдачей.
Connection Lifetime - 0 Секунды жизни соединения в пуле.

Формы URL Oracle JDBC thin

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

Ключевое словоСинонимыПо умолчаниюЧто оно делает
jdbc:oracle:thin:@//host:port/service - - Имя сервиса (Easy Connect).
jdbc:oracle:thin:@tcps://host:port/service - - TLS; добавьте ?wallet_location=/path для кошелька.
jdbc:oracle:thin:@(DESCRIPTION=...) - - Полный дескриптор подключения.
jdbc:oracle:thin:@alias?TNS_ADMIN=/path - - Псевдоним TNS из файла tnsnames.ora в этом каталоге (или oracle.net.tns_admin свойстве).
jdbc:oracle:thin:@host:port:SID - - Устаревшая форма SID; предпочтительно использовать имя сервиса.

Распространённые ошибки подключения к Oracle

ORA-12154: TNS:could not resolve the connect identifier specified

Почему: Клиент воспринял строку как псевдоним TNS и не смог его найти: нет tnsnames.ora, TNS_ADMIN указания на другое место или опечатка в псевдониме или строке Easy Connect.

Исправлено: Используйте Easy Connect (host:1521/service) или полный дескриптор, чтобы обойти tnsnames.ora, или установите TNS_ADMIN в каталог, в котором лежит файл.

ORA-12514: TNS:listener does not currently know of service requested in connect descriptor

Почему: Слушатель доступен, но ни одна база данных не зарегистрировала у него это имя службы: служба названа неверно или с опечаткой, SID указан вместо имени службы или база данных не открыта.

Исправлено: Выполнить lsnrctl services (или спросите у DBA) о зарегистрированных службах и используйте одно из этих имен.

ORA-12505: TNS:listener does not currently know of SID given in connect descriptor

Почему: Строка подключается по SID (host:port:SID или (SID=...)) и значение не является SID, который знает слушатель, часто потому, что это на самом деле имя службы.

Исправлено: Перейдите к варианту с именем службы: //host:port/service_name.

ORA-12541: TNS:no listener

Почему: По этому хосту и порту никто не слушает: слушатель не работает, порт неверный либо подключение блокирует брандмауэр.

Исправлено: Проверить lsnrctl status на сервере, порт (по умолчанию 1521) и брандмауэр.

ORA-01017: invalid username/password; logon denied

Почему: Неверное имя пользователя или пароль. Пароли чувствительны к регистру, а пароль со специальными символами может потребовать кавычек в SQL*Plus.

Исправлено: Проверьте учетные данные; заключите пароль в кавычки в SQL*Plus, как user/"p@ss"@host/service.

ORA-28000: the account is locked

Почему: Слишком много неудачных попыток входа или DBA заблокировал учетную запись.

Исправлено: DBA выполняет ALTER USER app_user ACCOUNT UNLOCK;.

Часто задаваемые вопросы о строках подключения Oracle

Что такое строка Oracle Easy Connect?

Компактный идентификатор подключения, host[:port]/service_name, которому не нужна запись в tnsnames.ora. Easy Connect Plus (начиная с 19c) добавляет tcps://несколько хостов и ?parameter=value опции, такие как connect_timeout.

В чем разница между SID и именем службы?

SID указывает на один экземпляр базы данных; имя службы — то, что клиенты запрашивают у прослушивателя, а одна база данных (или подключаемая база данных) может предлагать несколько имён служб. Современные и облачные базы данных доступны по имени службы. Easy Connect принимает только имена служб.

Какой порт используется по умолчанию в Oracle?

1521 для слушателя. TLS (TCPS) использует тот же порт по умолчанию, если не настроить другой порт; многие сайты используют 2484, порт, зарегистрированный для Oracle через TLS.

Как подключиться через python-oracledb, не устанавливая Oracle Client?

python-oracledb работает в Thin-режиме по умолчанию и не требует библиотек Oracle Client: oracledb.connect(user=..., password=..., dsn="host:1521/service").

Может ли SQLly открыть подключение к Oracle из строки подключения?

SQLly подключается к Oracle, но его средство вставки строки подключения пока не поддерживает строки Oracle, поэтому кнопка «Открыть в SQLly» для Oracle недоступна. Вместо этого введите хост, порт и имя сервиса в редакторе подключений SQLly.

// вообще без строк подключения

Подключитесь один раз. А потом просто пишите SQL.

SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для Oracle и других баз данных.