go-mssqldb Verbindungsstrings

Der Treiber go-mssqldb akzeptiert drei Verbindungszeichenfolge-Formate: URL, ADO und ODBC. Alle drei Formate unterstützen denselben Satz von Verbindungsparametern. Wählen Sie das Format, das am besten zu Ihrer Anwendung oder Ihrem Bereitstellungsmodell passt.

URL-Format

Das URL-Format folgt dem Schema sqlserver:// und ist das gebräuchlichste Format für Go-Anwendungen:

sqlserver://username:password@host:port?database=AdventureWorks2025&param=value

Beispiele

Verbinden Sie sich mit einer lokalen Standardinstanz über SQL-Authentifizierung:

sqlserver://<user>:<password>@<server>?database=AdventureWorks2025

Stellen Sie eine Verbindung mit einer benannten Instanz her:

sqlserver://<user>:<password>@<server>/myinstance?database=AdventureWorks2025

Connect to Azure SQL-Datenbank:

sqlserver://<user>:<password>@<server>.database.windows.net?database=AdventureWorks2025&encrypt=true&TrustServerCertificate=false

Verwenden Sie Windows-Authentifizierung (nur Windows):

sqlserver://<server>?database=AdventureWorks2025&trusted_connection=yes

Sonderzeichen in Passwörtern

Im URL-Format müssen Passwörter mit Sonderzeichen prozentual codiert werden. Häufige Zeichen, die codiert werden müssen:

Verwenden url.UserPassword() Sie zur automatischen Kodierung:

u := &url.URL{
    Scheme: "sqlserver",
    User:   url.UserPassword("<user>", "p@ss:word#1"),
    Host:   "<server>:1433",
}
u.RawQuery = url.Values{"database": {"AdventureWorks2025"}}.Encode()
// Result: sqlserver://<user>:p%40ss%3Aword%231@<server>:1433?database=AdventureWorks2025

Im ADO-Format ist eine prozentuale Codierung nicht erforderlich. Wenn ein Wert Semikolons enthält, wird er in Anführungszeichen gesetzt: password="<password>". Im ODBC-Format wickelt man den Wert stattdessen in Klammern: password={<password>}.

ADO-Format

Das ADO-Format verwendet Semikolon-getrennte key=value Paare:

server=<server>;user id=<user>;password=<password>;database=AdventureWorks2025

ADO-Beispiele

Verbinden Sie sich mit einer Portnummer:

server=<server>;port=1434;user id=<user>;password=<password>;database=AdventureWorks2025

Stellen Sie eine Verbindung mit einer benannten Instanz her:

server=<server>\myinstance;user id=<user>;password=<password>;database=AdventureWorks2025

ODBC-Format

Das ODBC-Format verwendet das odbc: Präfix mit semikolon-getrennten key=value Paaren. Werte, die spezielle Zeichen enthalten, können in Klammern eingeschlossen werden:

odbc:server=<server>;user id=<user>;password={<password>};database=AdventureWorks2025

Zahnspangen lösen sich aus

Im ODBC-Format wird ein Wert eingewickelt {} , um Semikolon, Gleichzeichenzeichen und andere Sonderzeichen zu entkommen. Um eine buchstäbliche } innere Zahnspange hinzuzufügen, verdoppeln Sie sie:

odbc:password={my}}password}

Allgemeine Parameter

Die folgenden Parameter werden in allen drei Formaten geteilt:

Für die vollständige Liste der Verbindungsoptionen siehe Verbindungsoptionen.

Aufbau von Verbindungsstrings im Code

Verwenden Sie den Type oder msdsn.Config Structurl.URL, um Verbindungsstrings programmatisch zu erstellen, anstatt rohe Strings zu verketten. Dieser Ansatz vermeidet Injektions- und Codierungsprobleme.

URL-Builder

Verwenden url.URL Sie aus der Standardbibliothek, um die Verbindungszeichenfolge sicher zu konstruieren:

import "net/url"

query := url.Values{}
query.Add("database", "AdventureWorks2025")
query.Add("encrypt", "true")
query.Add("TrustServerCertificate", "false")

u := &url.URL{
    Scheme:   "sqlserver",
    User:     url.UserPassword("<user>", "<password>"),
    Host:     "<server>.database.windows.net:1433",
    RawQuery: query.Encode(),
}
connString := u.String()

NewConnectorConfig

Verwendung NewConnectorConfig mit msdsn.Config für strukturierte Konfigurationen, besonders wenn Sie einen benutzerdefinierten Dialer einrichten müssen oder SessionInitSQL:

import (
    "database/sql"
    "github.com/microsoft/go-mssqldb"
    "github.com/microsoft/go-mssqldb/msdsn"
)

config := msdsn.Config{
    Host:     "<server>",
    Port:     1433,
    Database: "AdventureWorks2025",
}

connector := mssql.NewConnectorConfig(config)
db := sql.OpenDB(connector)

Verwandte Inhalte

• Verbindungsoptionen
• Verschlüsselung und Zertifikate
• SQL Server und Windows-Authentifizierung
• Microsoft Entra ID-Authentifizierung