Menginstal driver Microsoft ODBC untuk SQL Server (macOS)

Artikel ini menjelaskan cara menginstal Microsoft ODBC Driver untuk SQL Server di macOS. 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.

Catatan

Driver Microsoft ODBC untuk SQL Server di macOS hanya didukung pada arsitektur x64 melalui versi 17.7. Dukungan Apple ARM64 ditambahkan dimulai dengan versi 17.8. Arsitektur akan terdeteksi dan paket yang benar akan diinstal secara otomatis oleh rumus Homebrew. Jika perintah Anda berjalan dalam mode emulasi x64 pada ARM64, paket x64 akan diinstal. Jika Anda tidak berjalan dalam mode emulasi di prompt perintah Anda, paket ARM64 akan diinstal. Selain itu, direktori default Homebrew berubah dengan arsitektur ARM64, menjadi /opt/homebrew. Jalur di bagian File driver menggunakan jalur Homebrew x64, yang default ke /usr/local, sehingga jalur file Anda akan bervariasi sesuai.

Microsoft ODBC 18

Untuk menginstal driver Microsoft ODBC 18 untuk SQL Server di macOS, jalankan perintah berikut:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql18 mssql-tools18

Versi sebelumnya

Bagian berikut ini menyediakan instruksi untuk menginstal versi driver Microsoft ODBC sebelumnya di macOS.

Microsoft ODBC 17

Untuk menginstal driver Microsoft ODBC 17 untuk SQL Server di macOS, jalankan perintah berikut:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql17 mssql-tools

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.

ODBC 13.1

Gunakan perintah berikut untuk menginstal driver Microsoft ODBC 13.1 untuk SQL Server pada OS X 10.11 (El Capitan) dan macOS 10.12 (Sierra):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
brew install msodbcsql@13.1.9.2 mssql-tools@14.0.6.0

File driver

Driver ODBC di macOS terdiri dari komponen berikut:

Komponen	Deskripsi
libmsodbcsql.18.dylib atau libmsodbcsql.17.dylib atau libmsodbcsql.13.dylib	File pustaka dinamis (dylib) yang berisi semua fungsionalitas driver. File ini diinstal di /usr/local/lib/.
msodbcsqlr18.rll atau msodbcsqlr17.rll atau msodbcsqlr13.rll	File sumber daya yang menyertainya untuk pustaka driver. File ini diinstal untuk [driver .dylib directory]../share/msodbcsql18/resources/en_US/ Driver 18, [driver .dylib directory]../share/msodbcsql17/resources/en_US/ untuk Driver 17, dan di [driver .dylib directory]../share/msodbcsql/resources/en_US/ untuk Driver 13.
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 /usr/local/include/msodbcsql18/ Driver 18, /usr/local/include/msodbcsql17/ untuk Driver 17, dan di /usr/local/include/msodbcsql/ untuk Driver 13.
LICENSE.txt	File teks yang berisi ketentuan Perjanjian Lisensi End-User. File ini ditempatkan di /usr/local/share/doc/msodbcsql18/ untuk Driver 18, /usr/local/share/doc/msodbcsql17/ untuk Driver 17, dan di /usr/local/share/doc/msodbcsql/ untuk Driver 13.
RELEASE_NOTES	File teks yang berisi catatan rilis. File ini ditempatkan di /usr/local/share/doc/msodbcsql18/ untuk Driver 18, /usr/local/share/doc/msodbcsql17/ untuk Driver 17, dan di /usr/local/share/doc/msodbcsql/ untuk Driver 13.

Pemuatan file sumber daya

Driver perlu memuat file sumber daya agar berfungsi. File ini disebut msodbcsqlr18.rll, msodbcsqlr17.rll, atau msodbcsqlr13.rll tergantung pada versi driver. Lokasi .rll file relatif terhadap lokasi driver itu sendiri (so atau dylib), seperti yang dicatat dalam tabel komponen. Pada versi 17.1 driver juga mencoba memuat .rll dari direktori default jika pemuatan dari jalur relatif gagal. Jalur file sumber daya default di macOS adalah /usr/local/share/msodbcsql18/resources/en_US/

Pemecahan Masalah

Beberapa pengguna mengalami masalah saat mencoba menyambungkan setelah menginstal driver ODBC dan menerima kesalahan seperti: "[01000] [unixODBC][Driver Manager]Can't open lib 'ODBC Driver 18 for SQL Server' : file not found (0) (SQLDriverConnect)". Mungkin saja unixODBC tidak dikonfigurasi dengan benar untuk menemukan driver terdaftar. Dalam kasus ini, membuat tautan simbolis dapat menyelesaikan masalah.

sudo ln -s /usr/local/etc/odbcinst.ini /etc/odbcinst.ini
sudo ln -s /usr/local/etc/odbc.ini /etc/odbc.ini

Untuk kasus lain di mana Anda tidak dapat membuat koneksi ke SQL Server menggunakan driver ODBC, lihat artikel masalah yang diketahui tentang pemecahan masalah koneksi.

Jika brew mengalami masalah saat menemukan rumus, pastikan Anda tidak melewati langkah penginstalan: brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release

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.