// ferramenta gratuita

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.

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-chaveSinônimosPadrãoO 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-chaveSinônimosPadrãoO 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-chaveSinônimosPadrãoO 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.

// dispense as strings por completo

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.