Ejemplos de importación y exportación en bloque de documentos XML (SQL Server)

  • Artículo

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores Azure SQL Database Azure SQL Managed Instance

Puedes importar documentos XML de forma masiva en una base de datos de SQL Server o exportarlos de igual forma desde una base de datos de SQL Server. En este artículo se proporcionan ejemplos de ambos enfoques.

Para importar datos de forma masiva de un archivo de datos a una tabla o vista sin particiones de SQL Server, tienes las siguientes opciones:

  • Utilidad bcp

    También puedes usar la utilidad bcp para exportar datos de cualquier ubicación a una base de datos de SQL Server en la que funcione una instrucción SELECT, incluidas las vistas con particiones.

  • BULK INSERT

  • INSERT ... SELECT * FROM OPENROWSET(BULK...)

Vea los siguientes artículos para más información:

Ejemplos

Importar de forma masiva datos XML como un flujo de bytes binario

Cuando importas datos de forma masiva de un archivo que contiene una declaración de codificación que deseas aplicar, especifica la opción SINGLE_BLOB en la cláusula OPENROWSET(BULK...). La opción SINGLE_BLOB garantiza que el analizador de XML de SQL Server importa los datos según el esquema de codificación especificado en la declaración XML.

Tabla de ejemplo

Para probar el ejemplo A, debes crear una tabla de ejemplo T.

USE tempdb;
GO

CREATE TABLE T (
    IntCol INT IDENTITY(1,1),
    XmlCol XML
    );
GO

Archivo de datos de ejemplo

Para poder ejecutar el ejemplo A, debe crear un archivo codificado con UTF-8 (C:\SampleFolder\SampleData3.txt) que contenga el ejemplo de instancia siguiente que especifica el esquema de codificación UTF-8 .

<?xml version="1.0" encoding="UTF-8"?>
<Root>
    <ProductDescription ProductModelID="5">
        <Summary>Some Text</Summary>
    </ProductDescription>
</Root>

Ejemplo A

Este ejemplo utiliza la opción SINGLE_BLOB en una instrucción INSERT ... SELECT * FROM OPENROWSET(BULK...) para importar datos de un archivo llamado SampleData3.txt e insertar una instancia XML en la tabla de ejemplo de una sola columna T.

INSERT INTO T (XmlCol)
SELECT *
FROM OPENROWSET(
    BULK 'C:\SampleFolder\SampleData3.txt',
    SINGLE_BLOB)
AS x;

También puedes especificar explícitamente los nombres de columna de la siguiente manera:

INSERT INTO T (
    XmlCol
)
SELECT
    x.BulkColumn
FROM OPENROWSET(
    BULK 'C:\SampleFolder\SampleData3.txt',
    SINGLE_BLOB)
AS x;

Comentarios

Si usas SINGLE_BLOB en este caso, puedes evitar una discrepancia entre la codificación del documento XML (especificada por la declaración de codificación XML) y la página de códigos de cadena establecida implícitamente por el servidor.

Si utiliza tipos de datos NCLOB o CLOB y se produce un conflicto de página de códigos o de codificación, deberá realizar una de las siguientes acciones:

  • Elimine la declaración XML para poder importar correctamente el contenido del archivo de datos XML.

  • Especifica una página de códigos en la opción CODEPAGE de la consulta que coincida con el esquema de codificación que se utiliza en la declaración XML.

  • Compare o resuelva los valores de intercalación de base de datos con un esquema de codificación XML distinto de Unicode.

[Arriba]

Importar en bloque datos XML en una fila existente

Este ejemplo utiliza el el proveedor de conjuntos de filas BULK OPENROWSET para agregar una instancia XML a una fila o filas existentes en la tabla de ejemplo T.

Nota:

Para ejecutar este ejemplo, es necesario que complete primero el script de prueba del ejemplo A. Ese ejemplo crea la tabla tempdb.dbo.T e importa los datos de forma masiva de SampleData3.txt.

Archivo de datos de ejemplo

El ejemplo B utiliza una versión modificada del archivo de datos de ejemplo SampleData3.txt del ejemplo anterior. Para ejecutar este ejemplo, modifique el contenido de este archivo de la siguiente manera:

<Root>
    <ProductDescription ProductModelID="10">
        <Summary>Some New Text</Summary>
    </ProductDescription>
</Root>

Ejemplo B

-- Query before update shows initial state of XmlCol values.
SELECT * FROM T;

UPDATE T
SET XmlCol = (
    SELECT *
    FROM OPENROWSET(
    BULK 'C:\SampleFolder\SampleData3.txt',
            SINGLE_BLOB
    ) AS x
)
WHERE IntCol = 1;
GO

[Arriba]

Importar en bloque datos XML de un archivo que contiene una DTD

Importante

Se recomienda no habilitar la compatibilidad con definiciones de tipo de documento (DTD) si no es necesaria en el entorno XML. Si se activa la compatibilidad con DTD, se aumenta el área expuesta susceptible de ataques del servidor, que puede quedar expuesta a un ataque por denegación de servicio. En caso de que sea necesario habilitar la compatibilidad con DTD, este riesgo de seguridad puede reducirse procesando únicamente los documentos XML de confianza.

Puedes obtener el siguiente error cuando se usa bcp para importar datos XML desde un archivo que contiene un DTD:

SQLState = 42000, NativeError = 6359

Error = [Microsoft][SQL Server Native Client][SQL Server]Parsing XML with internal subset DTDs not allowed.
Use CONVERT with style option 2 to enable limited internal subset DTD support.

BCP copy %s failed

Para solucionar este problema, puede importar datos XML de un archivo de datos que contenga una DTD mediante la función OPENROWSET(BULK...) y especificando posteriormente la opción CONVERT en la cláusula SELECT del comando. La sintaxis básica para el comando es la siguiente:

INSERT ... SELECT CONVERT(...) FROM OPENROWSET(BULK...)

Archivo de datos de ejemplo

Para probar este ejemplo de importación en bloque, cree un archivo (C:\SampleFolder\Dtdfile.xml) que contenga la siguiente instancia de ejemplo:

<!DOCTYPE DOC [<!ATTLIST elem1 attr1 CDATA "defVal1">]><elem1>January</elem1>

Tabla de ejemplo

El ejemplo C utiliza la tabla de ejemplo T1 que crea la instrucción CREATE TABLE siguiente:

USE tempdb;
GO
CREATE TABLE T1(XmlCol XML);
GO

Ejemplo C

Este ejemplo utiliza OPENROWSET(BULK...) y especifica la opción CONVERT en la cláusula SELECT para importar los datos XML desde Dtdfile.xml al ejemplo de tabla T1.

INSERT INTO T1
SELECT CONVERT(XML, BulkColumn, 2)
FROM OPENROWSET(
    BULK 'C:\SampleFolder\Dtdfile.xml',
    SINGLE_BLOB
) AS [rowsetresults];

Después de ejecutar la instrucción INSERT , se quitará la DTD del XML y se almacenará en la tabla T1 .

[Arriba]

Especifica el terminador de campo explícitamente mediante el uso de un archivo de formato

El ejemplo siguiente muestra cómo importar de forma masiva el siguiente documento XML, Xmltable.dat.

Archivo de datos de ejemplo

El documento en Xmltable.dat contiene dos valores XML, uno para cada fila. El primer valor XML está codificado con UTF-16 y el segundo con UTF-8.

El contenido de este archivo de datos se muestra en el volcado Hex siguiente:

FF FE 3C 00 3F 00 78 00-6D 00 6C 00 20 00 76 00  *..\<.?.x.m.l. .v.*
65 00 72 00 73 00 69 00-6F 00 6E 00 3D 00 22 00  *e.r.s.i.o.n.=.".*
31 00 2E 00 30 00 22 00-20 00 65 00 6E 00 63 00  *1...0.". .e.n.c.*
6F 00 64 00 69 00 6E 00-67 00 3D 00 22 00 75 00  *o.d.i.n.g.=.".u.*
74 00 66 00 2D 00 31 00-36 00 22 00 3F 00 3E 00  *t.f.-.1.6.".?.>.*
3C 00 72 00 6F 00 6F 00-74 00 3E 00 A2 4F 9C 76  *\<.r.o.o.t.>..O.v*
0C FA 77 E4 80 00 89 00-00 06 90 06 91 2E 9B 2E  *..w.............*
99 34 A2 34 86 00 83 02-92 20 7F 02 4E C5 E4 A3  *.4.4..... ..N...*
34 B2 B7 B3 B7 FE F8 FF-F8 00 3C 00 2F 00 72 00  *4.........\<./.r.*
6F 00 6F 00 74 00 3E 00-00 00 00 00 7A EF BB BF  *o.o.t.>.....z...*
3C 3F 78 6D 6C 20 76 65-72 73 69 6F 6E 3D 22 31  *\<?xml version="1*
2E 30 22 20 65 6E 63 6F-64 69 6E 67 3D 22 75 74  *.0" encoding="ut*
66 2D 38 22 3F 3E 3C 72-6F 6F 74 3E E4 BE A2 E7  *f-8"?><root>....*
9A 9C EF A8 8C EE 91 B7-C2 80 C2 89 D8 80 DA 90  *................*
E2 BA 91 E2 BA 9B E3 92-99 E3 92 A2 C2 86 CA 83  *................*
E2 82 92 C9 BF EC 95 8E-EA 8F A4 EB 88 B4 EB 8E  *................*
B7 EF BA B7 EF BF B8 C3-B8 3C 2F 72 6F 6F 74 3E  *.........</root>*
00 00 00 00 7A                                   *....z*

Tabla de ejemplo

Al realizar una importación o exportación masiva de un documento XML, hay que usar un terminador de campo que no pueda aparecer en ninguno de los documentos; por ejemplo, una serie de cuatro valores NULL (\0) seguidos de la letra z: \0\0\0\0z.

Este ejemplo muestra cómo utilizar el terminador de campo para la tabla de ejemplo xTable . Para crear esta vista de ejemplo, utilice la siguiente instrucción CREATE TABLE :

USE tempdb;
GO
CREATE TABLE xTable (xCol XML);
GO

Archivo de formato de ejemplo

El terminador de campo se debe especificar en el archivo de formato. El ejemplo D utiliza un archivo de formato no XML denominado Xmltable.fmt que contiene la siguiente salida:

9.0
1
1       SQLBINARY     0       0       "\0\0\0\0z"    1     xCol         ""

Puede utilizar este archivo de formato para realizar importaciones masivas de documentos XML a la tabla xTable mediante el comando bcp o una instrucción BULK INSERT o INSERT ... SELECT * FROM OPENROWSET(BULK...) .

Ejemplo D

Este ejemplo utiliza el archivo de formato Xmltable.fmt en una instrucción BULK INSERT para importar el contenido de un archivo de datos XML denominado Xmltable.dat.

BULK INSERT xTable
FROM 'C:\SampleFolder\Xmltable.dat'
WITH (FORMATFILE = 'C:\SampleFolder\Xmltable.fmt');
GO

[Arriba]

Exportar en bloque datos XML

En el ejemplo siguiente se utiliza bcp para realizar la exportación masiva de datos XML a partir de la tabla creada en el ejemplo anterior con el mismo archivo de formato XML. En el siguiente comando bcp , <server_name> y <instance_name> representan los marcadores de posición que deben ser reemplazados con los valores adecuados:

bcp bulktest..xTable out a-wn.out -N -T -S<server_name>\<instance_name>

Nota:

SQL Server no guarda la codificación XML cuando se mantienen datos XML en la base de datos. Por lo tanto, la codificación original de los campos XML no estará disponible cuando se exporten datos XML. SQL Server usa la codificación UTF-16 al exportar datos XML.

Consulte también