Installiere den go-mssqldb-Treiber

Der Treiber go-mssqldb ist ein Go-Modul, das Sie mit go get installieren. Dieser Artikel behandelt Systemanforderungen, Installationsschritte und Verifizierung.

Prerequisites

Bestandteil Anforderung
Go 1,25 oder später. Download von go.dev/dl.
Microsoft SQL-Plattform Alle unterstützten Versionen von SQL Server, Azure SQL-Datenbank, Azure SQL Managed Instance, SQL-Datenbanken in Fabric, Fabric Data Warehouse oder Azure Synapse Analytics.
Modulunterstützung Dein Projekt muss Go-Module verwenden (eine go.mod Datei im Projektroot).

Installieren Sie das Treibermodul

  1. Öffne ein Terminal in deinem Go-Projektverzeichnis.

  2. Führe go get aus, um den Treiber und seine Abhängigkeiten herunterzuladen:

    go get github.com/microsoft/go-mssqldb

  3. Der Befehl aktualisiert automatisch deine go.mod und go.sum Dateien.

Optionale Pakete installieren

Der Fahrer bietet optionale Pakete für bestimmte Szenarien an. Installiere sie nur, wenn du die entsprechende Funktion brauchst.

Microsoft Entra ID-Authentifizierung

Installieren Sie dieses Paket, um Microsoft Entra ID-Anmeldeinformationstypen (früher Azure AD) zu verwenden:

go get github.com/microsoft/go-mssqldb/azuread

Dieses Paket registriert einen Treiber mit dem Namen azuresql, der alle Microsoft Entra ID-Anmeldeinformationstypen unterstützt. Weitere Informationen finden Sie unter Microsoft Entra ID-Authentifizierung.

Always Encrypted – Anbieter von Azure Key Vault

Installieren Sie dieses Paket, um Azure Key Vault als Spalten-Hauptschlüsselspeicher zu verwenden:

go get github.com/microsoft/go-mssqldb/aecmk/akv

Dieses Paket registriert den Azure Key Vault Column Master Key Provider. Weitere Informationen finden Sie unter Always Encrypted.

Always Encrypted – lokaler Zertifikatsanbieter

Installieren Sie dieses Paket, um lokale Zertifikate oder PFX-Dateien als Spalten-Hauptschlüsselspeicher zu verwenden:

go get github.com/microsoft/go-mssqldb/aecmk/localcert

Dieses Paket registriert den lokalen Zertifikats- und PFX-Dateispalten-Masterschlüssel-Provider. Weitere Informationen finden Sie unter Always Encrypted.

Überprüfen der Installation

Erstellen Sie eine Datei mit dem Namen verify.go und fügen Sie folgenden Code ein:

package main

import (
    "database/sql"
    "fmt"
    "log"

    _ "github.com/microsoft/go-mssqldb"
)

func main() {
    connString := "sqlserver://<server>?database=AdventureWorks2025&trusted_connection=yes"
    db, err := sql.Open("sqlserver", connString)
    if err != nil {
        log.Fatal("Error creating connection: ", err.Error())
    }
    defer db.Close()

    err = db.Ping()
    if err != nil {
        log.Fatal("Error pinging database: ", err.Error())
    }

    fmt.Println("Connected successfully.")
}

Führen Sie die Datei aus:

go run verify.go

Wenn die Ausgabe angezeigt wird Connected successfully., ist der Treiber installiert und funktioniert.

Note

Das vorherige Beispiel verwendet Windows integrierte Authentifizierung (trusted_connection=yes), die nur unter Windows funktioniert. Unter Linux oder macOS verwenden Sie stattdessen SQL-Authentifizierung, NTLM, Kerberos oder Microsoft Entra ID. Beispiele finden Sie unter Authentifizierung und Verbindungszeichen.

Treiber aufrüsten

So führen Sie ein Upgrade auf die neueste Version durch:

go get -u github.com/microsoft/go-mssqldb

Zum Upgrade auf eine bestimmte Version:

go get github.com/microsoft/go-mssqldb@v1.10.0

Nach dem Upgrade führe go mod tidy aus, um ungenutzte indirekte Abhängigkeiten zu entfernen.

Verwandte Inhalte

  • Last updated on