Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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
Go proje dizininizde bir terminal açın.
Sürücü ve bağımlılıklarını indirmek için çalıştırın
go get:go get github.com/microsoft/go-mssqldbKomut otomatik olarak your
go.modandgo.sumdosyaları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 .