增強型日期和時間類型的大量複製變更 (OLE DB)

發行項
05/23/2023

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Platform System （PDW）

本文描述 OLE DB Driver for SQL Server 中支援大量複製功能的日期/時間增強功能。

格式檔案

以互動方式建立格式檔案時，下表描述用於指定日期/時間類型與對應主檔資料類型名稱的輸入。

檔案儲存類型	主檔案資料類型	提示的回應：「請輸入欄位 <field_name> [<default>] 的檔案儲存類型:」
Datetime	SQLDATETIME	d
Smalldatetime	SQLDATETIM4	D
Date	SQLDATE	de
Time	SQLTIME	te
Datetime2	SQLDATETIME2	d2
Datetimeoffset	SQLDATETIMEOFFSET	do

XML 格式檔案 XSD 將具備下列加入項目：

<xs:complexType name="SQLDATETIME2">  
    <xs:complexContent>  
        <xs:extension base="bl:Fixed"/>  
    </xs:complexContent>  
</xs:complexType>  
<xs:complexType name="SQLDATETIMEOFFSET">  
    <xs:complexContent>  
        <xs:extension base="bl:Fixed"/>  
    </xs:complexContent>  
</xs:complexType>  
<xs:complexType name="SQLDATE">  
    <xs:complexContent>  
        <xs:extension base="bl:Fixed"/>  
    </xs:complexContent>  
</xs:complexType>  
<xs:complexType name="SQLTIME">  
    <xs:complexContent>  
        <xs:extension base="bl:Fixed"/>  
    </xs:complexContent>  
</xs:complexType>

字元資料類型

在字元資料檔案中，適用於 OLE DB 的日期和時間值表示方式如「資料格式：字串和常值」一節 (位於對 OLE DB 日期和時間改善的資料類型支援中) 所述。

在原生資料檔中，四個新類型的日期和時間值會表示為包含 7 個小數位數的 TDS 表示法 (因為這是 SQL Server 所支援的最大值，而且 bcp 資料檔不會儲存這些資料行的小數位數)。現有 datetime 和 smalldatetime 類型的儲存或其表格式資料流 (TDS) 表示法沒有變更。

對於 OLE DB，不同儲存類型的儲存大小如下所示：

檔案儲存類型	儲存體大小 (以位元組為單位)
Datetime	8
smalldatetime	4
date	3
time	6
datetime2	9
datetimeoffset	11

msoledbsql.h 中的 BCP 類型

下列類型定義於 msoledbsql.h 中。這些類型會利用 OLE DB 中 IBCPSession::BCPColFmt 的 eUserDataType 參數來傳遞。

檔案儲存類型	主檔案資料類型	msoledbsql.h 中搭配 IBCPSession::BCPColFmt 使用的類型	值
Datetime	SQLDATETIME	BCP_TYPE_SQLDATETIME	0x3d
Smalldatetime	SQLDATETIM4	BCP_TYPE_SQLDATETIM4	0x3a
Date	SQLDATE	BCP_TYPE_SQLDATE	0x28
Time	SQLTIME	BCP_TYPE_SQLTIME	0x29
Datetime2	SQLDATETIME2	BCP_TYPE_SQLDATETIME2	0x2a
Datetimeoffset	SQLDATETIMEOFFSET	BCP_TYPE_SQLDATETIMEOFFSET	0x2b

BCP 資料類型轉換

下表提供轉換資訊。

OLE DB 注意：下列轉換是由 IBCPSession 所執行。 IRowsetFastLoad 會使用如從用戶端到伺服器執行的轉換中所定義的 OLE DB 轉換。請注意，datetime 值會捨入為一秒的 1/300，而 smalldatetime 值在執行以下所描述的用戶端轉換之後，會將其秒數設定為零。 Datetime 捨入會透過小時和分鐘 (但非日期) 傳播。

至 --> 從	date	time	smalldatetime	Datetime	datetime2	datetimeoffset	char	wchar
Date	1	-	1, 6	1, 6	1, 6	1, 5, 6	1, 3	1, 3
Time	N/A	1, 10	1, 7, 10	1, 7, 10	1, 7, 10	1, 5, 7, 10	1, 3	1, 3
Smalldatetime	1, 2	1, 4, 10	1	1	1, 10	1, 5, 10	1, 11	1, 11
Datetime	1, 2	1, 4, 10	1, 12	1	1, 10	1, 5, 10	1, 11	1, 11
Datetime2	1, 2	1, 4, 10	1, 12	1, 10	1, 10	1, 5, 10	1, 3	1, 3
Datetimeoffset	1, 2, 8	1, 4, 8, 10	1, 8, 10	1, 8, 10	1, 8, 10	1, 10	1, 3	1, 3
Char/wchar (date)	9	-	9, 6, 12	9, 6, 12	9, 6	9, 5, 6	N/A	N/A
Char/wchar (time)	-	9, 10	9, 7, 10, 12	9, 7, 10, 12	9, 7, 10	9, 5, 7, 10	N/A	N/A
Char/wchar (datetime)	9, 2	9, 4, 10	9, 10, 12	9, 10, 12	9, 10	9, 5, 10	N/A	N/A
Char/wchar (datetimeoffset)	9, 2, 8	9, 4, 8, 10	9, 8, 10, 12	9, 8, 10, 12	9, 8, 10	9, 10	N/A	N/A

符號的索引鍵

符號	意義
-	不支援轉換。
1	如果提供的資料無效，就會發佈錯誤。對於 datetimeoffset 值，即使沒有要求轉換為 UTC，此時間部分在轉換到 UTC 之後仍然必須在範圍內。這是因為 TDS 和伺服器永遠會以 UTC 的 datetimeoffset 值，正規化時間。因此，用戶端必須確認時間元件在轉換為 UTC 之後，仍然位於支援的範圍內。
2	忽略時間元件。
3	如果截斷時發生資料損失，則會發佈錯誤。對於 datetime2，小數秒的位數 (小數位數) 會根據下表，從目的地資料行的大小決定。對於大於資料表中範圍的資料行大小，會隱含小數位數 9。此轉換應該最多允許九個小數秒位數，也就是 OLE DB 所允許的最大值。類型： DBTIME2 隱含的小數位數 0： 8 隱含的小數位數 1..9： 1..9 類型： DBTIMESTAMP 隱含的範圍 0： 19 隱含的範圍 1..9： 21..29 類型： DBTIMESTAMPOFFSET 隱含的範圍 0： 26 隱含的範圍 1..9： 28..36
4	忽略日期元件。
5	時區會設定為 UTC (例如，00:00)。
6	時間會設定為零。
7	日期會設定為 1900-01-01。
8	忽略時區位移。
9	根據出現的第一個標點符號字元以及剩餘的元件是否存在，字串會經過剖析，並轉換為 date、datetime、datetimeoffset 或 time 值。接著，在此程序針對來源類型探索本文結尾之資料表中的規則之後，此字串會轉換為目標類型。如果無法正確剖析提供的資料、有任何元件部分超出允許的範圍，或者，沒有從常值類型到目標類型的轉換，就會發佈錯誤。針對 datetime 和 smalldatetime 參數，如果年份超出這些類型所支援的範圍，就會發佈錯誤。對於 datetimeoffset，即使沒有要求轉換為 UTC，此值在轉換到 UTC 之後仍然必須在範圍內。這是因為 TDS 和伺服器永遠會以 UTC 的 datetimeoffset 值，將時間正規化，因此用戶端必須在轉換成 UTC 之後，確認時間元件位於支援的範圍內。如果值不在支援的 UTC 範圍內，就會發佈錯誤。
10	對於用戶端到伺服器的轉換，如果截斷時發生資料損失，就會發佈錯誤。如果此值落在伺服器使用之 UTC 範圍所代表的範圍外，也可能發生這個錯誤。如果在從伺服器轉換為用戶端時發生秒或小數秒的截斷，只會有一個警告。
11	對於用戶端到伺服器的轉換，如果截斷時發生資料損失，就會發佈錯誤。
12	秒數會設定為零，而小數秒會遭到捨棄。不可能發生截斷錯誤。
N/A	會對現有的 SQL Server 2005 (9.x) 和先前的行為進行維護。

另請參閱

日期和時間改善 (OLE DB)

共用方式為