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

Использование ключевых слов строки подключения с собственным клиентом SQL Server

  • Статья

Некоторые API-интерфейсы собственного клиента SQL Server используют строка подключения для указания атрибутов подключения. Строки подключения являются списками ключевых слов и связанных значений, причем каждое ключевое слово определяет определенный атрибут соединения.

Обратите внимание! Собственный клиент SQL Server позволяет неоднозначности в строка подключения поддерживать обратную совместимость (например, некоторые ключевые слова могут быть указаны более одного раза, и конфликтующие ключевые слова могут быть разрешены с разрешением на основе позиции или приоритета). Будущие выпуски собственного клиента SQL Server могут не разрешать неоднозначность в строка подключения. Рекомендуется изменять приложения для использования собственного клиента SQL Server для устранения любой зависимости от строка подключения неоднозначности.

В следующих разделах описываются ключевые слова, которые можно использовать с поставщиком OLE DB собственного клиента SQL Server, драйвером ODBC собственного клиента SQL Server и объектами данных ActiveX (ADO) при использовании собственного клиента SQL Server в качестве поставщика данных.

Ключевые слова в строке подключения драйвера ODBC

Приложения ODBC используют строка подключения в качестве параметров для функций SQLDriverConnect и SQLBrowseConnect.

Строки подключения, используемые ODBC, имеют следующий синтаксис:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[{]attribute-value[}]

attribute-value ::= character-string

attribute-keyword ::= identifier

Значения атрибутов можно (и рекомендуется) дополнительно заключить в фигурные скобки. Это позволяет избежать проблем, если значения атрибутов содержат символы, отличные от буквенно-цифровых. Предполагается, что первая закрывающая фигурная скобка в значении служит признаком конца значения, поэтому само значение не может содержать символы закрывающей фигурной скобки.

В следующей таблице описываются ключевые слова, которые можно использовать со строкой соединения ODBC.

Ключевое слово Description
Addr Синоним для «Address».
Address Сетевой адрес сервера, на котором выполняется экземпляр SQL Server. Address обычно является сетевым именем сервера, но может быть и другим именем, например именем канала, IP-адресом или портом TCP/IP с адресом сокета.

Если указать IP-адрес, убедитесь, что протоколы TCP/IP или именованных каналов включены в диспетчер конфигурации SQL Server.

Значение имеет приоритет над значениемAddress, переданным Server в строка подключения ODBC при использовании собственного клиента SQL Server. Также следует отметить, что строка Address=; соединяется с сервером, указанным в ключевом слове Server, а при использовании ключевых слов Address= ;, Address=.;, Address=localhost; и Address=(local); устанавливается соединение с локальным сервером.

Далее представлен полный синтаксис ключевого слова Address:

[протокол:]Address[,port |\pipe\pipename]

протокол может быть tcp (TCP/IP), lpc (общая память) или np (именованные каналы). Дополнительные сведения см. в статье Настройка клиентских протоколов.

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

port — это порт указанного сервера, к которому выполняется подключение. По умолчанию SQL Server использует порт 1433.
AnsiNPW Если задано значение «yes», то в драйвере используются определяемые стандартами ANSI правила обработки сравнений со значением NULL, дополнения символьных данных, формирования предупреждений и выполнения операция объединений со значением NULL. При использовании значения «no» определенные стандартом ANSI действия не используются. Дополнительные сведения о поведении NPW ANSI см. в разделе "Эффекты параметров ISO".
APP Имя приложения, вызывающего SQLDriverConnect (необязательно). Если задано, это значение хранится в столбце master.dbo.sysprocesses program_name и возвращается sp_who и функциями APP_NAME.
ApplicationIntent Объявляет тип рабочей нагрузки приложения при соединении с сервером. Возможные значения: ReadOnly и ReadWrite. Например: ApplicationIntent=ReadOnly

Значение по умолчанию — ReadWrite. Дополнительные сведения о поддержке собственного клиента SQL Server для групп доступности AlwaysOn см. в статье SQL Server Native Client Support for High Availability, Аварийное восстановление.
AttachDBFileName Имя первичного файла присоединяемой базы данных. Необходимо указать полный путь и экранировать любые символы \ при использовании символьной строковой переменной C:

AttachDBFileName=c:\\MyFolder\\MyDB.mdf

Эта база данных присоединяется и становится для соединения базой данных по умолчанию. Для использования AttachDBFileName необходимо также указать имя базы данных в параметре БАЗЫ ДАННЫХ SQLDriverConnect или атрибуте подключения SQL_COPT_CURRENT_CATALOG. Если база данных была подключена ранее, SQL Server не выполняет повторное присоединение к ней; он использует присоединенную базу данных в качестве значения по умолчанию для подключения.
AutoTranslate Если имеет значение «yes», строки символов ANSI, которыми обмениваются клиент и сервер, переводятся с использованием Юникода, чтобы минимизировать проблемы сопоставления символов национальных алфавитов кодовых страниц клиента и сервера.

Клиентские SQL_C_CHAR данные, отправленные в объект SQL Server char, varchar или текстовые переменные, параметр или столбец, преобразуются из символа в Юникод с помощью клиентской кодовой страницы ANSI (ACP), а затем преобразуются из Юникода в символ с помощью ACP сервера.

Sql Server char, varchar или текстовые данные, отправленные клиенту, SQL_C_CHAR переменная преобразуется из символа в Юникод с помощью сервера ACP, а затем преобразуется из Юникода в символ с помощью клиентского ACP.

Эти преобразования выполняются на клиенте драйвером ODBC собственного клиента SQL Server. Для этого необходимо, чтобы на сервере была доступна такая же кодовая страница ANSI, какая используется на клиенте.

Следующие параметры не влияют на преобразования, выполняемые для этих передач.

— Юникод SQL_C_WCHAR клиентские данные, отправленные на char, varchar или текст на сервере.
- данные char, varchar или текстового сервера, отправленные в переменную Юникода SQL_C_WCHAR на клиенте.
— ANSI SQL_C_CHAR клиентские данные, отправленные в Юникод nchar, nvarchar или ntext на сервере.
— Данные сервера Юникода nchar, nvarchar или ntext, отправленные в переменную ANSI SQL_C_CHAR на клиенте.

Если имеет значение «no», перевод символов не выполняется.

Драйвер ODBC собственного клиента SQL Server не преобразует символы ANSI клиента, SQL_C_CHAR данные, отправленные в char, varchar или текстовые переменные, параметры или столбцы на сервере. Преобразование не выполняется на char, varchar или текстовых данных, отправляемых с сервера на SQL_C_CHAR переменных на клиенте.

Если клиент и SQL Server используют разные APS, расширенные символы могут быть неправильно интерпретированы.
Database Имя базы данных SQL Server по умолчанию для подключения. Если ключевое слово Database не указано, используется база данных, определенная по умолчанию для имени входа. База данных по умолчанию из источника данных ODBC переопределяет базу данных по умолчанию, определенную для имени входа. База данных должна существовать, если не указан параметр AttachDBFileName. Если также указано ключевое слово AttachDBFileName, выполняется присоединение первичного файла, на который оно указывает, после чего присваивается имя базы данных, указанное ключевым словом Database.
Driver Имя драйвера, возвращаемого SQLDrivers. Ключевое слово для драйвера ODBC собственного клиента SQL Server — {SQL Server Native Client 11.0}. Ключевое слово Server требуется, если указано ключевое слово Driver, и ключевое слово DriverCompletion имеет значение SQL_DRIVER_NOPROMPT.

Дополнительные сведения об именах драйверов см. в разделе "Использование заголовка и файлов библиотеки sql Server Native Client".
DSN Имя существующего пользователя ODBC или системного источника данных. Это ключевое слово переопределяет все значения, указанные в ключевых словах Server, Network и Address.
Encrypt Указывает, необходимо ли шифрование данных перед их отправкой по сети. Допустимы значения «yes» и «no». Значение по умолчанию — «no».
Fallback Это ключевое слово устарело, и его параметр игнорируется драйвером ODBC собственного клиента SQL Server.
Failover_Partner Имя сервера партнера по обеспечению отработки отказа, которое будет использоваться, если невозможно установить соединение с сервером-источником.
FailoverPartnerSPN Имя участника-службы для партнера по обеспечению отработки отказа. Значение по умолчанию — пустая строка. Пустая строка приводит к тому, что собственный клиент SQL Server использует имя субъекта-службы, созданное по умолчанию.
FileDSN Имя существующего файлового источника данных ODBC.
Language Имя языка SQL Server (необязательно). SQL Server может хранить сообщения для нескольких языков в sysmessages. При подключении к SQL Server с несколькими языками Language указывает, какой набор сообщений используется для подключения.
MARS_Connection Включает или отключает режим MARS для соединения. Распознаются значения «yes» и «no». Значение по умолчанию — «no».
MultiSubnetFailover Всегда указывать multiSubnetFailover=Yes при подключении к прослушивателю группы доступности группы доступности SQL Server или экземпляру отказоустойчивого кластера SQL Server. multiSubnetFailover=Yes настраивает собственный клиент SQL Server для ускорения обнаружения и подключения к активному серверу (в настоящее время). Возможные значения: Yes и No. Например:

MultiSubnetFailover=Yes

Значение по умолчанию — No. Дополнительные сведения о поддержке собственного клиента SQL Server для групп доступности AlwaysOn см. в статье SQL Server Native Client Support for High Availability, Аварийное восстановление.
Net Синоним для «Network».
Network Допустимые значения: dbnmpntw (именованные каналы) и dbmssocn (TCP/IP).

Одновременное указание значения для ключевого слова Network и префикса протокола в ключевом слове Server является ошибкой.
PWD Пароль для учетной записи входа SQL Server, указанной в параметре UID. Указание PWD не требуется в случае, если пароль у имени входа равен NULL, либо при использовании проверки подлинности Windows (Trusted_Connection = yes).
QueryLog_On Если имеет значение «yes», для соединения включается регистрация данных длительных запросов. Если имеет значение «no», данные длительных запросов не регистрируются.
QueryLogFile Полный путь и имя файла, используемого для регистрации данных длительных запросов.
QueryLogTime Строка цифровых символов, указывающая порог (в миллисекундах) для регистрации длительных запросов. Любой запрос, ответ на который не поступает за указанное время, записывается в файл регистрации длительных запросов.
QuotedId Если значение "да", QUOTED_IDENTIFIERS задано для подключения, SQL Server использует правила ISO относительно использования кавычки в инструкциях SQL. Если параметр равен «no», то параметр QUOTED_IDENTIFIERS для соединения отключается (принимает значение OFF). Затем SQL Server следует устаревшим правилам Transact-SQL относительно использования кавычки в инструкциях SQL. Дополнительные сведения см. в разделе "Эффекты параметров ISO".
Regional Если "да", драйвер ODBC собственного клиента SQL Server использует параметры клиента при преобразовании данных валюты, даты и времени в символьные данные. Преобразование является односторонним, то есть драйвер не распознает строки даты и значения валюты, отличные от стандарта ODBC, например, параметры инструкций INSERT или UPDATE. Если имеет значение «no», драйвер использует стандартные строки ODBC для представления данных валюты, даты и времени, преобразуемых в символьные данные.
SaveFile Имя исходного файла данных ODBC, в который сохраняются атрибуты текущего соединения, если соединение успешно установлено.
Server Имя экземпляра SQL Server. Значение должно быть либо именем сервера в сети, IP-адресом или именем псевдонима диспетчер конфигурации SQL Server.

Ключевое слово Address переопределяет ключевое слово Server.

Чтобы подключиться к экземпляру по умолчанию на локальном сервере, можно указать одно из следующих ключевых слов:

- Server=;
- Server=.;
- Server=(local);
- Server=(localhost);
- Server=(localdb)\ имя экземпляра ;

Дополнительные сведения о поддержке LocalDB см. в статье sql Server Native Client Support for LocalDB.

Чтобы указать именованный экземпляр SQL Server, добавьте \имя экземпляра.

Если сервер не указан, устанавливается соединение с экземпляром по умолчанию на локальном компьютере.

Если указать IP-адрес, убедитесь, что протоколы TCP/IP или именованных каналов включены в диспетчер конфигурации SQL Server.

Далее представлен полный синтаксис ключевого слова Server:

Server=[протокол:]Сервер[,порт]

протокол может быть tcp (TCP/IP), lpc (общая память) или np (именованные каналы).

Ниже приводится пример указания именованного канала:

np:\\.\pipe\MSSQL$MYINST01\sql\query

Эта строка указывает протокол именованного канала, именованный канал на локальном компьютере (), имя экземпляра SQL Server (\\.\pipeMSSQL$MYINST01) и имя именованного канала (sql/query).

Если ни протокол, Network ни ключевое слово не указано, sql Server Native Client будет использовать порядок протокола, указанный в диспетчер конфигурации SQL Server.

port — это порт указанного сервера, к которому выполняется подключение. По умолчанию SQL Server использует порт 1433.

Пробелы игнорируются в начале значения, переданного Server в строка подключения ODBC при использовании собственного клиента SQL Server.
ServerSPN Имя участника-службы для сервера. Значение по умолчанию — пустая строка. Пустая строка приводит к тому, что собственный клиент SQL Server использует имя субъекта-службы, созданное по умолчанию.
StatsLog_On Если значение "да", включает запись данных производительности драйвера ODBC собственного клиента SQL Server. Если значение "нет", данные о производительности драйвера ODBC собственного клиента SQL Server недоступны в подключении.
StatsLogFile Полный путь и имя файла, используемого для записи статистики производительности драйвера ODBC собственного клиента SQL Server.
Trusted_Connection Когда "да" указывает драйверу ODBC собственного клиента SQL Server использовать режим проверки подлинности Windows для проверки входа. В противном случае драйвер ODBC собственного клиента SQL Server указывает использовать имя пользователя и пароль SQL Server для проверки входа, а ключевые слова UID и PWD должны быть указаны.
TrustServerCertificate Если используется с ключевым словом Encrypt, включает шифрование с использованием самозаверяющего сертификата сервера.
UID Допустимая учетная запись входа SQL Server. Ключевое слово UID не нужно указывать при использовании проверки подлинности Windows.
UseProcForPrepare Это ключевое слово устарело, и его параметр игнорируется драйвером ODBC собственного клиента SQL Server.
WSID Идентификатор рабочей станции. Обычно это сетевое имя компьютера, на котором находится приложение (необязательно). Если задано, это значение хранится в имени узла столбца master.dbo.sysprocesses и возвращается sp_who и функцией HOST_NAME.

Региональные параметры преобразований применяются к типам данных валюты, чисел и даты-времени. Параметр преобразования применим только к преобразованию выходных данных и отображается только в том случае, если значения валюты, числовых, дат или времени преобразуются в символьные строки..

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

Изменение режима работы источника данных с региональными параметрами может привести к ошибке приложения. Изменение этого значения может отрицательно повлиять на работу приложения, анализирующего строки даты и предполагающего, что строки даты будут выводиться в виде, определенном ODBC.

Ключевые слова строки подключения поставщика OLE DB

Приложения OLE DB могут инициализировать объекты источника данных двумя способами:

  • IDBInitialize::Initialize

  • IDataInitialize::GetDataSource

В первом случае строка поставщика может использоваться для инициализации свойств соединения посредством установки свойства DBPROP_INIT_PROVIDERSTRING в наборе свойств DBPROPSET_DBINIT. Во втором случае строка инициализации может быть передана методу IDataInitialize::GetDataSource для инициализации свойств соединения. При использовании каждого из этих методов инициализируются одни и те же свойства соединения OLE DB, однако, для этого применяются разные наборы ключевых слов. Набор ключевых слов, используемых методом IDataInitialize::GetDataSource, представляет собой по меньшей мере описание свойств, входящих в группу свойств инициализации.

Для любого параметра, указанного в строке поставщика, который имеет соответствующее свойство OLE DB, устанавливаемое в некоторое значение по умолчанию или явным образом установленное в некоторое значение, значение свойства OLE DB переопределяет значение, указанное в строке поставщика.

Логические свойства, установленные в строках поставщика через значения DBPROP_INIT_PROVIDERSTRING, устанавливаются с помощью значений «yes» и «no». Логические свойства, установленные в строках инициализации с помощью метода IDataInitialize::GetDataSource, устанавливаются с использованием значений true и false.

Приложения, использующие метод IDataInitialize::GetDataSource, также могут использовать ключевые слова, используемые методом IDBInitialize::Initialize, но только для свойств, у которых отсутствуют значения по умолчанию. Если приложение одновременно использует в строке инициализации ключевые слова методов IDataInitialize::GetDataSource и IDBInitialize::Initialize, используется ключевое слово метода IDataInitialize::GetDataSource. Настоятельно рекомендуется не использовать в приложениях ключевые слова IDBInitialize::Initialize в строках подключения IDataInitialize:GetDataSource, так как это поведение может не поддерживаться в будущих версиях.

Примечание. Строка подключения, передаваемый через IDataInitialize::GetDataSource, преобразуется в свойства и применяется через IDBProperties::SetProperties. Если службы компонентов обнаруживают описание свойства в IDBProperties::GetPropertyInfo, это свойство будет применяться в качестве изолированного. В противном случае оно будет применяться через свойство DBPROP_PROVIDERSTRING. Например, если указать строка подключения Data Source=server1; Server=server2Data Source будет задано в качестве свойства, но Server перейдет в строку поставщика.

Если указать несколько экземпляров одного свойства поставщика, то будет использоваться первое значение первого свойства.

Строки подключения, используемые в приложениях OLE DB, в которых используется DBPROP_INIT_PROVIDERSTRING и IDBInitialize::Initialize, имеют следующий синтаксис.

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[{]attribute-value[}]

attribute-value ::= character-string

attribute-keyword ::= identifier

Значения атрибутов можно (и рекомендуется) дополнительно заключить в фигурные скобки. Это позволяет избежать проблем, если значения атрибутов содержат символы, отличные от буквенно-цифровых. Предполагается, что первая закрывающая фигурная скобка в значении служит признаком конца значения, поэтому само значение не может содержать символы закрывающей фигурной скобки.

Пробельный символ после знака равенства (=) в строке подключения будет считаться литералом, даже если значение заключено в кавычки.

В следующей таблице рассматриваются ключевые слова, которые можно использовать со свойством DBPROP_INIT_PROVIDERSTRING.

Ключевое слово Свойство инициализации Description
Addr SSPROP_INIT_NETWORKADDRESS Синоним для «Address».
Address SSPROP_INIT_NETWORKADDRESS Сетевой адрес экземпляра SQL Server в организации.

Дополнительные сведения о допустимом синтаксисе адресов см. в описании ключевого слова ODBC Address далее в этом разделе.
APP SSPROP_INIT_APPNAME Строка, идентифицирующая приложение.
ApplicationIntent SSPROP_INIT_APPLICATIONINTENT Объявляет тип рабочей нагрузки приложения при соединении с сервером. Возможные значения: ReadOnly и ReadWrite.

Значение по умолчанию — ReadWrite. Дополнительные сведения о поддержке собственного клиента SQL Server для групп доступности AlwaysOn см. в статье SQL Server Native Client Support for High Availability, Аварийное восстановление.
AttachDBFileName SSPROP_INIT_FILENAME Имя первичного файла присоединяемой базы данных (включает полный путь). Чтобы использовать ключевое слово AttachDBFileName, необходимо также указать имя базы данных с помощью ключевого слова DATABASE в строке поставщика. Если база данных была подключена ранее, SQL Server не повторно прикрепить ее (она использует присоединенную базу данных в качестве базы данных по умолчанию для подключения).
Auto Translate SSPROP_INIT_AUTOTRANSLATE Синоним для «AutoTranslate».
AutoTranslate SSPROP_INIT_AUTOTRANSLATE Настраивает перевод символов OEM/ANSI. Распознаются значения «yes» и «no».
Database DBPROP_INIT_CATALOG Имя базы данных.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY Указывает используемый режим обработки типов данных. Распознаются значения «0» (для типов данных поставщика) и «80» (для типов данных SQL Server 2000).
Encrypt SSPROP_INIT_ENCRYPT Указывает, необходимо ли шифрование данных перед их отправкой по сети. Допустимы значения «yes» и «no». Значение по умолчанию — «no».
FailoverPartner SSPROP_INIT_FAILOVERPARTNER Имя сервера отработки отказа, используемого для зеркального отображения базы данных.
FailoverPartnerSPN SSPROP_INIT_FAILOVERPARTNERSPN Имя участника-службы для партнера по обеспечению отработки отказа. Значение по умолчанию — пустая строка. Пустая строка приводит к тому, что собственный клиент SQL Server будет использовать имя субъекта-службы, созданное поставщиком по умолчанию.
Language SSPROPT_INIT_CURRENTLANGUAGE Язык SQL Server.
MarsConn SSPROP_INIT_MARSCONNECTION Включает или отключает несколько активных результирующих наборов (MARS) подключения, если сервер — SQL Server 2005 или более поздней версии. Допустимы значения «yes» и «no». Значение по умолчанию — «no».
Net SSPROP_INIT_NETWORKLIBRARY Синоним для «Network».
Network SSPROP_INIT_NETWORKLIBRARY Сетевая библиотека, используемая для установления подключения к экземпляру SQL Server в организации.
Network Library SSPROP_INIT_NETWORKLIBRARY Синоним для «Network».
PacketSize SSPROP_INIT_PACKETSIZE Размер сетевого пакета. Значение по умолчанию — 4096.
PersistSensitive DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Принимает в качестве значений строки «yes» и «no». Если используется значение «no», объекту источника данных запрещено хранить конфиденциальные данные проверки подлинности.
PWD DBPROP_AUTH_PASSWORD Пароль для входа SQL Server.
Server DBPROP_INIT_DATASOURCE Имя экземпляра SQL Server в организации.

Если имя не задано, то производится соединение с экземпляром по умолчанию на локальном компьютере.

Дополнительные сведения о допустимом синтаксисе адресов см. в описании ключевого слова ODBC Server в этом разделе.
ServerSPN SSPROP_INIT_SERVERSPN Имя участника-службы для сервера. Значение по умолчанию — пустая строка. Пустая строка приводит к тому, что собственный клиент SQL Server будет использовать имя субъекта-службы, созданное поставщиком по умолчанию.
Timeout DBPROP_INIT_TIMEOUT Время (в секундах), в течение которого ожидается завершение инициализации источника данных.
Trusted_Connection DBPROP_AUTH_INTEGRATED Когда значение "да", указывает поставщику OLE DB собственного клиента SQL Server использовать режим проверки подлинности Windows для проверки входа. В противном случае поставщик OLE DB собственного клиента SQL Server указывает использовать имя пользователя и пароль SQL Server для проверки входа, а ключевые слова UID и PWD должны быть указаны.
TrustServerCertificate SSPROP_INIT_TRUST_SERVER_CERTIFICATE Принимает в качестве значений строки «yes» и «no». По умолчанию имеет значение «no», которое указывает, что сертификат сервера будет проверяться.
UID DBPROP_AUTH_USERID Имя входа SQL Server.
UseProcForPrepare SSPROP_INIT_USEPROCFORPREP Это ключевое слово устарело, и его параметр игнорируется поставщиком OLE DB собственного клиента SQL Server.
WSID SSPROP_INIT_WSID Идентификатор рабочей станции.

Строки подключения, используемые приложениями OLE DB, в которых используется IDataInitialize::GetDataSource, имеют следующий синтаксис.

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[quote]attribute-value[quote]

attribute-value ::= character-string

attribute-keyword ::= identifier

quote ::= " | '

Использование свойства должно соответствовать синтаксическим правилам, действующим в его области. Например, в WSID заключается в фигурные скобки ({}), а Application Name — в апострофы (') или двойные кавычки ("). Заключать в кавычки можно только строковые свойства. Заключение в кавычки целочисленного или перечисляемого свойства приведет к ошибке «Строка подключения не соответствует спецификации OLE DB».

Значения атрибутов можно при желании заключать в одинарные или двойные кавычки, а фактически это даже рекомендуется. Это позволяет избежать проблем, если значения содержат символы, отличные от буквенно-цифровых. Используемый символ кавычек может также появиться в значении при условии его удвоения.

Пробельный символ после знака равенства (=) в строке подключения будет считаться литералом, даже если значение заключено в кавычки.

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

В следующей таблице рассматриваются ключевые слова, которые можно использовать с IDataInitialize::GetDataSource.

Ключевое слово Свойство инициализации Description
Application Name SSPROP_INIT_APPNAME Строка, идентифицирующая приложение.
Application Intent SSPROP_INIT_APPLICATIONINTENT Объявляет тип рабочей нагрузки приложения при соединении с сервером. Возможные значения: ReadOnly и ReadWrite.

Значение по умолчанию — ReadWrite. Дополнительные сведения о поддержке собственного клиента SQL Server для групп доступности AlwaysOn см. в статье SQL Server Native Client Support for High Availability, Аварийное восстановление.
Auto Translate SSPROP_INIT_AUTOTRANSLATE Синоним для «AutoTranslate».
AutoTranslate SSPROP_INIT_AUTOTRANSLATE Настраивает перевод символов OEM/ANSI. Распознаются значения «true» и «false».
Connect Timeout DBPROP_INIT_TIMEOUT Время (в секундах), в течение которого ожидается завершение инициализации источника данных.
Current Language SSPROPT_INIT_CURRENTLANGUAGE Имя языка SQL Server.
Data Source DBPROP_INIT_DATASOURCE Имя экземпляра SQL Server в организации.

Если имя не задано, то производится соединение с экземпляром по умолчанию на локальном компьютере.

Дополнительные сведения о допустимом синтаксисе адресов см. в описании ключевого слова ODBC Server далее в этом разделе.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY Указывает используемый режим обработки типов данных. Распознаются значения «0» (для типов данных поставщика) и «80» (для типов данных SQL Server 2000).
Failover Partner SSPROP_INIT_FAILOVERPARTNER Имя сервера отработки отказа, используемого для зеркального отображения базы данных.
Failover Partner SPN SSPROP_INIT_FAILOVERPARTNERSPN Имя участника-службы для партнера по обеспечению отработки отказа. Значение по умолчанию — пустая строка. Пустая строка приводит к тому, что собственный клиент SQL Server будет использовать имя субъекта-службы, созданное поставщиком по умолчанию.
Initial Catalog DBPROP_INIT_CATALOG Имя базы данных.
Initial File Name SSPROP_INIT_FILENAME Имя первичного файла присоединяемой базы данных (включает полный путь). Чтобы использовать ключевое слово AttachDBFileName, необходимо также указать имя базы данных с помощью ключевого слова DATABASE в строке поставщика. Если база данных была подключена ранее, SQL Server не повторно прикрепить ее (она использует присоединенную базу данных в качестве базы данных по умолчанию для подключения).
Integrated Security DBPROP_AUTH_INTEGRATED Принимает значение «SSPI» для проверки подлинности Windows.
MARS Connection SSPROP_INIT_MARSCONNECTION Включает или отключает режим MARS для соединения. Распознаются значения «true» и «false». Значение по умолчанию — «false».
Network Address SSPROP_INIT_NETWORKADDRESS Сетевой адрес экземпляра SQL Server в организации.

Дополнительные сведения о допустимом синтаксисе адресов см. в описании ключевого слова ODBC Address далее в этом разделе.
Network Library SSPROP_INIT_NETWORKLIBRARY Сетевая библиотека, используемая для установления подключения к экземпляру SQL Server в организации.
Packet Size SSPROP_INIT_PACKETSIZE Размер сетевого пакета. Значение по умолчанию — 4096.
Password DBPROP_AUTH_PASSWORD Пароль для входа SQL Server.
Persist Security Info DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Принимает в качестве значений строки «true» и «false». Если указано значение «false», объекту источника данных не разрешается сохранять конфиденциальные сведения проверки подлинности.
Provider Для собственного клиента SQL Server это должно быть "SQLNCLI11".
Server SPN SSPROP_INIT_SERVERSPN Имя участника-службы для сервера. Значение по умолчанию — пустая строка. Пустая строка приводит к тому, что собственный клиент SQL Server будет использовать имя субъекта-службы, созданное поставщиком по умолчанию.
Trust Server Certificate SSPROP_INIT_TRUST_SERVER_CERTIFICATE Принимает в качестве значений строки «true» и «false». По умолчанию имеет значение «false», которое указывает, что сертификат сервера будет проверяться.
Use Encryption for Data SSPROP_INIT_ENCRYPT Указывает, необходимо ли шифрование данных перед их отправкой по сети. Возможными значениями являются «true» и «false». Значение по умолчанию равно "false".
User ID DBPROP_AUTH_USERID Имя входа SQL Server.
Workstation ID SSPROP_INIT_WSID Идентификатор рабочей станции.

Примечание. В строке подключения свойство Old Password устанавливает значение свойства SSPROP_AUTH_OLD_PASSWORD, которое является текущим паролем (возможно, с истекшим сроком действия), недоступным через свойство строки поставщика.

Ключевые слова строки подключения объектов данных ActiveX (ADO)

Приложения ADO устанавливают свойство ConnectionString объектов ADODBConnection или указывают строку подключения как параметр метода Open объектов ADODBConnection.

В приложениях ADO также могут применяться ключевые слова, используемые методом OLE DB IDBInitialize::Initialize, но только для свойств, у которых отсутствует значение по умолчанию. Если в строке инициализации приложения содержатся ключевые слова ADO и ключевые слова IDBInitialize::Initialize, используется параметр ключевого слова ADO. Настоятельно рекомендуется, чтобы приложение использовало для строк соединения только ключевые слова ADO.

Строки подключения, используемые ADO, имеют следующий синтаксис:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=["]attribute-value["]

attribute-value ::= character-string

attribute-keyword ::= identifier

Значения атрибутов можно (и рекомендуется) дополнительно заключить в двойные кавычки. Это позволяет избежать проблем, если значения содержат символы, отличные от буквенно-цифровых. Значения атрибутов не могут содержать двойные кавычки.

В следующей таблице описываются ключевые слова, которые можно использовать со строками соединения ADO.

Ключевое слово Свойство инициализации Description
Application Intent SSPROP_INIT_APPLICATIONINTENT Объявляет тип рабочей нагрузки приложения при соединении с сервером. Возможные значения: ReadOnly и ReadWrite.

Значение по умолчанию — ReadWrite. Дополнительные сведения о поддержке собственного клиента SQL Server для групп доступности AlwaysOn см. в статье SQL Server Native Client Support for High Availability, Аварийное восстановление.
Application Name SSPROP_INIT_APPNAME Строка, идентифицирующая приложение.
Auto Translate SSPROP_INIT_AUTOTRANSLATE Синоним для «AutoTranslate».
AutoTranslate SSPROP_INIT_AUTOTRANSLATE Настраивает перевод символов OEM/ANSI. Распознаются значения «true» и «false».
Connect Timeout DBPROP_INIT_TIMEOUT Время (в секундах), в течение которого ожидается завершение инициализации источника данных.
Current Language SSPROPT_INIT_CURRENTLANGUAGE Имя языка SQL Server.
Data Source DBPROP_INIT_DATASOURCE Имя экземпляра SQL Server в организации.

Если имя не задано, то производится соединение с экземпляром по умолчанию на локальном компьютере.

Дополнительные сведения о допустимом синтаксисе адресов см. в описании ключевого слова ODBC Server в этом разделе.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY Задает используемый режим обработки типов данных. Распознаются значения «0» (для типов данных поставщика) и «80» (для типов данных SQL Server 2000).
Failover Partner SSPROP_INIT_FAILOVERPARTNER Имя сервера отработки отказа, используемого для зеркального отображения базы данных.
Failover Partner SPN SSPROP_INIT_FAILOVERPARTNERSPN Имя участника-службы для партнера по обеспечению отработки отказа. Значение по умолчанию — пустая строка. Пустая строка приводит к тому, что собственный клиент SQL Server будет использовать имя субъекта-службы, созданное поставщиком по умолчанию.
Initial Catalog DBPROP_INIT_CATALOG Имя базы данных.
Initial File Name SSPROP_INIT_FILENAME Имя первичного файла присоединяемой базы данных (включает полный путь). Чтобы использовать ключевое слово AttachDBFileName, необходимо также указать имя базы данных с помощью ключевого слова DATABASE в строке поставщика. Если база данных была подключена ранее, SQL Server не повторно прикрепить ее (она использует присоединенную базу данных в качестве базы данных по умолчанию для подключения).
Integrated Security DBPROP_AUTH_INTEGRATED Принимает значение «SSPI» для проверки подлинности Windows.
MARS Connection SSPROP_INIT_MARSCONNECTION Включает или отключает несколько активных результирующих наборов (MARS) подключения, если сервер — SQL Server 2005 или более поздней версии. Распознаются значения «true» и «false». По умолчанию используется значение «false».
Network Address SSPROP_INIT_NETWORKADDRESS Сетевой адрес экземпляра SQL Server в организации.

Дополнительные сведения о допустимом синтаксисе адресов см. в описании ключевого слова ODBC Address в этом разделе.
Network Library SSPROP_INIT_NETWORKLIBRARY Сетевая библиотека, используемая для установления подключения к экземпляру SQL Server в организации.
Packet Size SSPROP_INIT_PACKETSIZE Размер сетевого пакета. Значение по умолчанию — 4096.
Password DBPROP_AUTH_PASSWORD Пароль для входа SQL Server.
Persist Security Info DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Принимает в качестве значений строки «true» и «false». Если указано значение «false», объекту источника данных не разрешается сохранять конфиденциальные сведения проверки подлинности.
Provider Для собственного клиента SQL Server это должно быть "SQLNCLI11".
Server SPN SSPROP_INIT_SERVERSPN Имя участника-службы для сервера. Значение по умолчанию — пустая строка. Пустая строка приводит к тому, что собственный клиент SQL Server будет использовать имя субъекта-службы, созданное поставщиком по умолчанию.
Trust Server Certificate SSPROP_INIT_TRUST_SERVER_CERTIFICATE Принимает в качестве значений строки «true» и «false». По умолчанию имеет значение «false», которое указывает, что сертификат сервера будет проверяться.
Use Encryption for Data SSPROP_INIT_ENCRYPT Указывает, необходимо ли шифрование данных перед их отправкой по сети. Возможными значениями являются «true» и «false». Значение по умолчанию равно "false".
User ID DBPROP_AUTH_USERID Имя входа SQL Server.
Workstation ID SSPROP_INIT_WSID Идентификатор рабочей станции.

Примечание. В строке подключения свойство Old Password устанавливает значение свойства SSPROP_AUTH_OLD_PASSWORD, которое является текущим паролем (возможно, с истекшим сроком действия), недоступным через свойство строки поставщика.

См. также

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