SQL Server 2005. Предложение FOR используется для задания параметра BROWSE или XML

Предложение FOR используется для задания параметра BROWSE или XML. Параметры BROWSE и XML не связаны друг с другом.

Соглашения о синтаксисе в Transact-SQL

Синтаксис

[ FOR { BROWSE | <XML> } ]<XML>::=XML { { RAW [ ('ElementName') ] | AUTO } [ <CommonDirectives> [, { XMLDATA | XMLSCHEMA [ ('TargetNameSpaceURI') ] } ] [, ELEMENTS [ XSINIL | ABSENT ] ] | EXPLICIT [ <CommonDirectives> [, XMLDATA ] ] | PATH [ ('ElementName') ] [ <CommonDirectives> [, ELEMENTS [ XSINIL | ABSENT ] ] ]} <CommonDirectives>::= [, BINARY BASE64 ][, TYPE ][, ROOT [ ('RootName') ] ]

Аргументы

BROWSE

Активирует возможность обновления данных во время их просмотра с помощью курсора в режиме обзора DB-Library. Таблицу можно просмотреть внутри приложения, если в таблице содержится столбец timestamp, если таблице присвоен уникальный индекс или если в конце инструкции SELECT, отсылаемой экземпляру SQL Server, имеется параметр FOR BROWSE.

Примечание.

Нельзя использовать синтаксис <lock_hint> HOLDLOCK для инструкции SELECT, включающей в себя параметр FOR BROWSE.

Примечание.

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

Параметр FOR BROWSE не может быть использован в инструкциях SELECT, соединенных оператором UNION.

XML

Задает возврат результатов запроса в виде XML-документа. Должен быть задан один из следующих режимов XML: RAW, AUTO, EXPLICIT. Дополнительные сведения об XML-данных и Analysis Services см. в разделе Создание XML с помощью предложения FOR XML.

RAW [ (' ElementName ') ]

Получает результат запроса и преобразует каждую строку результирующего набора в элемент XML, для которого в качестве тега используется общий идентификатор <row />. Дополнительно можно задать имя для элемента строки. Для результирующего выхода в формате XML в качестве элементов, создаваемых для каждой строки, используются определенные ElementName. Дополнительные сведения см. в разделах Использование режима RAW иРасширения режима RAW.

AUTO

Возвращает результаты запроса в виде простого вложенного дерева XML. Каждая таблица предложения FROM, для которой в предложении SELECT приведен хотя бы один столбец, отображается как элемент XML. Столбцы, перечисленные в предложении SELECT, сопоставлены с соответствующими атрибутами элемента. Дополнительные сведения см. в разделах Использование режима AUTO и Расширения режима AUTO.

EXPLICIT

Задает явное определение формы результирующего XML-дерева. При использовании данного режима запросы должны записываться таким образом, чтобы дополнительные сведения о вложениях могли быть заданы явно. Дополнительные сведения см. в разделах Применение режима EXPLICIT и Расширения режима EXPLICIT.

XMLDATA

Возвращает встроенную XDR-схему, не добавляя корневой элемент к результату. При задании параметра XMLDATA XDR-схема добавляется к документу.

XMLSCHEMA [ (' TargetNameSpaceURI ') ]

Возвращает встроенную XSD-схему. При задании указанной директивы, возвращающей заданное пространство имен схемы, дополнительно можно задать URI целевого пространства имен. Дополнительные сведения см. в разделе Создание встроенных XSD-схем.

ELEMENTS

Задает возврат столбцов в виде вложенных элементов. В противном случае столбцы будут сопоставлены с XML-атрибутами. Данный параметр поддерживается только в режимах RAW, AUTO и PATH. Дополнительные сведения см. в разделе Расширения режима RAW.

XSINIL

Задает создание элемента с атрибутом xsi:nil, установленного в значение True, для столбцов со значениями NULL. Данный параметр может быть указан только в директиве ELEMENTS. Дополнительные сведения см. в разделе Создание элементов для значений NULL с помощью параметра XSINIL.

ABSENT

Указывает, что соответствующие XML-элементы для столбцов со значениями NULL к XML-результату не добавляются. Указывайте данный параметр только с директивой ELEMENTS.

PATH [ (' ElementName ') ]

Создает упаковщик элементов <строки> для каждой строки в результирующем наборе. Для упаковщика элементов <строки> можно дополнительно задать имя элемента. При задании пустой строки, например FOR XML PATH ('')), упаковщик элементов не создается. Использование директивы PATH дает более простой способ написания запросов, чем написание запросов с помощью директивы EXPLICIT. Дополнительные сведения см. в разделе Использование режима PATH.

BINARY BASE64

Задает возврат двоичных данных запросом в двоичном зашифрованном формате base64. При извлечении двоичных данных с использованием режимов RAW и EXPLICIT необходимо указывать этот параметр. В режиме AUTO это указывается по умолчанию.

TYPE

Задает следующий формат выдаваемых запросом данных: тип xml. Дополнительные сведения см. в разделе Директива TYPE в запросах FOR XML.

ROOT [ (' RootName ') ]

Задает добавление единичного элемента высшего уровня к результирующему XML-документу. Дополнительно можно указать имя корневого элемента, который необходимо сформировать. Если имя корневого элемента не задано, то добавляется <корневой> элемент по умолчанию.