Supporto dei tipi di dati per i miglioramenti relativi a data e ora OLE DB
Si applica a:
SQL Server Azure SQL DatabaseIstanza gestita di SQL di Azure Azure SynapseAnalytics AnalyticsPlatform System (PDW)
Questo articolo offre informazioni sui tipi OLE DB (OLE DB Driver per SQL Server) che supportano i tipi di dati data/ora di SQL Server.
Mapping dei tipi di dati in set di righe e parametri
OLE DB fornisce due nuovi tipi di dati per supportare i nuovi tipi di server: DBTYPE_DBTIME2 e DBTYPE_DBTIMESTAMPOFFSET. Nella tabella seguente viene illustrato il mapping completo per il tipo di server:
| Tipo di dati di SQL Server | Tipo di dati OLE DB | valore |
|---|---|---|
| Datetime | DBTYPE_DBTIMESTAMP | 135 (oledb.h) |
| smalldatetime | DBTYPE_DBTIMESTAMP | 135 (oledb.h) |
| Data | DBTYPE_DBDATE | 133 (oledb.h) |
| time | DBTYPE_DBTIME2 | 145 (msoledbsql.h) |
| datetimeoffset | DBTYPE_DBTIMESTAMPOFFSET | 146 (msoledbsql.h) |
| datetime2 | DBTYPE_DBTIMESTAMP | 135 (oledb.h) |
Formati di dati: stringhe e valori letterali
| Tipo di dati di SQL Server | Tipo di dati OLE DB | Formato stringa per le conversioni client |
|---|---|---|
| Datetime | DBTYPE_DBTIMESTAMP | 'yyyy-mm-dd hh:mm:ss[.999]' SQL Server supporta fino a tre cifre per i secondi frazionari per datetime. |
| smalldatetime | DBTYPE_DBTIMESTAMP | 'yyyy-mm-dd hh:mm:ss' Questo tipo di dati ha un'accuratezza pari a un minuto. Il componente dei secondi sarà zero nell'output mentre verrà arrotondato dal server nell'input. |
| Data | DBTYPE_DBDATE | 'yyyy-mm-dd' |
| time | DBTYPE_DBTIME2 | 'hh:mm:ss[.9999999]' I secondi frazionari possono essere specificati facoltativamente utilizzando fino a sette cifre. |
| datetime2 | DBTYPE_DBTIMESTAMP | 'yyyy-mm-dd hh:mm:ss[.fffffff]' I secondi frazionari possono essere specificati facoltativamente utilizzando fino a sette cifre. |
| datetimeoffset | DBTYPE_DBTIMESTAMPOFFSET | 'yyyy-mm-dd hh:mm:ss[.fffffff] +/-hh:mm' I secondi frazionari possono essere specificati facoltativamente utilizzando fino a sette cifre. |
Non vi sono modifiche nelle sequenze di escape per i valori letterali di data/ora.
Per i secondi frazionari nei risultati viene utilizzato un punto (.) anziché i due punti (:).
I valori stringa restituiti alle applicazioni sono sempre della stessa lunghezza per una colonna specifica. Nei componenti per anno, mese, giorno, ora, minuti e secondi vengono aggiunti con zero iniziali per raggiungere la larghezza massima. Sarà presente esattamente uno spazio tra la data e l'ora ed esattamente uno spazio tra l'ora e la differenza di fuso orario. Una differenza di fuso orario sarà sempre preceduta da un segno. Il segno sarà un più (+) quando la differenza è zero. Non verrà aggiunto alcuno spazio vuoto tra il segno e il valore di differenza. Se necessario, nei secondi frazionari verranno aggiunti zero finali fino a raggiungere la precisione definita per la colonna, ma non oltre. Per le colonne di tipo datetime, verranno utilizzate tre cifre per i secondi frazionari. Per le colonne di tipo smalldatetime, non vi saranno cifre per i secondi frazionari e i secondi saranno sempre zero.
Le conversioni dai valori stringa forniti dall'applicazione saranno più flessibili e consentiranno la presenza di valori di componente minori della larghezza massima. Gli anni possono essere costituiti da una a quattro cifre. I mesi, i giorni, le ore, i minuti e i secondi possono essere costituiti da una o due cifre. Può essere presente uno spazio vuoto arbitrario tra le differenze data/ora e ora/fuso orario. Il segno utilizzato per una differenza con zero ore e zero minuti può essere un più o un meno. Gli zeri finali sono consentiti per i secondi frazionari fino a un massimo di 9 cifre. Un componente per le ore può terminare con un separatore decimale e senza cifre per i secondi frazionari.
Una stringa vuota non è un valore letterale di data/ora valido e non rappresenta un valore NULL. Un tentativo di convertire una stringa vuota in un valore di data/ora genererà errori con SQLState 22018 e il messaggio "Carattere non valido per la specifica del cast".
Formati di dati: strutture di dati
Nelle strutture specifiche di OLE DB descritte di seguito, a OLE DB si applicano i vincoli seguenti. Tali vincoli dipendono dal calendario gregoriano:
L'intervallo per i mesi è compreso tra 1 e 12.
L'intervallo per il campo del giorno è compreso tra 1 e il numero di giorni nel mese e deve essere coerente con i campi dell'anno e del mese, considerando gli anni bisestili.
L'intervallo delle ore è compreso tra 0 e 23.
L'intervallo dei minuti è compreso tra 0 e 59.
L'intervallo dei secondi è compreso tra 0 e 59, consentendo fino a due secondi di compensazione per mantenere la sincronizzazione con l'ora siderale.
Sono state modificate le implementazioni per le strutture OLE DB esistenti seguenti in modo da supportare i nuovi tipi di data e ora di SQL Server. Le definizioni, tuttavia, non sono state modificate.
DBTYPE_DATE (tipo DATE di automazione). È rappresentato internamente come un duplicato. L'intero indica il numero di giorni dal 30 dicembre 1899, mentre la parte frazionaria indica la frazione di un giorno. Questo tipo ha un'accuratezza di 1 secondo, quindi ha una scala efficace pari a 0.
DBTYPE_DBDATE
DBTYPE_DBTIME
DBTYPE_DBTIMESTAMP. Il campo della frazione è definito da OLE DB come numero di miliardesimi di secondo (nanosecondi) ed è incluso nell'intervallo compreso tra 0 e 999.999.999.
DBTYPE_FILETIME
DBTYPE_DBTIME2
In questa struttura è possibile aggiungere fino a 12 byte nei sistemi operativi a 32 bit e a 64 bit.
typedef struct tagDBTIME2 {
USHORT hour;
USHORT minute;
USHORT second;
ULONG fraction;
} DBTIME2;
DBTYPE_DBTIMESTAMPOFFSET
typedef struct tagDBTIMESTAMPOFFSET {
SHORT year;
USHORT month;
USHORT day;
USHORT hour;
USHORT minute;
USHORT second;
ULONG fraction;
SHORT timezone_hour;
SHORT timezone_minute;
} DBTIMESTAMPOFFSET;
Se timezone_hour è negativo, timezone_minute deve essere negativo o uguale a zero. Se timezone_hour è positivo, timezone minute deve essere positivo o uguale a zero. Se timezone_hour è zero, timezone minute può contenere un valore compreso tra -59 e +59.
SSVARIANT
Questa struttura include ora le nuove strutture DBTYPE_DBTIME2 e DBTYPE_DBTIMESTAMPOFFSET e viene aggiunta una scala di frazioni di secondo per i tipi appropriati.
struct SSVARIANT {
SSVARTYPE vt;
DWORD dwReserved1;
DWORD dwReserved2;
union {
// ...
DBTIMESTAMP tsDateTimeVal;
DBDATE dDateVal;
struct _Time2Val {
DBTIME2 tTime2Val;
BYTE bScale;
} Time2Val;
struct _DateTimeVal {
DBTIMESTAMP tsDateTimeVal;
BYTE bScale;
} DateTimeVal;
struct _DateTimeOffsetVal {
DBTIMESTAMPOFFSET tsoDateTimeOffsetVal;
BYTE bScale;
} DateTimeOffsetVal;
// ...
};
};
L'enumerazione associata alla codifica dei tipi SSVARIANT che determina il tipo dell'enumerazione, inoltre, verrà estesa nel modo seguente:
enum SQLVARENUM {
// ...
// Datetime
VT_SS_DATETIME = DBTYPE_DBTIMESTAMP,
VT_SS_SMALLDATETIME = 206,
VT_SS_DATE = DBTYPE_DBDATE,
VT_SS_TIME2 = DBTYPE_DBTIME2,
VT_SS_DATETIME2 = 212
VT_SS_DATETIMEOFFSET = DBTYPE_DBTIMESTAMPOFFSET
};
Le applicazioni che eseguono la migrazione a OLE DB Driver per SQL Server, che usano sql_variant e che si basano sulla precisione limitata di datetime dovranno essere aggiornate se lo schema sottostante è aggiornato per l'uso di datetime2 anziché di datetime.
Le macro di accesso per SSVARIANT sono state estese anche con l'aggiunta degli elementi seguenti:
#define V_SS_DATETIME2(X) V_SS_UNION(X, DateTimeVal)
#define V_SS_TIME2(X) V_SS_UNION(X, Time2Val)
#define V_SS_DATE(X) V_SS_UNION(X, dDateVal)
#define V_SS_DATETIMEOFFSET(X) V_SS_UNION(X, DateTimeOffsetVal)
Mapping dei tipi di dati in ITableDefinition::CreateTable
Il mapping dei tipi seguente viene usato con strutture DBCOLUMNDESC usate da ITableDefinition::CreateTable:
| Tipo di dati OLE DB (wType) | Tipo di dati di SQL Server | Note |
|---|---|---|
| DBTYPE_DBDATE | Data | |
| DBTYPE_DBTIMESTAMP | datetime2(p) | OLE DB Driver per SQL Server controlla il membro DBCOLUMDESC bScale per determinare la precisione in secondi frazionari. |
| DBTYPE_DBTIME2 | time(p) | OLE DB Driver per SQL Server controlla il membro DBCOLUMDESC bScale per determinare la precisione in secondi frazionari. |
| DBTYPE_DBTIMESTAMPOFFSET | datetimeoffset(p) | OLE DB Driver per SQL Server controlla il membro DBCOLUMDESC bScale per determinare la precisione in secondi frazionari. |
Quando un'applicazione specifica DBTYPE_DBTIMESTAMP in wType, può eseguire l'override del mapping a datetime2 specificando un nome del tipo in pwszTypeName. Se si specifica datetime, bScale deve essere 3. Se si specifica smalldatetime, bScale deve essere 0. Se bScale non è coerente con wType e pwszTypeName, viene restituito DB_E_BADSCALE.
Vedere anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per