Compartilhar via


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