// herramienta gratuita

Generador de cadenas de conexión de Oracle

Crea una cadena Oracle Easy Connect, un descriptor de conexión TNS, una URL JDBC thin o una cadena ODP.NET a partir de un formulario, o pega una para ver el host, el puerto y el nombre del servicio y detectar la confusión entre SID y nombre del servicio. Todo se ejecuta en tu navegador: nada de lo que escribas se envía a ningún lugar.

Abrir esta conexión en SQLly

Abre el editor de conexiones de SQLly con los datos ya rellenados.

Privado por diseño. El constructor y el decodificador son JavaScript puro que se ejecuta en esta pestaña. La página no envía ninguna solicitud con lo que escribes, no almacena nada (ni siquiera en tu navegador) y sigue funcionando sin conexión una vez cargada. El enlace Abrir en SQLly va directamente desde tu navegador a la aplicación en tu computadora.

Formatos de cadena de conexión de Oracle

Los clientes de Oracle nombran una base de datos de tres formas: Easy Connect (host:1521/service_name), un descriptor de conexión completo ((DESCRIPTION=(ADDRESS=...)(CONNECT_DATA=(SERVICE_NAME=...)))), o un alias TNS buscado en tnsnames.ora. JDBC thin, ODP.NET, python-oracledb y node-oracledb aceptan las dos primeras.

El error clásico es confundir un SID con un nombre de servicio. A las bases de datos conectables (pluggable) y a las de la nube se accede por el nombre de servicio; Easy Connect no sabe expresar un SID, y la forma antigua de JDBC host:port:SID falla con ORA-12505 cuando le das un nombre de servicio.

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

Descriptor de conexión tnsnames.ora, todos los clientes de 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 de SQLAlchemy python-oracledb

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

Los marcadores de posición como your_password son eso mismo: construye tu propia cadena con el formulario de arriba. Más sobre cómo conectar SQLly a Oracle: SQLly para Oracle.

Sintaxis de Easy Connect (Plus)

[[protocol:]//]host[,host2][:port][/service_name][:server_type][/instance_name][?parameter=value&...]. El protocolo es tcp (predeterminado) o tcps; el puerto predeterminado es 1521 para ambos. No se pueden usar SIDs en Easy Connect.

Palabra claveSinónimosPredeterminadoLo que hace
protocol - tcp tcps:// usa TLS. Los listeners TLS suelen usar 2484, el puerto registrado de Oracle, pero tienes que escribirlo.
port - 1521 Puerto del listener.
service_name - - Servicio de base de datos, por ejemplo un nombre de PDB como FREEPDB1 o ORCLPDB1.
server_type - - dedicated, shared o pooled.
connect_timeout - ninguno Segundos para establecer la conexión.
transport_connect_timeout - - Segundos para la conexión TCP en sí.
retry_count / retry_delay - - / 0 Reintentos de conexión y el tiempo de espera entre ellos.
ssl_server_dn_match - ON (clientes 19.2+) Comprueba que el DN del certificado del servidor coincide con el host.
wallet_location - - Directorio con la cartera para TCPS.

Atributos de la cadena de conexión ODP.NET

Estilo ADO.NET. Data Source acepta una cadena Easy Connect, un alias TNS o un descriptor completo.

Palabra claveSinónimosPredeterminadoLo que hace
User Id - - Usuario de la base de datos.
Password - - Contraseña; colócala entre comillas dobles si contiene caracteres especiales.
Data Source - - Easy Connect, alias o descriptor.
DBA Privilege - - SYSDBA, SYSOPER, SYSASM, SYSBACKUP, SYSDG, SYSKM, SYSRAC.
Connection Timeout - 15 Segundos de espera por una conexión del pool.
Pooling - verdadero Agrupación de conexiones.
Max Pool Size - 100 Pool más grande.
Min Pool Size - 1 Pool más pequeño.
Incr Pool Size - 5 Conexiones añadidas cuando el grupo crece.
Statement Cache Size - 0 Instrucciones almacenadas en caché por conexión.
Validate Connection - falso Verifica una conexión del pool antes de entregarla.
Connection Lifetime - 0 Segundos que puede vivir una conexión del pool.

Formatos de URL de Oracle JDBC thin

Pasa el usuario y la contraseña como propiedades de conexión en lugar de incrustarlos.

Palabra claveSinónimosPredeterminadoLo que hace
jdbc:oracle:thin:@//host:port/service - - Nombre del servicio (Easy Connect).
jdbc:oracle:thin:@tcps://host:port/service - - TLS; añade ?wallet_location=/path para un wallet.
jdbc:oracle:thin:@(DESCRIPTION=...) - - Descriptor de conexión completo.
jdbc:oracle:thin:@alias?TNS_ADMIN=/path - - Alias TNS de tnsnames.ora en ese directorio (o la oracle.net.tns_admin propiedad).
jdbc:oracle:thin:@host:port:SID - - Formato SID heredado; se prefiere un nombre de servicio.

Errores comunes de conexión a Oracle

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

Por qué: El cliente interpretó la cadena como un alias TNS y no lo encontró: no tnsnames.ora, TNS_ADMIN apuntando a otro lugar, o un error tipográfico en el alias o en la cadena de Easy Connect.

Solución: Usa Easy Connect (host:1521/service) o un descriptor completo para omitir tnsnames.ora, o configura TNS_ADMIN al directorio que contiene el archivo.

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

Por qué: El listener es accesible, pero ninguna base de datos ha registrado ese nombre de servicio con él: un servicio incorrecto o mal escrito, un SID usado como nombre de servicio, o la base de datos no está abierta.

Solución: Ejecutar lsnrctl services (o pregunta al DBA) por los servicios registrados y usa uno de esos nombres.

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

Por qué: La cadena se conecta por SID (host:port:SID o (SID=...)) y el valor no es un SID que el listener conozca, a menudo porque realmente es un nombre de servicio.

Solución: Cambia a la forma de nombre de servicio: //host:port/service_name.

ORA-12541: TNS:no listener

Por qué: No hay nada escuchando en ese host y puerto: el listener está caído, el puerto es incorrecto o un firewall lo bloquea.

Solución: Comprobar lsnrctl status en el servidor, el puerto (1521 por defecto) y el firewall.

ORA-01017: invalid username/password; logon denied

Por qué: Nombre de usuario o contraseña incorrectos. Las contraseñas distinguen entre mayúsculas y minúsculas, y una contraseña con caracteres especiales puede necesitar comillas dobles en SQL*Plus.

Solución: Verifica las credenciales; pon la contraseña entre comillas en SQL*Plus como user/"p@ss"@host/service.

ORA-28000: the account is locked

Por qué: Demasiados intentos de inicio de sesión fallidos o un DBA bloqueó la cuenta.

Solución: Un DBA ejecuta ALTER USER app_user ACCOUNT UNLOCK;.

Preguntas frecuentes sobre la cadena de conexión de Oracle

¿Qué es una cadena Easy Connect de Oracle?

Un identificador de conexión compacto, host[:port]/service_name, que no necesita una entrada en tnsnames.ora. Easy Connect Plus (19c y posteriores) añade tcps://, varios hosts y ?parameter=value opciones como connect_timeout.

¿Cuál es la diferencia entre un SID y un nombre de servicio?

Un SID nombra una instancia de base de datos; un nombre de servicio es lo que los clientes piden al listener, y una base de datos (o base de datos conectable) puede ofrecer varios. Las bases de datos modernas y en la nube se acceden por nombre de servicio. Easy Connect solo acepta nombres de servicio.

¿Cuál es el puerto predeterminado de Oracle?

1521 para el listener. TLS (TCPS) usa el mismo valor predeterminado a menos que configures otro puerto; muchos sitios usan 2484, el puerto registrado para Oracle sobre TLS.

¿Cómo me conecto con python-oracledb sin instalar Oracle Client?

python-oracledb funciona en modo Thin por defecto y no necesita las bibliotecas cliente de Oracle: oracledb.connect(user=..., password=..., dsn="host:1521/service").

¿Puede SQLly abrir una conexión de Oracle desde una cadena de conexión?

SQLly se conecta a Oracle, pero su lector de cadenas de conexión pegadas aún no acepta las de Oracle, así que el botón Abrir en SQLly está desactivado para Oracle. Introduce el host, el puerto y el nombre del servicio en el editor de conexiones de SQLly en su lugar.

// olvídate de las cadenas por completo

Conéctate una vez. Luego solo escribe SQL.

SQLly es un entorno de trabajo SQL nativo para macOS, Windows y Linux. Pega una cadena de conexión en su editor de conexiones, guarda las contraseñas en el llavero del sistema y obtén IntelliSense que entiende el esquema en Oracle, entre otros.