XML Updategram 的指導方針和限制 (SQLXML 4.0)

使用 XML Updategram 時，請記住下列事項：

• 如果您要將 Updategram 用於只有 <before> 和 <after> 區塊之單一配對的插入作業，可以省略 <before> 區塊。相反地，如果是刪除作業，則可省略 <after> 區塊。

• 如果您要搭配 <sync> 標籤中的多個 <before> 和 <after> 區塊使用 Updategram，必須同時指定 <before> 區塊和 <after> 區塊，才能形成 <before> 和 <after> 配對。

• Updategram 中的更新會套用到 XML 結構描述所提供的 XML 檢視。因此，若要讓預設的對應成功，您必須在 Updategram 中指定結構描述檔案名稱，或者，如果沒有提供檔案名稱，元素和屬性名稱必須符合資料庫中的資料表和資料行名稱。

• SQLXML 4.0 要求 Updategram 中的所有資料行值都必須在提供的結構描述 (XDR 或 XSD) 中明確對應，才能構成其子元素的 XML 檢視。此行為與舊版 SQLXML 不同，如果這意味著 sql:relationship 註解中外部索引鍵的一部分，則允許在結構描述中不對應資料行的值 (請注意，此變更不會影響主索引鍵值傳播到子元素，如果沒有針對子元素明確指定任何值，仍然會發生在 SQLXML 4.0 上。

• 如果您要使用 Updategram 來修改二進位資料行 (例如，SQL Serverimage 資料類型) 中的資料，您必須提供對應結構描述，其中必須指定 SQL Server 資料類型 (例如，sql:datatype="image") 和 XML 資料類型 (例如，dt:type="binhex" 或 dt:type="binbase64)。二進位資料行的資料必須在 Updategram 中指定；Updategram 會忽略在對應結構描述中指定的 sql:url-encode 註解。

• 當您要撰寫 XSD 結構描述時，如果您針對 sql:relation 或 sql:field 註解指定的值包含特殊字元，如空白字元 (例如，在 "Order Details" 資料表名稱中)，則必須以方括號括住這個值 (例如，"[Order Details]")。

• 使用 Updategram 時，不支援鏈結關聯性。例如，如果資料表 A 和 C 透過使用資料表 B 的鏈結關聯性相關聯，嘗試執行 Updategram 時，會發生下列錯誤：

  There is an inconsistency in the schema provided.
  

  即使結構描述和 Updategram 都正確而且格式有效，如果存在鏈結關聯性，則會發生此錯誤。

• 在更新期間，Updategram 不允許將 image 類型資料當做參數傳遞。

• 二進位大型物件 (BLOB) 類型如同 text/ntext 和 images，在使用 Updategram 時，不得用於 <before> 區塊，因為這會將它們包含在並行控制中使用。這可能會因為 BLOB 類型的比較限制而造成 SQL Server 的問題。例如，WHERE 子句中的 LIKE 關鍵字用於 text 資料類型之資料行間的比較，不過，如果 BLOB 類型中，資料大小大於 8K，則比較將會失敗。

• ntext 資料中的特殊字元可能會因為 BLOB 類型的比較限制而造成 SQLXML 4.0 的問題。例如，用於 ntext 類型之資料行的並行檢查中時，在 Updategram 類型的 <before> 區塊中使用 "[Serializable]" 將會失敗，並顯示下列 SQLOLEDB 錯誤描述：

  Empty update, no updatable rows found   Transaction aborted