Nainstalujte ovladač go-mssqldb

Ovladač go-mssqldb je modul v jazyce Go, který nainstalujete pomocí go get. Tento článek se zabývá systémovými požadavky, kroky instalace a ověřováním.

Prerequisites

Součást Requirement
Go 1,25 nebo později. Stáhnout z go.dev/dl.
Microsoft SQL platforma Všechny podporované verze databází SQL Server, Azure SQL Database, Azure SQL Managed Instance, SQL v Fabric, Fabric Data Warehouse nebo Azure Synapse Analytics.
Podpora modulů Váš projekt musí používat Go moduly ( go.mod soubor v kořeni projektu).

Nainstalujte ovladač modulu

  1. Otevřete terminál ve svém adresáři projektů Go.

  2. Spusťte go get pro stažení ovladače a jeho závislostí:

    go get github.com/microsoft/go-mssqldb

  3. Příkaz automaticky aktualizuje vaše go.mod a go.sum soubory.

Nainstalovat volitelné balíčky

Ovladač má volitelné balíčky pro konkrétní scénáře. Nainstalujte je jen tehdy, když potřebujete odpovídající funkci.

ověřování pomocí Microsoft Entra ID

Nainstalovat tento balíček pro použití typů přihlašovacích údajů Microsoft Entra ID (dříve Azure AD):

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

Tento balíček registruje ovladač s názvem azuresql, který podporuje všechny typy přihlašovacích údajů Microsoft Entra ID. Další informace naleznete v tématu Ověřování Pomocí entra ID společnosti Microsoft.

Always Encrypted - poskytovatel Azure Key Vault

Nainstalujte tento balíček pro použití Azure Key Vault jako úložiště sloupcových hlavních klíčů:

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

Tento balíček registruje poskytovatele hlavního klíče Azure Key Vault column. Další informace naleznete v tématu Always Encrypted.

Always Encrypted – místní poskytovatel certifikátů

Nainstalujte tento balíček tak, abyste používali lokální certifikáty nebo PFX soubory jako úložiště sloupcového hlavního klíče:

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

Tento balíček registruje místní poskytovatele hlavního klíče pro certifikáty a sloupce PFX souboru. Další informace naleznete v tématu Always Encrypted.

Ověření instalace

Vytvořte soubor s názvem verify.go a vložte následující kód:

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

Spusťte soubor:

go run verify.go

Pokud výstup ukazuje Connected successfully., ovladač je nainstalovaný a funguje.

Note

Předchozí příklad používá integrovanou autentizaci Windows (trusted_connection=yes), která funguje pouze na Windows. Na Linuxu nebo macOS použijte místo toho autentizaci SQL, NTLM, Kerberos nebo Microsoft Entra ID. Příklady naleznete v tématech Autentizace a Připojovací řetězce.

Aktualizovat ovladač

Upgrade na nejnovější verzi:

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

Pro upgrade na konkrétní verzi:

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

Po aktualizaci spusťte go mod tidy, abyste odstranili nepoužívané nepřímé závislosti.

Související obsah

  • Last updated on