go-mssqldb sürücüsünü yükleyin

go-mssqldb sürücüsü, go get kullanarak yüklediğiniz bir Go modülüdür. Bu makale sistem gereksinimlerini, kurulum adımlarını ve doğrulamayı ele alır.

Prerequisites

Bileşen Requirement
Go 1.25 veya daha sonra. go.dev/dl'dan indirin.
Microsoft SQL Platformu SQL Server, Azure SQL Veritabanı, Azure SQL Yönetilen Örneği, Fabric’teki SQL veritabanı, Fabric Data Warehouse veya Azure Synapse Analytics’in desteklenen tüm sürümleri.
Modül desteği Projeniz Go modüllerini (proje kökündeki bir go.mod dosya) kullanmak zorunda.

Sürücü modülünü kur

  1. Go proje dizininizde bir terminal açın.

  2. Sürücü ve bağımlılıklarını indirmek için çalıştırın go get :

    go get github.com/microsoft/go-mssqldb
    
  3. Komut otomatik olarak your go.mod and go.sum dosyalarını güncelliyor.

Isteğe bağlı paketleri kur

Sürücünün belirli senaryolar için isteğe bağlı paketleri var. Onları sadece ilgili özelliği duyduğunuzda kurun.

Microsoft Entra Id kimlik doğrulaması

Bu paketi Microsoft Entra ID (eski adıyla Azure AD) credential türlerini kullanmak için kurun:

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

Bu paket, tüm Microsoft Entra ID kimlik bilgisi türlerini destekleyen azuresql adlı bir sürücüyü kaydeder. Daha fazla bilgi için bkz. Microsoft Entra Id kimlik doğrulaması.

Always Encrypted - Azure Key Vault sağlayıcısı

Azure Key Vault'u column master key store olarak kullanmak için bu paketi yükleyin:

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

Bu paket, Azure Key Vault sütun ana anahtar sağlayıcısını kaydeder. Daha fazla bilgi için bkz. Always Encrypted .

Her Zaman Şifreli - yerel sertifika sağlayıcısı

Bu paketi, yerel sertifikalar veya PFX dosyalarını sütun ana anahtar deposu olarak kullanmak üzere kurun:

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

Bu paket, yerel sertifika ve PFX dosya sütunu ana anahtar sağlayıcılarını kaydeder. Daha fazla bilgi için bkz. Always Encrypted .

Yüklemeyi doğrulama

Bir dosya oluşturun ve aşağıdaki verify.go kodu yapıştırın:

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

Dosyayı çalıştırın:

go run verify.go

Çıkış gösteriyorsa Connected successfully., sürücü kurulu ve çalışıyor.

Uyarı

Önceki örnek, yalnızca Windows'ta çalışan Windows entegre kimlik doğrulamasını (trusted_connection=yes), kullanır. Linux veya macOS'ta, bunun yerine SQL kimlik doğrulama, NTLM, Kerberos veya Microsoft Entra ID kullanın. Örneğin, Kimlik Doğrulama ve Bağlantı Dizileri bölümlerine bakınız.

Sürücüyü yükseltin

En son sürüme yükseltmek için:

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

Belirli bir sürüme yükseltmek için:

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

Yükseltmeden sonra, kullanılmayan dolaylı bağımlılıkları kaldırmak için çalıştırın go mod tidy .