Modelo de objetos de carga masiva XML de SQL Server (SQLXML 4.0)

Se aplica a: SQL ServerAzure SQL Database

El modelo de objetos de carga masiva XML de Microsoft SQL Server consta del objeto SQLXMLBulkLoad. Este objeto admite los métodos y propiedades siguientes.

Métodos

Ejecutar
Realiza cargas masivas de los datos utilizando los archivos de esquema y de datos (o flujo) proporcionados como parámetros.

Propiedades

BulkLoad
Especifica si se debe realizar una carga masiva. Esta propiedad es útil si desea generar solo los esquemas (consulte las propiedades SchemaGen, SGDropTables y SGUseID que siguen) y no realice una carga masiva. Ésta es una propiedad Boolean. Cuando la propiedad está establecida en TRUE, se ejecuta la carga masiva XML. Cuando está establecida en FALSE, no se ejecuta la carga masiva XML.

El valor predeterminado es TRUE.

CheckConstraints
Especifica si se deben comprobar las restricciones (como las restricciones debido a la relación de clave principal/clave externa entre las columnas) especificadas en la columna cuando la carga masiva XML inserta los datos en las columnas. Ésta es una propiedad Boolean.

Cuando la propiedad está establecida en TRUE, la carga masiva XML comprueba las restricciones para cada valor insertado (lo que significa que una infracción de restricción produce un error).

Nota:

Para dejar esta propiedad como FALSE, debe tener permisos ALTER TABLE en las tablas de destino. Para obtener más información, consulte ALTER TABLE (Transact-SQL)

El valor predeterminado es FALSE. Cuando está establecida en FALSE, la carga masiva XML omite las restricciones durante una operación de inserción. En la implementación actual, debe definir las tablas en el orden de relaciones de clave principal y clave externa en el esquema de asignación. Es decir, se debe definir una tabla con una clave principal antes de la tabla correspondiente con la clave externa; de lo contrario, no se podrá realizar la carga masiva XML.

Tenga en cuenta que si se realiza la propagación de identificadores, esta opción no se aplica y quedará activa la comprobación de restricciones. Esto se produce cuando KeepIdentity=False y hay una relación definida donde el elemento primario es un campo de identidad y se proporciona el valor al elemento secundario cuando se genera.

ConnectionCommand
Identifica un objeto de conexión existente (por ejemplo, el objeto de comando ADO o ICommand) que debe usar la carga masiva XML. Puede usar la propiedad ConnectionCommand en lugar de especificar un cadena de conexión con la propiedad ConnectionString. La propiedad Transaction debe establecerse en TRUE si usa ConnectionCommand.

Si usa las propiedades ConnectionString y ConnectionCommand, la carga masiva XML usa la última propiedad especificada.

El valor predeterminado es NULL.

ConnectionString
Identifica la cadena de conexión OLE DB que proporciona la información necesaria para establecer una conexión a una instancia de la base de datos. Si usa las propiedades ConnectionString y ConnectionCommand, la carga masiva XML usa la última propiedad especificada.

El valor predeterminado es NULL.

ErrorLogFile
Especifica el nombre de archivo en el que la carga masiva XML registra errores y mensajes. El valor predeterminado es una cadena vacía, en cuyo caso el registro no tiene lugar.

FireTriggers
Especifica si los desencadenadores definidos en las tablas de destino se deben activar durante la operación de carga masiva. El valor predeterminado es FALSE.

Cuando se establece en TRUE, los desencadenadores se activan de forma normal durante las operaciones de inserción.

Nota:

Para dejar esta propiedad como FALSE, debe tener permisos ALTER TABLE en las tablas de destino. Para obtener más información, consulte ALTER TABLE (Transact-SQL)

Tenga en cuenta que si se realiza la propagación de identificadores, no se aplica esta opción y se quedarán activos los desencadenadores. Esto se produce cuando KeepIdentity=False y hay una relación definida donde el elemento primario es un campo de identidad y se proporciona el valor al elemento secundario cuando se genera.

ForceTableLock
Especifica si las tablas en las que la carga masiva XML copia los datos se deben bloquear el tiempo que dura la carga masiva. Ésta es una propiedad Boolean. Cuando la propiedad está establecida en TRUE, la carga masiva XML adquiere los bloqueos de la tabla el tiempo que dura la carga masiva. Cuando está establecida en FALSE, la carga masiva XML adquiere un bloqueo de la tabla cada vez que inserta un registro en una tabla.

El valor predeterminado es FALSE.

IgnoreDuplicateKeys
Especifica qué hacer si se intenta insertar valores duplicados en una columna de clave. Si esta propiedad se establece en TRUE y se intenta insertar un registro con un valor duplicado en una columna de clave, SQL Server no inserta ese registro. Pero inserta el registro subsiguiente; así, no se produce un error en la operación de carga masiva. Si esta propiedad está establecida en FALSE, se produce un error en la carga masiva cuando se intenta insertar un valor duplicado en una columna de clave.

Cuando la propiedad IgnoreDuplicateKeys se establece en TRUE, se emite una instrucción COMMIT para cada registro insertado en la tabla. Esto ralentiza el rendimiento. La propiedad solo se puede establecer en TRUE cuando la propiedad Transaction está establecida en FALSE, ya que el comportamiento transaccional se implementa mediante archivos.

El valor predeterminado es FALSE.

KeepIdentity
Especifica cómo solucionar los valores de una columna de tipo Identity del archivo de código fuente. Ésta es una propiedad Boolean. Cuando la propiedad está establecida en TRUE, la carga masiva XML asigna los valores especificados en el archivo de código fuente a la columna de identidad. Cuando la propiedad está establecida en FALSE, la operación de carga masiva omite los valores de columna de identidad especificados en el código fuente. En este caso, SQL Server asigna un valor a la columna de identidad.

Si la carga masiva implica una columna que es una clave externa que hace referencia a una columna de identidad en la que se almacenan los valores generados por SQL Server, la carga masiva propaga adecuadamente estos valores de identidad a la columna de clave externa.

El valor de esta propiedad se aplica a todas las columnas implicadas en la carga masiva. El valor predeterminado es TRUE.

Nota:

Para dejar esta propiedad como TRUE, debe tener permisos ALTER TABLE en las tablas de destino. De lo contrario, debe estar establecida en un valor de FALSE. Para obtener más información, consulte ALTER TABLE (Transact-SQL)

KeepNulls
Especifica qué valor se va a utilizar para una columna a la que le falta un atributo o elemento secundario correspondiente en el documento XML. Ésta es una propiedad Boolean. Cuando la propiedad está establecida en TRUE, la carga masiva XML asigna un valor nulo a la columna. No asigna el valor predeterminado de la columna, si existe, como está establecido en el servidor. El valor de esta propiedad se aplica a todas las columnas implicadas en la carga masiva.

El valor predeterminado es FALSE.

SchemaGen
Especifica si se van a crear las tablas necesarias antes de realizar una operación de carga masiva. Ésta es una propiedad Boolean. Si esta propiedad está establecida en TRUE, se crean las tablas identificadas en el esquema de asignación (debe existir la base de datos) . Si ya existe una o varias de las tablas en la base de datos, la propiedad SGDropTables determina si se van a quitar y volver a crear estas tablas preexistentes.

El valor predeterminado de la propiedad SchemaGen es FALSE. SchemaGen no crea restricciones PRIMARY KEY en las tablas recién creadas. SchemaGen, sin embargo, crea restricciones FOREIGN KEY en la base de datos si puede encontrar anotaciones sql:relationship y sql:key-fields coincidentes en el esquema de asignación y si el campo de clave consta de una sola columna.

Tenga en cuenta que si establece la propiedad SchemaGen en TRUE, la carga masiva XML hace lo siguiente:

• Crea las tablas necesarias a partir de los nombres de atributo y elemento. Por lo tanto, es importante que no use palabras reservadas de SQL Server para los nombres de elemento y atributo en el esquema.

• Devuelve datos de desbordamiento para cualquier columna designada mediante el campo sql:overflow-field en formato de tipo de datos xml.

SGDropTables
Especifica si se deben quitar las tablas existentes y volver a crearlas. Esta propiedad se usa cuando la propiedad SchemaGen está establecida en TRUE. Si SGDropTables es FALSE, se conservan las tablas existentes. Cuando esta propiedad es TRUE, se eliminan las tablas existentes y se vuelven a crear.

El valor predeterminado es FALSE.

SGUseID
Especifica si el atributo del esquema de asignación que se identifica como tipo de identificador se puede usar para crear una restricción PRIMARY KEY cuando se crea la tabla. Utilice esta propiedad cuando la propiedad SchemaGen esté establecida en TRUE. Si SGUseID es TRUE, la utilidad SchemaGen usa un atributo para el que dt:type="id" se especifica como columna de clave principal y agrega la restricción PRIMARY KEY adecuada al crear la tabla.

El valor predeterminado es FALSE.

TempFilePath
Especifica la ruta de acceso del archivo donde la carga masiva XML crea los archivos temporales para una carga masiva llevada a cabo. (Esta propiedad solo es útil cuando la propiedad Transaction está establecida en TRUE). Debe asegurarse de que la cuenta de SQL Server que se usa para la carga masiva XML tiene acceso a esta ruta de acceso. Si no se establece esta propiedad, la carga masiva XML almacena los archivos temporales en la ubicación especificada en la variable de entorno TEMP.

Transacción
Especifica si la carga masiva se debe hacer como una transacción, en cuyo caso se garantiza la reversión si se produce un error en la carga masiva. Ésta es una propiedad Boolean. Si la propiedad está establecida en TRUE, la carga masiva se produce en un contexto transaccional. La propiedad TempFilePath solo es útil cuando Transaction se establece en TRUE.

Nota:

Si va a cargar datos binarios (como bin.hex, tipos de datos XML bin.base64 en los tipos de datos binarios, image SQL Server), la propiedad Transaction debe establecerse en FALSE.

El valor predeterminado es FALSE.

XMLFragment
Especifica si los datos de origen son fragmentos XML. Un fragmento XML es un documento XML sin un elemento de nivel superior (raíz) único. Ésta es una propiedad Boolean. Esta propiedad debe estar establecida en TRUE si el archivo de código fuente está compuesto de un fragmento XML.

El valor predeterminado es FALSE.