Condividi tramite

  • Articolo

Utilizzo di tipi di dati XML

In SQL Server 2005 è stato introdotto il tipo di dati xml, che consente di archiviare documenti e frammenti XML in un database di SQL Server. Il tipo di dati xml è un tipo di dati predefinito di SQL Server ed è simile per alcuni aspetti ad altri tipi predefiniti, quali int e varchar. Come per gli altri tipi predefiniti, è possibile utilizzare il tipo di dati xml come tipo di colonna quando si crea una tabella, come tipo di variabile, tipo di parametro o tipo restituito dalla funzione oppure in funzioni CAST e CONVERT.

Considerazioni sulla programmazione

XML può essere autodescrittivo in quanto può eventualmente includere un'intestazione XML che specifica la codifica del documento, ad esempio:

<?xml version="1.0" encoding="windows-1252"?><doc/>

Lo standard XML descrive il modo in cui un processore XML può rilevare la codifica utilizzata per un documento esaminando i primi byte del documento. È possibile che la codifica specificata nell'applicazione crei conflitti con quella specificata nel documento. Poiché per i documenti passati come parametri associati i dati XML vengono considerati dati binari in SQL Server, non viene eseguita alcuna conversione e il parser XML può utilizzare senza problemi la codifica specificata nel documento. Per i dati XML associati come WSTR, tuttavia, l'applicazione deve quindi garantire che il documento venga codificato come Unicode. Ciò può comportare il caricamento del documento in un modello DOM, impostando la codifica su Unicode e serializzando il documento. In caso contrario, possono verificarsi conversioni dei dati che producono dati XML non validi o danneggiati.

Vi è inoltre il rischio di conflitti quando XML viene specificato in valori letterali. I dati seguenti, ad esempio, non sono validi:

INSERT INTO xmltable(xmlcol) VALUES('<?xml version="1.0" encoding="UTF-16"?><doc/>')

INSERT INTO xmltable(xmlcol) VALUES(N'<?xml version="1.0" encoding="UTF-8"?><doc/>')

Provider OLE DB per SQL Server Native Client

DBTYPE_XML è un nuovo tipo di dati specifico di XML nel provider OLE DB per SQL Server Native Client. È inoltre possibile accedere ai dati XML tramite i tipi OLE DB esistenti DBTYPE_BYTES, DBTYPE_WSTR, DBTYPE_BSTR, DBTYPE_XML, DBTYPE_STR, DBTYPE_VARIANT e DBTYPE_IUNKNOWN. I dati archiviati in colonne di tipo XML possono essere recuperati da una colonna in un set di righe del provider OLE DB per SQL Server Native Client nei formati seguenti:

  • Stringa di testo

  • ISequentialStream

[!NOTA]

Il provider OLE DB per SQL Server Native Client non include un lettore SAX, ma l'interfaccia ISequentialStream può essere passata in modo semplice a oggetti SAX e DOM in MSXML.

Per il recupero di documenti XML di dimensioni elevate, è necessario utilizzare ISequentialStream. A XML si applicano le stesse tecniche utilizzate per altri tipi di valore di grandi dimensioni. Per ulteriori informazioni, vedere Utilizzo di tipi di dati per valori di grandi dimensioni.

I dati in colonne di tipo XML in un set di righe possono inoltre essere recuperati, inseriti o aggiornati da un'applicazione tramite le normali interfacce, ad esempio IRow::GetColumns, IRowChange::SetColumns e ICommand::Execute. Analogamente al caso del recupero, un'applicazione può passare una stringa di testo o un'interfaccia ISequentialStream al provider OLE DB per SQL Server Native Client.

[!NOTA]

Per inviare dati XML in formato stringa tramite l'interfaccia ISequentialStream, è necessario ottenere ISequentialStream specificando DBTYPE_IUNKNOWN e impostare il relativo argomento pObject su Null nell'associazione.

Quando i dati XML recuperati risultano troncati a causa di un buffer del consumer di dimensioni troppo ridotte, è possibile che la lunghezza venga restituita come 0xffffffff, a indicare che non è nota. Questo comportamento è coerente con l'implementazione come tipo di dati trasmesso al client senza inviare informazioni sulla lunghezza dei dati effettivi. In alcuni casi è possibile che venga restituita la lunghezza effettiva quando il provider ha memorizzato nel buffer il valore intero, ad esempio IRowset::GetData, e laddove venga eseguita la conversione dei dati.

I dati XML inviati a SQL Server vengono considerati dati binari dal server. In questo modo viene impedito il verificarsi di qualsiasi conversione e il parser XML può rilevare automaticamente la codifica XML. Di conseguenza, una più ampia gamma di documenti XML, ad esempio quelli codificati in UTF-8, viene accettata come input in SQL Server.

Se i dati XML di input vengono associati come DBTYPE_WSTR, l'applicazione deve verificare che i dati siano già codificati come Unicode per evitare qualsiasi rischio di danni dovuti a conversioni di dati indesiderate.

Associazione di dati e coercizioni

Nella tabella seguente vengono descritte l'associazione e la coercizione che si verificano quando si utilizzano i tipi di dati elencati con il tipo xml di SQL Server.

Tipo di dati

Al server

XML

Al server

non XML

Dal server

XML

Dal server

non XML

DBTYPE_XML

Pass-through6,7

Errore1

OK11,6

Errore8

DBTYPE_BYTES

Pass-through6,7

N/D2

OK11,6

N/D2

DBTYPE_WSTR

Pass-through6,10

N/D2

OK4,6,12

N/D2

DBTYPE_BSTR

Pass-through6,10

N/D2

OK 3

N/D2

DBTYPE_STR

OK6,9,10

N/D2

OK5,6,12

N/D2

DBTYPE_IUNKNOWN

Flusso di byte tramite ISequentialStream7

N/D2

Flusso di byte tramite ISequentialStream11

N/D2

DBTYPE_VARIANT (VT_UI1 | VT_ARRAY)

Pass-through6,7

N/D2

N/D

N/D2

DBTYPE_VARIANT (VT_BSTR)

Pass-through6,10

N/D2

OK3

N/D2

1 Se un tipo di server diverso da DBTYPE_XML è specificato con ICommandWithParameters::SetParameterInfo e il tipo di funzione di accesso è DBTYPE_XML, si verifica un errore quando viene eseguita l'istruzione (DB_E_ERRORSOCCURRED, lo stato del parametro è DBSTATUS_E_BADACCESSOR). In caso contrario, i dati vengono inviati al server, ma il server restituisce un errore indicante che non è disponibile alcuna conversione implicita da XML al tipo di dati del parametro.

2 Esula dall'ambito di questo argomento.

3 Il formato è UTF-16, nessun indicatore dell'ordine dei byte, nessuna specifica di codifica, nessuna terminazione Null.

4Il formato è UTF-16, nessun indicatore dell'ordine dei byte, nessuna specifica di codifica, terminazione Null.

5 Il formato è caratteri multibyte codificati nella tabella codici del client con terminatore Null. Poiché la conversione dal formato Unicode fornito dal server può provocare danni ai dati, questa associazione è sconsigliata.

6 È possibile utilizzare BY_REF.

7 I dati UTF-16 devono iniziare con un indicatore dell'ordine dei byte. In caso contrario, la codifica potrebbe non essere riconosciuta correttamente dal server.

8 La convalida può verificarsi in fase di creazione della funzione di accesso o in fase di recupero. L'errore è DB_E_ERRORSOCCURRED, lo stato dell'associazione è impostato su DBBINDSTATUS_UNSUPPORTEDCONVERSION.

9 I dati vengono convertiti in Unicode utilizzando la tabella codici del client prima di inviarli al server. Se la codifica del documento non corrisponde alla tabella codici del client, i dati possono risultare danneggiati e, pertanto, questa associazione è fortemente sconsigliata.

10 Ai dati inviati al server viene sempre aggiunto un indicatore dell'ordine dei byte. Se i dati iniziano già con un indicatore dell'ordine dei byte, saranno presenti due indicatori dell'ordine dei byte all'inizio del buffer. Il server utilizza il primo indicatore dell'ordine dei byte per riconoscere la codifica come UTF-16, quindi lo ignora. Il secondo indicatore dell'ordine dei byte viene interpretato come spazio unificatore a larghezza zero.

11 Il formato è UTF-16, nessuna specifica di codifica, indicatore dell'ordine dei byte aggiunto ai dati ricevuti dal server. Se dal server viene restituita una stringa vuota, all'applicazione viene comunque restituito un indicatore dell'ordine dei byte. Se la lunghezza di buffer è un numero dispari di byte, i dati vengono troncati correttamente. Se il valore intero viene restituito in blocchi, questi possono essere concatenati per ricostituire il valore corretto.

12 Se la lunghezza di buffer è minore di due caratteri, ovvero non vi è spazio sufficiente per la terminazione Null, viene segnalato un errore di overflow.

[!NOTA]

Per i valori XML NULL non viene restituito alcun dato.

Lo standard XML richiede che i dati XML con codifica UTF-16 inizino con un indicatore dell'ordine dei byte, codice di carattere UTF-16 0xFEFF. Quando si utilizzano associazioni WSTR e BSTR, in SQL Server Native Client non è necessario né viene aggiunto un indicatore dell'ordine dei byte, in quanto la codifica viene definita in modo implicito dall'associazione. Quando si utilizzano associazioni BYTES, XML o IUNKNOWN, lo scopo è semplicità di gestione di altri processori XML e sistemi di archiviazione. In questo caso, con i dati XML con codifica UTF-16 deve essere presente un indicatore dell'ordine dei byte e l'applicazione non deve considerare l'effettiva codifica, in quando la maggior parte dei processori XML, incluso SQL Server, deduce la codifica controllando i primi byte del valore. I dati XML ricevuti da SQL Server Native Client utilizzando associazioni BYTES, XML o IUNKNOWN sono sempre codificati in UTF-16 con un indicatore dell'ordine dei byte e senza una dichiarazione di codifica incorporata.

Le conversioni dei dati fornite dai servizi OLE DB (IDataConvert) principali non sono applicabili a DBTYPE_XML.

La convalida viene eseguita durante l'invio dei dati al server. Le modifiche di convalida e di codifica sul lato client devono essere gestite dall'applicazione ed è consigliabile non elaborare i dati XML direttamente, ma utilizzare invece un indicatore dell'ordine dei byte o un lettore SAX per elaborarli.

DBTYPE_NULL e DBTYPE_EMPTY possono essere associati per i parametri di input ma non per i parametri di output o per i risultati. Se vengono associati per i parametri di input, lo stato deve essere impostato su DBSTATUS_S_ISNULL o DBSTATUS_S_DEFAULT.

DBTYPE_XML può essere convertito in DBTYPE_EMPTY e DBTYPE_NULL, DBTYPE_EMPTY può essere convertito in DBTYPE_XML, ma DBTYPE_NULL non può essere convertito in DBTYPE_XML. Questo comportamento è coerente con DBTYPE_WSTR.

Come illustrato nella tabella precedente, DBTYPE_IUNKNOWN è un'associazione supportata, ma non è disponibile alcuna conversione tra DBTYPE_XML e DBTYPE_IUNKNOWN. DBTYPE_IUNKNOWN non può essere utilizzato con DBTYPE_BYREF.

Aggiunte e modifiche nei set di righe OLE DB

In SQL Server Native Client sono stati aggiunti nuovi valori o modifiche a molti dei set di righe dello schema OLE DB principali.

Set di righe dello schema COLUMNS e PROCEDURE_PARAMETERS

Tra le aggiunte ai set di righe dello schema COLUMNS e PROCEDURE_PARAMETERS sono incluse le colonne seguenti.

Nome colonna

Tipo

Descrizione

SS_XML_SCHEMACOLLECTION_CATALOGNAME

DBTYPE_WSTR

Nome di un catalogo in cui viene definita una raccolta di schemi XML. NULL per una colonna non XML o una colonna XML non tipizzata.

SS_XML_SCHEMACOLLECTION_SCHEMANAME

DBTYPE_WSTR

Nome di uno schema in cui viene definita una raccolta di schemi XML. NULL per una colonna non XML o una colonna XML non tipizzata.

SS_XML_SCHEMACOLLECTIONNAME

DBTYPE_WSTR

Nome della raccolta di schemi XML. NULL per una colonna non XML o una colonna XML non tipizzata.

Set di righe dello schema PROVIDER_TYPES

Nel set di righe dello schema PROVIDER_TYPES il valore di COLUMN_SIZE è 0 per il tipo di dati xml e DATA_TYPE è DBTYPE_XML.

Set di righe dello schema SS_XMLSCHEMA

È stato introdotto un nuovo set di righe dello schema per i client, denominato SS_XMLSCHEMA, che consente il recupero di informazioni sullo schema XML. Il set di righe SS_XMLSCHEMA contiene le colonne seguenti.

Nome colonna

Tipo

Descrizione

SCHEMACOLLECTION_CATALOGNAME

DBTYPE_WSTR

Catalogo cui appartiene una raccolta XML.

SCHEMACOLLECTION_SCHEMANAME

DBTYPE_WSTR

Schema cui appartiene una raccolta XML.

SCHEMACOLLECTIONNAME

DBTYPE_WSTR

Nome di una raccolta di schemi XML per colonne XML tipizzate. In caso contrario, NULL.

TARGETNAMESPACEURI

DBTYPE_WSTR

Spazio dei nomi di destinazione di uno schema XML.

SCHEMACONTENT

DBTYPE_WSTR

Contenuto dello schema XML.

L'ambito di ogni schema XML è costituito da nome del catalogo, nome dello schema, nome della raccolta di schemi e URI dello spazio dei nomi di destinazione. Viene inoltre definito un nuovo GUID con il nome DBSCHEMA_XML_COLLECTIONS. Il numero di restrizioni e di colonne limitate per il set di righe dello schema SS_XMLSCHEMA viene definito come segue.

GUID

Numero di restrizioni

Colonne limitate

DBSCHEMA_XML_COLLECTIONS

4

SCHEMACOLLECTION_CATALOGNAME

SCHEMACOLLECTION_SCHEMANAME

SCHEMACOLLECTIONNAME

TARGETNAMESPACEURI

Aggiunte e modifiche nei set di proprietà OLE DB

In SQL Server Native Client sono stati aggiunti nuovi valori o modifiche a molti dei set di proprietà OLE DB principali.

Set di proprietà DBPROPSET_SQLSERVERPARAMETER

Ai fini del supporto del tipo di dati xml tramite OLE DB, in SQL Server Native Client è stato implementato il nuovo set di proprietà DBPROPSET_SQLSERVERPARAMETER, che contiene i valori seguenti.

Nome

Tipo

Descrizione

SSPROP_PARAM_XML_SCHEMACOLLECTION_CATALOGNAME

DBTYPE_WSTR

Nome di un catalogo (database) in cui viene definita una raccolta di schemi XML. Una delle tre parti di cui è composto l'identificatore del nome SQL.

SSPROP_PARAM_XML_SCHEMACOLLECTION_SCHEMANAME

DBTYPE_WSTR

Nome di uno schema XML all'interno della raccolta di schemi. Una delle tre parti di cui è composto l'identificatore del nome SQL.

SSPROP_PARAM_XML_SCHEMACOLLECTIONNAME

DBTYPE_WSTR

Nome della raccolta di schemi XML all'interno del catalogo. Una delle tre parti di cui è composto l'identificatore del nome SQL.

Set di proprietà DBPROPSET_SQLSERVERCOLUMN

Ai fini del supporto della creazione di tabelle nell'interfaccia ITableDefinition, in SQL Server Native Client sono state aggiunte tre nuove colonne al set di proprietà DBPROPSET_SQLSERVERCOLUMN.

Nome

Tipo

Descrizione

SSPROP_COL_XML_SCHEMACOLLECTION_CATALOGNAME

VT_BSTR

Per le colonne XML tipizzate, questa proprietà è una stringa che specifica il nome del catalogo in cui viene archiviato lo schema XML. Per gli altri tipi di colonna questa proprietà restituisce una stringa vuota.

SSPROP_COL_XML_SCHEMACOLLECTION_SCHEMANAME

VT_BSTR

Per le colonne XML tipizzate, questa proprietà è una stringa che specifica il nome dello schema XML che definisce la colonna.

SSPROP_COL_XML_SCHEMACOLLECTIONNAME

VT_BSTR

Per le colonne XML tipizzate, questa proprietà è una stringa che specifica il nome della raccolta di schemi XML che definisce il valore.

Analogamente ai valori di SSPROP_PARAM, tutte queste proprietà sono facoltative e non sono specificate per impostazione predefinita. SSPROP_COL_XML_SCHEMACOLLECTION_CATALOGNAME e SSPROP_COL_XML_SCHEMACOLLECTION_SCHEMANAME possono essere specificate solo se si specifica SSPROP_COL_XML_SCHEMACOLLECTIONNAME. Se quando si passano dati XML al server questi valori sono inclusi, ne viene verificata l'esistenza (validità) rispetto al database corrente e i dati dell'istanza vengono controllati rispetto allo schema. In tutti i casi, per essere validi tali valori devono essere tutti vuoti o specificati.

Aggiunte e modifiche nell'interfaccia OLE DB

In SQL Server Native Client sono stati aggiunti nuovi valori o modifiche a molte delle interfacce OLE DB principali.

Interfaccia ISSCommandWithParameters

Ai fini del supporto del tipo di dati xml tramite OLE DB, in SQL Server Native Client sono state implementate alcune modifiche, ad esempio l'aggiunta dell'interfaccia ISSCommandWithParameters. Questa nuova interfaccia eredita dall'interfaccia OLE DB ICommandWithParameters principale. Oltre ai tre metodi ereditati da ICommandWithParameters, ovvero GetParameterInfo, MapParameterNames e SetParameterInfo, ISSCommandWithParameters fornisce i metodi GetParameterProperties e SetParameterProperties utilizzati per gestire i tipi di dati specifici del server.

[!NOTA]

L'interfaccia ISSCommandWithParameters utilizza inoltre la nuova struttura SSPARAMPROPS.

Interfaccia IColumnsRowset

In SQL Server Native Client sono state aggiunte le colonne specifiche di SQL Server seguenti al set di righe restituito dal metodo IColumnRowset::GetColumnsRowset. Tali colonne contengono il nome in tre parti di una raccolta di schemi XML. Per le colonne non XML o per le colonne XML non tipizzate, le tre colonne assumono tutte il valore predefinito NULL.

Nome colonna

Tipo

Descrizione

DBCOLUMN_SS_XML_SCHEMACOLLECTION_CATALOGNAME

DBTYPE_WSTR

Catalogo cui appartiene una raccolta di schemi XML.

In caso contrario, NULL.

DBCOLUMN_SS_XML_SCHEMACOLLECTION_SCHEMANAME

DBTYPE_WSTR

Schema cui appartiene una raccolta di schemi XML. In caso contrario, NULL.

DBCOLUMN_SS_XML_SCHEMACOLLECTIONNAME

DBTYPE_WSTR

Nome della raccolta di schemi XML per le colonne XML tipizzate. In caso contrario, NULL.

Interfaccia IRowset

Un'istanza XML in una colonna XML viene recuperata tramite il metodo IRowset::GetData. A seconda dell'associazione specificata dal client, un'istanza XML può essere recuperata come DBTYPE_BSTR, DBTYPE_WSTR DBTYPE_VARIANT, DBTYPE_XML, DBTYPE_STR, DBTYPE_BYTES o come interfaccia tramite DBTYPE_IUNKNOWN. Se il consumer specifica DBTYPE_BSTR, DBTYPE_WSTR o DBTYPE_VARIANT, il provider converte l'istanza XML nel tipo richiesto dall'utente e la archivia nella posizione specificata nell'associazione corrispondente.

Se il consumer specifica DBTYPE_IUNKNOWN e imposta l'argomento pObject su NULL oppure imposta l'argomento pObject su IID_ISequentialStream, il provider restituisce un'interfaccia ISequentialStream all'utente in modo che questi possa eseguire il flusso dei dati XML all'esterno della colonna. ISequentialStream restituisce quindi i dati XML come flusso di caratteri Unicode.

Quando viene restituito un valore XML associato a DBTYPE_IUNKNOWN, il provider segnala un valore di dimensioni sizeof (IUnknown *). Si noti che questo comportamento è coerente con l'approccio adottato quando una colonna è associata come DBTYPE_IUnknown o DBTYPE_IDISPATCH, e tramite DBTYPE_IUNKNOWN/ISequentialStream quando non è possibile determinare con esattezza le dimensioni della colonna.

Interfaccia IRowsetChange

Il consumer può aggiornare un'istanza XML in una colonna utilizzando due modalità diverse. La prima consiste nell'utilizzare l'oggetto ISequentialStream creato dal provider. Il consumer può chiamare il metodo ISequentialStream::Write per aggiornare direttamente l'istanza XML restituita dal provider.

Il secondo approccio consiste nell'utilizzare il metodo IRowsetChange::SetData o IRowsetChange::InsertRow. In questo approccio è possibile specificare un'istanza XML nel buffer del consumer in un'associazione di tipo DBTYPE_BSTR, DBTYPE_WSTR, DBTYPE_VARIANT, DBTYPE_XML o DBTYPE_IUNKNOWN.

Se si utilizza il tipo DBTYPE_BSTR, DBTYPE_WSTR o DBTYPE_VARIANT, il provider archivia l'istanza XML che si trova nel buffer del consumer nella colonna appropriata.

Se si utilizza DBTYPE_IUNKNOWN/ISequentialStream e il consumer non specifica alcun oggetto di archiviazione, il consumer deve creare un oggetto ISequentialStream in anticipo, associare il documento XML all'oggetto, quindi passare l'oggetto al provider tramite il metodo IRowsetChange::SetData. Il consumer può creare inoltre un oggetto di archiviazione, impostare l'argomento pObject su IID_ISequentialStream, creare un oggetto ISequentialStream, quindi passare l'oggetto ISequentialStream al metodo IRowsetChange::SetData. In entrambi casi, il provider può recuperare l'oggetto XML tramite l'oggetto ISequentialStream e può inserirlo in una colonna appropriata.

Interfaccia IRowsetUpdate

L'interfaccia IRowsetUpdate fornisce una funzionalità per aggiornamenti ritardati. I dati resi disponibili per i set di righe non vengono resi disponibili per le altre transazioni fino a quando il consumer non chiama il metodo IRowsetUpdate:Update.

Interfaccia IRowsetFind

Non è possibile utilizzare il metodo IRowsetFind::FindNextRow con il tipo di dati xml. Quando IRowsetFind::FindNextRow viene chiamato e l'argomento hAccessor specifica una colonna di tipo DBTYPE_XML, viene restituito DB_E_BADBINDINFO. Ciò si verifica indipendentemente dal tipo di colonna di cui si esegue la ricerca. Per qualsiasi altro tipo di associazione, FindNextRow ha esito negativo con DB_E_BADCOMPAREOP se la colonna da cercare è del tipo di dati xml.

Driver ODBC di SQL Server Native Client

Nel driver ODBC di SQL Server Native Client è stata apportata una serie di modifiche a diverse funzioni per supportare il tipo di dati xml.

SQLColAttribute

La funzione SQLColAttribute include tre nuovi identificatori del campo, ovvero SQL_CA_SS_XML_SCHEMACOLLECTION_CATALOG_NAME, SQL_CA_SS_XML_SCHEMACOLLECTION_SCHEMA_NAME e SQL_CA_SS_XML_SCHEMACOLLECTION_NAME.

Il driver ODBC di SQL Server Native Client specifica SQL_SS_LENGTH_UNLIMITED per le colonne SQL_DESC_DISPLAY_SIZE e SQL_DESC_LENGTH.

SQLColumns

La funzione SQLColumns include tre nuove colonne, ovvero SS_XML_SCHEMACOLLECTION_CATALOG_NAME, SS_XML_SCHEMACOLLECTION_SCHEMA_NAME e SS_XML_SCHEMACOLLECTION_NAME. La colonna TYPE_NAME esistente viene utilizzata per indicare il nome del tipo XML e DATA_TYPE per una colonna o un parametro di tipo XML è SQL_SS_XML.

Il driver ODBC di SQL Server Native Client specifica SQL_SS_LENGTH_UNLIMITED per i valori di COLUMN_SIZE e CHAR_OCTET_LENGTH.

SQLDescribeCol

Il driver ODBC di SQL Server Native Client specifica SQL_SS_LENGTH_UNLIMITED quando non è possibile determinare le dimensioni di colonna nella funzione SQLDescribeCol.

SQLGetTypeInfo

Il driver ODBC di SQL Server Native Client ODBC specifica SQL_SS_LENGTH_UNLIMITED come valore massimo di COLUMN_SIZE per il tipo di dati xml nella funzione SQLGetTypeInfo.

SQLProcedureColumns

La funzione SQLProcedureColumns include le stesse aggiunte alle colonne della funzione SQLColumns.

Il driver ODBC di SQL Server Native Client specifica SQL_SS_LENGTH_UNLIMITED come valore massimo di COLUMN_SIZE per il tipo di dati xml.

Conversioni supportate

Quando si esegue una conversione dai tipi di dati SQL ai tipi di dati C, SQL_C_WCHAR, SQL_C_BINARY e SQL_C_CHAR possono essere convertiti tutti in SQL_SS_XML alle condizioni seguenti:

  • SQL_C_WCHAR: il formato è UTF-16, nessun indicatore dell'ordine dei byte, con terminazione Null.

  • SQL_C_BINARY: il formato è UTF-16, senza alcuna terminazione Null. Ai dati ricevuti dal server viene aggiunto un indicatore dell'ordine dei byte. Se dal server viene restituita una stringa vuota, all'applicazione viene comunque restituito un indicatore dell'ordine dei byte. Se la lunghezza di buffer è un numero dispari di byte, i dati vengono troncati correttamente. Se il valore intero viene restituito in blocchi, questi possono essere concatenati per ricostituire il valore corretto.

  • SQL_C_CHAR: il formato è caratteri multibyte codificati nella tabella codici del client con terminazione Null. Poiché la conversione dal formato UTF-16 fornito dal server può provocare danni ai dati, questa associazione è sconsigliata.

Quando si esegue una conversione dai tipi di dati V ai tipi di dati SQL, SQL_C_WCHAR, SQL_C_BINARY e SQL_C_CHAR possono essere convertiti tutti in SQL_SS_XML alle condizioni seguenti:

  • SQL_C_WCHAR: ai dati inviati al server viene sempre aggiunto un indicatore dell'ordine dei byte. Se i dati iniziano già con un indicatore dell'ordine dei byte, saranno presenti due indicatori dell'ordine dei byte all'inizio del buffer. Il server utilizza il primo indicatore dell'ordine dei byte per riconoscere la codifica come UTF-16, quindi lo ignora. Il secondo indicatore dell'ordine dei byte viene interpretato come spazio unificatore di larghezza zero.

  • SQL_C_BINARY: non viene eseguita alcuna conversione e i dati vengono passati al server come invariati. I dati UTF-16 devono iniziare con un indicatore dell'ordine dei byte. In caso contrario, la codifica potrebbe non essere riconosciuta correttamente dal server.

  • SQL_C_CHAR: i dati vengono convertiti in UTF-16 nel client e inviati al server solo come SQL_C_WCHAR, aggiungendo un indicatore dell'ordine dei byte. La mancata codifica dei dati XML nella tabella codici del client può provocare danni ai dati.

Lo standard XML richiede che i dati XML con codifica UTF-16 inizino con un indicatore dell'ordine dei byte, codice di carattere UTF-16 0xFEFF. Quando si utilizza un'associazione SQL_C_BINARY, in SQL Server Native Client non è necessario né viene aggiunto un indicatore dell'ordine dei byte, in quanto la codifica viene definita in modo implicito dall'associazione. Lo scopo consiste nel fornire semplicità di gestione con altri elaboratori XML e sistemi dell'archiviazione. In questo caso, con i dati XML con codifica UTF-16 deve essere presente un indicatore dell'ordine dei byte e l'applicazione non deve considerare l'effettiva codifica, in quando la maggior parte dei processori XML, incluso SQL Server, deduce la codifica controllando i primi byte del valore. I dati XML ricevuti da SQL Server Native Client e che utilizzando associazioni SQL_C_BINARY sono codificati sempre in UTF-16 con un indicatore dell'ordine dei byte e senza una dichiarazione di codifica incorporata.