// kostenloses Werkzeug

MariaDB-Verbindungszeichenfolgen-Builder

Eine MariaDB-JDBC-URL, eine ADO.NET-Zeichenfolge oder einen Go-DSN in einem Formular erstellen oder eine davon einfügen, um zu sehen, was jede Option bewirkt und ob TLS wirklich geprüft wird. 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.

MariaDB-Verbindungszeichenfolgen-Formate

MariaDB spricht das MySQL-Protokoll, daher verbinden sich MySQL-Treiber (MySqlConnector, go-sql-driver/mysql, mysql2) mit denselben Verbindungsstrings. MariaDBs eigener Connector/J verwendet jdbc:mariadb:// und andere sslMode Wörter als MySQLs: disable, trust, verify-ca, verify-full.

Beachte den Connector/J-Standard: Version 3.x verbindet sich ohne TLS, wenn sslMode nicht gesetzt ist, und 4.0 änderte den Standard zu verify-full, was bei einem Server mit einem selbstsignierten Zertifikat fehlschlägt.

JDBC MariaDB Connector/J

jdbc:mariadb://db.example.com/sales?user=app_user&password=your_password&sslMode=verify-full

ADO.NET MySqlConnector

Server=db.example.com;Database=sales;User ID=app_user;Password=your_password;SslMode=VerifyFull;

Go DSN github.com/go-sql-driver/mysql

app_user:your_password@tcp(db.example.com)/sales?tls=true

SQLAlchemy-URL MariaDB Connector/Python

mariadb+mariadbconnector://app_user:[email protected]/sales

URI SQLly und URI-ähnliche Tools

mariadb://app_user:[email protected]/sales?ssl-mode=VERIFY_IDENTITY

Platzhalter wie your_password sind genau das: Stell deine eigene Verbindungszeichenfolge mit dem Formular oben zusammen. Mehr dazu, wie du SQLly mit MariaDB verbindest: SQLly für MariaDB.

MariaDB Connector/J-Optionen

URL-Format: jdbc:mariadb:[replication:|loadbalance:|sequential:]//host[:port][,...]/[database][?key=value&...]. Connector/J 3.x akzeptiert nur jdbc:mysql: mit permitMysqlScheme.

SchlüsselwortSynonymeStandardWas es bewirkt
user / password - - Zugangsdaten.
sslMode - deaktivieren (3.x); verify-full (4.0+) disable, trust (verschlüsseln, keine Überprüfungen), verify-ca, verify-full, und allow (3.5.11+).
serverSslCert - - CA- oder Serverzertifikat (Pfad oder PEM) für verify-ca / verify-full.
connectTimeout - 30000 Millisekunden Wartezeit für die Verbindung.
socketTimeout - 0 Millisekunden, die ein Lesevorgang blockieren darf.
allowPublicKeyRetrieval - falsch Fordere den RSA-Schlüssel des Servers ohne TLS an.

Optionen für MySqlConnector (ADO.NET)

MySqlConnector und Oracles Connector/NET (MySql.Data) teilen die meisten Schlüsselwörter. Werte mit ; kommen in doppelte Anführungszeichen.

SchlüsselwortSynonymeStandardWas es bewirkt
Server Host, Datenquelle, Adresse localhost Host, kommagetrennte Liste oder ein Unix-Socket-Pfad.
Port - 3306 TCP-Port.
User ID UID, Benutzer, Benutzername - Benutzername.
Password PWD - Passwort.
Database Initialkatalog - Standardschema.
SslMode SSL-Modus Bevorzugt None/Disabled, Preferred, Required, VerifyCA, VerifyFull.
SslCa CA-Zertifikatdatei, Ssl-Ca - CA-Datei für VerifyCA / VerifyFull.
Connection Timeout Verbindungs-Timeout 15 Sekunden.
Default Command Timeout Befehls-Timeout 30 Sekunden; 0 wartet unbegrenzt.
Application Name - - Setzt program_name Verbindungsattribut.
AllowPublicKeyRetrieval - falsch Siehe die obige Warnung.
AllowUserVariables - falsch Erlauben @variables in SQL.
Pooling - wahr Verbindungs-Pooling.
Maximum Pool Size Maximale Poolgröße 100 Größter Pool.
Minimum Pool Size Minimale Poolgröße 0 Kleinster Pool.

go-sql-driver/mysql DSN

Formular: [user[:password]@][protocol[(address)]]/dbname[?param=value&...]. Das Passwort braucht keine Maskierung; der Datenbankname wird für den Pfad maskiert (1.8+); Parameterwerte werden für die Abfrage maskiert; Parameternamen unterscheiden Groß-/Kleinschreibung.

SchlüsselwortSynonymeStandardWas es bewirkt
tcp(host:port) unix(/Pfad) tcp(127.0.0.1:3306) Adresse; der Port ist standardmäßig 3306.
tls - falsch true (überprüfen), false, skip-verify (verschlüsseln, keine Überprüfungen), preferred, oder ein registrierter Konfigurationsname.
timeout - Betriebssystemstandard Verbindungsaufbau-Timeout mit einer Einheit: 10s.
readTimeout / writeTimeout - 0 E/A-Zeitüberschreitungen mit einer Einheit.
parseTime - falsch Scannen von DATE und DATETIME in time.Time.
loc - UTC Zeitzone für time.Time Werte (maskiere / als %2F).
collation - utf8mb4_general_ci Verbindungskollation.
allowCleartextPasswords - falsch Sende das Passwort im Klartext (nur über TLS).
multiStatements - falsch Mehrere Anweisungen pro Abfrage; vergrößert die Auswirkungen von SQL-Injektionen.

Häufige MariaDB-Verbindungsfehler

Access denied for user 'app_user'@'10.0.0.7' (using password: YES)

Warum: Falsches Passwort, oder das Konto ist für ein anderes Hostmuster definiert.

Lösung: Prüfen SELECT user, host FROM mysql.user und erstelle das Konto für den Host, von dem aus du dich verbindest, oder gewähre ihm Zugriff.

Could not connect to address=(host=db.example.com)(port=3306)(type=primary) : ... certificate

Warum: Connector/J 4.0+ nutzt standardmäßig sslMode=verify-full, und der Server zeigt ein selbstsigniertes Zertifikat oder eines für einen anderen Namen.

Lösung: Gib dem Treiber die CA mit serverSslCert=/path/ca.pem, oder benutze ein Zertifikat für den Hostnamen, zu dem du dich verbindest. sslMode=trust verschlüsselt ohne Überprüfung und ist nur für vertrauenswürdige Netzwerke.

Host '10.0.0.7' is not allowed to connect to this MariaDB server

Warum: Kein Konto passt zu deinem Benutzernamen und deinem Client-Host.

Lösung: Erstelle das Konto für deinen Host oder ein Muster wie 'app_user'@'10.0.0.%'.

Unknown database 'sales'

Warum: Die Datenbank in der Zeichenfolge existiert nicht oder ist anders geschrieben.

Lösung: Prüfen SHOW DATABASES;.

MariaDB-Verbindungszeichenfolgen-FAQ

Kann ich einen MySQL-Treiber mit MariaDB verwenden?

Ja, für die gängigen Fälle. MariaDB behält das MySQL-Clientprotokoll bei, sodass MySqlConnector, Connector/NET, go-sql-driver/mysql, mysql2 und PyMySQL mit denselben Strings verbinden. MariaDB-spezifische Funktionen decken MariaDBs eigene Connectoren am besten ab.

Was bedeutet sslMode=trust?

Es ist das Äquivalent von MariaDB Connector/J zu MySQLs REQUIRED: die Verbindung ist verschlüsselt, aber das Serverzertifikat wird nicht geprüft. Verwende verify-full mit serverSslCert um auch den Server zu verifizieren.

Was ist der Standardport von MariaDB?

3306, derselbe wie bei MySQL.

Warum ist meine MariaDB JDBC-Verbindung nach dem Upgrade von Connector/J kaputtgegangen?

Connector/J 4.0 hat den sslMode Standard von disable zu verify-full. Ein Server ohne TLS oder mit selbstsigniertem Zertifikat schlägt jetzt fehl. Konfiguriere TLS sauber oder setze sslMode explizit.

// 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 MariaDB und mehr.