Instrucciones y limitaciones de la carga masiva XML (SQLXML 4.0)
Antes de usar la carga masiva XML, debe familiarizarse con las siguientes limitaciones e instrucciones:
No se admiten los esquemas insertados.
Si tiene un esquema insertado en el documento XML de origen, la carga masiva XML omite dicho esquema. Debe especificar el esquema de asignación para la carga masiva XML de forma externa con respecto a los datos XML. No es posible especificar el esquema de asignación en un nodo mediante el atributo xmlns="x:schema".
Se comprueba que el formato de un documento XML sea correcto, pero no se valida el documento.
La carga masiva XML comprueba el documento XML para determinar si el formato es correcto, es decir, para asegurarse de que el XML cumple los requisitos de sintaxis de la recomendación XML 1.0 de World Wide Web Consortium. Si el documento no tiene el formato correcto, la carga masiva XML cancela el procesamiento y devuelve un error. La única excepción a esta regla es que el documento sea un fragmento (por ejemplo, el documento no tiene ningún elemento raíz único), en cuyo caso la carga masiva XML cargará el documento.
La carga masiva XML no valida el documento con respecto a cualquier esquema de datos XML o esquema DTD que se defina o al que se haga referencia dentro del archivo de datos XML. Además, la carga masiva XML no valida el archivo de datos XML en el esquema de asignación proporcionado.
Se omite cualquier información de prólogo XML.
La carga masiva XML omite toda la información situada antes y después del elemento <root> en el documento XML. Por ejemplo, la carga masiva XML omite todas las declaraciones XML, definiciones DTD internas, referencias DTD externas, todos los comentarios, etc.
Si tiene un esquema de asignación que define una relación de clave principal y clave externa entre dos tablas (como Customer y CustOrder), la tabla con la clave principal debe describirse en primer lugar en el esquema. La tabla con la columna de clave externa debe aparecer posteriormente en el esquema. El motivo de todo ello es que el orden en que las tablas se identifican en el esquema es el orden que se usa para cargarlas en la base de datos.Por ejemplo, el esquema XDR siguiente generará un error al usarlo en la carga masiva XML porque el elemento <Order> se describe antes que el elemento <Customer>. La columna CustomerID de CustOrder es una columna de clave externa que hace referencia a la columna de clave principal CustomerID de la tabla Cust.
<?xml version="1.0" ?> <Schema xmlns="urn:schemas-microsoft-com:xml-data" xmlns:dt="urn:schemas-microsoft-com:xml:datatypes" xmlns:sql="urn:schemas-microsoft-com:xml-sql" > <ElementType name="Order" sql:relation="CustOrder" > <AttributeType name="OrderID" /> <AttributeType name="CustomerID" /> <attribute type="OrderID" /> <attribute type="CustomerID" /> </ElementType> <ElementType name="CustomerID" dt:type="int" /> <ElementType name="CompanyName" dt:type="string" /> <ElementType name="City" dt:type="string" /> <ElementType name="root" sql:is-constant="1"> <element type="Customers" /> </ElementType> <ElementType name="Customers" sql:relation="Cust" sql:overflow-field="OverflowColumn" > <element type="CustomerID" sql:field="CustomerID" /> <element type="CompanyName" sql:field="CompanyName" /> <element type="City" sql:field="City" /> <element type="Order" > <sql:relationship key-relation="Cust" key="CustomerID" foreign-key="CustomerID" foreign-relation="CustOrder" /> </element> </ElementType> </Schema>Si el esquema no especifica las columnas de desbordamiento mediante la anotación sql:overflow-field, la carga masiva XML omite todos los datos presentes en el documento XML que no se describen en el esquema de asignación.
La carga masiva XML aplica el esquema de asignación especificado cada vez que encuentra etiquetas conocidas en el flujo de datos XML. Omite los datos presentes en el documento XML que no se describen en el esquema. Por ejemplo, supongamos que tiene un esquema de asignación que describe un elemento <Customer>. El archivo de datos XML tiene una etiqueta raíz <AllCustomers> (que no se describe en el esquema) que abarca todos los elementos <Customer>:
<AllCustomers> <Customer>...</Customer> <Customer>...</Customer> ... </AllCustomers>En este caso, la carga masiva XML omite el elemento <AllCustomers> y comienza la asignación en el elemento <Customer>. La carga masiva XML omite los elementos que no se describen en el esquema pero que están presentes en el documento XML.
Fíjese en otro archivo de datos de origen XML que contenga elementos <Order>. Estos elementos no se describen en el esquema de asignación:
<AllCustomers> <Customer>...</Customer> <Order> ... </Order> <Order> ... </Order> ... <Customer>...</Customer> <Order> ... </Order> <Order> ... </Order> ... ... </AllCustomers>La carga masiva XML omite estos elementos <Order>. Sin embargo, si usa la anotación sql:overflow-fielden el esquema para identificar una columna como una columna de desbordamiento, la carga masiva XML almacena todos los datos sin consumir en esta columna.
Las secciones CDATA y las referencias a entidades se traducen a sus cadenas equivalentes antes de almacenarse en la base de datos.
En este ejemplo, una sección CDATA ajusta el valor del elemento <City>. La carga masiva XML extrae el valor de cadena ("NY") antes de insertar el elemento <City> en la base de datos.
<City><![CDATA[NY]]> </City>La carga masiva XML no conserva las referencias a entidades.
Si el esquema de asignación especifica el valor predeterminado de un atributo y los datos de origen XML no contienen dicho atributo, la carga masiva XML usa el valor predeterminado.
El siguiente esquema XDR de ejemplo asigna un valor predeterminado al atributo HireDate:
<?xml version="1.0" ?> <Schema xmlns="urn:schemas-microsoft-com:xml-data" xmlns:dt="urn:schemas-microsoft-com:xml:datatypes" xmlns:sql="urn:schemas-microsoft-com:xml-sql" > <ElementType name="root" sql:is-constant="1"> <element type="Customers" /> </ElementType> <ElementType name="Customers" sql:relation="Cust3" > <AttributeType name="CustomerID" dt:type="int" /> <AttributeType name="HireDate" default="2004-01-01" /> <AttributeType name="Salary" /> <attribute type="CustomerID" sql:field="CustomerID" /> <attribute type="HireDate" sql:field="HireDate" /> <attribute type="Salary" sql:field="Salary" /> </ElementType> </Schema>En estos datos XML, falta el atributo HireDate en el segundo elemento <Customers>. Cuando la carga masiva XML inserta el segundo elemento <Customers> en la base de datos, usa el valor predeterminado especificado en el esquema.
<ROOT> <Customers CustomerID="1" HireDate="2003-01-01" Salary="10000" /> <Customers CustomerID="2" Salary="10000" /> </ROOT>No se admite la anotación sql:url-encode:
No puede especificar una dirección URL en la entrada de datos XML y esperar que la carga masiva lea los datos de dicha ubicación.
Se crean las tablas que se identifican en el esquema de asignación (la base de datos debe existir). Si una o varias de las tablas ya existen en la base de datos, la propiedad SGDropTables determina si estas tablas preexistentes deben quitarse y volver a crearse.
Si especifica la propiedad SchemaGen (por ejemplo, SchemaGen = true), se crean las tablas que se identifican en el esquema de asignación. Sin embargo, SchemaGen no crea ninguna restricción en estas tablas (como las restricciones PRIMARY KEY/FOREIGN KEY), con una excepción: si los nodos XML que constituyen la clave principal de una relación se definen de manera que tengan un tipo de identificador XML (es decir, type="xsd:ID" para XSD) Y SI la propiedad SGUseID se establece en True para SchemaGen, entonces no solo se crearán claves principales a partir de los nodos con tipo de identificador, sino que también se crearán relaciones de clave principal y clave externa a partir de las relaciones del esquema de asignación.
SchemaGen no usa extensiones ni facetas del esquema XSD para generar el esquema SQL Server relacional.
Si especifica la propiedad SchemaGen (por ejemplo, SchemaGen = true) en la carga masiva, solo se actualizan las tablas especificadas (no las vistas de nombre compartido).
SchemaGen solamente proporciona funcionalidad básica para generar el esquema relacional a partir del XSD anotado. El usuario debe modificar las tablas generadas manualmente si es preciso.
Donde haya más de una relación entre las tablas, SchemaGen intentará crear una relación única que incluya todas las claves implicadas entre las dos tablas. Esta limitación podría dar lugar a un error Transact-SQL.
Al realizar cargas masivas de datos XML en una base de datos, debe haber al menos un atributo o elemento secundario en el esquema de asignación que esté asignado a una columna de base de datos.
Si está insertando valores de fecha mediante la carga masiva XML, estos valores deben especificarse con el formato (-)CCYY-MM-DD((+-)TZ). Se trata del formato XSD estándar para la fecha.
Algunas marcas de propiedad no son compatibles con otras. Por ejemplo, la carga masiva no admite Ignoreduplicatekeys=true junto con Keepidentity=false. Cuando Keepidentity=false, la carga masiva espera que el servidor genere los valores clave. Las tablas deberían tener una limitación de IDENTITY en la clave. El servidor no generará claves duplicadas, lo que significa que no es necesario que Ignoreduplicatekeys se configure en true. Ignoreduplicatekeys debe configurarse en true solamente cuando se cargan valores de clave principales de los datos entrantes en una tabla que tiene filas y existe la posibilidad de un conflicto de los valores de clave principales.