Instal driver go-mssqldb

Driver go-mssqldb adalah modul Go yang Anda instal dengan menggunakan go get. Artikel ini membahas persyaratan sistem, langkah penginstalan, dan verifikasi.

Prasyarat

Komponen Requirement
Go 1.25 atau lebih baru. Unduh dari go.dev/dl.
Platform Microsoft SQL Semua versi yang didukung dari SQL Server, Azure SQL Database, Azure SQL Managed Instance, database SQL di Fabric, Fabric Data Warehouse, atau Azure Synapse Analytics.
Dukungan modul Proyek Anda harus menggunakan modul Go (file go.mod di root proyek).

Instal modul driver

  1. Buka terminal di direktori proyek Go Anda.

  2. Jalankan go get untuk mengunduh driver dan dependensinya:

    go get github.com/microsoft/go-mssqldb

  3. Perintah ini secara otomatis memperbarui file go.mod dan go.sum Anda.

Menginstal paket opsional

Driver ini memiliki paket opsional untuk skenario tertentu. Instal hanya saat Anda membutuhkan fitur yang sesuai.

Microsoft Entra ID otentikasi

Instal paket ini untuk menggunakan jenis kredensial Microsoft Entra ID (sebelumnya Azure AD):

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

Paket ini mendaftarkan driver bernama azuresql yang mendukung semua jenis kredensial Microsoft Entra ID. Untuk informasi selengkapnya, lihat Autentikasi ID Microsoft Entra.

Selalu Terenkripsi - penyedia Azure Key Vault

Instal paket ini untuk menggunakan Azure Key Vault sebagai penyimpanan kunci master kolom:

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

Paket ini mendaftarkan penyedia kunci master kolom Azure Key Vault. Untuk informasi selengkapnya, lihat Always Encrypted.

Selalu Terenkripsi - penyedia sertifikat lokal

Instal paket ini untuk menggunakan sertifikat lokal atau file PFX sebagai penyimpanan kunci master kolom:

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

Paket ini mendaftarkan sertifikat lokal dan penyedia kunci master kolom file PFX. Untuk informasi selengkapnya, lihat Always Encrypted.

Memverifikasi penginstalan

Buat file bernama verify.go dan tempel kode berikut:

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

Jalankan file:

go run verify.go

Jika output menunjukkan Connected successfully., driver diinstal dan berfungsi.

Note

Contoh sebelumnya menggunakan autentikasi terintegrasi Windows (),trusted_connection=yes yang hanya berfungsi di Windows. Di Linux atau macOS, gunakan autentikasi SQL, NTLM, Kerberos, atau Microsoft Entra ID sebagai gantinya. Sebagai contoh, lihat Autentikasi dan string koneksi.

Tingkatkan driver

Untuk meningkatkan ke versi terbaru:

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

Untuk meningkatkan ke versi tertentu:

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

Setelah peningkatan, jalankan go mod tidy untuk menghapus dependensi tidak langsung yang tidak digunakan.

Konten terkait

  • Last updated on