Construtor de strings de conexão Oracle
Construa uma string Oracle Easy Connect, um descritor de conexão TNS, uma URL JDBC thin ou uma string ODP.NET a partir de um formulário, ou cole uma para ver o host, porta e nome do serviço e detectar a confusão entre SID e nome do serviço. Tudo roda no seu navegador: nada do que você digita é enviado para lugar nenhum.
Abrir esta conexão no SQLly
Abre o editor de conexão do SQLly preenchido.
Abrir esta conexão no SQLly
Privado por design. O construtor e o decodificador são JavaScript puro rodando nesta aba. A página não envia nenhuma solicitação com o que você digita, não armazena nada (nem mesmo no seu navegador) e continua funcionando offline após carregada. O link Abrir no SQLly vai do seu navegador direto para o aplicativo no seu computador.
Formatos de strings de conexão Oracle
Os clientes Oracle nomeiam um banco de dados de três maneiras: Easy Connect (host:1521/service_name), um descritor de conexão completo ((DESCRIPTION=(ADDRESS=...)(CONNECT_DATA=(SERVICE_NAME=...)))), ou um alias TNS consultado em tnsnames.ora. JDBC thin, ODP.NET, python-oracledb e node-oracledb aceitam os dois primeiros.
O erro clássico é confundir um SID com um nome de serviço. Bancos de dados plugáveis e bancos de dados na nuvem são acessados pelo nome de serviço; Easy Connect não pode expressar um SID de forma alguma, e a forma legada do JDBC host:port:SID falha com ORA-12505 quando você fornece um nome de serviço.
Easy Connect SQL*Plus, SQLcl, python-oracledb, node-oracledb, ODP.NET
db.example.com:1521/FREEPDB1
Easy Connect sobre TLS Easy Connect Plus
tcps://db.example.com:2484/FREEPDB1
Descritor de conexão tnsnames.ora, todo cliente 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 do SQLAlchemy python-oracledb
oracle+oracledb://app_user:[email protected]:1521/?service_name=FREEPDB1
Marcadores como your_password são exatamente isso: monte sua própria string no formulário acima. Mais sobre como conectar o SQLly ao Oracle: SQLly para Oracle.
Sintaxe Easy Connect (Plus)
[[protocol:]//]host[,host2][:port][/service_name][:server_type][/instance_name][?parameter=value&...]. O protocolo é tcp (padrão) ou tcps; a porta padrão é 1521 para ambos. SIDs não podem ser usados no Easy Connect.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
protocol |
- | tcp | tcps:// usa TLS. Os listeners TLS geralmente usam 2484, a porta registrada da Oracle, mas você deve escrevê-la. |
port |
- | 1521 | Porta do listener. |
service_name |
- | - | Serviço do banco de dados, por exemplo, um nome de PDB como FREEPDB1 ou ORCLPDB1. |
server_type |
- | - | dedicated, shared ou pooled. |
connect_timeout |
- | nenhum | Segundos para estabelecer a conexão. |
transport_connect_timeout |
- | - | Segundos para a própria conexão TCP. |
retry_count / retry_delay |
- | - / 0 | Tentativas de conexão e o intervalo entre elas. |
ssl_server_dn_match |
- | ON (clientes 19.2+) | Verifique o DN do certificado do servidor em relação ao host. |
wallet_location |
- | - | Diretório com o wallet para TCPS. |
Atributos da string de conexão ODP.NET
Estilo ADO.NET. Data Source aceita uma string Easy Connect, um alias TNS ou um descritor completo.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
User Id |
- | - | Usuário do banco de dados. |
Password |
- | - | Senha; coloque entre aspas duplas se contiver caracteres especiais. |
Data Source |
- | - | Easy Connect, alias ou descritor. |
DBA Privilege |
- | - | SYSDBA, SYSOPER, SYSASM, SYSBACKUP, SYSDG, SYSKM, SYSRAC. |
Connection Timeout |
- | 15 | Segundos para aguardar por uma conexão no pool. |
Pooling |
- | true | Pool de conexões. |
Max Pool Size |
- | 100 | Maior pool. |
Min Pool Size |
- | 1 | Menor pool. |
Incr Pool Size |
- | 5 | Conexões adicionadas quando o pool cresce. |
Statement Cache Size |
- | 0 | Instruções armazenadas em cache por conexão. |
Validate Connection |
- | falso | Verifique uma conexão do pool antes de entregá-la. |
Connection Lifetime |
- | 0 | Segundos que uma conexão do pool pode viver. |
Formas de URL thin do Oracle JDBC
Passe o usuário e a senha como propriedades de conexão em vez de incorporá-los.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
jdbc:oracle:thin:@//host:port/service |
- | - | Nome do serviço (Easy Connect). |
jdbc:oracle:thin:@tcps://host:port/service |
- | - | TLS; adicionar ?wallet_location=/path para uma wallet. |
jdbc:oracle:thin:@(DESCRIPTION=...) |
- | - | Descritor de conexão completo. |
jdbc:oracle:thin:@alias?TNS_ADMIN=/path |
- | - | Alias TNS do tnsnames.ora nesse diretório (ou a oracle.net.tns_admin propriedade). |
jdbc:oracle:thin:@host:port:SID |
- | - | Formato de SID legado; prefira um nome de serviço. |
Erros comuns de conexão Oracle
ORA-12154: TNS:could not resolve the connect identifier specified
Por que: O cliente tratou a string como um alias TNS e não pôde encontrá-la: nenhum tnsnames.ora, TNS_ADMIN apontando para outro lugar, ou um erro de digitação no alias ou na string Easy Connect.
Correção: Use Easy Connect (host:1521/service) ou um descritor completo para ignorar o tnsnames.ora, ou defina TNS_ADMIN para o diretório que contém o arquivo.
ORA-12514: TNS:listener does not currently know of service requested in connect descriptor
Por que: O listener está acessível, mas nenhum banco de dados registrou nele esse nome de serviço: um serviço errado ou mal digitado, um SID dado como nome de serviço, ou o banco de dados não está aberto.
Correção: Executar lsnrctl services (ou pergunte ao DBA) pelos serviços registrados e use um desses nomes.
ORA-12505: TNS:listener does not currently know of SID given in connect descriptor
Por que: A string conecta pelo SID (host:port:SID ou (SID=...)) e o valor não é um SID que o listener conhece, muitas vezes porque é realmente um nome de serviço.
Correção: Mude para a forma de nome de serviço: //host:port/service_name.
ORA-12541: TNS:no listener
Por que: Nada está escutando nesse host e porta: o listener está fora do ar, a porta está errada ou um firewall está bloqueando.
Correção: Verificar lsnrctl status no servidor, a porta (1521 por padrão) e o firewall.
ORA-01017: invalid username/password; logon denied
Por que: Nome de usuário ou senha incorretos. As senhas diferenciam maiúsculas de minúsculas, e uma senha com caracteres especiais pode precisar de aspas duplas no SQL*Plus.
Correção: Verifique as credenciais; coloque a senha entre aspas no SQL*Plus como user/"p@ss"@host/service.
ORA-28000: the account is locked
Por que: Muitas tentativas de login falharam ou um DBA bloqueou a conta.
Correção: Um DBA executa ALTER USER app_user ACCOUNT UNLOCK;.
FAQ de string de conexão do Oracle
O que é uma string Oracle Easy Connect?
Um identificador de conexão compacto, host[:port]/service_name, que não necessita de entrada no tnsnames.ora. Easy Connect Plus (19c e versões posteriores) adiciona tcps://, vários hosts e ?parameter=value opções como connect_timeout.
Qual é a diferença entre um SID e um nome de serviço?
Um SID nomeia uma instância de banco de dados; um nome de serviço é o que os clientes pedem ao listener, e um banco de dados (ou banco de dados plugável) pode oferecer vários. Bancos de dados modernos e em nuvem são acessados pelo nome do serviço. Easy Connect aceita apenas nomes de serviço.
Qual é a porta padrão do Oracle?
1521 para o listener. TLS (TCPS) usa a mesma porta padrão, a menos que você configure outra; muitos sites usam 2484, a porta registrada para Oracle sobre TLS.
Como faço para me conectar com o python-oracledb sem instalar o Oracle Client?
python-oracledb roda no modo Thin por padrão e não precisa de bibliotecas do Oracle Client: oracledb.connect(user=..., password=..., dsn="host:1521/service").
O SQLly pode abrir uma conexão Oracle a partir de uma string de conexão?
O SQLLY se conecta ao Oracle, mas o leitor de string de conexão colada ainda não aceita strings do Oracle, então o botão Abrir no SQLLY fica desativado para o Oracle. Informe o host, a porta e o nome do serviço no editor de conexão do SQLLY.
Outros mecanismos
- Strings de conexão do SQL Server
- Strings de conexão do PostgreSQL
- Strings de conexão do MySQL
- Strings de conexão do MariaDB
- Strings de conexão do SQLite
- Strings de conexão do Redis
- Strings de conexão do ClickHouse
- Strings de conexão do DuckDB
- Strings de conexão do libSQL
- Todos os mecanismos e formatos
- Formatador SQL
- Todas as ferramentas gratuitas
Conecte-se uma vez. Depois é só escrever SQL.
O SQLly é um ambiente de trabalho SQL nativo para macOS, Windows e Linux. Cole uma string de conexão no editor de conexões, mantenha as senhas no chaveiro do sistema e tenha IntelliSense baseado no esquema no Oracle e muito mais.