Anotações XDR (Preteridas no SQLXML 4.0)
Importante |
---|
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. |
|
sql:field |
Mapeia um item XML e a coluna de banco de dados. |
|
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. |
|
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çã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 |