Générateur de chaînes de connexion Oracle
Construisez une chaîne Oracle Easy Connect, un descripteur de connexion TNS, une URL JDBC thin ou une chaîne ODP.NET depuis un formulaire, ou collez-en une pour voir l'hôte, le port et le nom du service et repérer la confusion entre SID et nom de service. Tout fonctionne dans votre navigateur : rien de ce que vous tapez n'est envoyé quelque part.
Ouvrir cette connexion dans SQLly
Ouvre l'éditeur de connexion de SQLly, prérempli.
Ouvrir cette connexion dans SQLly
Privé par conception. Le constructeur et le décodeur sont du JavaScript pur fonctionnant dans cet onglet. La page n'envoie aucune requête avec ce que vous tapez, ne stocke rien (pas même dans votre navigateur) et continue de fonctionner hors ligne une fois chargée. Le lien Ouvrir dans SQLly va directement de votre navigateur à l'application sur votre ordinateur.
Formats de chaînes de connexion Oracle
Les clients Oracle nomment une base de données de trois manières : Easy Connect (host:1521/service_name), un descripteur de connexion complet ((DESCRIPTION=(ADDRESS=...)(CONNECT_DATA=(SERVICE_NAME=...)))), ou un alias TNS consulté dans tnsnames.ora. JDBC thin, ODP.NET, python-oracledb et node-oracledb acceptent tous les deux premiers.
L'erreur classique consiste à confondre un SID et un nom de service. Les bases pluggables et les bases cloud sont jointes via le nom de service ; Easy Connect ne peut pas exprimer de SID du tout, et la forme JDBC héritée host:port:SID échoue avec ORA-12505 lorsque vous lui donnez un nom de service.
Easy Connect SQL*Plus, SQLcl, python-oracledb, node-oracledb, ODP.NET
db.example.com:1521/FREEPDB1
Easy Connect via TLS Easy Connect Plus
tcps://db.example.com:2484/FREEPDB1
Descripteur de connexion tnsnames.ora, chaque client 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
Espaces réservés tels que your_password sont exactement cela : construisez votre propre chaîne avec le formulaire ci-dessus. Pour en savoir plus sur la connexion de SQLly à Oracle : SQLly pour Oracle.
Syntaxe Easy Connect (Plus)
[[protocol:]//]host[,host2][:port][/service_name][:server_type][/instance_name][?parameter=value&...]. Le protocole est tcp (par défaut) ou tcps; le port est par défaut 1521 pour les deux. Les SID ne peuvent pas être utilisés dans Easy Connect.
| Mot-clé | Synonymes | Par défaut | Ce que cela fait |
|---|---|---|---|
protocol |
- | tcp | tcps:// utilise TLS. Les écouteurs TLS utilisent généralement le port 2484, celui enregistré pour Oracle, mais vous devez l'écrire. |
port |
- | 1521 | Port de l'écouteur. |
service_name |
- | - | Service de base de données, par exemple un nom de PDB tel que FREEPDB1 ou ORCLPDB1. |
server_type |
- | - | dedicated, shared ou pooled. |
connect_timeout |
- | aucun | Secondes pour établir la connexion. |
transport_connect_timeout |
- | - | Secondes pour la connexion TCP elle-même. |
retry_count / retry_delay |
- | - / 0 | Tentatives de reconnexion et délai entre elles. |
ssl_server_dn_match |
- | ON (clients 19.2+) | Vérifier le DN du certificat du serveur par rapport à l'hôte. |
wallet_location |
- | - | Répertoire contenant le wallet pour TCPS. |
Attributs de la chaîne de connexion ODP.NET
Style ADO.NET. Data Source prend une chaîne Easy Connect, un alias TNS ou un descripteur complet.
| Mot-clé | Synonymes | Par défaut | Ce que cela fait |
|---|---|---|---|
User Id |
- | - | Utilisateur de base de données. |
Password |
- | - | Mot de passe ; mettez-le entre guillemets doubles s'il contient des caractères spéciaux. |
Data Source |
- | - | Easy Connect, alias ou descripteur. |
DBA Privilege |
- | - | SYSDBA, SYSOPER, SYSASM, SYSBACKUP, SYSDG, SYSKM, SYSRAC. |
Connection Timeout |
- | 15 | Secondes d'attente d'une connexion du pool. |
Pooling |
- | vrai | Pool de connexions. |
Max Pool Size |
- | 100 | Plus grand pool. |
Min Pool Size |
- | 1 | Plus petit pool. |
Incr Pool Size |
- | 5 | Connexions ajoutées lorsque le pool s'agrandit. |
Statement Cache Size |
- | 0 | Instructions mises en cache par connexion. |
Validate Connection |
- | faux | Vérifier une connexion du pool avant de l'allouer. |
Connection Lifetime |
- | 0 | Secondes de durée de vie d'une connexion du pool. |
Formats d'URL Oracle JDBC thin
Passez l'utilisateur et le mot de passe en tant que propriétés de connexion plutôt que de les intégrer.
| Mot-clé | Synonymes | Par défaut | Ce que cela fait |
|---|---|---|---|
jdbc:oracle:thin:@//host:port/service |
- | - | Nom du service (Easy Connect). |
jdbc:oracle:thin:@tcps://host:port/service |
- | - | TLS ; ajouter ?wallet_location=/path pour un wallet. |
jdbc:oracle:thin:@(DESCRIPTION=...) |
- | - | Descripteur de connexion complet. |
jdbc:oracle:thin:@alias?TNS_ADMIN=/path |
- | - | Alias TNS à partir de tnsnames.ora dans ce répertoire (ou la oracle.net.tns_admin propriété). |
jdbc:oracle:thin:@host:port:SID |
- | - | Forme SID héritée ; préférez un nom de service. |
Erreurs de connexion Oracle courantes
ORA-12154: TNS:could not resolve the connect identifier specified
Pourquoi : Le client a traité la chaîne comme un alias TNS et n'a pas pu le trouver : aucun tnsnames.ora, TNS_ADMIN pointant ailleurs, ou une faute de frappe dans l'alias ou la chaîne Easy Connect.
Correction : Utilisez Easy Connect (host:1521/service) ou un descripteur complet pour ignorer tnsnames.ora, ou définissez TNS_ADMIN vers le répertoire qui contient le fichier.
ORA-12514: TNS:listener does not currently know of service requested in connect descriptor
Pourquoi : Le listener est joignable mais aucune base de données n'a enregistré ce nom de service auprès de lui : un service incorrect ou mal orthographié, un SID donné comme nom de service, ou la base de données n'est pas ouverte.
Correction : Exécuter lsnrctl services (ou demandez au DBA) pour les services enregistrés et utilisez l'un de ces noms.
ORA-12505: TNS:listener does not currently know of SID given in connect descriptor
Pourquoi : La chaîne se connecte par SID (host:port:SID ou (SID=...)) et la valeur n'est pas un SID que l'écouteur connaît, souvent parce que c'est vraiment un nom de service.
Correction : Passez à la forme nom de service : //host:port/service_name.
ORA-12541: TNS:no listener
Pourquoi : Rien n'écoute sur cet hôte et ce port : l'écouteur est arrêté, le port est incorrect ou un pare-feu le bloque.
Correction : Vérifier lsnrctl status sur le serveur, le port (1521 par défaut) et le pare-feu.
ORA-01017: invalid username/password; logon denied
Pourquoi : Nom d'utilisateur ou mot de passe incorrect. Les mots de passe sont sensibles à la casse, et un mot de passe contenant des caractères spéciaux peut nécessiter des guillemets doubles dans SQL*Plus.
Correction : Vérifiez les identifiants ; mettez le mot de passe entre guillemets dans SQL*Plus comme user/"p@ss"@host/service.
ORA-28000: the account is locked
Pourquoi : Trop de tentatives de connexion échouées, ou un DBA a verrouillé le compte.
Correction : Un DBA exécute ALTER USER app_user ACCOUNT UNLOCK;.
FAQ sur la chaîne de connexion Oracle
Qu'est-ce qu'une chaîne de connexion Oracle Easy Connect ?
Un identifiant de connexion compact, host[:port]/service_name, qui ne nécessite pas d'entrée dans tnsnames.ora. Easy Connect Plus (19c et versions ultérieures) ajoute tcps://, plusieurs hôtes et ?parameter=value options telles que connect_timeout.
Quelle est la différence entre un SID et un nom de service ?
Un SID nomme une instance de base de données ; un nom de service est ce que les clients demandent au listener, et une base de données (ou une base de données pluggable) peut en offrir plusieurs. Les bases de données modernes et cloud sont accessibles par nom de service. Easy Connect ne prend que des noms de service.
Quel est le port par défaut d'Oracle ?
1521 pour le listener. TLS (TCPS) utilise le même port par défaut sauf si vous configurez un autre port ; de nombreux sites utilisent 2484, le port enregistré pour Oracle sur TLS.
Comment me connecter avec python-oracledb sans installer le client Oracle ?
python-oracledb fonctionne en mode Thin par défaut et n'a pas besoin des bibliothèques du client Oracle : oracledb.connect(user=..., password=..., dsn="host:1521/service").
SQLly peut-il ouvrir une connexion Oracle à partir d'une chaîne de connexion ?
SQLly se connecte à Oracle, mais sa lecture des chaînes de connexion collées ne gère pas encore les chaînes Oracle, donc le bouton Ouvrir dans SQLly est désactivé pour Oracle. Saisissez plutôt l'hôte, le port et le nom du service dans l'éditeur de connexion de SQLly.
Autres moteurs
- Chaînes de connexion SQL Server
- Chaînes de connexion PostgreSQL
- Chaînes de connexion MySQL
- Chaînes de connexion MariaDB
- Chaînes de connexion SQLite
- Chaînes de connexion Redis
- Chaînes de connexion ClickHouse
- Chaînes de connexion DuckDB
- Chaînes de connexion libSQL
- Tous les moteurs et formats
- Formateur SQL
- Tous les outils gratuits
Connectez-vous une fois. Ensuite, écrivez simplement du SQL.
SQLly est un atelier SQL natif pour macOS, Windows et Linux. Collez une chaîne de connexion dans son éditeur de connexion, gardez les mots de passe dans votre trousseau système et profitez d'un IntelliSense conscient du schéma sur Oracle et plus encore.