Поделиться через


Использование файлов заголовков и библиотек SQL Server Native Client

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Внимание

SQL Server Native Client (SNAC) не поставляется с:

  • SQL Server 2022 (16.x) и более поздних версий
  • SQL Server Management Studio 19 и более поздних версий

Собственный клиент SQL Server (SQLNCLI или SQLNCLI11) и устаревший поставщик Microsoft OLE DB для SQL Server (SQLOLEDB) не рекомендуется для разработки новых приложений.

Для новых проектов используйте один из следующих драйверов:

Сведения о SQLNCLI, которые поставляется в качестве компонента SQL Server ядро СУБД (версии 2012–2019), см. в этом исключении жизненного цикла поддержки.

Файлы заголовков и библиотек sql Server Native Client устанавливаются с ПОМОЩЬЮ SQL Server. При разработке приложения важно скопировать и установить все требуемые файлы для работы среды разработки. Дополнительные сведения об установке и распространении собственного клиента SQL Server см. в разделе "Установка собственного клиента SQL Server".

Файлы заголовка и библиотеки sql Server Native Client устанавливаются в следующем расположении:

%PROGRAM FILES%\Microsoft SQL Server\110\SDK

Файл заголовка собственного клиента SQL Server (sqlncli.h) можно использовать для добавления функций доступа к данным собственного клиента SQL Server в пользовательские приложения. Файл заголовка собственного клиента SQL Server содержит все определения, атрибуты, свойства и интерфейсы, необходимые для использования новых функций, представленных в SQL Server 2005 (9.x).

Помимо файла заголовка собственного клиента SQL Server существует файл библиотеки sqlncli11.lib, который является библиотекой экспорта для функций программы массового копирования SQL Server (BCP) для ODBC.

Файл заголовка собственного клиента SQL Server обратно совместим с файлами заголовков sqloledb.h и odbcss.h, используемыми с компонентами MICROSOFT Data Access (MDAC), но не содержит CLSID для SQLOLEDB (поставщик OLE DB для SQL Server, включенный в MDAC) или символы для функций XML (которые не поддерживаются собственным клиентом SQL Server).

Приложения ODBC не могут ссылаться на заголовок sql Server Native Client (sqlncli.h) и odbcss.h в той же программе. Даже если вы не используете какие-либо функции, представленные в SQL Server 2005 (9.x), файл заголовка собственного клиента SQL Server будет работать вместо старого odbcss.h.

Приложения OLE DB, использующие поставщик OLE DB собственного клиента SQL Server, должны ссылаться только на sqlncli.h. Если приложение использует mdAC (SQLOLEDB) и поставщик OLE DB собственного клиента SQL Server, оно может ссылаться как на sqloledb.h, так и на sqlncli.h, но ссылка на sqloledb.h должна появиться первым.

Использование файла заголовка собственного клиента SQL Server

Чтобы использовать файл заголовка собственного клиента SQL Server, необходимо использовать инструкцию включения в код программирования C/C++. В следующих подразделах описано, как это сделать для приложений OLE DB и ODBC.

Примечание.

Файлы заголовка и библиотеки собственного клиента SQL Server можно скомпилировать только с помощью Visual Studio C++ 2002 или более поздней версии.

OLE DB

Чтобы использовать файл заголовка собственного клиента SQL Server в приложении OLE DB, используя следующие строки кода программирования:

#define _SQLNCLI_OLEDB_  
include "sqlncli.h";  

Примечание.

Если приложение использует оба API-интерфейса (OLE DB и ODBC), то первая строка приведенного выше кода должна быть пропущена. Кроме того, если у приложения есть инструкция include для sqloledb.h, инструкция include для sqlncli.h должна прийти после нее.

При создании подключения к источнику данных с помощью собственного клиента SQL Server используйте "SQLNCLI11" в качестве строки имени поставщика.

ODBC

Чтобы использовать файл заголовка собственного клиента SQL Server в приложении ODBC, выполните следующие строки кода программирования:

#define _SQLNCLI_ODBC_  
include "sqlncli.h";  

Примечание.

Если приложение использует оба API-интерфейса (OLE DB и ODBC), то первая строка приведенного выше кода должна быть пропущена. Кроме того, если приложение содержит инструкцию #include для файла odbcss.h, ее нужно удалить.

При создании подключения к источнику данных с помощью собственного клиента SQL Server используйте "SQL Server Native Client 11.0" в качестве строки имени драйвера.

Имена и свойства компонентов в зависимости от версии

Свойство собственный клиент SQL Server

SQL Server 2005
Sql Server Native Client 10.0

SQL Server 2008
SQL Server Native Client 11.0

SQL Server 2012 (11.x)
MDAC
Имя драйвера ODBC Собственный клиент SQL Sql Server Native Client 10.0 SQL Server Native Client 11.0 SQL Server
Имя файла заголовка ODBC Sqlncli.h Sqlncli.h Sqlncli.h Odbcss.h
DLL-библиотека драйвера ODBC Sqlncli.dll Sqlncl10.dll Sqlncl11.dll sqlsrv32.dll
Библиотека ODBC для API-интерфейсов программы BCP Sqlncli.lib Sqlncli10.lib Sqlncli11.lib Odbcbcp.lib
DLL-библиотека ODBC для API-интерфейсов программы BCP Sqlncli.dll Sqlncli10.dll Sqlncli11.dll Odbcbcp.dll
Идентификатор PROGID OLE DB SQLNCLI SQLNCLI10 SQLNCLI11 SQLOLEDB
Имя файла заголовка OLE DB Sqlncli.h Sqlncli.h Sqlncli.h Sqloledb.h
DLL-библиотека поставщика OLE DB Sqlncli.dll Sqlncli10.dll Sqlncli11.dll Sqloledb.dll

sqlncli.h поддерживает несколько версий собственного клиента SQL Server через макрос SQLNCLI_VER. По умолчанию SQLNCLI_VER по умолчанию используется последняя версия собственного клиента SQL Server. Чтобы создать приложение, использующее sqlncli10.dll вместо sqlncli11.dll, установите SQLNCLI_VER в значение 10.

Статическая компоновка и функции BCP

Если в приложении используются функции BCP, важно указывать в строке подключения драйвер из той же версии, которая поставлялась с файлом заголовка и библиотекой, использованными при компиляции приложения.

Например, при компиляции приложения с помощью собственного клиента SQL Server и связанного файла библиотеки (sqlncli11.lib) и файла заголовка (sqlncli.h) из \Program Files\Microsoft SQL Server\110\SDK обязательно укажите (используя ODBC в качестве примера) "DRIVER={SQL Server Native Client 11.0}" в строка подключения.

Дополнительные сведения см. в разделе Performing Bulk Copy Operations (Выполнение операций массового копирования).

См. также

Построение приложений с использованием SQL Server Native Client