XML 格式檔案的結構描述語法

XML 結構描述的基本語法

此語法陳述式只會顯示元素 (<BCPFORMAT>、<RECORD>、<FIELD>、<ROW> 和 <COLUMN>) 及其基本屬性。

<BCPFORMAT ...>

   <RECORD>

      <FIELD ID = "fieldID" xsi:type = "fieldType" [...]

      />

   </RECORD>

   <ROW>

      <COLUMN SOURCE = "fieldID" NAME = "columnName" xsi:type = "columnType" [...]

      />

   </ROW>

</BCPFORMAT>

結構描述元素的描述

<FIELD> 元素的屬性

<COLUMN> 元素的屬性

本節描述 <COLUMN> 元素的屬性，這些屬性會摘要在下列的結構描述語法中：

<COLUMN

   SOURCE = "fieldID"

   NAME = "columnName"

   xsi:type = "columnType"

   [ LENGTH = "n" ]

   [ PRECISION = "n" ]

   [ SCALE = "value" ]

   [ NULLABLE = { "YES"

"NO" } ]

/>

欄位會使用下列屬性對應到目標資料表的資料行：

COLUMN 屬性	說明	選擇性 / 必要
SOURCE ="fieldID"	指定對應到資料行的欄位識別碼。 <COLUMN SOURCE="fieldID"/> 對應到 <FIELD ID="fieldID"/>	必要
NAME = "columnName"	指定資料列集中由格式檔案代表的資料行名稱。此資料行名稱會用來識別結果集中的資料行，而且它不需要對應到用於目標資料表中的資料行名稱。	必要
xsi:type ="ColumnType"	這是識別元素執行個體之資料類型的 XML 建構 (如同屬性般使用)。ColumnType 的值會決定在給定的執行個體中需要哪些選用屬性 (如下)。 附註 ColumnType 的可能值與關聯的屬性如下表所示。	選擇性
LENGTH ="n"	定義固定長度資料類型的長度。只有當 xsi:type 是字串資料類型時，才會使用 LENGTH。 n 的值必須為正整數。	選用 (只在 xsi:type 是字串資料類型時才可使用)
PRECISION ="n"	指定數字中的位數。例如，數字 123.45 的精確度是 5。 其值必須為正整數。	選擇性 (唯有 xsi:type 是變數數字 (variable-number) 資料類型時才能使用)
SCALE ="int"	指定數字中小數點右方的位數。例如，數字 123.45 的小數位數是 2。 值必須是整數。	選擇性 (唯有 xsi:type 是變數數字 (variable-number) 資料類型時才能使用)
NULLABLE = { "YES" "NO" }	指定資料行是否可指定 NULL 值。此屬性完全與 FIELDS 無關。然而，若資料行並非 NULLABLE 且欄位指定 NULL (未指定任何值)，則會導致執行階段錯誤。 只有當您執行一般的 SELECT FROM OPENROWSET(BULK...) 陳述式時，才會使用 NULLABLE 屬性。	選擇性 (可用於任何資料類型)

<COLUMN> 元素的 Xsi:type 值

xsi:type 值是識別元素執行個體之資料類型的 XML 建構 (如同屬性般使用)。如需有關使用「將 xsi:type 值放入資料集」的資訊，請參閱本節稍後的部分。

<COLUMN> 元素支援原生 SQL 資料類型，如下所示：

類型類別目錄	<COLUMN> 資料類型	必要的 XML 屬性 適用於資料類型	選擇性 XML 屬性 適用於資料類型
固定	SQLBIT、SQLTINYINT、SQLSMALLINT、SQLINT、SQLBIGINT、SQLFLT4、SQLFLT8、SQLDATETIME、SQLDATETIM4、SQLDATETIM8、SQLMONEY、SQLMONEY4、SQLVARIANT 和 SQLUNIQUEID	無。	NULLABLE
變數數字	SQLDECIMAL 及 SQLNUMERIC	無。	NULLABLE、PRECISION、SCALE
LOB	SQLIMAGE、CharLOB、SQLTEXT 和 SQLUDT	無。	NULLABLE
字元 LOB	SQLNTEXT	無。	NULLABLE
二進位字串	SQLBINARY 及 SQLVARYBIN	無。	NULLABLE、LENGTH
字元字串	SQLCHAR、SQLVARYCHAR、SQLNCHAR 和 SQLNVARCHAR	無。	NULLABLE、LENGTH

重要事項
若要大量匯出或匯入 SQLXML 資料，請在格式檔案中使用下列資料類型：SQLCHAR 或 SQLVARYCHAR (資料會以用戶端字碼頁或定序所隱含的字碼頁傳送)、SQLNCHAR、SQLNVARCHAR (資料會以 Unicode 傳送)、SQLBINARY 或 SQLVARYBIN (資料不經轉換即傳送)。

如需有關 SQL Server 資料類型的詳細資訊，請參閱＜資料類型 (Transact-SQL)＞。

大量匯入如何使用 <ROW> 元素

某些內容會忽略 <ROW> 元素。<ROW> 元素是否會影響大量匯入作業，視作業執行方式而定：

• bcp 命令

  當資料載入目標資料表時，bcp 會略過 <ROW> 元件。相反地，bcp 會根據目標資料表的資料行類型來載入資料。

• Transact-SQL 陳述式 (BULK INSERT 和 OPENROWSET 的 Bulk 資料列集提供者)

  大量匯入資料到資料表時，Transact-SQL 陳述式會使用 <ROW> 元件來產生輸入資料列集。此外，Transact-SQL 陳述式會根據在目標資料表中 <ROW> 與對應資料行中指定的資料行類型，執行適當的類型轉換。若格式檔案中指定的資料行類型與目標資料表不同，會發生額外的類型轉換。此額外類型轉換可能會導致 BULK INSERT 或 OPENROWSET 的 Bulk 資料列集提供者發生某些不一致 (亦即，遺失精確度) 的行為 (與 bcp 相較)。

  <ROW> 元素中的資訊可讓您建構資料列，而不需要任何額外資訊。因此，您可以使用 SELECT 陳述式 (SELECT * FROM OPENROWSET(BULK datafile FORMATFILE=xmlformatfile) 來產生資料列集。

  [!附註]

  OPENROWSET BULK 子句需要格式檔案 (請注意，要有 XML 格式檔案才能將欄位的資料類型轉換為資料行的資料類型)。

大量匯入如何使用 <COLUMN> 元素

若要大量匯入資料至資料表中，格式檔案中的 <COLUMN> 元素會藉由指定下列各項，將資料檔案欄位對應到資料表資料：

• 資料檔的資料列中每一個欄位的位置。

• 資料行類型，用來將欄位資料類型轉換成所要的資料行資料類型。

若沒有任何資料行對應到欄位，則該欄位不會被複製到產生的資料列。此行為可讓資料檔產生具有不同資料行的資料列 (在不同的資料表中)。

同樣地，從資料表大量匯出資料時，格式檔案中的每一個 <COLUMN> 會將輸入資料表資料列中的資料行對應到輸出資料檔中的對應欄位。

將 xsi:type 值放到資料集中

當您使用 XML Schema Definition (XSD) 語言來驗證 XML 文件時，xsi:type 值不會放到資料集中。然而，您可以透過將 XML 格式檔案載入到 XML 文件 (例如：myDoc)，來將 xsi:type 資訊放到資料集中，如以下程式碼片段所示：

...;
myDoc.LoadXml(xmlFormat);
XmlNodeList ColumnList = myDoc.GetElementsByTagName("COLUMN");
for(int i=0;i<ColumnList.Count;i++)
{
   Console.Write("COLUMN: xsi:type=" +ColumnList[i].Attributes["type",
      "http://www.w3.org/2001/XMLSchema-instance"].Value+"\n");
}

請參閱

參考

概念