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

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:relationship 和 sql:key-fields 批注并且键字段由单个列构成，则它会在数据库中创建 FOREIGN KEY 约束。

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

• 根据元素和属性名称创建必需的表。因此，不采用 SQL Server 保留字作为架构中的元素和属性名称十分重要。

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

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

默认值为 FALSE。

SGUseID
指定映射架构中作为 id 类型标识的属性是否可用于在创建表时创建 PRIMARY KEY 约束。在 SchemaGen 属性设置为 TRUE 时使用此属性。如果 SGUseID 为 TRUE，则 SchemaGen 实用工具将使用其 dt:type="id" 指定为主键列的属性，并且在创建表时添加相应的 PRIMARY KEY 约束。

默认值为 FALSE。

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

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

注意
如果您在加载二进制数据（例如 bin.hex、bin.base64 XML 数据类型到二进制、图像 SQL Server 数据类型），则 Transaction 属性必须设置为 FALSE。

默认值为 FALSE。

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

默认值为 FALSE。