SQL Server XML 大容量加载对象模型 (SQLXML 4.0)

适用于:SQL Server Azure SQL 数据库

Microsoft SQL Server XML 大容量加载对象模型由 SQLXMLBulkLoad 对象组成。 该对象支持以下方法和属性。

方法

执行
通过使用作为参数提供的架构文件和数据文件(或流),大容量加载数据。

属性

BulkLoad
指定是否应执行大容量加载。 如果只想生成架构(请参阅 SchemaGen、SGDropTables 和 SGUseID 属性),并且不执行大容量加载,则此属性非常有用。 此属性是一个布尔属性。 当此属性设置为 TRUE 时,XML 大容量加载将执行。 当此属性设置为 FALSE 时,XML 大容量加载将不执行。

默认值为 TRUE。

CheckConstraints
指定在 XML 大容量加载将数据插入列时是否应检查对该列指定的约束(例如,由于列之间的主键/外键关系而产生的约束)。 此属性是一个布尔属性。

在此属性设置为 TRUE 时,XML 大容量加载检查每个插入的值的约束(这意味着约束冲突将导致错误)。

注意

若要将此属性保留为 FALSE,必须对目标表具有 ALTER TABLE 权限。 有关详细信息,请参阅 ALTER TABLE (Transact-SQL)

默认值是 FALSE。 在该值设置为 FALSE 时,XML 大容量加载在插入操作期间将忽略这些约束。 在当前实现中,您必须按照映射架构中的主键和外键关系的顺序定义表。 也就是说,具有主键的表必须在具有外键的相应表之前定义;否则,XML 大容量加载将失败。

请注意,如果 ID 传播正在进行,则此选项不适用并且约束检查将保持。 这将在 KeepIdentity=False 并且存在定义的关系(即,父级是标识字段并且在生成子级时值将提供给子级)发生。

ConnectionCommand
标识 XML 大容量加载应使用的现有连接对象(例如 ADO 或 ICommand 命令对象)。 可以使用 ConnectionCommand 属性,而不是使用 ConnectionString 属性指定连接字符串。 如果使用 ConnectionCommand,则必须将 Transaction 属性设置为 TRUE。

如果使用 ConnectionString 和 ConnectionCommand 属性,XML 大容量加载将使用最后一个指定的属性。

默认值为 NULL。

ConnectionString
标识 OLE DB 连接字符串,该字符串提供建立与数据库实例的连接所必需的信息。 如果使用 ConnectionString 和 ConnectionCommand 属性,XML 大容量加载将使用最后一个指定的属性。

默认值为 NULL。

ErrorLogFile
指定 XML 大容量加载将错误和消息记录到的文件名。 默认值为空字符串,在此情况下将不发生日志记录。

FireTriggers
指定在大容量加载操作期间是否应引发对目标表定义的触发器。 默认值为 FALSE。

在设置为 TRUE 时,在插入操作期间触发器将照常触发。

注意

若要将此属性保留为 FALSE,必须对目标表具有 ALTER TABLE 权限。 有关详细信息,请参阅 ALTER TABLE (Transact-SQL)

请注意,如果 ID 传播正在进行,则此选项不适用并且触发器将保持。 这将在 KeepIdentity=False 并且存在定义的关系(即,父级是标识字段并且在生成子级时值将提供给子级)发生。

ForceTableLock
指定在大容量加载期间,XML 大容量加载将数据复制到的表是否应被锁定。 此属性是一个布尔属性。 在此属性设置为 TRUE 时,XML 大容量加载要求在大容量加载期间执行表锁定。 在此属性设置为 FALSE 时,XML 大容量加载在每次将记录插入到表中时要求表锁定。

默认值是 FALSE。

IgnoreDuplicateKeys
指定尝试在某一键列中插入重复值时应采取什么后续操作。 如果此属性设置为 TRUE,并且尝试在键列中插入具有重复值的记录,则 SQL Server 不会插入该记录。 但它将插入随后的记录;这样,大容量加载操作将不会失败。 如果此属性设置为 FALSE,则尝试在某一键列中插入重复值时大容量加载将失败。

当 IgnoreDuplicateKeys 属性设置为 TRUE 时,将为表中插入的每个记录发出 COMMIT 语句。 这将降低性能。 仅当 Transaction 属性设置为 FALSE 时,该属性才可设置为 TRUE,因为事务行为是使用文件实现的。

默认值是 FALSE。

KeepIdentity
指定如何处理源文件中标识类型列的值。 此属性是一个布尔属性。 在此属性设置为 TRUE 时,XML 大容量加载将在源文件中指定的值分配给标识列。 在该属性设置为 FALSE 时,大容量加载操作将忽略在源文件中指定的标识列值。 在这种情况下,SQL Server 向标识列分配一个值。

如果大容量加载涉及引用存储 SQL Server 生成的值的标识列的外键列,则大容量加载会适当地将这些标识值传播到外键列。

此属性的值适用于在大容量加载中涉及的所有列。 默认值为 TRUE。

注意

若要将此属性保留为 TRUE,必须对目标表具有 ALTER TABLE 权限。 否则,它必须设置为 FALSE 的值。 有关详细信息,请参阅 ALTER TABLE (Transact-SQL)

KeepNulls
指定哪些值将用于在 XML 文档中缺少相应属性或子元素的列。 此属性是一个布尔属性。 当此属性设置为 TRUE 时,XML 大容量加载将 Null 值分配给该列。 它并不分配在服务器上设置的该列的默认值(如果有)。 此属性的值适用于在大容量加载中涉及的所有列。

默认值是 FALSE。

SchemaGen
指定是否在执行大容量加载操作前创建必需的表。 此属性是一个布尔属性。 如果该属性设置为 TRUE,则创建在映射架构中标识的表(数据库必须存在)。 如果数据库中已存在一个或多个表,SGDropTables 属性将确定是否删除并重新创建这些预先存在的表。

SchemaGen 属性的默认值为 FALSE。 SchemaGen 不会对新创建的表创建 PRIMARY KEY 约束。 但是,如果 SchemaGen 可以在映射架构中找到匹配 的 sql:relationshipsql:key-fields 批注,并且键字段包含单个列,则会在数据库中创建 FOREIGN KEY 约束。

请注意,如果将 SchemaGen 属性设置为 TRUE,XML 大容量加载将执行以下操作:

  • 根据元素和属性名称创建必需的表。 因此,请务必不要对架构中的元素和属性名称使用 SQL Server 保留字。

  • 返回使用 xml 数据类型格式的 sql:overflow-field 指定的任何列的溢出数据。

SGDropTables
指定是否应删除并重新创建现有表。 当 SchemaGen 属性设置为 TRUE 时,请使用此属性。 如果 SGDropTables 为 FALSE,则保留现有表。 在此属性为 TRUE 时,将删除并重新创建现有表。

默认值是 FALSE。

SGUseID
指定在创建表时是否可以在创建 PRIMARY KEY 约束时使用标识为 ID 类型的映射架构中的属性。 当 SchemaGen 属性设置为 TRUE 时,请使用此属性。 如果 SGUseID 为 TRUE,SchemaGen 实用工具将使用 dt:type=“id” 指定为主键列的属性,并在创建表时添加相应的 PRIMARY KEY 约束。

默认值是 FALSE。

TempFilePath
指定文件路径,该路径中包含 XML 大容量加载为事务性大容量加载创建的临时文件。 (仅当 Transaction 属性设置为 TRUE 时,此属性才有用。必须确保用于 XML 大容量加载的 SQL Server 帐户有权访问此路径。 如果未设置此属性,XML 大容量加载将 TEMP 环境变量上指定的位置中存储临时文件。

事务
指定大容量加载是否应作为事务实现,在此情况下,如果大容量加载失败,则确保回滚。 此属性是一个布尔属性。 如果此属性设置为 TRUE,则大容量加载将在事务上下文中发生。 TempFilePath 属性仅在事务设置为 TRUE 时才有用。

注意

如果要将二进制数据(如 bin.hex、bin.base64 XML 数据类型)加载到二进制图像 SQL Server 数据类型,则 Transaction 属性必须设置为 FALSE。

默认值是 FALSE。

XMLFragment
指定源数据是否是 XML 片断。 XML 片段是没有单个顶级(根)元素的 XML 文档。 此属性是一个布尔属性。 如果源文件由 XML 片断构成,则此属性必须设置为 TRUE。

默认值是 FALSE。