SQL Server XML 大量載入物件模型 (SQLXML 4.0)

適用於：SQL ServerAzure SQL Database

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 大量載入會失敗。

請注意，如果識別碼擴展即將完成，則此選項不會套用，而且條件約束檢查將會保持開啟。 如果 KeepIdentity=False，而且有定義一個關聯性，其中父系是識別欄位，並在產生值時將其提供給子系，則會發生這個狀況。

ConnectionCommand
識別現有的連線物件 (例如，ADO 或 ICommand 命令物件) XML 大量載入應該使用。 您可以使用 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)。

請注意，如果識別碼擴展即將完成，則此選項不會套用，而且觸發條件將會保持開啟。 如果 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
指定在建立資料表時，是否可以在建立 PRIMARY KEY 條件約束時，使用識別為 識別碼 類型的對應架構中的屬性。 當 SchemaGen 屬性設定為 TRUE 時，請使用這個屬性。 如果 SGUseID 為 TRUE，SchemaGen 公用程式會使用 將 dt：type=「id」 指定為主鍵資料行的屬性，並在建立資料表時加入適當的 PRIMARY KEY 條件約束。

預設值為 FALSE。

TempFilePath
針對交易的大量載入，指定 XML 大量載入建立暫存檔案所在的檔案路徑 (只有當 Transaction 屬性設定為 TRUE.) 您必須確定用於 XML 大量載入的SQL Server帳戶可以存取此路徑時，此屬性才有用。 如果未設定此屬性，XML 大量載入會將暫存檔案儲存在 TEMP 環境變數中所指定的位置。

交易
指定大量載入是否應該當做交易完成，在此情況下，保證會在大量載入失敗時回復。 這是布林屬性。 如果屬性設定為 TRUE，大量載入會在交易內容中發生。 TempFilePath 屬性只有在 Transaction 設定為 TRUE 時才有用。

注意

如果您要將二進位資料載入二進位資料 (，例如 bin.hex、bin.base64 XML 資料類型至二進位、映射SQL Server資料類型) ，則 Transaction 屬性必須設定為 FALSE。

預設值為 FALSE。

XMLFragment
指定來源資料是否為 XML 片段。 XML 片段是沒有單一、最上層 (根) 元素的 XML 文件。 這是布林屬性。 如果來源檔案由 XML 片段所組成，此屬性必須設定為 TRUE。

預設值為 FALSE。