適用於:
SQL Server - Linux
下列步驟會安裝命令列工具、Microsoft ODBC 驅動程式及兩者的相依性。
mssql-tools 套件包含:
-
sqlcmd:命令列查詢公用程式。
-
BCP:大量匯入/匯出公用程式。
安裝適用於您平台的工具:
本文描述如何安裝命令列工具。 如果您要尋找如何使用 sqlcmd 或 bcp 的範例,請參閱本文結尾的相關內容。
重要
適用於 和 架構的 mssql-tools18 中提供 x64 和 arm64。 如需跨 Linux、macOS 和 Windows 的新式替代方案,請參閱 go-sqlcmd 公用程式。
這些指示適用於安裝 Microsoft ODBC 18 套件。 如需之前版本的相關資訊,請參閱安裝 Microsoft ODBC driver for SQL Server (Linux)。
遵循下列步驟,在 Red Hat Enterprise Linux 上安裝 mssql-tools18。
下載 Microsoft Red Hat 存放庫組態檔。
針對 Red Hat 10 (預覽版),請使用下列命令從 RHEL 9 存放庫下載 Microsoft Red Hat 存放庫組態檔。 相同版本的工具也適用於 RHEL 10。
curl https://packages.microsoft.com/config/rhel/9/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo
針對 Red Hat 9,請使用下列命令:
curl https://packages.microsoft.com/config/rhel/9/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo
針對 Red Hat 8,請使用下列命令:
curl https://packages.microsoft.com/config/rhel/8/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo
針對 Red Hat 7,請使用下列命令:
curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo
如果您已安裝舊版的 mssql-tools,請移除所有舊版的 unixODBC 套件。
sudo yum remove mssql-tools unixODBC-utf16 unixODBC-utf16-devel
執行下列命令,使用 unixODBC 開發人員套件安裝 mssql-tools18。
sudo yum install -y mssql-tools18 unixODBC-devel
若要更新為最新版本的 mssql-tools,請執行下列命令:
sudo yum check-update
sudo yum update mssql-tools18
選用:在 Bash 殼層中將 /opt/mssql-tools18/bin/ 新增至您的 PATH 環境變數。
若要使 Bash 殼層在登入工作階段中可存取 sqlcmd 和 bcp,請使用下列命令修改 PATH 檔案中的 ~/.bash_profile:
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
source ~/.bash_profile
若要讓 sqlcmd 和 bcp 在互動和非登入會話中使用 Bash shell 存取,請使用下列命令修改 PATH 檔案中的 ~/.bashrc:
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
遵循下列步驟,在 SUSE Linux Enterprise Server 上安裝 mssql-tools18。
匯入 Microsoft 套件簽署金鑰。
curl -O https://packages.microsoft.com/keys/microsoft.asc
sudo rpm --import microsoft.asc
將 SQL Server 儲存機制新增至 Zypper。
使用 unixODBC 開發人員套件安裝 mssql-tools18。
sudo zypper install -y mssql-tools18 unixODBC-devel glibc-locale-base
sudo zypper install -y mssql-tools18 unixODBC-devel
若要更新為最新版本的 mssql-tools18,請執行下列命令:
sudo zypper refresh
sudo zypper update mssql-tools18
選用:在 Bash 殼層中將 /opt/mssql-tools18/bin/ 新增至您的 PATH 環境變數。
若要使 Bash 殼層在登入工作階段中可存取 sqlcmd 和 bcp,請使用下列命令修改 PATH 檔案中的 ~/.bash_profile:
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
source ~/.bash_profile
若要在互動式/非登入工作階段中,讓 Bash Shell 可以存取 sqlcmd 或 bcp,請使用下列命令修改 PATH 檔案中的 ~/.bashrc:
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
使用下列步驟在 Ubuntu 上安裝 mssql-tools18。
- 自 SQL Server 2025(17.x)起,將支援 Ubuntu 24.04 的預覽版。
- 從 SQL Server 2022 (16.x) CU 10 開始支援 Ubuntu 22.04。
- 從 SQL Server 2019 (15.x) CU 10 開始支援 Ubuntu 20.04。
- 從 SQL Server 2019 (15.x) CU 3 開始支援 Ubuntu 18.04。
進入超級使用者模式。
sudo su
匯入公開存放庫 GPG 金鑰。
curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc
註冊 Microsoft Ubuntu 存放庫。
curl https://packages.microsoft.com/config/ubuntu/18.04/prod.list | tee /etc/apt/sources.list.d/mssql-release.list
結束超級使用者模式。
exit
進入超級使用者模式。
sudo su
匯入公開存放庫 GPG 金鑰。
curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc
註冊 Microsoft Ubuntu 存放庫。
curl https://packages.microsoft.com/config/ubuntu/20.04/prod.list | tee /etc/apt/sources.list.d/mssql-release.list
結束超級使用者模式。
exit
進入超級使用者模式。
sudo su
匯入公開存放庫 GPG 金鑰。
curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc
註冊 Microsoft Ubuntu 存放庫。
curl https://packages.microsoft.com/config/ubuntu/22.04/prod.list | tee /etc/apt/sources.list.d/mssql-release.list
結束超級使用者模式。
exit
請依照以下步驟在 Ubuntu 24.04 預覽版上安裝 MSSQL-tools18 for SQL Server 2025(17.x)。
進入超級使用者模式。
sudo su
註冊 Ubuntu 24.04 的 Microsoft 存放庫。
curl -sSL -O https://packages.microsoft.com/config/ubuntu/24.04/packages-microsoft-prod.deb
安裝存放庫套件:
sudo dpkg -i packages-microsoft-prod.deb
結束超級使用者模式。
exit
更新來源清單,並使用 unixODBC 開發人員套件執行安裝命令。
sudo apt-get update
sudo apt-get install mssql-tools18 unixodbc-dev
若要更新為最新版本的 mssql-tools,請執行下列命令:
sudo apt-get update
sudo apt-get install mssql-tools18
選用:在 Bash 殼層中將 /opt/mssql-tools18/bin/ 新增至您的 PATH 環境變數。
若要使 Bash 殼層在登入工作階段中可存取 sqlcmd 和 bcp,請使用下列命令修改 PATH 檔案中的 ~/.bash_profile:
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
source ~/.bash_profile
若要讓 sqlcmd 和 bcp 在互動和非登入會話中使用 Bash shell 存取,請使用下列命令修改 PATH 檔案中的 ~/.bashrc:
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
安裝 Homebrew (若尚未安裝):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
若要安裝適用於 macOS El Capitan 和更新版本的工具,請使用下列命令:
# brew untap microsoft/mssql-preview if you installed the preview version
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
brew install mssql-tools18
如果您在 Docker 容器中執行 SQL Server,則 SQL Server 命令列工具已包含在 SQL Server Linux 容器映射中。 如果您使用互動式 Bash Shell 來附加至正在執行的容器,則您可以在本機執行這些工具。
如果您要使用 SQL Server 命令列工具建立容器,請將 ACCEPT_EULA=Y 新增至安裝命令,以無訊息方式接受 EULA,不要插斷映像建立。 在以 Ubuntu 為基礎的映像上進行安裝時,最後一個命令的範例為:
sudo ACCEPT_EULA=Y apt-get install mssql-tools18 unixodbc-dev
離線安裝
如果您的 Linux 電腦無法存取前幾節中使用的線上存放庫,則您可以直接下載套件檔案。 這些套件位於 Microsoft 存放庫 https://packages.microsoft.com 中。
提示
如果您已使用前幾節的步驟順利安裝,則不需要下載或手動安裝下列套件。 這只適用於離線案例。
首先,找出並複製適用於您 Linux 發行版本的 mssql-tools18 套件。 針對 Red Hat 8.0,這個套件位於 https://packages.microsoft.com/rhel/8/prod。
此外,也請找出並複製 msodbcsql18 套件,這是相依性。
msodbcsql18 套件也相依於 unixODBC-devel。 針對 Red Hat,msodbcsql18 套件位於 https://packages.microsoft.com/rhel/8/prod。
將已下載套件移至您的 Linux 電腦。 如果您使用不同電腦來下載套件,將套件移至 Linux 電腦的其中一種方式是使用 scp 命令。
安裝套件:安裝 mssql-tools18 和 msodbc18 套件。 如果您遇到任何相依性錯誤,請忽略,直到進行下一個步驟。 將 <version> 取代為正確的版本:
sudo yum localinstall msodbcsql18-<version>.rpm
sudo yum localinstall mssql-tools18-<version>.rpm
解決遺漏的相依性:此時,您可能會遺漏某些相依性。 如果沒有,則您可以略過此步驟。 在某些情況下。您必須手動找出並安裝這些相依性。
您可以使用下列命令來檢查所需的相依性。 將 <version> 取代為正確的版本:
rpm -qpR msodbcsql18-<version>.rpm
rpm -qpR mssql-tools18-<version>.rpm
首先,找出並複製適用於您 Linux 發行版本的 mssql-tools18 套件。 針對 SLES 15,這個套件位於 https://packages.microsoft.com/sles/15/prod。
此外,也請找出並複製 msodbcsql18 套件,這是相依性。
msodbcsql18 套件也相依於 unixODBC-devel。 針對 SLES,msodbcsql18 套件位於 https://packages.microsoft.com/sles/15/prod。
將已下載套件移至您的 Linux 電腦。 如果您使用不同電腦來下載套件,將套件移至 Linux 電腦的其中一種方式是使用 scp 命令。
安裝套件:安裝 mssql-tools18 和 msodbc18 套件。 如果您遇到任何相依性錯誤,請忽略,直到進行下一個步驟。 將 <version> 取代為正確的版本:
sudo zypper install msodbcsql18-<version>.rpm
sudo zypper install mssql-tools18-<version>.rpm
解決遺漏的相依性:此時,您可能會遺漏某些相依性。 如果沒有,則您可以略過此步驟。 在某些情況下。您必須手動找出並安裝這些相依性。
您可以使用下列命令來檢查所需的相依性。 將 <version> 取代為正確的版本:
rpm -qpR msodbcsql18-<version>.rpm
rpm -qpR mssql-tools18-<version>.rpm
首先,找出並複製適用於您 Linux 發行版本的 mssql-tools18 套件。 針對 Ubuntu 20.04,這個套件位於 https://packages.microsoft.com/ubuntu/20.04/prod/pool/main/m/mssql-tools。
此外,也請找出並複製 msodbcsql18 套件,這是相依性。
msodbcsql18 套件也相依於 unixodbc-dev。 針對 Ubuntu,msodbcsql18 套件位於 msodbcsql18 和 unixodbc-dev。
將已下載套件移至您的 Linux 電腦。 如果您使用不同電腦來下載套件,將套件移至 Linux 電腦的其中一種方式是使用 scp 命令。
安裝套件:安裝 mssql-tools18 和 msodbc18 套件。 如果您遇到任何相依性錯誤,請忽略,直到進行下一個步驟。 將 <version> 取代為正確的版本:
sudo dpkg -i msodbcsql18_<version>.deb
sudo dpkg -i mssql-tools18_<version>.deb
解決遺漏的相依性:此時,您可能會遺漏某些相依性。 如果沒有,則您可以略過此步驟。 在某些情況下。您必須手動找出並安裝這些相依性。
如果您可以存取包含這些相依性的已核准存放庫,則最簡單的解決方案是使用 apt-get 命令:
sudo apt-get -f install
此命令也會完成安裝 SQL Server 套件。
如果這個步驟不適用於您的 Debian 套件,您可以使用下列命令檢查所需的相依性:
dpkg -I msodbcsql18_<version>_amd64.deb | grep "Depends:"
dpkg -I mssql-tools18_<version>_amd64.deb | grep "Depends:"
相關內容
參與編輯 SQL 文件
您知道您可以自行編輯 SQL 內容嗎? 如果您這樣做,您不僅可以協助改善我們的文件,還能被列為該頁面的貢獻者。
如需詳細資訊,請參閱 編輯 Microsoft Learn 文件。