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 penggunaan untuk alat yang bersifat opsional pada baris perintah untuk SQL Server (bcp dan sqlcmd) serta 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), Ubuntu, dan Azure Linux. Dimulai dengan versi 18.4, untuk menerima Perjanjian Lisensi Pengguna Akhir (EULA) secara otomatis saat menginstal driver Linux.deb (atau .rpm) non-Alpine, Anda dapat membuat file /opt/microsoft/msodbcsql18/ACCEPT_EULA.

Alpine

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/0b3d5518-b4a7-4a2b-afc7-7ee9e967f93c/msodbcsql18_18.6.2.1-1_$architecture.apk
curl -O https://download.microsoft.com/download/cad0d30f-b9b1-4765-a011-81d8a66c8b8d/mssql-tools18_18.6.2.1-1_$architecture.apk

#(Optional) Verify signature, if 'gpg' is missing install it using 'apk add gnupg':
curl -O https://download.microsoft.com/download/0b3d5518-b4a7-4a2b-afc7-7ee9e967f93c/msodbcsql18_18.6.2.1-1_$architecture.sig
curl -O https://download.microsoft.com/download/cad0d30f-b9b1-4765-a011-81d8a66c8b8d/mssql-tools18_18.6.2.1-1_$architecture.sig

curl https://packages.microsoft.com/keys/microsoft.asc | gpg --import -
gpg --verify msodbcsql18_18.6.2.1-1_$architecture.sig msodbcsql18_18.6.2.1-1_$architecture.apk
gpg --verify mssql-tools18_18.6.2.1-1_$architecture.sig mssql-tools18_18.6.2.1-1_$architecture.apk

#Install the package(s)
sudo apk add --allow-untrusted msodbcsql18_18.6.2.1-1_$architecture.apk
sudo apk add --allow-untrusted mssql-tools18_18.6.2.1-1_$architecture.apk

Catatan

Diperlukan driver versi 17.5 atau yang lebih tinggi untuk dukungan Alpine.

Debian

if ! [[ "9 10 11 12 13" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
then
    echo "Debian $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
    exit;
fi

# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/debian/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.deb
# Install the package
sudo dpkg -i packages-microsoft-prod.deb
# Delete the file
rm packages-microsoft-prod.deb

sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y apt-get install -y mssql-tools18
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install -y unixodbc-dev
# optional: kerberos library for debian-slim distributions
sudo apt-get install -y libgssapi-krb5-2

Catatan

Alih-alih mengatur variabel ACCEPT_EULAlingkungan , Anda dapat mengatur debconf variabel msodbcsql/ACCEPT_EULA:

echo msodbcsql18 msodbcsql/ACCEPT_EULA boolean true | sudo debconf-set-selections

RHEL dan Oracle Linux

if ! [[ "7 8 9 10" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
then
    echo "RHEL $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
    exit;
fi

# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/rhel/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.rpm
# Install the package
sudo yum install packages-microsoft-prod.rpm
# Delete the file
rm packages-microsoft-prod.rpm

sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install -y msodbcsql18
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y yum install -y mssql-tools18
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo yum install -y unixODBC-devel

SLES

if ! [[ "12 15" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
then
    echo "SLES $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
    exit;
fi

# Import the GPG key
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/sles/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.rpm
# Install the package
sudo zypper install packages-microsoft-prod.rpm
# Delete the file
rm packages-microsoft-prod.rpm

sudo zypper update
sudo ACCEPT_EULA=Y zypper install -y msodbcsql18
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y zypper install -y mssql-tools18
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo zypper install -y unixODBC-devel

Ubuntu

if ! [[ "18.04 20.04 22.04 24.04 25.10" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)"* ]];
then
    echo "Ubuntu $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2) is not currently supported.";
    exit;
fi

# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/ubuntu/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)/packages-microsoft-prod.deb
# Install the package
sudo dpkg -i packages-microsoft-prod.deb
# Delete the file
rm packages-microsoft-prod.deb

# Install the driver
sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y apt-get install -y mssql-tools18
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install -y unixodbc-dev

Catatan

Alih-alih mengatur variabel ACCEPT_EULAlingkungan , Anda dapat mengatur debconf variabel msodbcsql/ACCEPT_EULA:

echo msodbcsql18 msodbcsql/ACCEPT_EULA boolean true | sudo debconf-set-selections

Azure Linux

Catatan

Azure Linux 3.0 menyertakan repositori paket Microsoft secara default. Anda tidak perlu mengonfigurasi repositori secara manual sebelum menginstal driver. Jika gambar Azure Linux Anda menggunakan tdnf sebagai manajer paket, perintah berikut berfungsi secara langsung.

if ! [[ "3.0" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)"* ]];
then
    echo "Azure Linux $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2) is not currently supported.";
    exit;
fi

sudo ACCEPT_EULA=Y tdnf install -y msodbcsql18
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y tdnf install -y mssql-tools18
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo tdnf install -y unixODBC-devel

Catatan

Jika Anda tidak mengatur ACCEPT_EULA variabel lingkungan, penginstalan masih berlanjut. Namun, Anda perlu menjalankan /opt/microsoft/msodbcsql18/accept-eula.sh dan /opt/mssql-tools18/bin/accept-eula.sh secara manual untuk menyetujui persyaratan lisensi. Untuk menerima EULA secara otomatis selama penginstalan, Anda dapat membuat file /opt/microsoft/msodbcsql18/ACCEPT_EULA dan /opt/mssql-tools18/ACCEPT_EULA.

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 hanya tersedia singkat, hapus paket tersebut sebelum menginstal paket msodbcsql17 untuk menghindari konflik. Anda dapat menginstal paket msodbcsql17 berdampingan dengan paket msodbcsql v13.

Alpine

#Download the desired package(s)
curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.10.6.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.6.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.6.1-1_amd64.sig msodbcsql17_17.10.6.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.6.1-1_amd64.apk
sudo apk add --allow-untrusted mssql-tools_17.10.1.1-1_amd64.apk

Catatan

Diperlukan driver versi 17.5 atau yang lebih tinggi untuk dukungan Alpine.

Debian

if ! [[ "8 9 10 11 12" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
then
    echo "Debian $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
    exit;
fi

# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/debian/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.deb
# Install the package
sudo dpkg -i packages-microsoft-prod.deb
# Delete the file
rm packages-microsoft-prod.deb

sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install -y msodbcsql17
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y apt-get install -y mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install -y unixodbc-dev
# optional: kerberos library for debian-slim distributions
sudo apt-get install -y libgssapi-krb5-2

Catatan

Alih-alih mengatur variabel ACCEPT_EULAlingkungan , Anda dapat mengatur debconf variabel msodbcsql/ACCEPT_EULA:

echo msodbcsql17 msodbcsql/ACCEPT_EULA boolean true | sudo debconf-set-selections

RHEL dan Oracle Linux

if ! [[ "6 7 8 9" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
then
    echo "RHEL $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
    exit;
fi

# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/rhel/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.rpm
# Install the package
sudo yum install packages-microsoft-prod.rpm
# Delete the file
rm packages-microsoft-prod.rpm

sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install -y msodbcsql17
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y yum install -y mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo yum install -y unixODBC-devel

SLES

if ! [[ "11 12 15" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
then
    echo "SLES $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
    exit;
fi

# Import the GPG key
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/sles/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.rpm
# Install the package
sudo zypper install packages-microsoft-prod.rpm
# Delete the file
rm packages-microsoft-prod.rpm

# If you need driver 17.3 or below on SLES 15, you also need to run:
# sudo SUSEConnect -p sle-module-legacy/15/x86_64

sudo zypper update
sudo ACCEPT_EULA=Y zypper install -y msodbcsql17
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y zypper install -y mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo zypper install -y unixODBC-devel

Ubuntu

if ! [[ "14.04 16.04 18.04 20.04 22.04" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)"* ]];
then
    echo "Ubuntu $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2) is not currently supported.";
    exit;
fi

# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/ubuntu/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)/packages-microsoft-prod.deb
# Install the package
sudo dpkg -i packages-microsoft-prod.deb
# Delete the file
rm packages-microsoft-prod.deb

sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install -y msodbcsql17
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y apt-get install -y mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install -y unixodbc-dev

Catatan

Alih-alih mengatur variabel ACCEPT_EULAlingkungan , Anda dapat mengatur debconf variabel msodbcsql/ACCEPT_EULA:

echo msodbcsql17 msodbcsql/ACCEPT_EULA boolean true | sudo debconf-set-selections

ODBC 13.1

Bagian berikut menjelaskan cara menginstal driver Microsoft ODBC 13.1 dari shell bash untuk distribusi Linux yang berbeda.

Debian 8

if ! [[ "8" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
then
    echo "Debian $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
    exit;
fi

# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/debian/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.deb
# Install the package
sudo dpkg -i packages-microsoft-prod.deb
# Delete the file
rm packages-microsoft-prod.deb

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

RHEL 7

if ! [[ "6 7" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
then
    echo "RHEL $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
    exit;
fi

# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/rhel/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.rpm
# Install the package
sudo yum install packages-microsoft-prod.rpm
# Delete the file
rm packages-microsoft-prod.rpm

sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install msodbcsql
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y yum install mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo yum install unixODBC-devel

SLES 12

if ! [[ "11 12" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
then
    echo "SLES $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
    exit;
fi

# Import the GPG key
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/sles/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.rpm
# Install the package
sudo zypper install packages-microsoft-prod.rpm
# Delete the file
rm packages-microsoft-prod.rpm

sudo ACCEPT_EULA=Y zypper install msodbcsql
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y zypper install mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo zypper install unixODBC-devel

Ubuntu 16.04

if ! [[ "14.04 16.04" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)"* ]];
then
    echo "Ubuntu $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2) is not currently supported.";
    exit;
fi

# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/ubuntu/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)/packages-microsoft-prod.deb
# Install the package
sudo dpkg -i packages-microsoft-prod.deb
# Delete the file
rm packages-microsoft-prod.deb

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.

RHEL 7 (ODBC 13)

if ! [[ "6 7" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
then
    echo "RHEL $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
    exit;
fi

# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/rhel/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.rpm
# Install the package
sudo yum install packages-microsoft-prod.rpm
# Delete the file
rm packages-microsoft-prod.rpm

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

Ubuntu 16.04 (ODBC 13)

if ! [[ "14.04 16.04" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)"* ]];
then
    echo "Ubuntu $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2) is not currently supported.";
    exit;
fi

# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/ubuntu/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)/packages-microsoft-prod.deb
# Install the package
sudo dpkg -i packages-microsoft-prod.deb
# Delete the file
rm packages-microsoft-prod.deb

sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install msodbcsql=13.0.1.0-1 mssql-tools=14.0.2.0-1
sudo apt-get install unixodbc-dev-utf16 #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

SLES 12 (ODBC 13)

if ! [[ "11 12" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
then
    echo "SLES $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
    exit;
fi

# Import the GPG key
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
# Download the package to configure the Microsoft repo
curl -sSL -O https://packages.microsoft.com/config/sles/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.rpm
# Install the package
sudo zypper install packages-microsoft-prod.rpm
# Delete the file
rm packages-microsoft-prod.rpm

sudo zypper update
sudo ACCEPT_EULA=Y zypper install msodbcsql-13.0.1.0-1 mssql-tools-14.0.2.0-1
sudo zypper install unixODBC-utf16-devel
#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 untuk ODBC 13

Jika Anda perlu menginstal Microsoft ODBC Driver 13 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, openssldebconf (>= 0.5), unixODBC (>= 2.3.1-1)
• Red Hat: glibc, , e2fsprogskrb5-libs, openssl,unixODBC
• SUSE: glibc, libuuid1, krb5, openssl, unixODBC

Masing-masing paket ini 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.

Anda dapat mengunduh semua paket dependen secara manual dan menempatkannya bersama-sama di komputer penginstalan. Kemudian, instal setiap paket secara manual secara bergantian, selesai dengan paket Microsoft ODBC Driver 13.

RHEL 7 (ODBC 13 offline)

• Unduh paket terbaru msodbcsql 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

SLES 12 (ODBC 13 offline)

• Unduh paket terbaru msodbcsql dari https://packages.microsoft.com/sles/12/prod/.
• Pasang semua dependensi dan driver.

sudo zypper install glibc, libuuid1, krb5, openssl, unixODBC unixODBC-devel #install dependencies
sudo rpm -i  msodbcsql-13.1.X.X-X.x86_64.rpm #install the Driver

Setelah menyelesaikan penginstalan paket, Anda dapat memverifikasi bahwa Microsoft ODBC Driver 13 dapat menemukan semua dependensinya dengan menjalankan ldd dan memeriksa outputnya untuk pustaka yang hilang:

ldd /opt/microsoft/msodbcsql/lib64/libmsodbcsql-*

Ubuntu 16.04 (ODBC 13 offline)

• Unduh paket terbaru msodbcsql dari https://packages.microsoft.com/ubuntu/16.04/prod/pool/main/m/msodbcsql/.
• Pasang dependensi dan driver.

sudo apt-get install libc6 libstdc++6 libkrb5-3 libcurl3 openssl debconf unixodbc unixodbc-dev #install dependencies
sudo dpkg -i msodbcsql_13.1.X.X-X_amd64.deb #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 di SUSE Linux, nama filenya adalah msodbcsql-11.0.2260.0.tar.gz.

Untuk menginstal driver:

1. Pastikan Anda memiliki izin root.

2. Unduh driver.

   Distribusi	Driver	Hash SHA256
   Red Hat 5	msodbcsql-11.0.2270.0.tar.gz	178280daf01a49b8322cd902b6440979adacd594c01cd2a1f081dda23dbfb343
   Red Hat 6	msodbcsql-11.0.2270.0.tar.gz	e9b6bd33d174c7753b3a3f2d541713fbc156b46254484a169caa3f459dd828f7
   Linux SUSE	msodbcsql-11.0.2260.0.tar.gz	86d1c5842be4f0095234a9455e18a04fdf4cc7960ec0255b37258112e2391ef5

3. Ubah ke direktori tempat unduhan menempatkan file msodbcsql-11.0.2270.0.tar.gz. Pastikan Anda memiliki file yang cocok dengan *.tar.gz versi Linux Anda. Untuk mengekstrak file, jalankan perintah berikut:

   tar xvzf msodbcsql-11.0.2270.0.tar.gz
   

4. Ubah ke direktori msodbcsql-11.0.2270.0. Anda akan melihat file yang disebut install.sh.

5. Untuk melihat daftar opsi penginstalan yang tersedia, jalankan perintah berikut:

   ./install.sh
   

6. 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
   

7. Sebelum Anda menginstal driver, jalankan perintah berikut:

   ./install.sh verify
   

   Output dari ./install.sh verify melaporkan apakah komputer Anda memiliki perangkat lunak yang diperlukan untuk mendukung driver ODBC di Linux.

8. Ketika Anda siap untuk menginstal driver ODBC di Linux, jalankan perintah:

   ./install.sh install
   

   Jika Anda perlu menentukan perintah instal (bin-dir atau lib-dir), tentukan perintah setelah install opsi .

9. Setelah meninjau perjanjian lisensi, ketik YES 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"

Copot pemasangan

Hapus instalan 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 mencakup komponen-komponen berikut:

Komponen	Deskripsi
libmsodbcsql-17.X.so.X.X atau libmsodbcsql-13.X.so.X.X	Berkas pustaka dinamis berbagi objek (so) yang berisi semua fungsionalitas driver. Jalur penginstalan adalah /opt/microsoft/msodbcsql17/lib64/ untuk Driver 17 dan /opt/microsoft/msodbcsql/lib64/ untuk Driver 13.
msodbcsqlr17.rll atau msodbcsqlr13.rll	File sumber daya yang menyertai pustaka driver. Jalur penginstalan adalah [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. Jalur penginstalan adalah /opt/microsoft/msodbcsql17/include/ untuk Driver 17 dan /opt/microsoft/msodbcsql/include/ untuk Driver 13.
LICENSE.txt	File teks yang berisi ketentuan Perjanjian Lisensi Pengguna Akhir. Jalur penginstalan adalah /usr/share/doc/msodbcsql17/ untuk Driver 17 dan /usr/share/doc/msodbcsql/ untuk Driver 13.
RELEASE_NOTES	File teks yang berisi catatan rilis. Jalur penginstalan adalah /usr/share/doc/msodbcsql17/ untuk Driver 17 dan /usr/share/doc/msodbcsql/ untuk Driver 13.

Pemuatan file sumber daya

Pengemudi perlu memuat file sumber daya agar dapat berfungsi. 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 dijelaskan dalam tabel sebelumnya. Dimulai dengan versi 17.1, jika driver tidak dapat memuat .rll file dari jalur relatif, driver juga mencoba memuat .rll file dari direktori default. Jalur file sumber daya default di Linux adalah /opt/microsoft/msodbcsql17/share/resources/en_US/.

Pecahkan masalah

Konflik versi driver sebelumnya

Jika sebelumnya Anda menginstal dan mendaftarkan versi driver dengan unixODBC, penginstalan mungkin gagal dengan kesalahan yang mirip dengan:

Installation failed, ODBC Driver $1 for SQL Server detected!

Untuk mengatasi masalah, batalkan pendaftaran versi driver tersebut dengan menggunakan odbcinst perintah . Ganti $1 dengan versi driver yang dilaporkan dalam kesalahan penginstalan:

odbcinst -u -d -n "ODBC Driver $1 for SQL Server"

Jika menghapus instalasi dengan menggunakan odbcinst perintah gagal, Anda dapat menghapus bagian driver secara manual dari odbcinst.ini file. Anda dapat menemukan lokasi odbcinst.ini file dengan menggunakan perintah odbcinst -j.

Kesalahan pengunduhan paket pada Debian dan Ubuntu

Pada distribusi berbasis Debian, Anda mungkin melihat kesalahan berikut saat menginstal packages-microsoft-prod.deb paket:

dpkg-deb: error: 'packages-microsoft-prod.deb' is not a Debian format archive

Kesalahan ini biasanya berarti file yang diunduh rusak atau tidak lengkap, sering disebabkan oleh gangguan jaringan atau masalah proksi. Untuk mengatasi masalah:

1. Hapus file yang rusak dan unduh lagi. Untuk Ubuntu:

   rm packages-microsoft-prod.deb
   curl -sSL -O https://packages.microsoft.com/config/ubuntu/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)/packages-microsoft-prod.deb
   

   Untuk Debian, ganti ubuntu dan gunakan nomor versi utama saja:

   rm packages-microsoft-prod.deb
   curl -sSL -O https://packages.microsoft.com/config/debian/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.deb
   

2. Verifikasi bahwa unduhan adalah paket Debian yang valid (output harus mencakup Debian binary package):

   file packages-microsoft-prod.deb
   

3. Jika unduhan terus gagal, periksa koneksi jaringan dan pengaturan proksi Anda, atau gunakan wget alih-alih curl:

   wget https://packages.microsoft.com/config/ubuntu/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)/packages-microsoft-prod.deb
   

Masalah koneksi

Jika Anda tidak dapat membuat koneksi ke SQL Server dengan menggunakan driver ODBC, lihat artikel masalah yang diketahui tentang pemecahan masalah koneksi.

Konten terkait

• Aplikasi contoh C / C++ ODBC mengakses database SQL
• Mengembangkan Aplikasi
• catatan rilis
• persyaratan sistem