Zainstaluj sterownik go-mssqldb

Sterownik go-mssqldb to moduł Go, który instalujesz za pomocą go get. Ten artykuł obejmuje wymagania systemowe, kroki instalacji oraz weryfikację.

Prerequisites

Składnik Requirement
Go 1.25 lub nowsza. Pobierz z go.dev/dl.
Platforma Microsoft SQL Wszystkie obsługiwane wersje programu SQL Server, usługi Azure SQL Database, usługi Azure SQL Managed Instance, bazy danych SQL w środowisku Fabric, usługi Fabric Data Warehouse lub usługi Azure Synapse Analytics.
Wsparcie modułów Twój projekt musi korzystać z modułów Go ( go.mod pliku w korzu projektu).

Zainstaluj moduł sterownika

  1. Otwórz terminal w swoim katalogu projektów Go.

  2. Uruchom go get, aby pobrać sterownik i jego zależności:

    go get github.com/microsoft/go-mssqldb

  3. Polecenie automatycznie aktualizuje pliki go.mod i go.sum.

Instalacja opcjonalnych pakietów

Sterownik oferuje opcjonalne pakiety do konkretnych scenariuszy. Instaluj je tylko wtedy, gdy potrzebujesz odpowiedniej funkcji.

Uwierzytelnianie za pomocą Microsoft Entra ID

Zainstaluj ten pakiet, aby użyć typów poświadczeń Microsoft Entra ID (dawniej Azure AD):

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

Ten pakiet rejestruje sterownik o nazwie azuresql obsługujący wszystkie typy poświadczeń Microsoft Entra ID. Aby uzyskać więcej informacji, zobacz Microsoft Entra ID authentication (Uwierzytelnianie za pomocą identyfikatora Entra firmy Microsoft).

Always Encrypted — dostawca Azure Key Vault

Zainstaluj ten pakiet, aby używać usługi Azure Key Vault jako magazynu głównego klucza kolumny:

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

Ten pakiet rejestruje dostawcę klucza głównego kolumny usługi Azure Key Vault. Aby uzyskać więcej informacji, zobacz Always Encrypted.

Zawsze szyfrowane – lokalny dostawca certyfikatów

Zainstaluj ten pakiet, aby używać lokalnych certyfikatów lub plików PFX jako magazynu kluczy głównych kolumn:

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

Ten pakiet rejestruje lokalne dostawców kluczy głównych kolumn certyfikatów i plików PFX. Aby uzyskać więcej informacji, zobacz Always Encrypted.

Weryfikowanie instalacji

Stwórz plik o nazwie verify.go i wklej następujący 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.")
}

Uruchom plik:

go run verify.go

Jeśli wyjście pokazuje Connected successfully., sterownik jest zainstalowany i działa.

Uwaga / Notatka

Powyższy przykład wykorzystuje zintegrowane uwierzytelnianie Windows (trusted_connection=yes), które działa tylko na Windows. Na Linuksie lub macOS zamiast tego używaj uwierzytelniania SQL, NTLM, Kerberos lub Microsoft Entra ID. Przykłady można znaleźć w sekcji Uwierzytelnianie i Połączenia.

Zaktualizuj sterownik

Aby uaktualnić do najnowszej wersji:

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

Aby przejść do konkretnej wersji:

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

Po aktualizacji uruchom go mod tidy, aby usunąć nieużywane zależności pośrednie.

Treści powiązane

  • Last updated on