Sdílet prostřednictvím


Instalace ovladače Microsoft ODBC pro SQL Server (macOS)

Tento článek vysvětluje, jak nainstalovat ovladač Microsoft ODBC pro SQL Server v systému macOS. Obsahuje také pokyny pro volitelné nástroje příkazového řádku pro SQL Server (bcp a sqlcmd) a hlavičky vývoje unixODBC.

Tento článek obsahuje příkazy pro instalaci ovladače ODBC z prostředí Bash. Pokud chcete balíčky stáhnout přímo, přečtěte si téma Stažení ovladače ODBC pro SQL Server.

Poznámka:

Ovladač Microsoft ODBC pro SQL Server v systému macOS je podporován pouze v architektuře x64 až do verze 17.7. Podpora Apple ARM64 byla přidána od verze 17.8. Architektura se zjistí a vzorec Homebrew automaticky nainstaluje správný balíček. Pokud je váš příkazový řádek spuštěný v režimu emulace x64 v ARM64, nainstaluje se balíček x64. Pokud na příkazovém řádku neběžíte v režimu emulace, nainstaluje se balíček ARM64. Kromě toho se výchozí adresář Homebrew změnil s architekturou ARM64 na /opt/homebrew. Cesty v části Soubory ovladače používají cesty x64 Homebrew, které jsou výchozí /usr/local, takže cesty k souborům se budou odpovídajícím způsobem lišit.

Microsoft ODBC 18

Pokud chcete nainstalovat ovladač Microsoft ODBC 18 pro SQL Server v systému macOS, spusťte následující příkazy:

/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

Předchozí verze

Následující části obsahují pokyny k instalaci předchozích verzí ovladače Microsoft ODBC v systému macOS.

Microsoft ODBC 17

Pokud chcete nainstalovat ovladač Microsoft ODBC 17 pro SQL Server v systému macOS, spusťte následující příkazy:

/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

Důležité

Pokud jste nainstalovali balíček verze 17 msodbcsql, který byl krátce dostupný, měli byste ho odebrat před instalací balíčku msodbcsql17. Tím se zabrání konfliktům. Balíček msodbcsql17 lze nainstalovat vedle balíčku msodbcsql v13.

ODBC 13.1

Pomocí následujících příkazů nainstalujte ovladač Microsoft ODBC 13.1 pro SQL Server na OS X 10.11 (El Capitan) a 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

Soubory ovladačů

Ovladač ODBC v systému macOS se skládá z následujících komponent:

Součást Description
libmsodbcsql.18.dylib nebo libmsodbcsql.17.dylib nebo libmsodbcsql.13.dylib Soubor dynamické knihovny (dylib), který obsahuje všechny funkce ovladače. Tento soubor je nainstalován v /usr/local/lib/.
msodbcsqlr18.rll nebo msodbcsqlr17.rll nebo msodbcsqlr13.rll Doprovodný soubor zdrojů pro knihovnu ovladačů. Tento soubor je nainstalován pro [driver .dylib directory]../share/msodbcsql18/resources/en_US/ Driver 18, [driver .dylib directory]../share/msodbcsql17/resources/en_US/ pro Driver 17 a pro [driver .dylib directory]../share/msodbcsql/resources/en_US/ Driver 13.
msodbcsql.h Hlavičkový soubor, který obsahuje všechny nové definice potřebné k použití ovladače.

Poznámka: ve stejném programu nelze odkazovat na msodbcsql.h a odbcss.h.
Msodbcsql.h je nainstalován v /usr/local/include/msodbcsql18/ pro Driver 18, /usr/local/include/msodbcsql17/ pro Driver 17 a v /usr/local/include/msodbcsql/ pro Driver 13.
LICENSE.txt Textový soubor, který obsahuje podmínky licenční smlouvy End-User. Tento soubor je umístěn v /usr/local/share/doc/msodbcsql18/ pro ovladač 18, v /usr/local/share/doc/msodbcsql17/ pro ovladač 17 a v /usr/local/share/doc/msodbcsql/ pro ovladač 13.
POZNÁMKY K VYDÁNÍ Textový soubor, který obsahuje poznámky k verzi. Tento soubor je umístěn v /usr/local/share/doc/msodbcsql18/ pro Driver 18, v /usr/local/share/doc/msodbcsql17/ pro Driver 17 a v /usr/local/share/doc/msodbcsql/ pro Driver 13.

Načítání souboru zdrojů

Aby mohl ovladač fungovat, musí načíst soubor prostředků. Tento soubor se nazývá msodbcsqlr18.rll, msodbcsqlr17.rllnebo msodbcsqlr13.rll v závislosti na verzi ovladače. Umístění .rll souboru je relativní vzhledem k umístění samotného ovladače (so nebo dylib), jak je uvedeno v tabulce komponent. Od verze 17.1 se ovladač také pokusí načíst .rll z výchozího adresáře, pokud se načtení z relativní cesty nezdaří. Výchozí cesta k souboru prostředků v macOS je /usr/local/share/msodbcsql18/resources/en_US/

Řešení problémů

Někteří uživatelé narazí na problém při pokusu o připojení po instalaci ovladače ODBC a zobrazí se chyba, například: "[01000] [unixODBC][Driver Manager]Can't open lib 'ODBC Driver 18 for SQL Server' : file not found (0) (SQLDriverConnect)". Může se jednat o případ, že unixODBC není správně nakonfigurovaný pro vyhledání registrovaných ovladačů. V těchto případech může problém vyřešit vytváření symbolických odkazů.

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

Další případy, kdy nemůžete vytvořit připojení k SQL Serveru pomocí ovladače ODBC, najdete v článku o známých problémech s řešením problémů s připojením.

Pokud má brew potíže s vyhledáním vzorců, ujistěte se, že jste nepřeskočili krok instalace: brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release