Creazione di indici XML

Creazione di un indice XML primario

Per creare un indice XML primario, utilizzare l'istruzione DDL CREATE INDEX (Transact-SQL)Transact-SQL. Negli indici XML non sono supportate tutte le opzioni disponibili per gli indici non XML.

Per la creazione di un indice XML, si noti quanto segue:

• Per creare un indice XML primario, è necessario che la tabella contenente la colonna XML da indicizzare, denominata tabella di base, includa un indice cluster nella chiave primaria. In tal modo si garantisce che, nel caso in cui la tabella di base sia partizionata, sia possibile partizionare l'indice XML primario tramite lo stesso schema e la stessa funzione di partizionamento.

• Se è presente un indice XML, non è possibile modificare la chiave primaria cluster della tabella. Prima di modificarla, sarà necessario eliminare tutti gli indici XML dalla tabella.

• È possibile creare un indice XML primario in una singola colonna di tipo xml. Non è possibile creare nessun altro tipo di indice se la colonna di tipo XML è una colonna chiave. È tuttavia possibile includere la colonna di tipo L xml in un indice non XML. Ogni colonna di tipo xml in una tabella può includere l'indice XML primario corrispondente. È tuttavia consentito solo un indice XML primario per ogni colonna di tipo xml.

• Gli indici XML si trovano nello stesso spazio dei nomi degli indici non XML. Pertanto, nella stessa tabella non possono esistere un indice XML e un indice non XML con lo stesso nome.

• Per gli indici XML, le opzioni IGNORE_DUP_KEY e ONLINE sono sempre impostate su OFF. È possibile specificare queste opzioni con il valore OFF.

• Le informazioni sul filegroup o sul partizionamento della tabella utente vengono applicate all'indice XML. Gli utenti non possono specificare tali informazioni separatamente in un indice XML.

• L'opzione per gli indici DROP_EXISTING consente di eliminare un indice XML primario e di crearne uno nuovo oppure di eliminare un indice XML secondario e di crearne uno nuovo. Tale opzione, tuttavia, non consente di eliminare un indice XML secondario per creare un nuovo indice XML primario o viceversa.

• Per i nomi degli indici XML primari vengono applicate le stesse restrizioni valide per i nomi delle viste.

Non è possibile creare un indice XML in una colonna di tipo xml in una vista, in una variabile valutata a livello di tabella con colonne di tipoxml o in variabili di tipo xml.

• Per modificare una colonna di tipo xml da XML non tipizzato a XML tipizzato, o viceversa, tramite l'opzione ALTER TABLE ALTER COLUMN, nella colonna non deve esistere alcun indice XML. In caso contrario, è necessario eliminarlo prima di provare a modificare il tipo della colonna.

• Dopo la creazione di un indice XML, è necessario impostare l'opzione ARITHABORT su ON. Per eseguire operazioni di query, inserimento, eliminazione o aggiornamento sui valori della colonna XML utilizzando i metodi con tipo di dati XML, è necessario impostare la stessa opzione nella connessione. In caso contrario, i metodi con tipo di dati XML avranno esito negativo.

  Nota

  Le informazioni su un indice XML sono disponibili nelle viste del catalogo. Tuttavia, sp_helpindex non è supportata. In questo argomento sono disponibili esempi che illustrano l'esecuzione di query sulle viste del catalogo per trovare informazioni sugli indici XML.

Creando o ricreando un indice XML primario in una colonna con tipo di dati XML che contiene valori dei tipi schema XML xs:date o xs:dateTime (o qualsiasi sottotipo di questi tipi) che hanno meno di un anno, la creazione dell'indice non riuscirà in SQL Server 2008. SQL Server 2005 ha consentito questi valori, quindi questo problema può verificarsi nella creazione di indici generati in SQL Server 2005. Per ulteriori informazioni, vedere Dati XML tipizzati confrontati con dati XML non tipizzati.

Esempio: creazione di un indice XML primario

<book genre="security" publicationdate="2002" ISBN="0-7356-1588-2">
   <title>Writing Secure Code</title>
   <author>
      <first-name>Michael</first-name>
      <last-name>Howard</last-name>
   </author>
   <author>
      <first-name>David</first-name>
      <last-name>LeBlanc</last-name>
   </author>
   <price>39.99</price>
</book>

CREATE PRIMARY XML INDEX idx_xCol on T (xCol)

Creazione di un indice XML secondario

Per creare indici XML secondari e specificare il tipo di indice XML secondario desiderato, utilizzare l'istruzione DDL CREATE INDEX (Transact-SQL)Transact-SQL.

Per la creazione di indici XML secondari, si noti quanto segue:

• Per gli indici XML secondari sono consentite tutte le opzioni applicate a un indice non cluster, ad eccezione di IGNORE_DUP_KEY e di ONLINE. Per gli indici XML secondari, le due opzioni devono essere impostate sempre su OFF.

• Gli indici secondari vengono partizionati esattamente come l'indice XML primario.

• L'opzione DROP_EXISTING consente di eliminare un indice secondario dalla tabella utente e di crearne un altro.

È possibile eseguire una query nella vista del catalogo sys.xml_indexes per recuperare informazioni sugli indici XML. Si noti che la colonna seconday_type_desc nella vista del catalogo sys.xml_indexes include il tipo di indice secondario.

SELECT  * 
FROM    sys.xml_indexes

I valori restituiti nella colonna seconday_type_desc possono essere NULL, PATH, VALUE o PROPERTY. Per l'indice XML primario, il valore restituito è NULL.

Esempio: creazione di indici XML secondari

CREATE TABLE T (Col1 INT PRIMARY KEY, XmlCol XML)
GO
-- Create primary index.
CREATE PRIMARY XML INDEX PIdx_T_XmlCol 
ON T(XmlCol)
GO
-- Create secondary indexes (PATH, VALUE, PROPERTY).
CREATE XML INDEX PIdx_T_XmlCol_PATH ON T(XmlCol)
USING XML INDEX PIdx_T_XmlCol
FOR PATH
GO
CREATE XML INDEX PIdx_T_XmlCol_VALUE ON T(XmlCol)
USING XML INDEX PIdx_T_XmlCol
FOR VALUE
GO
CREATE XML INDEX PIdx_T_XmlCol_PROPERTY ON T(XmlCol)
USING XML INDEX PIdx_T_XmlCol
FOR PROPERTY
GO

SELECT  * 
FROM    sys.xml_indexes

SELECT *
FROM sys.xml_indexes
WHERE object_id = object_id('T')

INSERT INTO T VALUES (1,
'<doc id="123">
<sections>
<section num="2">
<heading>Background</heading>
</section>
<section num="3">
<heading>Sort</heading>
</section>
<section num="4">
<heading>Search</heading>
</section>
</sections>
</doc>')
GO
-- Check XML index information.
SELECT *
FROM   sys.dm_db_index_physical_stats (db_id(), object_id('T'), NULL, NULL, 'DETAILED')
GO
-- Space usage of primary XML index
DECLARE @index_id int
SELECT  @index_id = i.index_id
FROM    sys.xml_indexes i 
WHERE   i.name = 'PIdx_T_XmlCol' and object_name(i.object_id) = 'T'
 
SELECT *
FROM sys.dm_db_index_physical_stats (db_id(), object_id('T') , @index_id, DEFAULT, 'DETAILED')
go
--- Space usage of secondary XML index (for example PATH secondary index)  PIdx_T_XmlCol_PATH
DECLARE @index_id int
SELECT  @index_id = i.index_id 
FROM    sys.xml_indexes i 
WHERE  i.name = 'PIdx_T_XmlCol_PATH' and object_name(i.object_id) = 'T'
 
SELECT *
FROM sys.dm_db_index_physical_stats (db_id(), object_id('T') , @index_id, DEFAULT, 'DETAILED')
go
 
-- Space usage of all secondary XML indexes for a particular table
SELECT i.name, object_name(i.object_id), stats.* 
FROM   sys.dm_db_index_physical_stats (db_id(), object_id('T'), NULL, DEFAULT, 'DETAILED') stats
JOIN sys.xml_indexes i ON (stats.object_id = i.object_id and stats.index_id = i.index_id)
WHERE secondary_type is not null
-- Drop secondary indexes.
DROP INDEX PIdx_T_XmlCol_PATH ON T
GO
DROP INDEX PIdx_T_XmlCol_VALUE ON T
GO
DROP INDEX PIdx_T_XmlCol_PROPERTY ON T
GO
-- Drop primary index.
DROP INDEX PIdx_T_XmlCol ON T
-- Drop table T.
DROP TABLE T
Go

Vedere anche

Concetti