Oracle-Verbindungszeichenfolgen-Generator
Eine Oracle-Easy-Connect-Zeichenfolge, einen TNS-Verbindungsdeskriptor, eine JDBC-Thin-URL oder eine ODP.NET-Zeichenfolge in einem Formular erstellen oder eine einfügen, um Host, Port und Service-Name zu sehen und die Verwechslung von SID und Service-Name zu erkennen. Alles läuft in deinem Browser: Nichts, was du eingibst, wird irgendwohin gesendet.
Diese Verbindung in SQLly öffnen
Öffnet den Verbindungseditor von SQLly mit vorausgefüllten Angaben.
Diese Verbindung in SQLly öffnen
Privat von Grund auf. Der Builder und der Decoder sind einfaches JavaScript, das in diesem Tab läuft. Die Seite sendet keine Anfrage mit dem, was du eingibst, speichert nichts (nicht einmal in deinem Browser) und funktioniert weiter offline, sobald sie geladen ist. Der Link „In SQLly öffnen“ geht direkt von deinem Browser zur App auf deinem Computer.
Formate für Oracle-Verbindungszeichenfolgen
Oracle-Clients benennen eine Datenbank auf drei Arten: Easy Connect (host:1521/service_name), ein vollständiger Verbindungsdeskriptor ((DESCRIPTION=(ADDRESS=...)(CONNECT_DATA=(SERVICE_NAME=...)))), oder ein TNS-Alias, der in tnsnames.ora. JDBC thin, ODP.NET, python-oracledb und node-oracledb akzeptieren alle die ersten beiden.
Der klassische Fehler: SID und Servicename verwechseln. Pluggable-Datenbanken und Cloud-Datenbanken erreicht man über den Servicenamen; Easy Connect kann eine SID gar nicht ausdrücken, und die alte JDBC-Form host:port:SID schlägt mit ORA-12505 fehl, wenn du ihr einen Servicenamen gibst.
Easy Connect SQL*Plus, SQLcl, python-oracledb, node-oracledb, ODP.NET
db.example.com:1521/FREEPDB1
Easy Connect über TLS Easy Connect Plus
tcps://db.example.com:2484/FREEPDB1
Verbindungsdeskriptor tnsnames.ora, jeder Oracle-Client
(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;
SQLAlchemy-URL python-oracledb
oracle+oracledb://app_user:[email protected]:1521/?service_name=FREEPDB1
Platzhalter wie your_password sind genau das: Stell deine eigene Verbindungszeichenfolge mit dem Formular oben zusammen. Mehr dazu, wie du SQLly mit Oracle verbindest: SQLly für Oracle.
Easy Connect (Plus) Syntax
[[protocol:]//]host[,host2][:port][/service_name][:server_type][/instance_name][?parameter=value&...]. Das Protokoll ist tcp (Standard) oder tcps; der Port ist standardmäßig 1521 für beide. SIDs können in Easy Connect nicht verwendet werden.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
protocol |
- | tcp | tcps:// verwendet TLS. TLS-Listener nutzen üblicherweise 2484, Oracles registrierten Port, aber du musst ihn ausschreiben. |
port |
- | 1521 | Listener-Port. |
service_name |
- | - | Datenbankdienst, z. B. ein PDB-Name wie FREEPDB1 oder ORCLPDB1. |
server_type |
- | - | dedicated, shared oder pooled. |
connect_timeout |
- | keiner | Sekunden, um die Verbindung herzustellen. |
transport_connect_timeout |
- | - | Sekunden für die TCP-Verbindung selbst. |
retry_count / retry_delay |
- | - / 0 | Verbindungswiederholungen und die Verzögerung dazwischen. |
ssl_server_dn_match |
- | ON (Clients ab 19.2) | Vergleiche den DN des Serverzertifikats mit dem Host. |
wallet_location |
- | - | Verzeichnis mit dem Wallet für TCPS. |
ODP.NET-Verbindungszeichenfolgenattribute
ADO.NET-Stil. Data Source nimmt eine Easy Connect-Zeichenfolge, ein TNS-Alias oder einen vollständigen Deskriptor.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
User Id |
- | - | Datenbankbenutzer. |
Password |
- | - | Passwort; setzen Sie es in doppelte Anführungszeichen, wenn es Sonderzeichen enthält. |
Data Source |
- | - | Easy Connect, Alias oder Deskriptor. |
DBA Privilege |
- | - | SYSDBA, SYSOPER, SYSASM, SYSBACKUP, SYSDG, SYSKM, SYSRAC. |
Connection Timeout |
- | 15 | Sekunden, um auf eine Verbindung aus dem Pool zu warten. |
Pooling |
- | wahr | Verbindungs-Pooling. |
Max Pool Size |
- | 100 | Größter Pool. |
Min Pool Size |
- | 1 | Kleinster Pool. |
Incr Pool Size |
- | 5 | Verbindungen, die beim Wachsen des Pools hinzugefügt werden. |
Statement Cache Size |
- | 0 | Pro Verbindung zwischengespeicherte Anweisungen. |
Validate Connection |
- | falsch | Prüfe eine gepoolte Verbindung, bevor du sie weitergibst. |
Connection Lifetime |
- | 0 | Sekunden, die eine Verbindung aus dem Pool leben darf. |
Oracle JDBC Thin URL-Formate
Übergib Benutzername und Passwort als Verbindungseigenschaften, statt sie einzubetten.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
jdbc:oracle:thin:@//host:port/service |
- | - | Dienstname (Easy Connect). |
jdbc:oracle:thin:@tcps://host:port/service |
- | - | TLS; hinzufügen von ?wallet_location=/path für eine Wallet. |
jdbc:oracle:thin:@(DESCRIPTION=...) |
- | - | Vollständiger Verbindungsdescriptor. |
jdbc:oracle:thin:@alias?TNS_ADMIN=/path |
- | - | TNS-Alias aus tnsnames.ora in diesem Verzeichnis (oder der oracle.net.tns_admin Eigenschaft). |
jdbc:oracle:thin:@host:port:SID |
- | - | Alte SID-Form; lieber einen Servicenamen verwenden. |
Häufige Oracle-Verbindungsfehler
ORA-12154: TNS:could not resolve the connect identifier specified
Warum: Der Client behandelte die Zeichenfolge als TNS-Alias und konnte sie nicht finden: kein tnsnames.ora, TNS_ADMIN verweis auf einen anderen Ort oder ein Tippfehler im Alias oder Easy Connect-String.
Lösung: Verwende Easy Connect (host:1521/service) oder einen vollständigen Descriptor, um tnsnames.ora zu überspringen, oder setze TNS_ADMIN auf das Verzeichnis, das die Datei enthält.
ORA-12514: TNS:listener does not currently know of service requested in connect descriptor
Warum: Der Listener ist erreichbar, aber keine Datenbank hat diesen Servicenamen bei ihm registriert: ein falscher oder falsch geschriebener Service, eine als Servicename angegebene SID oder die Datenbank ist nicht geöffnet.
Lösung: Ausführen lsnrctl services (oder frag den DBA) nach den registrierten Diensten und nimm einen dieser Namen.
ORA-12505: TNS:listener does not currently know of SID given in connect descriptor
Warum: Die Zeichenfolge verbindet über SID (host:port:SID oder (SID=...)) und der Wert ist keine SID, die der Listener kennt, oft weil es in Wirklichkeit ein Dienstname ist.
Lösung: Wechsle zum Servicenamen-Format: //host:port/service_name.
ORA-12541: TNS:no listener
Warum: An diesem Host und Port lauscht nichts: Der Listener ist nicht aktiv, der Port ist falsch oder eine Firewall blockiert ihn.
Lösung: Prüfen lsnrctl status auf dem Server, den Port (standardmäßig 1521) und die Firewall.
ORA-01017: invalid username/password; logon denied
Warum: Falscher Benutzername oder falsches Passwort. Bei Passwörtern wird Groß- und Kleinschreibung unterschieden, und ein Passwort mit Sonderzeichen braucht in SQL*Plus eventuell doppelte Anführungszeichen.
Lösung: Prüfe die Anmeldedaten; setze das Passwort in SQL*Plus als user/"p@ss"@host/service.
ORA-28000: the account is locked
Warum: Zu viele fehlgeschlagene Anmeldungen oder ein DBA hat das Konto gesperrt.
Lösung: Ein DBA startet ALTER USER app_user ACCOUNT UNLOCK;.
FAQ zur Oracle-Verbindungszeichenfolge
Was ist eine Oracle Easy Connect-Zeichenfolge?
Ein kompakter Verbindungsbezeichner, host[:port]/service_name, der keinen tnsnames.ora-Eintrag benötigt. Easy Connect Plus (ab 19c) fügt tcps://, mehrere Hosts und ?parameter=value Optionen wie connect_timeout.
Was ist der Unterschied zwischen einer SID und einem Servicenamen?
Eine SID bezeichnet eine Datenbankinstanz; ein Servicename ist der Name, nach dem Clients beim Listener fragen, und eine Datenbank (oder Pluggable Database) kann mehrere davon anbieten. Moderne und Cloud-Datenbanken werden über den Servicenamen erreicht. Easy Connect akzeptiert nur Servicenamen.
Was ist Oracles Standardport?
1521 für den Listener. TLS (TCPS) verwendet denselben Standard, außer du konfigurierst einen anderen Port; viele Installationen verwenden 2484, den für Oracle über TLS registrierten Port.
Wie verbinde ich mich mit python-oracledb, ohne Oracle Client zu installieren?
python-oracledb läuft standardmäßig im Thin-Modus und benötigt keine Oracle Client-Bibliotheken: oracledb.connect(user=..., password=..., dsn="host:1521/service").
Kann SQLly eine Oracle-Verbindung aus einer Verbindungszeichenfolge öffnen?
SQLLY verbindet sich mit Oracle, aber sein Reader für eingefügte Verbindungszeichenfolgen akzeptiert noch keine Oracle-Zeichenfolgen, daher ist der Button „In SQLly öffnen“ für Oracle deaktiviert. Gib Host, Port und Servicenamen stattdessen in SQLlys Verbindungseditor ein.
Andere Engines
- SQL Server-Verbindungszeichenfolgen
- PostgreSQL-Verbindungszeichenfolgen
- MySQL-Verbindungszeichenfolgen
- MariaDB-Verbindungszeichenfolgen
- SQLite-Verbindungszeichenfolgen
- Redis-Verbindungszeichenfolgen
- ClickHouse-Verbindungszeichenfolgen
- DuckDB-Verbindungszeichenfolgen
- libSQL-Verbindungszeichenfolgen
- Alle Engines und Formate
- SQL-Formatter
- Alle kostenlosen Tools
Einmal verbinden. Dann einfach SQL schreiben.
SQLLY ist eine native SQL-Workbench für macOS, Windows und Linux. Füge eine Verbindungszeichenfolge in den Verbindungseditor ein, speichere Passwörter in deinem System-Schlüsselbund, und erhalte schemabewusstes IntelliSense für Oracle und mehr.