Installera drivrutinen go-mssqldb

Drivrutinen go-mssqldb är en Go-modul som du installerar genom att använda go get. Denna artikel täcker systemkrav, installationssteg och verifiering.

Förutsättningar

Component Requirement
Go 1,25 eller senare. Ladda ner från go.dev/dl.
Microsoft SQL-plattform Alla stödda versioner av SQL Server, Azure SQL Database, Azure SQL Managed Instance SQL-databaser i Fabric, Fabric Data Warehouse eller Azure Synapse Analytics.
Modulstöd Ditt projekt måste använda Go-moduler (en go.mod fil i projektets rot).

Installera drivrutinsmodulen

  1. Öppna en terminal i din Go-projektkatalog.

  2. Kör go get för att ladda ner drivrutinen och dess beroenden:

    go get github.com/microsoft/go-mssqldb

  3. Kommandot uppdaterar automatiskt dina go.mod och go.sum filer.

Installera valfria paket

Drivrutinen har valfria paket för specifika scenarier. Installera dem bara när du behöver motsvarande funktion.

Microsoft Entra ID-autentisering

Installera detta paket för att använda Microsoft Entra ID (tidigare Azure AD) inloggningsuppgifter:

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

Detta paket registrerar en drivrutin med namnet azuresql som stöder alla typer av autentiseringsuppgifter för Microsoft Entra ID. Mer information finns i Microsoft Entra ID-autentisering.

Always Encrypted - leverantör av Azure Key Vault

Installera detta paket för att använda Azure Key Vault som kolumnens master key store:

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

Detta paket registrerar Azure Key Vault-kolumnens master key provider. Mer information finns i Always Encrypted.

Alltid krypterad – lokal certifikatleverantör

Installera detta paket för att använda lokala certifikat eller PFX-filer som kolumnens huvudnyckellagring:

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

Detta paket registrerar de lokala certifikat- och PFX-filkolumnens huvudnyckelleverantörer. Mer information finns i Always Encrypted.

Kontrollera installationen

Skapa en fil med namnet verify.go och klistra in följande kod:

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.")
}

Kör filen:

go run verify.go

Om utgången visar Connected successfully., är drivrutinen installerad och fungerar.

Note

Föregående exempel använder Windows integrerad autentisering (trusted_connection=yes), vilket endast fungerar på Windows. På Linux eller macOS, använd SQL-autentisering, NTLM, Kerberos eller Microsoft Entra ID istället. För exempel, se Autentisering och anslutningssträngar.

Uppgradera drivrutinen

Så här uppgraderar du till den senaste versionen:

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

För att uppgradera till en specifik version:

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

Efter uppgradering, kör go mod tidy för att ta bort oanvända indirekta beroenden.

Relaterat innehåll

  • Last updated on