Comportement des types de date et d'heure améliorés avec les versions SQL Server antérieures (ODBC)
S’applique à :
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Cette rubrique décrit le comportement attendu lorsqu’une application cliente qui utilise des fonctionnalités de date et d’heure améliorées communique avec une version de SQL Server antérieure à SQL Server 2008 (10.0.x) et lorsqu’une application cliente utilisant microsoft Data Access Components, Windows Data Access Components ou une version de SQL Server Native Client antérieure à SQL Server 2008 (10.0.x) envoie des commandes à un serveur qui prend en charge les fonctionnalités de date et d’heure améliorées.
Comportement de client de bas niveau
Les applications clientes compilées à l’aide d’une version de SQL Server Native Client antérieure à SQL Server 2008 (10.0.x) voient les nouveaux types de date/heure en tant que colonnes nvarchar. Le contenu de la colonne est les représentations littérales, comme décrit dans la section « Formats de données : chaînes et littéraux » de la prise en charge des types de données pour les améliorations de date et d’heure ODBC. La taille de colonne correspond à la longueur littérale maximale pour la précision en fractions de seconde spécifiée pour la colonne.
Les API du catalogue retournent des métadonnées conformes au code du type de données de bas niveau retourné au client (nvarchar, par exemple) et à la représentation de bas niveau associée (le format littéral approprié, par exemple). Toutefois, le nom du type de données retourné sera le nom de type SQL Server 2008 (10.0.x).
Les métadonnées d’instruction retournées par SQLDescribeCol, SQLDescribeParam, SQGetDescField et SQLColAttribute retournent des métadonnées cohérentes avec le type de bas niveau à tous les égards, y compris le nom du type. Un exemple de ce type de bas niveau est nvarchar.
Lorsqu’une application cliente de bas niveau s’exécute sur un serveur SQL Server 2008 (10.0.x) (ou version ultérieure) sur lequel les modifications de schéma apportées aux types date/heure ont été effectuées, le comportement attendu est le suivant :
| Type SQL Server 2005 | Type SQL Server 2008 (10.0.x) (ou version ultérieure) | Type de client ODBC | Conversion des résultats (de SQL vers C) | Conversion des paramètres (de C vers SQL) |
|---|---|---|---|---|
| Datetime | Date | SQL_C_TYPE_DATE | OK | OK (1) |
| SQL_C_TYPE_TIMESTAMP | Champs d'heure définis à zéro. | OK (2) Échoue si le champ d'heure n'est pas nul. Fonctionne avec SQL Server 2005 (9.x). |
||
| Time(0) | SQL_C_TYPE_TIME | OK | OK (1) | |
| SQL_C_TYPE_TIMESTAMP | Champs de date définis à la date actuelle. | OK (2) La date est ignorée. Échoue si les fractions de secondes ne sont pas nulles. Fonctionne avec SQL Server 2005 (9.x). |
||
| Time(7) | SQL_C_TIME | Échec : littéral de temps non valide. | OK (1) | |
| SQL_C_TYPE_TIMESTAMP | Échec : littéral de temps non valide. | OK (1) | ||
| Datetime2(3) | SQL_C_TYPE_TIMESTAMP | OK | OK (1) | |
| Datetime2(7) | SQL_C_TYPE_TIMESTAMP | OK | La valeur sera arrondie à 1/300e de seconde par la conversion cliente. | |
| Smalldatetime | Date | SQL_C_TYPE_DATE | OK | OK |
| SQL_C_TYPE_TIMESTAMP | Champs d'heure définis à zéro. | OK (2) Échoue si le champ d'heure n'est pas nul. Fonctionne avec SQL Server 2005 (9.x). |
||
| Time(0) | SQL_C_TYPE_TIME | OK | OK | |
| SQL_C_TYPE_TIMESTAMP | Champs de date définis à la date actuelle. | OK (2) La date est ignorée. Échoue si les fractions de seconde ne sont pas nulles. Fonctionne avec SQL Server 2005 (9.x). |
||
| Datetime2(0) | SQL_C_TYPE_TIMESTAMP | OK | OK |
Liste des symboles
| Symbole | Signification |
|---|---|
| 1 | S’il a fonctionné avec SQL Server 2005 (9.x), il doit continuer à fonctionner avec une version plus récente de SQL Server. |
| 2 | Une application qui fonctionnait avec SQL Server 2005 (9.x) peut échouer avec une version plus récente de SQL Server. |
Notez que seules les modifications de schéma courantes ont été considérées. Les modifications courantes sont les suivantes :
Utilisation d'un nouveau type alors qu'en toute logique une application requiert uniquement une valeur de date ou d'heure. Toutefois, l'application a été forcée d'utiliser des données datetime ou smalldatetime en raison du manque de types de date et d'heure distincts.
Utilisation d'un nouveau type pour gagner en précision sur les fractions de seconde.
Passage à datetime2, car il représente le type de données de date et d'heure préféré.
Métadonnées de colonne retournées par SQLColumns, SQLProcedureColumns et SQLSpecialColumns
Les valeurs de colonnes suivantes sont retournées pour les types date/heure :
| Type de colonne | date | time | smalldatetime | DATETIME | datetime2 | datetimeoffset |
|---|---|---|---|---|---|---|
| DATA_TYPE | SQL_WVARCHAR | SQL_WVARCHAR | SQL_TYPE_TIMESTAMP | SQL_TYPE_TIMESTAMP | SQL_WVARCHAR | SQL_WVARCHAR |
| TYPE_NAME | Date | time | smalldatetime | DATETIME | datetime2 | datetimeoffset |
| COLUMN_SIZE | 10 | 8,10..16 | 16 | 23 | 19, 21..27 | 26, 28..34 |
| BUFFER_LENGTH | 20 | 16, 20..32 | 16 | 16 | 38, 42..54 | 52, 56..68 |
| DECIMAL_DIGITS | NULL | NULL | 0 | 3 | NULL | NULL |
| SQL_DATA_TYPE | SQL_WVARCHAR | SQL_WVARCHAR | SQL_DATETIME | SQL_DATETIME | SQL_WVARCHAR | SQL_WVARCHAR |
| SQL_DATETIME_SUB | NULL | NULL | SQL_CODE_TIMESTAMP | SQL_CODE_TIMESTAMP | NULL | NULL |
| CHAR_OCTET_LENGTH | NULL | NULL | NULL | NULL | NULL | NULL |
| SS_DATA_TYPE | 0 | 0 | 111 | 111 | 0 | 0 |
SQLSpecialColumns ne retourne pas SQL_DATA_TYPE, SQL_DATETIME_SUB, CHAR_OCTET_LENGTH ni SS_DATA_TYPE.
Métadonnées de type de données retournées par SQLGetTypeInfo
Les valeurs de colonnes suivantes sont retournées pour les types date/heure :
| Type de colonne | date | time | smalldatetime | DATETIME | datetime2 | datetimeoffset |
|---|---|---|---|---|---|---|
| TYPE_NAME | Date | time | smalldatetime | DATETIME | datetime2 | datetimeoffset |
| DATA_TYPE | SQL_WVARCHAR | SQL_WVARCHAR | SQL_TYPE_TIMESTAMP | SQL_TYPE_TIMESTAMP | SQL_WVARCHAR | SQL_WVARCHAR |
| COLUMN_SIZE | 10 | 16 | 16 | 23 | 27 | 34 |
| LITERAL_PREFIX | ' | ' | ' | ' | ' | ' |
| LITERAL_SUFFIX | ' | ' | ' | ' | ' | ' |
| CREATE_PARAMS | NULL | NULL | NULL | NULL | NULL | NULL |
| NULLABLE | SQL_NULLABLE | SQL_NULLABLE | SQL_NULLABLE | SQL_NULLABLE | SQL_NULLABLE | SQL_NULLABLE |
| CASE_SENSITIVE | SQL_FALSE | SQL_FALSE | SQL_FALSE | SQL_FALSE | SQL_FALSE | SQL_FALSE |
| POSSIBILITÉ DE RECHERCHE | SQL_PRED_SEARCHABLE | SQL_PRED_SEARCHABLE | SQL_PRED_SEARCHABLE | SQL_PRED_SEARCHABLE | SQL_PRED_SEARCHABLE | SQL_PRED_SEARCHABLE |
| UNSIGNED_ATTRIBUTE | NULL | NULL | NULL | NULL | NULL | NULL |
| FXED_PREC_SCALE | SQL_FALSE | SQL_FALSE | SQL_FALSE | SQL_FALSE | SQL_FALSE | SQL_FALSE |
| AUTO_UNIQUE_VALUE | NULL | NULL | NULL | NULL | NULL | NULL |
| LOCAL_TYPE_NAME | Date | time | smalldatetime | DATETIME | datetime2 | datetimeoffset |
| MINIMUM_SCALE | NULL | NULL | 0 | 3 | NULL | NULL |
| MAXIMUM_SCALE | NULL | NULL | 0 | 3 | NULL | NULL |
| SQL_DATA_TYPE | SQL_WVARCHAR | SQL_WVARCHAR | SQL_DATETIME | SQL_DATETIME | SQL_WVARCHAR | SQL_WVARCHAR |
| SQL_DATETIME_SUB | NULL | NULL | SQL_CODE_TIMESTAMP | SQL_CODE_TIMESTAMP | NULL | NULL |
| NUM_PREC_RADIX | NULL | NULL | NULL | NULL | NULL | NULL |
| INTERVAL_PRECISION | NULL | NULL | NULL | NULL | NULL | NULL |
| USERTYPE | 0 | 0 | 12 | 22 | 0 | 0 |
Comportement de serveur de bas niveau
Lorsqu’il est connecté à une instance de serveur d’une version antérieure que SQL Server 2008 (10.0.x), toute tentative d’utilisation des nouveaux types de serveurs ou des codes de métadonnées associés et des champs de descripteur entraîne le retour de SQL_ERROR. Un enregistrement de diagnostic sera généré avec SQLSTATE HY004 et le message « Type de données SQL non valide pour la version du serveur lors de la connexion », ou avec 07006 et « Violation de l'attribut de type de données restreint ».
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour