機能強化された日付型と時刻型向けの一括コピーの変更 (OLE DB および ODBC)
適用対象:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
このトピックでは、一括コピー機能をサポートするための日付と時刻の機能強化について説明します。 このトピックの情報は、SQL Server Native Clientの OLE DB と ODBC の両方に対して有効です。
重要
SQL Server Native Client (SNAC と略されることがよくあります) は、SQL Server 2022 (16.x) と SQL Server Management Studio 19 (SSMS) から削除されました。 SQL Server Native Client (SQLNCLI または SQLNCLI11) とレガシ Microsoft OLE DB Provider for SQL Server (SQLOLEDB) は、新しいアプリケーション開発には推奨されません。 今後、新しい Microsoft OLE DB Driver (MSOLEDBSQL) for SQL Server または最新の Microsoft ODBC Driver for SQL Server に切り替えてください。 SQL Server データベース エンジン (バージョン 2012 から 2019) のコンポーネントとして付属する SQLNCLI については、このサポート ライフサイクルの例外を参照してください。
フォーマット ファイル
フォーマット ファイルを対話形式で作成する場合に、日付型と時刻型の指定に使用する入力、および対応するホスト ファイル データ型名を次の表に示します。
| ファイル ストレージ型 | ホスト ファイル データ型 | "フィールド <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>
文字データ ファイル
文字データ ファイルでは、日付と時刻の値は、「ODBC のデータ 型のサポート」 の「データ形式: 文字列とリテラル」セクション、または OLE DB の日付と時刻 の改善のためのデータ型のサポートに関するセクションで説明されているように表されます。
ネイティブ データ fl では、4 つの新しい型の日付と時刻の値は、スケールが 7 の TDS 表現として表されます (これは、SQL Serverでサポートされる最大値であり、bcp データ ファイルにはこれらの列のスケールが格納されないためです)。 既存の datetime 型および smalldatetime 型や、それらの TDS (表形式のデータ ストリーム) 表現のストレージに変更はありません。
OLE DB の場合、さまざまなストレージ型のストレージ サイズは次のとおりです。
| ファイル ストレージ型 | ストレージ サイズ (バイト単位) |
|---|---|
| DATETIME | 8 |
| smalldatetime | 4 |
| date | 3 |
| time | 6 |
| datetime2 | 9 |
| datetimeoffset | 11 |
ODBC の場合、サイズは次のとおりです。 BCP.exe を実行すると有効桁数は常にサーバーから取得されるので、フォーマット ファイルにもデータ ファイルにも、有効桁数を格納する必要はありません。
| ファイル ストレージ型 | ストレージ サイズ (バイト単位) | ストレージ形式 |
|---|---|---|
| datetime (d) | 8 | TDS (TDS) |
| smalldatetime (D) | 4 | TDS (TDS) |
| date (de) | 3 | TDS (TDS) |
| time (te) | 6 | TDS (TDS) |
| datetime2 (d2) | 9 | TDS (TDS) |
| datetimeoffset (do) | 11 | TDS (TDS) |
sqlncli.h 内の BCP 型
sqlncli.h では、ODBC の BCP API 拡張機能で使用する次の型が定義されています。 これらの型は OLE DB で IBCPSession::BCPColFmt の eUserDataType パラメーターと共に渡されます。
| ファイル ストレージ型 | ホスト ファイル データ型 | IBCPSession::BCPColFmt で使用する sqlncli.h を入力します | 値 |
|---|---|---|---|
| Datetime | SQLDATETIME | BCP_TYPE_SQLDATETIME | 0x3d |
| Smalldatetime | SQLDATETIM4 | BCP_TYPE_SQLDATETIME4 | 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 値の秒は 0 に設定されます。 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 | 該当なし | 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、10 (ODBC) 1、12 (OLE DB) | 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 (ODBC) 9、6、12 (OLE DB) | 9、6 (ODBC) 9、6、12 (OLE DB) | 9,6 | 9,5,6 | 該当なし | 該当なし |
| Char/wchar (time) | - | 9、10 | 9,7,10 (ODBC)9,7,10,12 (OLE DB) | 9、7、10 (ODBC) 9、7、10、12 (OLE DB) | 9,7,10 | 9,5,7,10 | 該当なし | 該当なし |
| Char/wchar (datetime) | 9,2 | 9,4,10 | 9、10 (ODBC) 9、10、12 (OLE DB) | 9、10 (ODBC) 9、10、12 (OLE DB) | 9、10 | 9,5,10 | 該当なし | 該当なし |
| Char/wchar (datetimeoffset) | 9,2,8 | 9,4,8,10 | 9、8、10 (ODBC) 9、8、10、12 (OLE DB) | 9、8、10 (ODBC) 9、8、10、12 (OLE DB) | 9,8,10 | 9、10 | 該当なし | 該当なし |
記号の説明
| Symbol | 意味 |
|---|---|
| - | 変換はサポートされていません。 "データ型の属性に関する制限に違反しました" というメッセージで SQLSTATE 07006 の ODBC 診断レコードが生成されます。 |
| 1 | 指定されたデータが無効な場合は、SQLSTATE 22007 とメッセージ "無効な datetime 形式" を使用して ODBC 診断レコードが生成されます。 datetimeoffset 値の場合は、UTC への変換が必要なくても、時刻部分は UTC への変換後の範囲内に収まっている必要があります。 TDS とサーバーは datetimeoffset 値の時刻を常に UTC 用に正規化するためです。 したがって、クライアントは、時刻部分が、UTC への変換後にサポートされる範囲内に収まっていることを確認する必要があります。 |
| 2 | 時刻部分は無視されます。 |
| 3 | ODBC の場合、データ損失を伴う切り捨てが発生した場合、SQLSTATE 22001 とメッセージ 'String data, right truncated' で診断レコードが生成されます。秒の小数部の桁数 (小数点以下桁数) は、次の表に従って変換先列のサイズから決定されます。 テーブルの範囲よりサイズが大きい列の場合、7 桁と見なされます。 この変換では、ODBC で許可される最大 9 桁の秒の小数部を使用できます。 種類: DBTIME2 暗黙の小数点以下桁数 0 8 暗黙のスケール 1..7 10,16 種類: DBTIMESTAMP 暗黙の小数点以下桁数 0: 19 暗黙のスケール 1..7: 21..27 種類: DBTIMESTAMPOFFSET 暗黙の小数点以下桁数 0: 26 暗黙的なスケール 1..7: 28..34 OLE DB の場合は、データの損失を伴う切り捨てが行われると、エラーが通知されます。 datetime2 に関しては、次の表に示すように、秒の小数点以下桁数 (スケール) は変換先の列のサイズによって決まります。 テーブルの範囲よりサイズが大きい列の場合は、9 桁と見なされます。 この変換では、秒の小数点以下桁数が 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 | 時刻は 0 に設定されます。 |
| 7 | 日付は 1900-01-01 に設定されます。 |
| 8 | タイム ゾーン オフセットは無視されます。 |
| 9 | 文字列は解析され、最初に検出された句読点、および残りの部分があるかどうかに応じて、date 値、datetime 値、datetimeoffset 値、time 値のいずれかに変換されます。 次に、このトピックの最後にある表に示した規則のうち、この処理で検出された変換元の型についての規則に従って、文字列は変換先の型に変換されます。 指定したデータを解析するとエラーが発生する場合、データを構成するいずれかの部分が許容範囲の外にある場合、または、リテラル型から変換先の型への変換が存在しない場合は、エラーが通知される (OLE DB) か、"キャストした文字コードが正しくありません" というメッセージで SQLSTATE 22018 の ODBC 診断レコードが生成されます。 datetime 型および smalldatetime 型のパラメーターでは、年がこれらの型でサポートされる範囲外の場合、エラーが通知される (OLE DB) か、"datetime 形式が無効です" というメッセージで SQLSTATE 22007 の ODBC 診断レコードが生成されます。 datetimeoffset では、UTC への変換が必要なくても、値は UTC への変換後の範囲内に収まっている必要があります。 TDS とサーバーは datetimeoffset 値の時刻を常に UTC 用に正規化するので、クライアントは、時刻部分が、UTC への変換後にサポートされる範囲内に収まっていることを確認する必要があるためです。 値が、サポートされている UTC の範囲内にない場合、エラーが通知される (OLE DB) か、"datetime 形式が無効です" というメッセージで SQLSTATE 22007 の ODBC 診断レコードが生成されます。 |
| 10 | クライアントからサーバーへの変換で、データの損失を伴う切り捨てが行われると、エラーが通知される (OLE DB) か、"Datetime フィールド オーバーフロー" というメッセージで SQLSTATE 22008 の ODBC 診断レコードが生成されます。 サーバーが使用する UTC の範囲で表すことができる範囲の外に値がある場合にも、このエラーが発生します。 サーバーからクライアントへの変換で、秒または秒の小数部の切り捨てが行われた場合は、警告のみが発生します。 |
| 11 | データの損失を伴う切り捨てが行われると、診断レコードが生成されます。 サーバーからクライアントへの変換では、これは警告 (ODBC SQLSTATE S1000) です。 クライアントからサーバーへの変換では、これはエラー (ODBC SQLSTATE 22001) です。 |
| 12 | 秒は 0 に設定され、秒の小数部は破棄されます。 切り捨てエラーは発生しません。 |
| 該当なし | 既存の SQL Server 2005 (9.x) 以前のバージョンの動作が維持されます。 |
参照
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示