Menginstal driver Microsoft ODBC untuk SQL Server (Linux)
Artikel ini menjelaskan cara menginstal Microsoft ODBC Driver untuk SQL Server di Linux. Ini juga mencakup instruksi untuk alat baris perintah opsional untuk SQL Server (bcp
dan sqlcmd
) dan header pengembangan unixODBC.
Artikel ini menyediakan perintah untuk menginstal driver ODBC dari shell bash. Jika Anda ingin mengunduh paket secara langsung, lihat Mengunduh Driver ODBC untuk SQL Server.
Microsoft ODBC 18
Bagian berikut menjelaskan cara menginstal driver Microsoft ODBC 18 dari shell bash untuk distribusi Linux yang berbeda. Distribusi yang didukung adalah Alpine Linux, Debian, Red Hat Enterprise Linux (RHEL), Oracle Linux, SUSE Linux Enterprise Server (SLES), dan Ubuntu.
case $(uname -m) in
x86_64) architecture="amd64" ;;
arm64) architecture="arm64" ;;
*) architecture="unsupported" ;;
esac
if [[ "unsupported" == "$architecture" ]];
then
echo "Alpine architecture $(uname -m) is not currently supported.";
exit;
fi
#Download the desired package(s)
curl -O https://download.microsoft.com/download/3/5/5/355d7943-a338-41a7-858d-53b259ea33f5/msodbcsql18_18.3.3.1-1_$architecture.apk
curl -O https://download.microsoft.com/download/3/5/5/355d7943-a338-41a7-858d-53b259ea33f5/mssql-tools18_18.3.1.1-1_$architecture.apk
#(Optional) Verify signature, if 'gpg' is missing install it using 'apk add gnupg':
curl -O https://download.microsoft.com/download/3/5/5/355d7943-a338-41a7-858d-53b259ea33f5/msodbcsql18_18.3.3.1-1_$architecture.sig
curl -O https://download.microsoft.com/download/3/5/5/355d7943-a338-41a7-858d-53b259ea33f5/mssql-tools18_18.3.1.1-1_$architecture.sig
curl https://packages.microsoft.com/keys/microsoft.asc | gpg --import -
gpg --verify msodbcsql18_18.3.3.1-1_$architecture.sig msodbcsql18_18.3.3.1-1_$architecture.apk
gpg --verify mssql-tools18_18.3.1.1-1_$architecture.sig mssql-tools18_18.3.1.1-1_$architecture.apk
#Install the package(s)
sudo apk add --allow-untrusted msodbcsql18_18.3.3.1-1_$architecture.apk
sudo apk add --allow-untrusted mssql-tools18_18.3.1.1-1_$architecture.apk
Catatan
Driver versi 17.5 atau yang lebih tinggi diperlukan untuk dukungan Alpine.
Versi sebelumnya
Bagian berikut ini menyediakan instruksi untuk menginstal versi driver Microsoft ODBC sebelumnya di Linux. Versi driver berikut tercakup:
- Driver Microsoft ODBC 17 untuk SQL Server
- Driver Microsoft ODBC 13.1 untuk SQL Server
- Driver Microsoft ODBC 13 untuk SQL Server
- Driver Microsoft ODBC 11 untuk SQL Server
Microsoft ODBC 17
Bagian berikut menjelaskan cara menginstal driver Microsoft ODBC 17 dari shell bash untuk distribusi Linux yang berbeda.
Penting
Jika Anda menginstal paket v17 msodbcsql
yang tersedia secara singkat, Anda harus menghapusnya sebelum menginstal msodbcsql17
paket. Ini akan menghindari konflik. Paket msodbcsql17
dapat diinstal berdampingan msodbcsql
dengan paket v13.
#Download the desired package(s)
curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.10.5.1-1_amd64.apk
curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/mssql-tools_17.10.1.1-1_amd64.apk
#(Optional) Verify signature, if 'gpg' is missing install it using 'apk add gnupg':
curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.10.5.1-1_amd64.sig
curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/mssql-tools_17.10.1.1-1_amd64.sig
curl https://packages.microsoft.com/keys/microsoft.asc | gpg --import -
gpg --verify msodbcsql17_17.10.5.1-1_amd64.sig msodbcsql17_17.10.5.1-1_amd64.apk
gpg --verify mssql-tools_17.10.1.1-1_amd64.sig mssql-tools_17.10.1.1-1_amd64.apk
#Install the package(s)
sudo apk add --allow-untrusted msodbcsql17_17.10.5.1-1_amd64.apk
sudo apk add --allow-untrusted mssql-tools_17.10.1.1-1_amd64.apk
Catatan
Driver versi 17.5 atau yang lebih tinggi diperlukan untuk dukungan Alpine.
ODBC 13.1
Bagian berikut menjelaskan cara menginstal driver Microsoft ODBC 13.1 dari shell bash untuk distribusi Linux yang berbeda.
curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc
curl https://packages.microsoft.com/config/debian/8/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list
sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install msodbcsql
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y apt-get install mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install unixodbc-dev
ODBC 13
Bagian berikut menjelaskan cara menginstal driver Microsoft ODBC 13 dari shell bash untuk distribusi Linux yang berbeda.
curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo
sudo yum update
sudo yum remove unixODBC #to avoid conflicts
sudo ACCEPT_EULA=Y yum install msodbcsql-13.0.1.0-1 mssql-tools-14.0.2.0-1
sudo yum install unixODBC-utf16-devel #this step is optional but recommended*
#Create symlinks for tools
sudo ln -sfn /opt/mssql-tools/bin/sqlcmd-13.0.1.0 /usr/bin/sqlcmd
sudo ln -sfn /opt/mssql-tools/bin/bcp-13.0.1.0 /usr/bin/bcp
Penginstalan offline
Jika Anda memerlukan Microsoft ODBC Driver 13 untuk diinstal di komputer tanpa koneksi Internet, Anda harus mengatasi dependensi paket secara manual. Microsoft ODBC Driver 13 memiliki dependensi langsung berikut:
- Ubuntu: libc6 (>= 2.21), libstdc++6 (>= 4.9), libkrb5-3, libcurl3, openssl, debconf (>= 0,5), unixodbc (>= 2.3.1-1)
- Red Hat:
glibc, e2fsprogs, krb5-libs, openssl, unixODBC
- SUSE:
glibc, libuuid1, krb5, openssl, unixODBC
Masing-masing paket ini pada gilirannya memiliki dependensinya sendiri, yang mungkin atau mungkin tidak ada pada sistem. Untuk solusi umum untuk masalah ini, lihat dokumentasi manajer paket distribusi Anda: Red Hat, Ubuntu, dan SUSE
Biasanya juga mengunduh semua paket dependen secara manual dan menempatkannya bersama-sama di komputer penginstalan, lalu menginstal setiap paket secara manual secara bergantian, menyelesaikan dengan paket Microsoft ODBC Driver 13.
- Unduh yang terbaru
msodbcsql
.rpm
dari https://packages.microsoft.com/rhel/7/prod/. - Pasang dependensi dan driver.
sudo yum install glibc e2fsprogs krb5-libs openssl unixODBC unixODBC-devel #install dependencies
sudo rpm -i msodbcsql-13.1.X.X-X.x86_64.rpm #install the Driver
ODBC 11
Bagian berikut menjelaskan cara menginstal driver Microsoft ODBC 11 di Linux. Sebelum Anda dapat menggunakan driver, instal manajer driver unixODBC. Untuk informasi selengkapnya, lihat Menginstal Driver Manager.
Langkah-langkah penginstalan
Penting
Instruksi ini mengacu pada msodbcsql-11.0.2270.0.tar.gz
, yang merupakan file penginstalan untuk Red Hat Linux. Jika Anda menginstal Pratinjau untuk SUSE Linux, nama filenya adalah msodbcsql-11.0.2260.0.tar.gz
.
Untuk menginstal driver:
Pastikan Anda memiliki izin root.
Ubah ke direktori tempat unduhan menempatkan file
msodbcsql-11.0.2270.0.tar.gz
. Pastikan Anda memiliki file *.tar.gz yang cocok dengan versi Linux Anda. Untuk mengekstrak file, jalankan perintah berikut,tar xvzf msodbcsql-11.0.2270.0.tar.gz
.Ubah ke
msodbcsql-11.0.2270.0
direktori dan di sana Anda akan melihat file yang disebut install.sh.Untuk melihat daftar opsi penginstalan yang tersedia, jalankan perintah berikut: ./install.sh.
Buat cadangan odbcinst.ini. Penginstalan driver memperbarui odbcinst.ini. odbcinst.ini berisi daftar driver yang terdaftar di UnixODBC Driver Manager. Untuk menemukan lokasi odbcinst.ini di komputer Anda, jalankan perintah berikut:
odbc_config --odbcinstini
.Sebelum Anda menginstal driver, jalankan perintah berikut:
./install.sh verify
. Output./install.sh verify
laporan jika komputer Anda memiliki perangkat lunak yang diperlukan untuk mendukung driver ODBC di Linux.Ketika Anda siap untuk menginstal driver ODBC di Linux, jalankan perintah:
./install.sh install
. Jika Anda perlu menentukan perintah instal (bin-dir
ataulib-dir
), tentukan perintah setelah opsi instal .Setelah meninjau perjanjian lisensi, ketik YA untuk melanjutkan penginstalan.
Penginstalan menempatkan driver di /opt/microsoft/msodbcsql/11.0.2270.0
. Driver dan file dukungannya harus berada di /opt/microsoft/msodbcsql/11.0.2270.0
.
Untuk memverifikasi bahwa driver Microsoft ODBC di Linux berhasil didaftarkan, jalankan perintah berikut: odbcinst -q -d -n "ODBC Driver 11 for SQL Server"
.
Menghapus instalan
Anda dapat menghapus instalasi driver ODBC 11 di Linux dengan menjalankan perintah berikut:
rm -f /usr/bin/sqlcmd
rm -f /usr/bin/bcp
rm -rf /opt/microsoft/msodbcsql
odbcinst -u -d -n "ODBC Driver 11 for SQL Server"
File driver
Driver ODBC di Linux terdiri dari komponen-komponen berikut:
Komponen | Deskripsi |
---|---|
libmsodbcsql-17. X.so.X.X atau libmsodbcsql-13. X.so.X.X | File pustaka dinamis objek bersama (so ) yang berisi semua fungsionalitas driver. File ini diinstal untuk /opt/microsoft/msodbcsql17/lib64/ Driver 17 dan masuk /opt/microsoft/msodbcsql/lib64/ untuk Driver 13. |
msodbcsqlr17.rll atau msodbcsqlr13.rll |
File sumber daya yang menyertainya untuk pustaka driver. File ini terinstal di [driver .so directory]../share/resources/en_US/ |
msodbcsql.h | File header yang berisi semua definisi baru yang diperlukan untuk menggunakan driver. Catatan: Anda tidak dapat mereferensikan msodbcsql.h dan odbcss.h dalam program yang sama. msodbcsql.h diinstal untuk /opt/microsoft/msodbcsql17/include/ Driver 17 dan di /opt/microsoft/msodbcsql/include/ untuk Driver 13. |
LICENSE.txt | File teks yang berisi ketentuan Perjanjian Lisensi Pengguna Akhir. File ini ditempatkan untuk /usr/share/doc/msodbcsql17/ Driver 17 dan di /usr/share/doc/msodbcsql/ untuk Driver 13. |
RELEASE_NOTES | File teks yang berisi catatan rilis. File ini ditempatkan untuk /usr/share/doc/msodbcsql17/ Driver 17 dan di /usr/share/doc/msodbcsql/ untuk Driver 13. |
Pemuatan file sumber daya
Driver perlu memuat file sumber daya ke fungsi. File ini dipanggil msodbcsqlr17.rll
atau msodbcsqlr13.rll
tergantung pada versi driver. Lokasi .rll
file relatif terhadap lokasi driver itu sendiri (so
atau dylib
), seperti yang disebutkan dalam tabel sebelumnya. Pada versi 17.1 driver juga mencoba memuat .rll
dari direktori default jika pemuatan dari jalur relatif gagal. Jalur file sumber daya default di Linux adalah /opt/microsoft/msodbcsql17/share/resources/en_US/
.
Pemecahan masalah
Jika versi driver telah diinstal sebelumnya dan terdaftar di unixODBC, penginstalan mungkin gagal dengan kesalahan seperti Installation failed, ODBC Driver $1 for SQL Server detected!
. Untuk mengatasi masalah ini, batalkan pendaftaran versi driver tersebut. Anda dapat membatalkan pendaftaran driver melalui odbcinst
perintah: odbcinst -u -d -n "ODBC Driver $1 for SQL Server
. (Ganti $1
dengan versi driver yang dilaporkan dalam kesalahan penginstalan.) Jika penghapusan instalasi melalui odbcinst
perintah gagal, Anda dapat menghapus bagian driver secara manual dari odbcinst.ini
file. Anda dapat menemukan lokasi odbcinst.ini
file melalui perintah odbcinst -j
.
Jika Anda tidak dapat membuat koneksi ke SQL Server menggunakan driver ODBC, lihat artikel masalah yang diketahui tentang pemecahan masalah koneksi.
Langkah berikutnya
Setelah menginstal driver, Anda dapat mencoba aplikasi contoh C++ ODBC. Untuk informasi selengkapnya tentang mengembangkan aplikasi ODBC, lihat Mengembangkan Aplikasi.
Untuk informasi selengkapnya, lihat catatan rilis driver ODBC dan persyaratan sistem.
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk