Telepítsd a go-mssqldb illesztőprogramot

A go-mssqldb illesztőprogram egy Go-modul, amelyet a go get használatával telepítesz. Ez a cikk a rendszerkövetelményeket, telepítési lépéseket és ellenőrzést tárgyalja.

Prerequisites

Komponens Requirement
Go 1,25 vagy annál tovább. Töltsd le go.dev/dl-ről.
Microsoft SQL platform A SQL Server, az Azure SQL Database, az Azure SQL Managed Instance, a Fabric SQL-adatbázisa, a Fabric Data Warehouse vagy az Azure Synapse Analytics összes támogatott verziója.
Modul támogatás A projektednek Go modulokat kell használnia (egy go.mod fájl a projekt gyökeren).

Telepítsd az illesztőprogram-modult

  1. Nyiss meg egy terminált a Go projektkönyvtárban.

  2. Futtassa a(z) go get elemet az illesztőprogram és függőségeinek letöltéséhez:

    go get github.com/microsoft/go-mssqldb
    
  3. A parancs automatikusan frissíti a go.mod és go.sum fájljaidat.

Opcionális csomagok telepítése

A sofőr opcionális csomagokat kínál bizonyos helyzetekhez. Csak akkor telepítsd őket, ha szükséged van a megfelelő funkcióra.

Microsoft Entra ID-hitelesítés

Telepítsd ezt a csomagot, hogy a Microsoft Entra ID (korábban Azure AD) hitelesítési típusait használd:

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

Ez a csomag regisztrál egy azuresql nevű illesztőprogramot, amely támogatja a Microsoft Entra ID összes hitelesítőadat-típusát. További információ: Microsoft Entra ID-hitelesítés.

Always Encrypted – Azure Key Vault szolgáltató

Telepítsd ezt a csomagot, hogy az Azure Key Vault-t használd column master key store-ként:

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

Ez a csomag regisztrálja az Azure Key Vault oszlop master key szolgáltatóját. További információ: Always Encrypted.

Always Encrypted - helyi tanúsítványszolgáltató

Telepítsd ezt a csomagot, hogy helyi tanúsítványokat vagy PFX fájlokat használj oszlopfő kulcsraktárként:

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

Ez a csomag regisztrálja a helyi tanúsítványokat és a PFX fájloszlop fő kulcsszolgáltatóit. További információ: Always Encrypted.

A telepítés ellenőrzése

Hozz létre egy fájlt néven verify.go , és illesztsd be a következő kódot:

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

Futtassa a fájlt:

go run verify.go

Ha a kimenet megjelenik Connected successfully., a meghajtó telepítve van és működik.

Note

Az előző példa a Windows integrált hitelesítést (trusted_connection=yes), amely csak a Windows-on működik. Linuxon vagy macOS-en használj SQL hitelesítést, NTLM-t, Kerberost vagy Microsoft Entra ID-t helyette. Például lásd: Hitelesítés és Kapcsolódási stringek.

Az illesztőprogram frissítése

Frissítés a legújabb verzióra:

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

Egy adott verzióra való frissítéshez:

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

Frissítés után futasd go mod tidy el a használatlan közvetett függőségek eltávolítását.