Anotações XDR (Preteridas no SQLXML 4.0)

Observação importanteImportante

Este tópico está incluso como referência para aplicativos herdados. Não será feito nenhum trabalho de desenvolvimento futuro nesse recurso. Evite usá-lo em novos trabalhos de desenvolvimento. Em vez disso, use esquemas XSD anotados para criar exibições XML. Para obter mais informações, consulte Introdução a esquemas XSD anotados (SQLXML 4.0). Você pode converter esquemas XDR anotados existentes em esquemas XSD. Para obter mais informações, consulte Convertendo esquemas XDR anotados a esquemas XSD equivalentes (SQLXML 4.0).

O SQL Server continua fornecendo várias anotações para a linguagem de esquema XDR que foram introduzidas primeiro no SQL Server 2000. Essas anotações podem ser usadas no esquema XDR para especificar o mapeamento de XML para relacional. Isso inclui o mapeamento entre elementos e atributos no esquema XDR para tabelas/exibições e colunas nos bancos de dados. Por padrão, um nome de elemento em um esquema anotado mapeia para um nome de tabela (exibição) no banco de dados especificado, ao passo que o nome de atributo mapeia para o nome de coluna. Essas anotações também podem ser usadas para especificar as relações hierárquicas em XML (representando, assim, as relações no banco de dados).

A tabela a seguir mostra a lista de anotações.

Anotação

Descrição

Link do tópico

sql:relation

Mapeia um item XML para a tabela de banco de dados.

Usando sql:relation (Esquema XDR)

sql:field

Mapeia um item XML e a coluna de banco de dados.

Usando sql:field (Esquema XDR)

sql:is-constant

Cria um elemento XML que não é mapeado para nenhuma tabela. O elemento aparece na saída da consulta.

Criando elementos constantes usando sql:is-constant (Esquema XDR)

sql:map-field

Permite que itens de esquema sejam excluídos do resultado.

Excluindo elementos de esquema do documento XML resultante usando sql:map-field (esquema XDR)

<sql:relationship>

Especifica relações entre elementos XML. Os atributos key, key-relation, foreign-key e foreign-relation são usados para estabelecer a relação.

Especificando relações usando sql:relationship (Esquema XDR)

sql:limit-fieldsql:limit-value

Permite limitar os valores retornados com base em um valor limitador.

Filtrando valores usando sql:limit-field e sql:limit-value (esquema XDR)

sql:key-fields

Permite a especificação de coluna(s) que identifica(m) exclusivamente as linhas em uma tabela.

Identificando colunas de chave usando sql:key-fields (esquema XDR)

sql:target-namespace

Permite colocar os elementos e atributos do namespace padrão em um namespace diferente para resultados de consulta.

Especificando um namespace de destino usando sql:target-namespace (Esquema XDR)

sql:id-prefix

Cria ID, IDREF e IDREFS de XML válidos. Precede os valores de ID, IDREF e IDREFS com uma cadeia de caracteres.

Criando atributos do tipo Valid ID, IDREF e IDREFS usando sql:id-prefix (Esquema XDR)

sql:use-cdata

Permite especificar seções CDATA a serem usadas para determinados elementos no documento XML.

Criando seções CDATA usando sql:use-cdata (Esquema XDR)

sql:url-encode

Quando um elemento/atributo XML é mapeado para uma coluna BLOB de SQL Server, permite solicitar que uma referência (URI) seja retornada para ser usada posteriormente para dados BLOB.

Solicitando referências de URL a dados BLOB usando sql:url-encode (Esquema XDR)

sql:overflow-field

Identifica a coluna de banco de dados que contém os dados de estouro.

Recuperando dados não consumidos usando sql:overflow-field (Esquema XDR)

ObservaçãoObservação

Todos os exemplos apresentados nos tópicos desta seção especificam consultas XPath simples no esquema XDR anotado descrito em cada exemplo. Pressupõe-se familiaridade anterior com a linguagem Xpath. Para obter mais informações, consulte Usando consultas XPath no SQLXML 4.0