Supporto dei tipi di dati per i miglioramenti dei tipi di data/ora OLE DB
In questo argomento vengono fornite informazioni sui tipi OLE DB (SQL Server Native Client) che supportano i tipi di dati di 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 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) |
ora |
DBTYPE_DBTIME2 |
145 (sqlncli.h) |
datetimeoffset |
DBTYPE_DBTIMESTAMPOFFSET |
146 (sqlncli.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 di 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 gli stessi vincoli di ODBC. 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 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. Si tratta di un tipo DATE di automazione. Viene rappresentato internamente come double. La parte intera corrisponde al numero di giorni a partire dal 30 dicembre 1899, mentre la parte frazionaria rappresenta una frazione del giorno. Poiché questo tipo ha un'accuratezza di 1 secondo, dispone di una scala effettiva 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 SQL Server Native Client, che utilizzano sql_variant e che si basano sulla precisione limitata di datetime dovranno essere aggiornate se lo schema sottostante è aggiornato per l'utilizzo 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 utilizzato con strutture DBCOLUMNDESC utilizzate da ITableDefinition::CreateTable:
Tipo di dati OLE DB (wType) |
Tipo di dati SQL Server |
Note |
|---|---|---|
DBTYPE_DBDATE |
data |
|
DBTYPE_DBTIMESTAMP |
datetime2(p) |
Il provider OLE DB di SQL Server Native Client controlla il membro DBCOLUMDESC bScale per determinare la precisione frazionaria dei secondi. |
DBTYPE_DBTIME2 |
time(p) |
Il provider OLE DB di SQL Server Native Client controlla il membro DBCOLUMDESC bScale per determinare la precisione frazionaria dei secondi. |
DBTYPE_DBTIMESTAMPOFFSET |
datetimeoffset(p) |
Il provider OLE DB di SQL Server Native Client controlla il membro DBCOLUMDESC bScale per determinare la precisione frazionaria dei secondi. |
Quando un'applicazione specifica DBTYPE_DBTIMESTAMP in wType, può eseguire l'override del mapping a datetime2 fornendo 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.