Использование типов данных XML
В версии SQL Server 2005 был введен тип данных xml, позволяющий хранить XML-документы и их фрагменты в базе данных SQL Server. Тип данных xml — это встроенный в SQL Server тип данных, несколько напоминающий другие встроенные типы данных, такие как int и varchar. Как и другие встроенные типы данных, тип данных xml можно использовать как тип столбца при создании таблицы, как тип переменной, параметра, тип возвращаемого функцией значения, а также в инструкциях CAST и CONVERT.
Замечания по программированию
Язык XML может описывать сам себя в том смысле, что он может по желанию включать заголовок XML, описывающий кодировку документа, например:
<?xml version="1.0" encoding="windows-1252"?><doc/>
Стандарт языка XML описывает, как обработчик XML определяет кодировку, использованную в документе, по первым нескольким байтам документа. Существует возможность, что кодировка, заданная приложением, не совпадет с кодировкой, заданной в документе. Для документов, переданных как связанные параметры, SQL Server обрабатывает XML как двоичные данные, поэтому никаких преобразований не производится и средство синтаксического анализа XML может без проблем использовать кодировку, указанную в документе. Однако для XML-данных, привязанных как WSTR, приложение должно проверить, что документ имеет кодировку Юникод. Возможно, придется загрузить документ в модель DOM, изменить кодировку на Юникод и сериализовать документ. Если этого не сделать, может произойти порча данных, в результате чего образуется недопустимый или испорченный XML-документ.
Возможен также конфликт, если XML задается в виде литерала. Например, приведенные ниже инструкции являются недопустимыми.
INSERT INTO xmltable(xmlcol) VALUES('<?xml version="1.0" encoding="UTF-16"?><doc/>')
INSERT INTO xmltable(xmlcol) VALUES(N'<?xml version="1.0" encoding="UTF-8"?><doc/>')
Поставщик OLE DB для собственного клиента SQL Server
DBTYPE_XML — новый, специфичный для XML тип данных в поставщике OLE DB для собственного клиента SQL Server. Кроме того, к XML-данным можно получить доступ через существующие типы OLE DB: DBTYPE_BYTES, DBTYPE_WSTR, DBTYPE_BSTR, DBTYPE_XML, DBTYPE_STR, DBTYPE_VARIANT и DBTYPE_IUNKNOWN. Данные, хранимые в столбцах типа XML, можно получить из столбца в наборе строк поставщика OLE DB для собственного клиента SQL Server в следующих форматах.
Текстовая строка
Интерфейс ISequentialStream
.gif "Примечание") Примечание |
|---|
Поставщик OLE DB для собственного клиента SQL Server не включает в себя функции чтения SAX, но интерфейс ISequentialStream легко передать объектам SAX и DOM в MSXML. |
Для получения больших XML-документов следует использовать интерфейс ISequentialStream. При работе с типами больших значений в XML используются те же технологии, что и для работы с другими типами больших значений. Дополнительные сведения см. в разделе Использование типов больших значений.
Приложение может также получать, вставлять и изменять данные, хранящиеся в столбцах типа XML в наборе строк, через обычные интерфейсы — IRow::GetColumns, IRowChange::SetColumns и ICommand::Execute. Как и в случае с получением, приложение может передавать текстовую строку или интерфейс ISequentialStream поставщику OLE DB для собственного клиента SQL Server.
| Примечание |
|---|
Для посылки XML-данных в строковом формате через интерфейс ISequentialStream нужно получить этот интерфейс ISequentialStream, задав DBTYPE_IUNKNOWN и установив в привязке аргумент pObject, равный NULL. |
Если полученные XML-данные усечены из-за недостаточного размера буфера потребителя, возвращаемое значение длины может быть равно 0xffffffff — это означает, что длина данных неизвестна. Это согласуется с реализацией в виде типа данных, который передается клиенту в потоке без отправки информации о длине до пересылки самих данных. В некоторых случаях может возвращаться реальная длина: если значение целиком помещено в буфер поставщика (например, IRowset::GetData) или если производится преобразование данных.
XML-данные, переданные в SQL Server, сервер обрабатывает как двоичные данные. Таким образом предотвращается преобразование данных, и это позволяет средству синтаксического анализа XML автоматически обнаружить кодировку XML. Это позволяет принимать в качестве входных данных для SQL Server более широкий диапазон XML-документов (например, документы в кодировке UTF-8).
Если входные XML-данные привязаны как тип DBTYPE_WSTR, приложение должно убедиться, что данные уже находятся в кодировке Юникод, чтобы предотвратить всякую возможность повреждения данных ненужными преобразованиями.
Привязки данных и приведение типов
В следующей таблице перечислены привязки и приведения, происходящие, когда указанный тип данных используется вместе с типом данных SQL Serverxml.
Тип данных |
На сервер XML |
На сервер Не XML |
С сервера XML |
С сервера Не XML |
|---|---|---|---|---|
DBTYPE_XML |
Передать6,7 |
Ошибка1 |
ОК11, 6 |
Ошибка8 |
DBTYPE_BYTES |
Передать6,7 |
н/д2 |
ОК11, 6 |
н/д2 |
DBTYPE_WSTR |
Передать6,10 |
н/д2 |
ОК4, 6, 12 |
н/д2 |
DBTYPE_BSTR |
Передать6,10 |
н/д2 |
ОК3 |
н/д2 |
DBTYPE_STR |
ОК6, 9, 10 |
н/д2 |
ОК5, 6, 12 |
н/д2 |
DBTYPE_IUNKNOWN |
Поток байтов через интерфейс ISequentialStream7 |
н/д2 |
Поток байтов через интерфейс ISequentialStream11 |
н/д2 |
DBTYPE_VARIANT (VT_UI1 | VT_ARRAY) |
Передать6,7 |
Н/Д2 |
Н/Д |
Н/Д2 |
DBTYPE_VARIANT (VT_BSTR) |
Передать6,10 |
Н/Д2 |
ОК3 |
Н/Д2 |
1Если вместе с интерфейсом ICommandWithParameters::SetParameterInfo указан тип сервера, отличный от DBTYPE_XML, а в качестве типа метода доступа задан DBTYPE_XML, то при выполнении инструкции произойдет ошибка (DB_E_ERRORSOCCURRED, состояние параметра будет DBSTATUS_E_BADACCESSOR); в противном случае данные будут отправлены на сервер, но сервер вернет ошибку, указывающую, что неявного преобразования из XML в тип данных параметра не существует.
2Не обсуждается в этом разделе.
3Формат UTF-16, метка порядка следования байтов (BOM) отсутствует, кодировка не указана, данные не завершаются нулем.
4Формат UTF-16, метка порядка следования байтов (BOM) отсутствует, кодировка не указана, данные завершаются нулем.
5Формат многобайтовый, кодировка совпадает с кодовой страницей клиента, данные завершаются нулем. Преобразование из переданной с сервера кодировки Юникод может вызвать повреждение данных, поэтому такую привязку крайне не рекомендуется использовать.
6Может использоваться BY_REF.
7Данные в формате UTF-16 должны начинаться с метки порядка байтов (BOM). Если метка отсутствует, то кодировка может быть неправильно распознана сервером.
8Проверка может происходить во время создания объекта доступа или во время выборки данных. Значение ошибки — DB_E_ERRORSOCCURRED, состояние привязки устанавливается в DBBINDSTATUS_UNSUPPORTEDCONVERSION.
9Данные преобразуются в кодировку Юникод с помощью клиентской кодовой страницы до отправки данных на сервер. Если кодировка документа не соответствует клиентской кодовой странице, это может вызвать повреждение данных, поэтому такую привязку крайне не рекомендуется использовать.
10Метка порядка байтов (BOM) всегда добавляется к данным, посылаемым на сервер. Если в начале данных уже стоит метка порядка следования байтов, то в начале буфера будут две метки порядка следования байтов. Сервер использует первую метку для распознавания кодировки как UTF-16, а затем отбрасывает ее. Вторая метка порядка следования байтов рассматривается как символ неразрывного пробела нулевой ширины.
11Данные в формате UTF-16, кодировка не указана, метка порядка байтов (BOM) добавляется к данным, полученным с сервера. Если сервер вернул пустую строку, метка порядка байтов все равно будет возвращена приложению. Если длина буфера представляет собой нечетное число байтов, данные усекаются корректно. Если значение возвращается по частям, их можно объединить для восстановления правильного значения.
12Если длина буфера меньше двух символов — иными словами, не хватает места для завершения данных нулем, — возникает ошибка переполнения.
| Примечание |
|---|
Для XML-данных со значением NULL не возвращаются никакие данные. |
Согласно стандарту XML XML-документы в кодировке UTF-16 должны начинаться с метки порядка следования байтов (BOM); в UTF-16 это код символа 0xFEFF. При работе с привязками типов WSTR и BSTR собственный клиент SQL Server не требует и не добавляет метки порядка байтов, так как кодировка задана привязкой. При работе с привязками типов BYTES, XML и IUNKNOWN целью является предоставление возможностей для наиболее простого взаимодействия с другими обработчиками XML и хранилищами данных. В этом случае в XML с кодировкой UTF-16 нужно включить метку порядка байтов, и приложение может не заботиться о том, какова на самом деле кодировка данных, потому что большинство обработчиков XML (в том числе SQL Server) вычислят кодировку по нескольким первым байтам данных. XML-данные, полученные от собственного клиента SQL Server с использованием привязок типов BYTES, XML или IUNKNOWN, всегда закодированы в кодировке UTF-16 с меткой порядка байтов и не содержат внедренной декларации кодировки.
Преобразование данных, выполняемое основными службами OLE DB (IDataConvert), неприменимо к типу DBTYPE_XML.
Проверка производится при отсылке данных на сервер. Проверку с клиентской стороны и изменение кодировки должно проводить приложение. Обрабатывать непосредственно XML-данные не рекомендуется. Для обработки данных лучше использовать функции чтения DOM или SAX.
Типы DBTYPE_NULL и DBTYPE_EMPTY могут быть привязаны только для входных параметров. Они не могут быть привязаны для выходных параметров или результатов. При привязке входных параметров состояние следует установить равным DBSTATUS_S_ISNULL или DBSTATUS_S_DEFAULT.
DBTYPE_XML можно преобразовать в DBTYPE_EMPTY и DBTYPE_NULL, DBTYPE_EMPTY можно преобразовать в DBTYPE_XML, но DBTYPE_NULL нельзя преобразовать в DBTYPE_XML. Это согласуется с DBTYPE_WSTR.
Привязка DBTYPE_IUNKNOWN поддерживается, как показано в приведенной таблице, но преобразований между типами DBTYPE_XML и DBTYPE_IUNKNOWN не существует. DBTYPE_IUNKNOWN нельзя использовать с DBTYPE_BYREF.
Добавления и изменения для наборов строк OLE DB
Собственный клиент SQL Server добавляет новые значения или изменяет многие из основных наборов строк схемы OLE DB.
Наборы строк схем COLUMNS и PROCEDURE_PARAMETERS
К наборам строк схем COLUMNS и PROCEDURE_PARAMETERS добавились следующие столбцы.
Имя столбца |
Тип |
Описание |
|---|---|---|
SS_XML_SCHEMACOLLECTION_CATALOGNAME |
DBTYPE_WSTR |
Имя каталога, в котором определена коллекция схем XML. Значение NULL для столбцов, отличных от XML, или нетипизированных XML-столбцов. |
SS_XML_SCHEMACOLLECTION_SCHEMANAME |
DBTYPE_WSTR |
Имя схемы, в которой определена коллекция схем XML. Значение NULL для столбцов, отличных от XML, или нетипизированных XML-столбцов. |
SS_XML_SCHEMACOLLECTIONNAME |
DBTYPE_WSTR |
Имя коллекции схем XML. Значение NULL для столбцов, отличных от XML, или нетипизированных XML-столбцов. |
Набор строк схемы PROVIDER_TYPES
В наборе строк схемы PROVIDER_TYPES значение параметра COLUMN_SIZE для типа данных xml равно 0, а DATA_TYPE равен DBTYPE_XML.
Набор строк схемы SS_XMLSCHEMA
Для клиентов добавлен новый набор строк схемы SS_XMLSCHEMA для получения информации о схеме XML. Набор строк SS_XMLSCHEMA содержит следующие столбцы.
Имя столбца |
Тип |
Описание |
|---|---|---|
SCHEMACOLLECTION_CATALOGNAME |
DBTYPE_WSTR |
Каталог, которому принадлежит коллекция XML. |
SCHEMACOLLECTION_SCHEMANAME |
DBTYPE_WSTR |
Схема, которой принадлежит коллекция XML. |
SCHEMACOLLECTIONNAME |
DBTYPE_WSTR |
Имя коллекции схем XML для типизированных XML-столбцов, NULL — для всех остальных столбцов. |
TARGETNAMESPACEURI |
DBTYPE_WSTR |
Имя целевого пространства имен схемы XML. |
SCHEMACONTENT |
DBTYPE_WSTR |
Содержимое схемы XML. |
Для каждой схемы XML задается область действия — именем каталога, именем схемы, именем коллекции схем и URI-идентификатором целевого пространства имен. Кроме того, задан новый идентификатор GUID с именем DBSCHEMA_XML_COLLECTIONS. Количество ограничений и столбцы с ограничениями для набора строк схемы SS_XMLSCHEMA определены следующим образом.
Идентификатор GUID |
Количество ограничений |
Столбцы с ограничениями |
|---|---|---|
DBSCHEMA_XML_COLLECTIONS |
4 |
SCHEMACOLLECTION_CATALOGNAME SCHEMACOLLECTION_SCHEMANAME SCHEMACOLLECTIONNAME TARGETNAMESPACEURI |
Добавления и изменения для наборов свойств OLE DB
Собственный клиент SQL Server добавляет новые значения или изменяет многие из основных наборов свойств OLE DB.
Набор свойств DBPROPSET_SQLSERVERPARAMETER
Для поддержки типа данных xml при работе через OLE DB собственный клиент SQL Server реализует новый набор свойств DBPROPSET_SQLSERVERPARAMETER, содержащий следующие значения.
Имя |
Тип |
Описание |
|---|---|---|
SSPROP_PARAM_XML_SCHEMACOLLECTION_CATALOGNAME |
DBTYPE_WSTR |
Имя каталога (базы данных), где определена коллекция схем XML. Часть идентификатора трехкомпонентного имени SQL. |
SSPROP_PARAM_XML_SCHEMACOLLECTION_SCHEMANAME |
DBTYPE_WSTR |
Имя схемы XML в коллекции схем XML. Часть идентификатора трехкомпонентного имени SQL. |
SSPROP_PARAM_XML_SCHEMACOLLECTIONNAME |
DBTYPE_WSTR |
Имя коллекции схем XML в каталоге. Часть идентификатора трехкомпонентного имени SQL. |
Набор свойств DBPROPSET_SQLSERVERCOLUMN
Для поддержки создания таблиц с помощью интерфейса ITableDefinition собственный клиент SQL Server добавляет к набору свойств DBPROPSET_SQLSERVERCOLUMN три новых столбца.
Имя |
Тип |
Описание |
|---|---|---|
SSPROP_COL_XML_SCHEMACOLLECTION_CATALOGNAME |
VT_BSTR |
Для типизированных XML-столбцов данное свойство содержит строку, представляющую имя каталога, где хранится схема XML. Для других типов столбцов это свойство содержит пустую строку. |
SSPROP_COL_XML_SCHEMACOLLECTION_SCHEMANAME |
VT_BSTR |
Для типизированных XML-столбцов данное свойство содержит строку, представляющую имя схемы XML, задающей этот столбец. |
SSPROP_COL_XML_SCHEMACOLLECTIONNAME |
VT_BSTR |
Для типизированных XML-столбцов данное свойство содержит строку, указывающую имя коллекции схем XML, содержащей данную схему XML. |
Подобно значениям SSPROP_PARAM, все эти свойства являются необязательными и по умолчанию пусты. SSPROP_COL_XML_SCHEMACOLLECTION_CATALOGNAME и SSPROP_COL_XML_SCHEMACOLLECTION_SCHEMANAME можно задавать только при заданном свойстве SSPROP_COL_XML_SCHEMACOLLECTIONNAME. При передаче данных в формате XML на сервер, если эти значения включены, они будут проверены на существование (допустимость) в текущей базе данных, а экземпляр данных проверяется по схеме. Во всех случаях, чтобы данные были допустимыми, эти столбцы должны быть все одновременно пусты или все одновременно заполнены.
Добавления и изменения для интерфейсов OLE DB
Собственный клиент SQL Server добавляет новые значения или изменяет многие из основных интерфейсов OLE DB.
Интерфейс ISSCommandWithParameters
Для поддержки типа данных xml при работе через OLE DB собственный клиент SQL Server содержит ряд изменений, в том числе в него добавлен интерфейс ISSCommandWithParameters. Этот новый интерфейс наследует основной интерфейс OLE DB — ICommandWithParameters. Помимо трех методов, наследуемых из интерфейса ICommandWithParameters — GetParameterInfo, MapParameterNames и SetParameterInfo, — интерфейс ISSCommandWithParameters содержит методы GetParameterProperties и SetParameterProperties, которые используются для обработки серверных типов данных.
| Примечание |
|---|
Интерфейс ISSCommandWithParameters также задействует возможности новой структуры SSPARAMPROPS. |
Интерфейс IColumnsRowset
Собственный клиент SQL Server добавляет следующие специфичные для SQL Server столбцы к набору строк, возвращаемому методом IColumnRowset::GetColumnsRowset. Эти столбцы содержат трехкомпонентное имя коллекции схем XML. Для столбцов, не находящихся в формате XML, и нетипизированных XML-столбцов все три данных столбца по умолчанию имеют значение NULL.
Имя столбца |
Тип |
Описание |
|---|---|---|
DBCOLUMN_SS_XML_SCHEMACOLLECTION_CATALOGNAME |
DBTYPE_WSTR |
Каталог, к которому принадлежит коллекция схем XML. В противном случае — значение NULL. |
DBCOLUMN_SS_XML_SCHEMACOLLECTION_SCHEMANAME |
DBTYPE_WSTR |
Схема, к которой принадлежит коллекция схем XML. В противном случае — значение NULL. |
DBCOLUMN_SS_XML_SCHEMACOLLECTIONNAME |
DBTYPE_WSTR |
Имя коллекции схем XML для типизированных XML-столбцов, NULL — для всех остальных столбцов. |
Интерфейс IRowset
Метод IRowset::GetData служит для получения экземпляра XML в XML-столбце. В зависимости от привязки, указанной клиентом, экземпляр XML может быть получен в виде типа DBTYPE_BSTR, DBTYPE_WSTR, DBTYPE_VARIANT, DBTYPE_XML, DBTYPE_STR, DBTYPE_BYTES или как интерфейс через DBTYPE_IUNKNOWN. Если потребитель задает один из следующих типов: DBTYPE_BSTR, DBTYPE_WSTR или DBTYPE_VARIANT, поставщик преобразует экземпляр XML в запрошенный пользователем тип и помещает в местоположение, заданное соответствующей привязкой.
Если потребитель задает DBTYPE_IUNKNOWN и устанавливает аргумент pObject равным NULL или задает для аргумента pObject значение IID_ISequentialStream, поставщик возвращает потребителю интерфейс ISequentialStream, чтобы потребитель мог получить из столбца XML-данные в виде потока. Затем интерфейс ISequentialStream возвращает XML-данные в виде потока символов в формате Юникод.
При возврате значения XML, привязанного к DBTYPE_IUNKNOWN, поставщик передает значение размера sizeof (IUnknown *). Следует заметить, что это согласуется с подходом, который используется при передаче привязанного столбца как DBTYPE_IUnknown или DBTYPE_IDISPATCH, а также при передаче в формате DBTYPE_IUNKNOWN/ISequentialStream, когда точный размер столбца установить не удается.
Интерфейс IRowsetChange
Потребитель может изменить экземпляр XML в столбце двумя способами. Первый способ использует объект хранилища с интерфейсом ISequentialStream, созданный поставщиком. Потребитель может вызвать метод ISequentialStream::Write для непосредственного изменения экземпляра XML, возвращенного поставщиком.
Второй подход использует методы IRowsetChange::SetData или IRowsetChange::InsertRow. При таком подходе экземпляр XML в буфере потребителя можно задать привязкой типа DBTYPE_BSTR, DBTYPE_WSTR, DBTYPE_VARIANT, DBTYPE_XML или DBTYPE_IUNKNOWN.
В случае DBTYPE_BSTR, DBTYPE_WSTR или DBTYPE_VARIANT поставщик сохраняет экземпляр XML из буфера потребителя в соответствующий столбец.
В случае DBTYPE_IUNKNOWN/ISequentialStream, если потребитель не задал объект хранилища, потребитель должен создать объект ISequentialStream заранее, привязать к этому объекту XML-документ, а затем передать объект поставщику методом IRowsetChange::SetData. Потребитель может также создать объект хранилища, установить аргумент pObject равным IID_ISequentialStream, создать объект ISequentialStream, а затем передать этот ISequentialStream методу IRowsetChange::SetData. В обоих случаях поставщик может получить объект XML через объект ISequentialStream и вставить в нужный столбец.
Интерфейс IRowsetUpdate
Интерфейс IRowsetUpdate предоставляет функциональность отсроченных изменений. Данные, доступные наборам строк, недоступны другим транзакциям, пока потребитель не вызовет метод IRowsetUpdate:Update.
Интерфейс IRowsetFind
Метод IRowsetFind::FindNextRow не работает с типом xml. При вызове IRowsetFind::FindNextRow, если в аргументе hAccessor передается столбец типа DBTYPE_XML, будет возвращен результат DB_E_BADBINDINFO. Это происходит независимо от типа столбца, в котором производится поиск данных. Для любого другого типа привязки вызов FindNextRow возвращает результат DB_E_BADCOMPAREOP, если столбец, в котором производится поиск данных, имеет тип xml.
Драйвер ODBC для собственного клиента SQL Server
В ODBC-драйвере для собственного клиента SQL Server изменены некоторые функции для поддержки типа данных xml.
SQLColAttribute
Функция SQLColAttribute теперь поддерживает три новых идентификатора поля, в том числе SQL_CA_SS_XML_SCHEMACOLLECTION_CATALOG_NAME, SQL_CA_SS_XML_SCHEMACOLLECTION_SCHEMA_NAME и SQL_CA_SS _XML_SCHEMACOLLECTION_NAME.
ODBC-драйвер для собственного клиента SQL Server возвращает значение SQL_SS_LENGTH_UNLIMITED для столбцов SQL_DESC_DISPLAY_SIZE и SQL_DESC_LENGTH.
SQLColumns
Функция SQLColumns теперь содержит три новых столбца: SS_XML_SCHEMACOLLECTION_CATALOG_NAME, SS_XML_SCHEMACOLLECTION_SCHEMA_NAME и SS_XML_SCHEMACOLLECTION_NAME. Существующий столбец TYPE_NAME используется для обозначения имени типа XML, а значение DATA_TYPE для столбца или параметра типа XML равно SQL_SS_XML.
ODBC-драйвер для собственного клиента SQL Server возвращает значение SQL_SS_LENGTH_UNLIMITED для значений COLUMN_SIZE и CHAR_OCTET_LENGTH.
SQLDescribeCol
ODBC-драйвер для собственного клиента SQL Server возвращает значение SQL_SS_LENGTH_UNLIMITED, если размер столбца не удается определить с помощью функции SQLDescribeCol.
SQLGetTypeInfo
ODBC-драйвер для собственного клиента SQL Server возвращает значение SQL_SS_LENGTH_UNLIMITED как максимальное значение COLUMN_SIZE для типа данных xml в функции SQLGetTypeInfo.
SQLProcedureColumns
В функцию SQLProcedureColumns добавлены те же столбцы, что и в функцию SQLColumns.
ODBC-драйвер для собственного клиента SQL Server возвращает значение SQL_SS_LENGTH_UNLIMITED как максимальное значение COLUMN_SIZE для типа данных xml.
Поддерживаемые преобразования
При преобразовании данных из типа SQL в типы языка C типы SQL_C_WCHAR, SQL_C_BINARY и SQL_C_CHAR могут быть преобразованы в SQL_SS_XML со следующими оговорками.
SQL_C_WCHAR. Формат UTF-16, метка порядка следования байтов (BOM) отсутствует, данные не завершаются нулем.
SQL_C_BINARY. Формат UTF-16, данные не завершаются нулем. Метка порядка байтов (BOM) добавляется к данным, получаемым с сервера. Если сервер вернул пустую строку, метка порядка байтов все равно будет возвращена приложению. Если длина буфера представляет собой нечетное число байтов, данные усекаются корректно. Если значение возвращается по частям, их можно объединить для восстановления правильного значения.
SQL_C_CHAR. Формат многобайтовый, кодировка совпадает с кодовой страницей клиента, данные завершаются нулем. Преобразование из переданной с сервера кодировки UTF-16 может вызвать повреждение данных, поэтому такую привязку крайне не рекомендуется использовать.
При преобразовании данных из типов языка С в типы SQL типы SQL_C_WCHAR, SQL_C_BINARY и SQL_C_CHAR могут быть преобразованы в SQL_SS_XML со следующими оговорками.
SQL_C_WCHAR. Метка порядка байтов (BOM) всегда добавляется к данным, посылаемым на сервер. Если в начале данных уже стоит метка порядка следования байтов, то в начале буфера будут две метки порядка следования байтов. Сервер использует первую метку для распознавания кодировки как UTF-16, а затем отбрасывает ее. Вторая метка порядка следования байтов рассматривается как символ неразрывного пробела нулевой ширины.
SQL_C_BINARY. Преобразование не проводится, данные передаются на сервер в неизменном виде. Данные в формате UTF-16 должны начинаться с метки порядка байтов. Если метка отсутствует, то кодировка может быть неправильно распознана сервером.
SQL_C_CHAR. Данные преобразуются в UTF-16 на клиенте и отсылаются на сервер в виде SQL_C_WCHAR (с добавлением метки порядка байтов). Если кодировка XML не совпадает с клиентской кодовой страницей, это может привести к повреждению данных.
Согласно стандарту XML XML-документы в кодировке UTF-16 должны начинаться с метки порядка следования байтов (BOM); в UTF-16 это код символа 0xFEFF. При работе с привязками типа SQL_C_BINARY собственный клиент SQL Server не требует и не добавляет метки порядка байтов, так как кодировка задана привязкой. Цель — предоставить возможности для наиболее простого взаимодействия с другими обработчиками XML и хранилищами данных. В этом случае в XML с кодировкой UTF-16 нужно включить метку порядка байтов, и приложение может не заботиться о том, какова на самом деле кодировка данных, потому что большинство обработчиков XML (в том числе SQL Server) выяснят кодировку по нескольким первым байтам данных. XML-данные, полученные от собственного клиента SQL Server с использованием привязок типа SQL_C_BINARY, всегда закодированы в кодировке UTF-16 с меткой порядка байтов и не содержат внедренной декларации кодировки.
См. также