// kostenloses Werkzeug

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.

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üsselwortSynonymeStandardWas 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üsselwortSynonymeStandardWas 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üsselwortSynonymeStandardWas 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.

// ganz ohne Verbindungszeichenfolgen

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.