Конструктор строк подключения Oracle
Создавайте строку Oracle Easy Connect, TNS-дескриптор подключения, JDBC thin URL или строку ODP.NET в одной форме или вставьте готовую, чтобы увидеть хост, порт и имя сервиса и не перепутать SID с именем сервиса. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.
Открыть это подключение в SQLly
Открывает редактор подключений 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 Server
- Строки подключения к PostgreSQL
- Строки подключения к MySQL
- Строки подключения к MariaDB
- Строки подключения к SQLite
- Строки подключения Redis
- Строки подключения ClickHouse
- Строки подключения DuckDB
- Строки подключения libSQL
- Все движки и форматы
- Форматировщик SQL
- Все бесплатные инструменты
Подключитесь один раз. А потом просто пишите SQL.
SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для Oracle и других баз данных.