Condividi tramite


Raccolte di schemi XML (SQL Server)

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure

Come descritto nell'articolo xml (Transact-SQL), SQL Server offre funzionalità per l'archiviazione nativa dei dati XML tramite il tipo di dati xml. È facoltativamente possibile associare schemi XSD a una variabile o colonna di tipo xml tramite una raccolta di XML Schema. Una raccolta di XML Schema archivia gli elementi XML Schema importati e può essere quindi utilizzata per eseguire le operazioni seguenti:

  • Convalidare istanze XML.

  • Tipizzare i dati XML a mano a mano che vengono archiviati nel database.

Una raccolta di schemi XML è un'entità di metadati analoga a una tabella in un database. Le raccolte di schemi XML possono essere create, modificate ed eliminate. Gli schemi specificati in un'istruzione CREATE XML SCHEMA COLLECTION (Transact-SQL) vengono automaticamente importati nell'oggetto raccolta di XML Schema appena creato. È possibile importare altri schemi o componenti di schema in un oggetto raccolta esistente nel database, usando l'istruzione ALTER XML SCHEMA COLLECTION (Transact-SQL) .

Come descritto nell'articolo Confronto dati XML tipizzati con dati XML non tipizzati, i dati XML archiviati in una colonna o in una variabile a cui è associato uno schema sono detti dati XML tipizzati perché lo schema fornisce le informazioni sul tipo di dati necessarie per i dati dell'istanza. SQL Server utilizza tali informazioni sul tipo per ottimizzare l'archiviazione dei dati.

Lo schema viene inoltre utilizzato dal motore di elaborazione delle query per la verifica dei tipi, per l'ottimizzazione delle query e per la modifica dei dati.

Per i valori xml tipizzati, SQL Server usa la raccolta di schemi XML associata per convalidare l'istanza XML. Se l'istanza XML è conforme allo schema, il database consente di archiviarla nel sistema insieme alle relative informazioni sul tipo, in caso contrario la rifiuta.

Per recuperare la raccolta di schemi archiviata nel database è possibile utilizzare la funzione intrinseca XML_SCHEMA_NAMESPACE. Per altre informazioni, vedere Visualizzare una raccolta di XML Schema archiviata.

La raccolta di XML Schema può essere utilizzata anche per tipizzare variabili, parametri e colonne XML.

Istruzioni DDL per la gestione di raccolte di schemi XML

È possibile creare raccolte di XML Schema nel database e associarle a variabili e colonne di tipo xml . Per gestire le raccolte di schemi nel database, in SQL Server sono disponibili le istruzioni DDL seguenti:

Per utilizzare una raccolta XML Schema e i relativi schemi, è necessario innanzitutto creare la raccolta e gli schemi utilizzando l'istruzione CREATE XML SCHEMA COLLECTION. Dopo aver creato la raccolta di schemi è possibile creare le variabili e le colonne di tipo xml e associare a esse la raccolta di schemi. Dopo aver creato la raccolta, nei metadati verranno archiviati diversi componenti degli schemi. È inoltre possibile utilizzare l'istruzione ALTER XML SCHEMA COLLECTION per aggiungere altri componenti agli schemi o nuovi schemi alla raccolta.

Per eliminare la raccolta di schemi, utilizzare l'istruzione DROP XML SCHEMA COLLECTION, che consente di eliminare tutti gli schemi contenuti nella raccolta e di rimuovere l'oggetto raccolta. Prima di eliminare una raccolta di schemi è necessario soddisfare le condizioni descritte in DROP XML SCHEMA COLLECTION (Transact-SQL).

Informazioni sui componenti dello schema

Quando si utilizza l'istruzione CREATE XML SCHEMA COLLECTION, vengono importati nel database diversi componenti dello schema, ad esempio elementi, attributi e definizioni di tipi dello schema. Se si utilizza l'istruzione DROP XML SCHEMA COLLECTION, verrà rimossa l'intera raccolta.

L'istruzione CREATE XML SCHEMA COLLECTION salva i componenti dello schema in diverse tabelle di sistema.

Si consideri ad esempio lo schema seguente:

<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            targetNamespace="uri:Cust_Orders2"
            xmlns="uri:Cust_Orders2" >
  <xsd:attribute name="SomeAttribute" type="xsd:int" />
  <xsd:complexType name="SomeType" />
  <xsd:complexType name="OrderType" >
    <xsd:sequence>
      <xsd:element name="OrderDate" type="xsd:date" />
      <xsd:element name="RequiredDate" type="xsd:date" />
      <xsd:element name="ShippedDate" type="xsd:date" />
    </xsd:sequence>
    <xsd:attribute name="OrderID" type="xsd:ID" />
    <xsd:attribute name="CustomerID"  />
    <xsd:attribute name="EmployeeID"  />
  </xsd:complexType>
  <xsd:complexType name="CustomerType" >
     <xsd:sequence>
        <xsd:element name="Order" type="OrderType"
                     maxOccurs="unbounded" />
       </xsd:sequence>
      <xsd:attribute name="CustomerID" type="xsd:string" />
      <xsd:attribute name="OrderIDList" type="xsd:IDREFS" />
  </xsd:complexType>
  <xsd:element name="Customer" type="CustomerType" />
</xsd:schema>

Questo schema mostra i diversi tipi di componenti che possono essere archiviati nel database, tra cui SomeAttribute, SomeType, OrderType, CustomerType, Customer, Order, CustomerID, OrderID, OrderDate, RequiredDatee ShippedDate.

Categorie di componenti

I componenti dello schema archiviati nel database rientrano nelle categorie seguenti:

  • ELEMENT

  • ATTRIBUTE

  • TYPE (per tipi semplici o complessi)

  • ATTRIBUTEGROUP

  • MODELGROUP

Ad esempio:

  • SomeAttribute è un componente ATTRIBUTE.

  • SomeType, OrderType e CustomerType sono componenti TYPE.

  • Customer è un componente ELEMENT.

Quando si importa uno schema nel database, SQL Server non archivia direttamente lo schema, SQL Server archivia invece i singoli componenti. Ciò significa che il tag <Schema> non viene archiviato, ma vengono mantenuti i componenti definiti al suo interno. Non vengono mantenuti tutti gli elementi dello schema. Se il tag <Schema> contiene attributi che specificano il comportamento predefinito dei relativi componenti, tali attributi vengono spostati nei componenti dello schema durante il processo di importazione, come illustrato nella tabella seguente.

Attribute name Comportamento
attributeFormDefault Attributo form applicato a tutte le dichiarazioni di attributo nello schema nelle quali non è già presente e dove il valore viene impostato sul valore dell'attributo attributeFormDefault .
elementFormDefault Attributo form applicato a tutte le dichiarazioni di elemento nello schema nelle quali non è già presente e dove il valore viene impostato sul valore dell'attributo elementFormDefault .
blockDefault Attributo block applicato a tutte le dichiarazioni di elemento e definizioni di tipo nelle quali non è già presente e dove il valore viene impostato sul valore dell'attributo blockDefault .
finalDefault Attributo final applicato a tutte le dichiarazioni di elemento e definizioni di tipo nelle quali non è già presente e dove il valore viene impostato sul valore dell'attributo finalDefault .
targetNamespace Le informazioni sui componenti appartenenti allo spazio dei nomi di destinazione vengono archiviate nei metadati.

Autorizzazioni per una raccolta di schemi XML

È necessario disporre delle autorizzazioni necessarie per eseguire le operazioni seguenti:

  • Creare o caricare la raccolta XML Schema.

  • Modificare la raccolta XML Schema.

  • Eliminare la raccolta XML Schema.

  • Usare la raccolta XML Schema per colonne, variabili e parametri di tipo xml oppure nei vincoli di tabella o di colonna

Il modello di sicurezza di SQL Server consente l'autorizzazione CONTROL per tutti gli oggetti. L'utente che dispone di questa autorizzazione ottiene tutte le altre autorizzazioni per l'oggetto. Il proprietario dell'oggetto dispone anch'esso di tutte le autorizzazioni per l'oggetto.

Il proprietario e l'utente che dispongono dell'autorizzazione CONTROL per un oggetto possono concedere qualsiasi autorizzazione per l'oggetto specifico. Un utente che non è il proprietario e che non dispone dell'autorizzazione CONTROL può comunque concedere l'autorizzazione per un oggetto se è specificata WITH GRANT OPTION. Ad esempio, si supponga che Utente A disponga tramite WITH GRANT OPTION dell'autorizzazione REFERENCES per la raccolta XML Schema denominata S, ma di nessun'altra autorizzazione per la raccolta. Utente A può concedere a Utente B l'autorizzazione REFERENCES per la raccolta di schemi S.

Il modello di sicurezza consente inoltre le autorizzazioni per la creazione e l'utilizzo di raccolte XML Schema o per il trasferimento della proprietà da un utente a un altro. Negli articoli seguenti vengono illustrate le autorizzazioni per le raccolte di schemi XML.

Acquisizione di Informazioni su schemi XML e raccolte di schemi

Le raccolte di XML Schema sono enumerate nella vista del catalogo sys.xml_schema_collections. La raccolta di schemi XML sys è definita dal sistema e contiene gli spazi dei nomi predefiniti che è possibile utilizzare in tutte le raccolte di XML Schema definite dall'utente senza doverli caricare in modo esplicito. Tale elenco contiene gli spazi dei nomi per xml, xs, xsi, fn e xdt. Sono disponibili altre due viste del catalogo: sys.xml_schema_namespaces, che enumera tutti gli spazi dei nomi in ogni raccolta di schemi XML, e sys.xml_components, che enumera tutti i componenti degli elementi di schemi XML presenti in ognuno.

La funzione predefinita XML_SCHEMA_NAMESPACE, schemaName, XmlSchemacollectionName, namespace-uri, restituisce un'istanza del tipo di dati xml. Tale istanza contiene frammenti di XML Schema per gli schemi inclusi in una raccolta di XML Schema, ad eccezione degli elementi XML Schema predefiniti.

Per enumerare il contenuto di una raccolta di XML Schema è possibile:

  • Scrivere query Transact-SQL sulle viste del catalogo appropriate per le raccolte di XML Schema.

  • Usare la funzione predefinita XML_SCHEMA_NAMESPACE(). È possibile applicare i metodi per il tipo di dati xml all'output di questa funzione, ma non è possibile modificare gli elementi di schemi XML sottostanti.

Queste tecniche di enumerazione sono illustrate negli esempi seguenti.

Esempi

Enumerazione degli spazi dei nomi XML in una raccolta di schemi XML

Per la raccolta di schemi XML myCollection utilizzare la query seguente:

SELECT XSN.name
FROM    sys.xml_schema_collections XSC JOIN sys.xml_schema_namespaces XSN
    ON (XSC.xml_collection_id = XSN.xml_collection_id)
WHERE    XSC.name = 'myCollection';

Enumerazione del contenuto di una raccolta di schemi XML

L'istruzione seguente enumera il contenuto della raccolta di schemi XML myCollection nell'ambito dello schema relazionale dbo.

SELECT XML_SCHEMA_NAMESPACE (N'dbo', N'myCollection');

I singoli elementi XML Schema inclusi nella raccolta possono essere ottenuti come istanze del tipo di dati xml , specificando lo spazio dei nomi di destinazione come terzo argomento della funzione XML_SCHEMA_NAMESPACE(), come illustrato nell'esempio seguente.

Restituzione di uno schema specifico da una raccolta di schemi XML

L'istruzione seguente restituisce l'elemento schema XML con spazio dei nomi di destinazione pretend https://www.microsoft.com/was-books dalla raccolta di schemi XML myCollection nell'ambito dello schema relazionale dbo.

SELECT XML_SCHEMA_NAMESPACE (N'dbo', N'myCollection',
N'https://www.microsoft.com/was-books')

Esecuzione di query su elementi di schemi XML

Per eseguire query sugli elementi XML Schema caricati in raccolte di XML Schema è possibile:

  • Scrivere query Transact-SQL sulle viste del catalogo per gli spazi dei nomi degli elementi XML Schema.

  • Creare una tabella contenente una colonna con tipo di dati xml per archiviare gli elementi XML Schema e quindi caricarli nel sistema di tipi XML. Per eseguire query sulla colonna XML, è possibile usare i metodi per il tipo di dati xml . È inoltre possibile compilare un indice XML su questa colonna. Questo approccio richiede tuttavia che l'applicazione mantenga la consistenza tra gli elementi XML Schema archiviati nella colonna XML e il sistema di tipi XML. Se ad esempio si elimina lo spazio dei nomi di un elemento XML Schema dal sistema di tipi XML, per mantenere la consistenza sarà necessario eliminarlo anche dalla tabella.

Vedi anche