Artículo
09/29/2010

Generar instancias XML

Tal como se describe en Tipo de datos xml, se pueden almacenar instancias XML en una base de datos de SQL Server. En este tema se describe cómo generar las instancias XML.

En SQL Server, podrá generar instancias XML de las formas siguientes:

Instancias de cadenas de conversión de tipo.
Usar la instrucción SELECT con la cláusula FOR XML.
Usar asignaciones de constantes.
Usar la carga masiva.

Instancias de cadenas de conversión de tipo e instancias binarias

Se puede analizar cualquier tipo de datos de cadena de SQL Server, como [n][var]char, [n]text, varbinary e image, en el tipo de datos xml convirtiendo (mediante CAST o CONVERT) la cadena al tipo de datos xml. Se comprueba el XML sin tipo para confirmar que su formato es correcto. Si hay un esquema asociado al tipo xml, también se realiza una validación. Para obtener más información, vea Comparación de XML con tipo y XML sin tipo.

Los documentos XML pueden codificarse con distintas codificaciones (por ejemplo, UTF-8, UTF-16, windows-1252). A continuación se describen de forma resumida las reglas que establecen el modo en que los tipos de origen de cadena y binarios interactúan con la codificación del documento XML y cómo se comporta el analizador.

Puesto que nvarchar asume una codificación Unicode de dos bytes como UTF-16 o UCS-2, el analizador de XML tratará el valor de cadena como un documento o fragmento XML codificado con Unicode de dos bytes. Esto significa que el documento XML también debe codificarse con codificación Unicode de dos bytes para que sea compatible con el tipo de datos de origen. Un documento XML con codificación UTF-16 puede tener una marca de orden de bytes (BOM) UTF-16, pero no es necesario que la tenga ya que el contexto del tipo de origen indica claramente que sólo puede tratarse de un documento con codificación Unicode de dos bytes.

El analizador de XML trata el contenido de una cadena varchar como un documento o fragmento XML con codificación de un byte. Puesto que la cadena de origen varchar tiene una página de códigos asociada, el analizador utilizará dicha página de códigos para la codificación si no se especifica ninguna codificación explícita en el XML. Si una instancia de XML tiene una marca BOM o una declaración de codificación, éstas deben ser coherentes con la página de códigos, de lo contrario el analizador notificará un error.

El contenido de varbinary se trata como una secuencia de puntos de código que se pasa directamente al analizador de XML. Por consiguiente, el documento o fragmento XML debe proporcionar la marca BOM u otro tipo de información de codificación insertada. Para determinar la codificación, el analizador sólo consultará la secuencia. Esto significa que el XML con codificación UTF-16 debe proporcionar la marca BOM UTF-16 y que una instancia sin marca BOM y sin una codificación de declaración se interpretará como UTF-8.

Si la codificación del documento XML no se conoce de antemano y los datos se pasan como datos de cadena o datos binarios en lugar de pasarse como datos XML antes de realizar su conversión a XML, es recomendable tratar los datos como varbinary. Por ejemplo, si se leen datos de un archivo XML utilizando OpenRowset(), es necesario especificar los datos que deben leerse como un valor varbinary(max):

select CAST(x as XML) 
from OpenRowset(BULK 'filename.xml', SINGLE_BLOB) R(x)

SQL Server representa internamente XML en una representación binaria eficaz que utiliza la codificación UTF-16. La codificación proporcionada por el usuario no se mantiene, pero se tiene en cuenta durante el proceso de análisis.

Conversión de tipos definidos por el usuario CLR

Si un tipo definido por el usuario CLR tiene una serialización XML, las instancias de dicho tipo pueden convertirse explícitamente a un tipo de datos XML. Para obtener más información acerca de la serialización XML de un tipo de datos definido por el usuario CLR, vea Serialización XML de objetos de base de datos de CLR.

Control de los espacios en blanco en XML con tipo

En SQL Server, los espacios en blanco en el contenido de los elementos se consideran no significativos si aparecen en una secuencia de datos de caracteres únicamente de espacios en blanco delimitados por caracteres de marcado, como etiquetas iniciales o finales, y no se crea una entidad para los mismos. Las secciones CDATA se omiten. Este control de los espacios en blanco es distinto de lo que se describe en la especificación XML 1.0 publicada por el World Wide Web Consortium (W3C). Esto se debe a que el analizador de XML de SQL Server sólo reconoce un número limitado de subconjuntos de DTD, tal como se define en XML 1.0. Para obtener más información acerca de los subconjuntos de DTD limitados que admite SQL Server, vea CAST y CONVERT (Transact-SQL).

De forma predeterminada, el analizador de XML descarta los espacios en blanco insignificantes cuando convierte datos de cadena a XML si se da alguna de las condiciones siguientes:

No se define el atributo The xml:space en un elemento o en sus elementos antecesores.
El atributo xml:space activo en un elemento, o uno de sus elementos antecesores, tiene el valor predeterminado.

Por ejemplo:

declare @x xml
set @x = '<root>      <child/>     </root>'
select @x

El resultado es el siguiente:

<root><child/></root>

No obstante, puede cambiar este comportamiento. Para mantener los espacios en blanco de una instancia DT xml, utilice el operador CONVERT y su parámetro style opcional establecido en el valor 1. Por ejemplo:

SELECT CONVERT(xml, N'<root>      <child/>     </root>', 1)

Si no se utiliza el parámetro style o su valor es 0, no se mantendrán los espacios en blanco insignificantes para la conversión de la instancia DT xml. Para obtener más información acerca de cómo utilizar el operador CONVERT y su parámetro style al convertir datos de cadena a instancias DT xml, vea CAST y CONVERT (Transact-SQL).

Ejemplo: convertir un valor de cadena a xml con tipo y asignarlo a una columna

En el ejemplo siguiente se convierte una variable de cadena que contiene un fragmento de XML al tipo de datos xml y, a continuación, se almacena en la columna de tipo xml:

CREATE TABLE T(c1 int primary key, c2 xml)
go
DECLARE  @s varchar(100)
SET @s = '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>'

La siguiente operación de inserción se convierte implícitamente de una cadena al tipo xml:

INSERT INTO T VALUES (3, @s)

Se puede convertir la cadena explícitamente mediante cast() al tipo xml:

INSERT INTO T VALUES (3, cast (@s as xml))

También se puede utilizar convert(), tal como se muestra a continuación:

INSERT INTO T VALUES (3, convert (xml, @s))

Ejemplo: convertir una cadena a xml con tipo y asignarla a una variable

En el ejemplo siguiente, se convierte una cadena a tipo xml y se asigna a una variable de tipo de datos xml:

declare @x xml
declare  @s varchar(100)
SET @s = '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>' 
set @x =convert (xml, @s)
select @x

Usar la instrucción SELECT con la cláusula FOR XML

Se puede utilizar la cláusula FOR XML en una instrucción SELECT para devolver resultados como XML. Por ejemplo:

DECLARE @xmlDoc xml
SET @xmlDoc = (SELECT Column1, Column2
               FROM   Table1, Table2
               WHERE   Some condition
               FOR XML AUTO)
 ...

La instrucción SELECT devuelve un fragmento de XML de texto que a continuación se analiza durante la asignación a la variable de tipo de datos xml.

También se puede utilizar la directiva TYPE en la cláusula FOR XML, lo que devuelve directamente un resultado de consulta FOR XML como tipo xml:

Declare @xmlDoc xml
SET @xmlDoc = (SELECT ProductModelID, Name
               FROM   Production.ProductModel
               WHERE  ProductModelID=19
               FOR XML AUTO, TYPE)
SELECT @xmlDoc

El resultado es el siguiente:

<Production.ProductModel ProductModelID="19" Name="Mountain-100" />...

En el ejemplo siguiente, el resultado xml con tipo de una consulta FOR XML se inserta en una columna de tipo xml:

CREATE TABLE T1 (c1 int, c2 xml)
go
INSERT T1(c1, c2)
SELECT 1, (SELECT ProductModelID, Name
           FROM Production.ProductModel
           WHERE ProductModelID=19
           FOR XML AUTO, TYPE)
SELECT * FROM T1
go

Para obtener más información acerca de FOR XML, vea Generar XML mediante FOR XML.

[!NOTA]

SQL Server devuelve instancias de tipo de datos xml al cliente como resultado de las distintas construcciones del servidor, como consultas FOR XML que utilizan la directiva TYPE, o donde se utiliza el tipo de datos xml para devolver XML a partir de parámetros de salida, variables y columnas SQL. En el código de la aplicación cliente, el proveedor ADO.NET solicita que la información de tipos de datos xml se envíe en una codificación binaria desde el servidor. No obstante, si se está utilizando FOR XML sin la directiva TYPE, los datos XML se devuelven como un tipo de cadena. En cualquier caso, el proveedor del cliente siempre podrá controlar cualquier formato de tipo XML.

Usar asignaciones de constantes

Se puede utilizar una constante de cadena cuando se espera una instancia de tipo de datos xml. Es lo mismo que una conversión (CAST) implícita de cadena a XML. Por ejemplo:

DECLARE @xmlDoc xml
SET @xmlDoc = '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>' 
-- Or
SET @xmlDoc = N'<?xml version="1.0" encoding="ucs-2"?><doc/>'

En el ejemplo anterior se convierte implícitamente la cadena al tipo de datos xml y se asigna a una variable de tipo xml.

En el ejemplo siguiente se inserta una cadena de constante en una columna de tipo xml:

CREATE TABLE T(c1 int primary key, c2 xml)
INSERT INTO T VALUES (3, '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>')

[!NOTA]

El XML con tipo se valida con el esquema especificado. Para obtener más información, vea Comparación de XML con tipo y XML sin tipo.

Usar la carga masiva

La funcionalidad mejorada OPENROWSET (Transact-SQL) permite la carga masiva de documentos XML en la base de datos. Se pueden cargar de forma masiva instancias XML desde archivos a columnas de tipo xml de la base de datos. Para ver algunos ejemplos funcionales, vea Ejemplos de importación y exportación de forma masiva documentos XML. Para obtener más información acerca de la carga de documentos XML, vea Cargar datos XML.