Share via

Utilizzo di tipi di dati XML

  • Articolo

Si applica a: SQL Server Azure SQL DatabaseIstanza gestita di SQL di AzureAzure Synapse Analytics AnalyticsPlatform System (PDW)

Scaricare il driver OLE DB

In SQL Server 2005 (9.x) è 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, è simile per alcuni aspetti ad altri tipi predefiniti, quali int e varchar. Come per gli altri tipi predefiniti, è possibile usare 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ò usare 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. Questo scenario può comportare il caricamento del documento in un modello DOM, impostando la codifica su Unicode e serializzando il documento. Se questo passaggio non viene eseguito, 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/>')

Driver OLE DB per SQL Server

DBTYPE_XML è un nuovo tipo di dati specifico di XML in OLE DB Driver per SQL Server. È 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 driver OLE DB per SQL Server nei formati seguenti:

  • Stringa di testo

  • ISequentialStream

Nota

Il driver OLE DB per SQL Server 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 usare ISequentialStream. A XML si applicano le stesse tecniche utilizzate per altri tipi di valore di grandi dimensioni. Per altre informazioni, vedere la sezione Uso di tipi valore 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 driver OLE DB per SQL Server.

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. Questo comportamento impedisce il verificarsi di qualsiasi conversione e consente al parser XML di 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 dati e coercizioni

Nella tabella seguente vengono descritte l'associazione e la coercizione che si verificano quando si usano i tipi di dati elencati con il tipo di dati 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 OK 11, 6 N/D 2
DBTYPE_WSTR Pass-through6,10 N/D 2 OK4, 6, 12 N/D 2
DBTYPE_BSTR Pass-through6,10 N/D 2 OK 3 N/D 2
DBTYPE_STR OK6, 9, 10 N/D 2 OK5, 6, 12 N/D 2
DBTYPE_IUNKNOWN Flusso di byte tramite ISequentialStream7 N/D 2 Flusso di byte tramite ISequentialStream11 N/D 2
DBTYPE_VARIANT (VT_UI1 | VT_ARRAY) Pass-through6,7 N/D 2 N/D N/D 2
DBTYPE_VARIANT (VT_BSTR) Pass-through6,10 N/D 2 OK3 N/D 2

1Se 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.

2Esula dall'ambito di questo argomento.

3Il formato è UTF-16, nessun byte order mark (BOM), nessuna specifica di codifica, nessuna terminazione Null.

4Il formato è UTF-16, nessun BOM, nessuna specifica di codifica, terminazione Null.

5Il 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.

6Può essere usato BY_REF.

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

8La 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.

9I dati vengono convertiti in Unicode usando 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.

10Ai dati inviati al server viene sempre aggiunto un indicatore BOM (Byte Order Mark). Se i dati iniziano già con un indicatore BOM (Byte Order Mark), saranno presenti due indicatori BOM 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.

11Il formato è UTF-16, nessuna specifica di codifica, BOM 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.

12Se 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 usano associazioni WSTR e BSTR, nel driver OLE DB per SQL Server non è necessario né viene aggiunto un BOM 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 BOM 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 dal driver OLE DB per SQL Server usando associazioni BYTES, XML o IUNKNOWN sono sempre codificati in UTF-16 con un BOM 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. La convalida lato client e le modifiche di codifica devono essere gestite dall'applicazione. È consigliabile non elaborare direttamente i dati XML, ma di usare invece un lettore DOM o 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 ai set di righe OLE DB

In OLE DB Driver per SQL Server sono stati aggiunti nuovi valori o modifiche a molti set di righe dello schema OLE DB principale.

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 Type Descrizione
SS_XML_SCHEMACOLLECTION_CATALOGNAME DBTYPE_WSTR Nome di un catalogo in cui viene definita una raccolta di XML Schema. 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 XML Schema. NULL per una colonna non XML o una colonna XML non tipizzata.
SS_XML_SCHEMACOLLECTIONNAME DBTYPE_WSTR Nome della raccolta di XML Schema. 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 su XML Schema. Il set di righe SS_XMLSCHEMA contiene le colonne seguenti:

Nome colonna Type 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 XML Schema per colonne XML tipizzate. In caso contrario, NULL.
TARGETNAMESPACEURI DBTYPE_WSTR Spazio dei nomi di destinazione di un elemento XML Schema.
SCHEMACONTENT DBTYPE_WSTR Contenuto dell'elemento XML Schema.

L'ambito di ogni XML Schema è 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 ai set di proprietà OLE DB

In OLE DB Driver per SQL Server sono stati aggiunti nuovi valori o modifiche a molti set di proprietà dello schema OLE DB principale.

Set di proprietà DBPROPSET_SQLSERVERPARAMETER

Ai fini del supporto del tipo di dati xml tramite OLE DB, nel driver OLE DB per SQL Server è 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 XML Schema. Una delle tre parti di cui è composto l'identificatore del nome SQL.
SSPROP_PARAM_XML_SCHEMACOLLECTION_SCHEMANAME DBTYPE_WSTR Nome di un elemento XML Schema 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 XML Schema 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, nel driver OLE DB per SQL Server 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 l'elemento XML Schema. 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 dell'elemento XML Schema 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 XML Schema 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 alle interfacce OLE DB

In OLE DB Driver per SQL Server sono stati aggiunti nuovi valori o modifiche a molte interfacce dello schema OLE DB principale.

Interfaccia ISSCommandWithParameters

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

Nota

L'interfaccia ISSCommandWithParameters usa anche la nuova struttura SSPARAMPROPS.

Interfaccia IColumnsRowset

In OLE DB Driver per SQL Server 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 XML Schema. Per le colonne non XML o per le colonne XML non tipizzate, le tre colonne assumono tutte il valore predefinito NULL.

Nome colonna Type Descrizione
DBCOLUMN_SS_XML_SCHEMACOLLECTION_CATALOGNAME DBTYPE_WSTR Catalogo cui appartiene una raccolta di XML Schema.

In caso contrario, NULL.
DBCOLUMN_SS_XML_SCHEMACOLLECTION_SCHEMANAME DBTYPE_WSTR Schema cui appartiene una raccolta di XML Schema. In caso contrario, NULL.
DBCOLUMN_SS_XML_SCHEMACOLLECTIONNAME DBTYPE_WSTR Nome della raccolta di XML Schema 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 *). 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'usare 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'usare 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 viene specificato 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 viene specificato 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 usare 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.

Vedere anche

Driver OLE DB per funzionalità di SQL Server
ISSCommandWithParameters (OLE DB)