Nuove funzionalità di data e ora con le versioni precedenti di SQL Server (OLE DB)
Si applica a:
SQL Server database SQL di Azure Istanza gestita di SQL di Azure azure Synapse Analytics Analytics Platform System (PDW)
Questo argomento descrive il comportamento previsto quando un'applicazione client che usa funzionalità avanzate di data e ora comunica con una versione di SQL Server precedente a SQL Server 2008 (10.0.x) e quando un client compilato con una versione di SQL Server Native Client precedente a SQL Server 2008 (10.0.x) invia comandi a un server che supporta funzionalità avanzate di data e ora.
Comportamento dei client legacy
Le applicazioni client che usano una versione di SQL Server Native Client precedenti a SQL Server 2008 (10.0.x) vedono i nuovi tipi di data/ora come colonne nvarchar . Il contenuto delle colonne è costituito da rappresentazioni letterali. Per altre informazioni, vedere la sezione "Formati di dati: stringhe e valori letterali" di Supporto dei tipi di dati per i miglioramenti di data e ora OLE DB. Le dimensioni di colonna corrispondono alla lunghezza massima in valori letterali per la precisione specificata per la colonna.
Le API del catalogo restituiscono metadati coerenti con il codice del tipo di dati di livello inferiore restituito al client (ad esempio, nvarchar) e la rappresentazione di livello inferiore associata (ad esempio, il formato letterale appropriato). Tuttavia, il nome del tipo di dati restituito sarà il nome del tipo reale di SQL Server 2008 (10.0.x).
Quando un'applicazione client di livello inferiore viene eseguita su un server SQL Server 2008 (10.0.x) (o versione successiva) in cui sono state apportate modifiche dello schema ai tipi di data/ora, il comportamento previsto è il seguente:
| Tipo di client OLE DB | Tipo di SQL Server 2005 | Tipo di SQL Server 2008 (o versioni successive) | Conversione risultati (da server a client) | Conversione parametri (da client a server) |
|---|---|---|---|---|
| DBTYPE_DBDATE | Datetime | Data | Ok | Ok |
| DBTYPE_DBTIMESTAMP | Campi dell'ora impostati su zero. | IRowsetChange avrà esito negativo a causa del troncamento della stringa se il campo time è diverso da zero. | ||
| DBTYPE_DBTIME | Time(0) | Ok | Ok | |
| DBTYPE_DBTIMESTAMP | Campi della data impostati sulla data corrente. | IRowsetChange avrà esito negativo a causa del troncamento delle stringhe se i secondi frazionari sono diversi da zero. La data viene ignorata. |
||
| DBTYPE_DBTIME | Time(7) | Errore: valore letterale ora non valido. | Ok | |
| DBTYPE_DBTIMESTAMP | Errore: valore letterale ora non valido. | Ok | ||
| DBTYPE_DBTIMESTAMP | Datetime2(3) | Ok | Ok | |
| DBTYPE_DBTIMESTAMP | Datetime2(7) | Ok | Ok | |
| DBTYPE_DBDATE | Smalldatetime | Data | Ok | Ok |
| DBTYPE_DBTIMESTAMP | Campi dell'ora impostati su zero. | IRowsetChange avrà esito negativo a causa del troncamento della stringa se il campo time è diverso da zero. | ||
| DBTYPE_DBTIME | Time(0) | Ok | Ok | |
| DBTYPE_DBTIMESTAMP | Campi della data impostati sulla data corrente. | IRowsetChange avrà esito negativo a causa del troncamento delle stringhe se i secondi frazionari sono diversi da zero. La data viene ignorata. |
||
| DBTYPE_DBTIMESTAMP | datetime2(0) | Ok | Ok |
OK significa che se ha funzionato con SQL Server 2005 (9.x), deve continuare a funzionare con SQL Server 2008 (10.0.x) (o versione successiva).
Sono state prese in considerazione solo le modifiche dello schema comuni indicate di seguito:
Utilizzo di un nuovo tipo nei casi in cui logicamente un'applicazione richiede solo un valore di data o di ora. Tuttavia, l'applicazione è stata costretta a usare datetime o smalldatetime perché non erano disponibili tipi di data e ora separati.
Utilizzo di un nuovo tipo per ottenere precisione o accuratezza maggiore nei secondi frazionari.
Passaggio a datetime2 perché si tratta del tipo di dati preferito per data e ora.
Le applicazioni che usano i metadati del server ottenuti tramite ICommandWithParameters::GetParameterInfo o set di righe dello schema per impostare le informazioni sul tipo di parametro tramite ICommandWithParameters::SetParameterInfo avranno esito negativo durante le conversioni client in cui la rappresentazione di stringa di un tipo di origine è maggiore della rappresentazione di stringa del tipo di destinazione. Ad esempio, se un'associazione client usa DBTYPE_DBTIMESTAMP e la colonna del server è data, SQL Server Native Client convertirà il valore in "a-gg-mm hh:mm:ss.fff", ma i metadati del server verranno restituiti come nvarchar(10). L'overflow risultante restituisce DBSTATUS_E_CATCONVERTVALUE. Problemi simili si verificano con le conversioni di dati da IRowsetChange, perché i metadati del set di righe vengono impostati dai metadati del set di risultati.
Metadati per parametri e set di righe
Questa sezione descrive i metadati per parametri, colonne dei risultati e set di righe dello schema per i client compilati con una versione di SQL Server Native Client precedente a SQL Server 2008 (10.0.x).
ICommandWithParameters::GetParameterInfo
La struttura DBPARAMINFO restituisce le informazioni seguenti tramite il parametro prgParamInfo :
| Tipo parametro | wType | ulParamSize | bPrecision | bScale |
|---|---|---|---|---|
| data | DBTYPE_WSTR | 10 | ~0 | ~0 |
| Ora | DBTYPE_WSTR | 8, 10..16 | ~0 | ~0 |
| smalldatetime | DBTYPE_DBTIMESTAMP | 16 | 16 | 0 |
| datetime | DBTYPE_DBTIMESTAMP | 16 | 23 | 3 |
| datetime2 | DBTYPE_WSTR | 19,21..27 | ~0 | ~0 |
| datetimeoffset | DBTYPE_WSTR | 26,28..34 | ~0 | ~0 |
Si noti che alcuni di questi intervalli di valori non sono continui. Nell'intervallo 8,10..16, ad esempio, non è presente il valore 9. Ciò è dovuto all'aggiunta di un separatore decimale quando la precisione frazionaria è maggiore di zero.
IColumnsRowset::GetColumnsRowset
Vengono restituite le colonne seguenti:
| Tipo di colonna | DBCOLUMN_TYPE | DBCOLUMN_COLUMNSIZE | DBCOLUMN_PRECISION | DBCOLUMN_SCALE, DBCOLUMN_DATETIMEPRECISION |
|---|---|---|---|---|
| data | DBTYPE_WSTR | 10 | NULL | NULL |
| Ora | DBTYPE_WSTR | 8, 10..16 | NULL | NULL |
| smalldatetime | DBTYPE_DBTIMESTAMP | 16 | 16 | 0 |
| datetime | DBTYPE_DBTIMESTAMP | 16 | 23 | 3 |
| datetime2 | DBTYPE_WSTR | 19,21..27 | NULL | NULL |
| datetimeoffset | DBTYPE_WSTR | 26,28..34 | NULL | NULL |
ColumnsInfo::GetColumnInfo
La struttura DBCOLUMNINFO restituisce le informazioni seguenti:
| Tipo di parametro | wType | ulColumnSize | bPrecision | bScale |
|---|---|---|---|---|
| data | DBTYPE_WSTR | 10 | ~0 | ~0 |
| time(1..7) | DBTYPE_WSTR | 8, 10..16 | ~0 | ~0 |
| smalldatetime | DBTYPE_DBTIMESTAMP | 16 | 16 | 0 |
| datetime | DBTYPE_DBTIMESTAMP | 16 | 23 | 3 |
| datetime2 | DBTYPE_WSTR | 19,21..27 | ~0 | ~0 |
| datetimeoffset | DBTYPE_WSTR | 26,28..34 | ~0 | ~0 |
Set di righe dello schema
In questa sezione vengono descritti i metadati per parametri, colonne dei risultati e set di righe dello schema per i nuovi tipi di dati. Queste informazioni sono utili perché si dispone di un provider client sviluppato usando strumenti precedenti a SQL Server 2008 (10.0.x) SQL Server Native Client.
Set di righe COLUMNS
Per i tipi di data/ora vengono restituiti i valori di colonna seguenti:
| Tipo di colonna | DATA_TYPE | CHARACTER_MAXIMUM_LENGTH | CHARACTER_OCTET_LENGTH | DATETIME_PRECISION |
|---|---|---|---|---|
| data | DBTYPE_WSTR | 10 | 20 | NULL |
| Ora | DBTYPE_WSTR | 8, 10..16 | 16,20..32 | NULL |
| smalldatetime | DBTYPE_DBTIMESTAMP | NULL | NULL | 0 |
| datetime | DBTYPE_DBTIMESTAMP | NULL | NULL | 3 |
| datetime2 | DBTYPE_WSTR | 19,21..27 | 38,42..54 | NULL |
| datetimeoffset | DBTYPE_WSTR | 26,28..34 | 52, 56..68 | NULL |
Set di righe PROCEDURE_PARAMETERS
Per i tipi di data/ora vengono restituiti i valori di colonna seguenti:
| Tipo di colonna | DATA_TYPE | CHARACTER_MAXIMUM_LENGTH | CHARACTER_OCTET_LENGTH | TYPE_NAME LOCAL_TYPE_NAME |
|---|---|---|---|---|
| data | DBTYPE_WSTR | 10 | 20 | data |
| Ora | DBTYPE_WSTR | 8, 10..16 | 16,20..32 | Ora |
| smalldatetime | DBTYPE_DBTIMESTAMP | NULL | NULL | smalldatetime |
| datetime | DBTYPE_DBTIMESTAMP | NULL | NULL | datetime |
| datetime2 | DBTYPE_WSTR | 19,21..27 | 38,42..54 | datetime2 |
| datetimeoffset | DBTYPE_WSTR | 26,28..34 | 52, 56..68 | datetimeoffset |
Set di righe PROVIDER_TYPES
Per i tipi di data/ora vengono restituite le righe seguenti:
| Tipo -> Colonna |
data | Ora | smalldatetime | datetime | datetime2 | datetimeoffset |
|---|---|---|---|---|---|---|
| TYPE_NAME | data | Ora | smalldatetime | datetime | datetime2 | datetimeoffset |
| DATA_TYPE | DBTYPE_WSTR | DBTYPE_WSTR | DBTYPE_DBTIMESTAMP | DBTYPE_DBTIMESTAMP | DBTYPE_WSTR | DBTYPE_WSTR |
| COLUMN_SIZE | 10 | 16 | 16 | 23 | 27 | 34 |
| LITERAL_PREFIX | ' | ' | ' | ' | ' | ' |
| LITERAL_SUFFIX | ' | ' | ' | ' | ' | ' |
| CREATE_PARAMS | NULL | NULL | NULL | NULL | NULL | NULL |
| IS_NULLABLE | VARIANT_TRUE | VARIANT_TRUE | VARIANT_TRUE | VARIANT_TRUE | VARIANT_TRUE | VARIANT_TRUE |
| CASE_SENSITIVE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE |
| RICERCABILE | DB_SEARCHABLE | DB_SEARCHABLE | DB_SEARCHABLE | DB_SEARCHABLE | DB_SEARCHABLE | DB_SEARCHABLE |
| UNSIGNED_ATTRIBUTE | NULL | NULL | NULL | NULL | NULL | NULL |
| FIXED_PREC_SCALE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE |
| AUTO_UNIQUE_VALUE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE |
| LOCAL_TYPE_NAME | data | Ora | smalldatetime | datetime | datetime2 | datetimeoffset |
| MINIMUM_SCALE | NULL | NULL | NULL | NULL | NULL | NULL |
| MAXIMUM_SCALE | NULL | NULL | NULL | NULL | NULL | NULL |
| GUID | NULL | NULL | NULL | NULL | NULL | NULL |
| TYPELIB | NULL | NULL | NULL | NULL | NULL | NULL |
| VERSION | NULL | NULL | NULL | NULL | NULL | NULL |
| IS_LONG | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE |
| BEST_MATCH | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_TRUE | VARIANT_FALSE | VARIANT_FALSE |
| IS_FIXEDLENGTH | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE | VARIANT_FALSE |
Comportamento dei server legacy
Quando si è connessi a un server di una versione precedente a SQL Server 2008 (10.0.x), qualsiasi tentativo di usare i nuovi nomi dei tipi di server (ad esempio, con ICommandWithParameters::SetParameterInfo o ITableDefinition::CreateTable) genererà DB_E_BADTYPENAME.
Se vengono associati nuovi tipi per parametri o risultati senza l'utilizzo di un nome del tipo e il nuovo tipo viene utilizzato per specificare in modo implicito il tipo di server o non è disponibile una conversione valida dal tipo di server al tipo di client, viene restituito DB_E_ERRORSOCCURRED e DBBINDSTATUS_UNSUPPORTED_CONVERSION viene impostato come stato dell'associazione per la funzione di accesso utilizzata in fase di esecuzione.
Se è disponibile una conversione client supportata dal tipo di buffer al tipo di server per la versione del server nella connessione, è possibile utilizzare tutti i tipi di buffer client. In questo contesto, il tipo di server indica il tipo specificato da ICommandWithParameters::SetParameterInfo o implicito dal tipo di buffer se ICommandWithParameters::SetParameterInfo non è stato chiamato. Di conseguenza, è possibile utilizzare DBTYPE_DBTIME2 e DBTYPE_DBTIMESTAMPOFFSET con i server legacy o quando DataTypeCompatibility=80, se la conversione client a un tipo di server supportato ha esito positivo. Se il tipo di server non è corretto, potrebbe essere segnalato un errore dal server se questo non è in grado di eseguire una conversione implicita al tipo di server effettivo.
Comportamento di SSPROP_INIT_DATATYPECOMPATIBILITY
Quando SSPROP_INIT_DATATYPECOMPATIBILITY è impostato su SSPROPVAL_DATATYPECOMPATIBILITY_SQL2000, i nuovi tipi di data/ora e i metadati associati appaiono ai client così come vengono visualizzati per i client di livello inferiore, come descritto in Modifiche alla copia bulk per i tipi di data e ora avanzati (OLE DB e ODBC).
Possibilità di confronto per IRowsetFind
Per i nuovi tipi di data/ora sono consentiti tutti gli operatori di confronto, in quanto vengono visualizzati come tipi stringa anziché come tipi di data/ora.
Vedi 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