Modifications de copie en bloc pour les types date/heure améliorés (OLE DB et ODBC)

Article
08/06/2013

Cette rubrique décrit les améliorations de date/heure permettant de prendre en charge les fonctionnalités de copie en bloc. Les informations fournies dans cette rubrique sont valables pour OLE DB et ODBC dans SQL Server Native Client.

Fichiers de format

Lors de la génération interactive de fichiers de format, le tableau ci-dessous décrit l'entrée utilisée pour spécifier des types date/heure et les noms de type de données de fichier hôte correspondants.

Type de stockage de fichier	Type de données du fichier hôte	Réponse à l'invite : "Tapez le type de stockage de fichier du champ <nom_champ> [<valeur_par_défaut>] :"
Datetime	SQLDATETIME	d
Smalldatetime	SQLDATETIM4	D
Date	SQLDATE	de
Heure	SQLTIME	te
Datetime2	SQLDATETIME2	d2
Datetimeoffset	SQLDATETIMEOFFSET	do

Le fichier au format XML XSD possédera les ajouts suivants :

    <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>

Fichiers de données de type caractère

Dans les fichiers de données de type caractère, les valeurs de date et d'heure sont représentées comme décrit dans la section « Formats de données : chaînes et littéraux » de la rubrique Prise en charge du type de données pour les améliorations Date/Heure (ODBC) pour ODBC ou Prise en charge du type de données pour les améliorations de Date/Heure OLE DB pour OLE DB.

Dans les fichiers de données natifs, les valeurs de date et d'heure pour les quatre nouveaux types sont sous la forme de leurs représentations TDS avec une échelle de 7 (maximum pris en charge par SQL Server et les fichiers de données bcp ne stockent pas l'échelle de ces colonnes). Aucune modification n'est apportée au stockage des types datetime et smalldatetime existants ni à leurs représentations de flux de données tabulaires (TDS).

Les tailles de stockage pour les différents types de stockage sont les suivantes pour OLE DB :

Type de stockage de fichier	Taille de stockage en octets
datetime	8
smalldatetime	4
date	3
time	6
datetime2	9
datetimeoffset	11

Les tailles sont les suivantes pour ODBC. Notez qu'il n'est pas nécessaire de stocker la précision dans les fichiers de format ou de données, car BCP.exe extraira toujours la précision du serveur.

Type de stockage de fichier	Taille de stockage en octets	Format de stockage
datetime (d)	8	TDS (flux de données tabulaires)
smalldatetime (D)	4	TDS (flux de données tabulaires)
date (de)	3	TDS (flux de données tabulaires)
time (te)	6	TDS (flux de données tabulaires)
datetime2 (d2)	9	TDS (flux de données tabulaires)
datetimeoffset (do)	11	TDS (flux de données tabulaires)

Types BCP dans sqlncli.h

Les types suivants sont définis dans sqlncli.h pour être utilisés avec les extensions d'API BCP d'ODBC. Ces types sont passés avec le paramètre eUserDataType d'IBCPSession::BCPColFmt dans OLE DB.

Type de stockage de fichier	Type de données du fichier hôte	Type dans sqlncli.h à utiliser avec IBCPSession::BCPColFmt	Valeur
Datetime	SQLDATETIME	BCP_TYPE_SQLDATETIME	0x3d
Smalldatetime	SQLDATETIM4	BCP_TYPE_SQLDATETIME4	0x3a
Date	SQLDATE	BCP_TYPE_SQLDATE	0x28
Heure	SQLTIME	BCP_TYPE_SQLTIME	0x29
Datetime2	SQLDATETIME2	BCP_TYPE_SQLDATETIME2	0x2a
Datetimeoffset	SQLDATETIMEOFFSET	BCP_TYPE_SQLDATETIMEOFFSET	0x2b

Conversions des types de données BCP

Les tableaux ci-dessous fournissent des informations de conversion.

Remarque OLE DB Les conversions suivantes sont effectuées par IBCPSession. IRowsetFastLoad utilise les conversions OLE DB telles qu'elles sont définies dans Conversions de client à serveur. Notez que les valeurs datetime sont arrondies au 1/300e de seconde et que les secondes des valeurs smalldatetime sont mises à zéro après l'exécution des conversions clientes décrites ci-dessous. L'arrondi des valeurs datetime est propagé aux heures et aux minutes, mais pas à la date.

Vers --> De	date	time	smalldatetime	datetime	datetime2	datetimeoffset	char	wchar
Date	1	-	1,6	1,6	1,6	1,5,6	1,3	1,3
Heure	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,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	N/A	N/A
Char/wchar (heure)	-	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	N/A	N/A
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	N/A	N/A
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	N/A	N/A

Liste des symboles

Aucune conversion n'est prise en charge.

Un enregistrement de diagnostic ODBC est généré avec SQLSTATE 07006 et le message « Violation de l'attribut de type de données restreint ».

Si les données fournies ne sont pas valides, un enregistrement de diagnostic ODBC est généré avec SQLSTATE 22007 et le message « Format datetime non valide ». Pour les valeurs datetimeoffset, la partie heure doit se situer dans la plage après la conversion au format UTC, même si aucune conversion au format UTC n'est demandée. Ceci tient au fait que TDS et le serveur normalisent toujours l'heure dans les valeurs datetimeoffset pour UTC. Par conséquent, le client doit vérifier que les composants heure se situent dans la plage prise en charge après la conversion au format UTC.

Le composant heure est ignoré.

Pour ODBC, s'il se produit une troncation avec perte de données, un enregistrement de diagnostic est généré avec SQLSTATE 22001 et le message « Troncation à droite de la chaîne de données ». Le nombre de chiffres des fractions de seconde (l'échelle) est déterminé à partir de la taille de la colonne de destination, conformément au tableau suivant : Pour les tailles de colonne supérieures à la plage du tableau, une échelle de 7 est nécessaire. Cette conversion accepte jusqu'à neuf chiffres de fractions de seconde, valeur maximale autorisée par ODBC.

DBTIME2

10,16

DBTIMESTAMP

21..27

DBTIMESTAMPOFFSET

28..34

Pour OLE DB, s'il se produit une troncation avec perte de données, une erreur est publiée. Pour datetime2, le nombre de chiffres des fractions de seconde (l'échelle) est déterminé à partir de la taille de la colonne de destination, conformément au tableau suivant : pour les tailles de colonne supérieures à la plage du tableau, une échelle de 9 est nécessaire. Cette conversion accepte jusqu'à neuf chiffres de fractions de seconde, valeur maximale autorisée par OLE DB.

DBTIME2

1..9

DBTIMESTAMP

21..29

DBTIMESTAMPOFFSET

28..36

Le composant date est ignoré.

Le composant fuseau horaire est défini au format UTC (par exemple, 00:00).

L'heure est définie avec la valeur zéro.

La date est définie avec la valeur 1900-01-01.

Le décalage horaire est ignoré.

La chaîne est analysée et convertie en valeur date, datetime, datetimeoffset ou time, selon le premier caractère de ponctuation rencontré et la présence de composants restants. La chaîne est ensuite convertie en type cible, selon les règles fournies dans le tableau à la fin de cette rubrique pour le type source découvert par ce processus. Si les données fournies ne peuvent pas être analysées sans erreur, ou si un composant quelconque est en dehors de la plage autorisée, ou s'il n'y a aucune conversion du type de littéral au type cible, une erreur est publiée (OLE DB) ou un enregistrement de diagnostic ODBC est généré avec SQLSTATE 22018 et le message « Valeur de caractère non valide pour la spécification de la casse ». Pour les paramètres datetime et smalldatetime, si l'année est en dehors de la plage prise en charge par ces types, une erreur est publiée (OLE DB) ou un enregistrement de diagnostic ODBC est généré avec SQLSTATE 22007 et le message « Format datetime non valide ».

Pour datetimeoffset, la valeur doit se situer dans la plage après la conversion au format UTC, même si aucune conversion au format UTC n'est demandée. Cela tient au fait que TDS et le serveur normalisent toujours l'heure des valeurs datetimeoffset pour UTC, si bien que le client doit vérifier que les composants heure se situent dans la plage prise en charge après la conversion au format UTC. Si la valeur n'est pas dans la plage UTC prise en charge, une erreur est publiée (OLE DB) ou un enregistrement de diagnostic ODBC est généré avec SQLSTATE 22007 et le message « Format datetime non valide ».

S'il se produit une troncation avec perte de données lors d'une conversion de client à serveur, une erreur est publiée (OLE DB) ou un enregistrement de diagnostic ODBC est généré avec SQLSTATE 22008 et le message « Dépassement de la capacité du champ datetime ». Cette erreur se produit également si la valeur est située en dehors de la plage qui peut être représentée par la plage UTC utilisée par le serveur. S'il se produit une troncation de secondes ou de fractions de seconde lors d'une conversion de serveur à client, seul un avertissement est émis.

S'il se produit une troncation avec perte de données, un enregistrement de diagnostic est généré.

Lors d'une conversion de serveur à client, il s'agit d'un avertissement (ODBC SQLSTATE S1000).

Lors d'une conversion de client à serveur, il s'agit d'une erreur (ODBC SQLSTATE 22001).

Les secondes sont réinitialisées et les fractions de seconde sont ignorées. Aucune erreur de troncation n'est possible.

N/A

Le comportement existant et antérieur de SQL Server 2005 est conservé.

Voir aussi

Concepts

Améliorations de la date et de l'heure (ODBC)

Améliorations des types de données de date et d'heure (OLE DB)

Partager via