Articolo
09/28/2010

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 di SQL Server	Tipo di dati OLE DB	Valore
datetime	DBTYPE_DBTIMESTAMP	135 (oledb.h)
smalldatetime	DBTYPE_DBTIMESTAMP	135 (oledb.h)
date	DBTYPE_DBDATE	133 (oledb.h)
time	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.
date	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.

In SQL Server 2008 non è stata apportata alcuna nuova modifica alle sequenze di escape per i valori letterali di data/ora.

I secondi frazionari nei risultati utilizzano un punto (.) anziché 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

Questa struttura è nuova in SQL Server 2008 e possono esservi aggiunti 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

Questa struttura è nuova in SQL Server 2008:

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 è stata modificata in SQL Server 2008 per includere le nuove strutture DBTYPE_DBTIME2 e DBTYPE_ DBTIMESTAMPOFFSET e per aggiungere 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 2008, 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 di SQL Server	Note
DBTYPE_DBDATE	date
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.

Vedere anche

Concetti

Miglioramenti relativi a data e ora (OLE DB)

Condividi tramite