Utilizzo di proprietà estese su oggetti di database

Definizione delle proprietà estese

Ogni proprietà estesa dispone di un nome e di un valore definiti dall'utente. Il valore di una proprietà estesa è di tipo sql_variant e può contenere fino a 7.500 byte di dati. È possibile aggiungere più proprietà estese a un unico oggetto.

Per consentire la specifica delle proprietà estese, gli oggetti inclusi in un database SQL Server sono classificati in tre livelli, ovvero 0, 1 e 2. Il livello 0 rappresenta quello più elevato e viene utilizzato per gli oggetti contenuti nell'ambito del database. Gli oggetti del livello 1 sono contenuti in un ambito utente o dello schema, mentre quelli di livello 2 in oggetti di livello 1. È possibile definire le proprietà estese per oggetti di un qualsiasi livello.

Per i riferimenti a un oggetto di un livello è necessario specificare i nomi degli oggetti di livello superiore che li posseggono o li contengono. Quando, ad esempio, si aggiunge una proprietà estesa a una colonna di tabella di livello 2, è necessario specificare anche il nome della tabella di livello 1 che contiene la colonna e lo schema di livello 0 che contiene la tabella.

Nell'esempio seguente il valore della proprietà estesa 'Minimum inventory quantity.' viene aggiunto alla colonna SafetyStockLevel nella tabella Product contenuta nello schema Production .

USE AdventureWorks;
GO
EXEC sys.sp_addextendedproperty 
@name = N'MS_DescriptionExample', 
@value = N'Minimum inventory quantity.', 
@level0type = N'SCHEMA', @level0name = Production, 
@level1type = N'TABLE',  @level1name = Product,
@level2type = N'COLUMN', @level2name = SafetyStockLevel;
GO

Aggiunta di proprietà estese a oggetti

Nelle tabelle seguenti sono elencati gli oggetti ai quali è possibile aggiungere proprietà estese. Oltre ai tipi validi di oggetti di livello 0, 1 e 2, sono indicate anche le autorizzazioni necessarie per aggiungere, eliminare o visualizzare le proprietà estese.

Funzione di aggregazione

Chiave asimmetrica

Assembly

Certificato

Contratto (Service Broker)

Database

Esempio

USE AdventureWorks;
GO
EXEC sys.sp_addextendedproperty 
@name = N'MS_DescriptionExample', 
@value = N'AdventureWorks Sample OLTP Database';
GO

Valore predefinito

Notifica degli eventi

Filegroup o nome di file

Esempio

USE AdventureWorks;
GO
EXEC sys.sp_addextendedproperty 
@name = N'MS_DescriptionExample', 
@value = N'Primary filegroup for the AdventureWorks sample database.', 
@level0type = N'FILEGROUP', @level0name = [PRIMARY];
GO

USE AdventureWorks;
GO
EXEC sys.sp_addextendedproperty 
@name = N'MS_DescriptionExample', 
@value = N'Primary data file for the AdventureWorks sample database.', 
@level0type = N'FILEGROUP', @level0name = [PRIMARY],
@level1type = N'Logical File Name', @level1name = AdventureWorks_Data;
GO

Funzione

Esempio

USE AdventureWorks;
GO
EXEC sys.sp_addextendedproperty 
@name = N'MS_DescriptionExample', 
@value = N'Scalar function returning the quantity of inventory for a specified ProductID.', 
@level0type = N'SCHEMA', @level0name = [dbo],
@level1type = N'FUNCTION', @level1name = ufnGetStock;
GO

USE AdventureWorks;
GO
EXEC sys.sp_addextendedproperty 
@name = N'MS_DescriptionExample', 
@value = N'Input parameter. Enter a valid ProductID.', 
@level0type = N'SCHEMA', @level0name = [dbo],
@level1type = N'FUNCTION', @level1name = ufnGetStock,
@level2type = N'PARAMETER', @level2name ='@ProductID';
GO

Tipo di messaggio

Funzione di partizione

Schema di partizione

Guida di piano

Nel seguente esempio viene aggiunta una proprietà estesa viene aggiunta alla guida di piano TemplateGuide1.

USE AdventureWorks;
GO
EXECUTE sp_addextendedproperty @name=N'PlanGuideGroup', @value = N'MyTest', 
@level0type = N'Plan Guide', @level0name = 'TemplateGuide1';

Procedura

Livello	Tipo di livello	Autorizzazioni necessarie per aggiungere o eliminare una proprietà estesa	Autorizzazioni necessarie per visualizzare una proprietà estesa	Commenti
0	SCHEMA o USER			È consigliabile utilizzare SCHEMA anziché USER. Vedere la sezione dedicata al confronto tra Schema e User di seguito in questo argomento.
1	PROCEDURE	ALTER per OBJECT procedura Nota Solo i membri del ruolo predefinito del server sysadmin possono aggiungere proprietà estese alle stored procedure estese.	Qualsiasi per OBJECT	Si applica alle stored procedure definite dall'utente riportate di seguito: CLR Transact-SQL Filtro di replica Se non viene specificato un tipo di livello 2, la proprietà si applica alla procedura stessa.
2	PARAMETER	ALTER per OBJECT procedura	Qualsiasi per OBJECT

Coda (Service Broker)

Associazione al servizio remoto (Service Broker)

Route (Service Broker)

Regola

Schema o utente

Livello	Tipo di livello	Autorizzazioni necessarie per aggiungere o eliminare una proprietà estesa	Autorizzazioni necessarie per visualizzare una proprietà estesa	Commenti
0	SCHEMA o USER	ALTER per SCHEMA o ALTER per USER	Qualsiasi per APPLICATION ROLE oppure Qualsiasi per ROLE oppure Qualsiasi per USER	Se non viene specificato un tipo di livello 1, la proprietà si applica allo schema o all'utente stesso. I possibili valori di USER sono i seguenti: Ruolo dell'applicazione Ruolo del database Utente SQL Server Gruppo di Windows Utente di Windows Utilizzare USER solo per l'aggiunta di una proprietà estesa a un utente. Importante L'opzione USER come tipo di livello 0 definito nei tipi di oggetti di livello 1 o 2 verrà rimossa in una versione futura di SQL Server. Evitare pertanto di utilizzarla in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui questa funzione è stata implementata. In alternativa, utilizzare SCHEMA come tipo di livello 0.
1	Variabile
2	Variabile

Servizio

Chiave simmetrica

Sinonimo

Tabella

Esempio

USE AdventureWorks;
GO
EXEC sys.sp_addextendedproperty 
@name = N'MS_Description', 
@value = N'Street address information for customers, employees, and vendors.', 
@level0type = N'SCHEMA', @level0name = Person, 
@level1type = N'TABLE',  @level1name = Address;
GO

USE AdventureWorks;
GO
EXEC sys.sp_addextendedproperty 
@name = N'MS_DescriptionExample', 
@value = N'Nonclustered index on StateProvinceID.', 
@level0type = N'SCHEMA', @level0name = Person, 
@level1type = N'TABLE',  @level1name = Address,
@level2type = N'INDEX',  @level2name = IX_Address_StateProvinceID;
GO

Trigger

Tipo

Tipo

Vista

Insieme di schemi XML

Oggetti che non supportano le proprietà estese

Gli oggetti seguenti non supportano le proprietà estese:

• Oggetti dell'ambito del database non elencati nelle tabelle precedenti, ad esempio gli oggetti full-text.

• Oggetti non compresi nell'ambito del database, ad esempio gli endpoint HTTP.

• Oggetti senza nome, ad esempio parametri della funzione di partizione.

• Certificati, chiavi simmetriche, chiavi asimmetriche e credenziali.

• Oggetti definiti dal sistema, ad esempio tabelle di sistema, viste del catalogo e stored procedure di sistema.

Confronto tra Schema e User

Nelle versioni precedenti di SQL Server gli utenti sono proprietari degli oggetti di database quali tabelle, viste e trigger. Era quindi consentito sia aggiungere una proprietà estesa a uno di tali oggetti che specificare un nome utente come tipo di livello 0. Gli oggetti di database sono contenuti in schemi che non dipendono dai rispettivi proprietari.

Se si specifica USER come tipo di livello 0, l'applicazione di una proprietà estesa a un oggetto di database può determinare un'ambiguità nella risoluzione dei nomi. Si supponga, ad esempio che l'utente Mary sia proprietaria di due schemi, Mary e MySchema, e che entrambi gli schemi includano una tabella denominata MyTable. Se l'utente Mary aggiunge una proprietà estesa alla tabella MyTable e specifica @level0type = N'USER', @level0name = Mary, non sarà possibile identificare con certezza la tabella a cui viene applicata la proprietà estesa. Per mantenere la compatibilità con le versioni precedenti, SQL Server applicherà la proprietà alla tabella inclusa nello schema denominato Mary. Per ulteriori informazioni su utenti e schemi, vedere Separazione tra schema e utente.

Confronto tra maschere di input e vincoli CHECK

Per specificare lo schema dei dati previsti per colonne di tabelle o viste, è possibile utilizzare sia vincoli CHECK che proprietà estese che forniscono una maschera di input. La maggior parte dei siti sceglierà la prima o la seconda soluzione finché non si verifica una delle situazioni seguenti:

• I vincoli CHECK sono stati utilizzati come misura ad interim fino a quando non è stato possibile modificare tutti i programmi che utilizzano questa tabella in modo che utilizzino le proprietà della maschera di input.

• Il sito supporta anche gli utenti che possono aggiornare i dati tramite strumenti ad hoc che non prevedono la lettura delle proprietà estese.

La maschera di input presenta un indubbio vantaggio rispetto al vincolo CHECK in quanto consente di applicare la logica nelle applicazioni, che potranno generare errori di carattere maggiormente informativo se vengono specificati dati non formattati correttamente. La maschera di input richiede tuttavia una chiamata distinta a fn_listextendedproperty o sys.extended_properties per ottenere la proprietà e l'aggiunta della logica per l'applicazione della maschera in tutti i programmi.

Replica delle proprietà estese

Le proprietà estese vengono replicate solo durante la sincronizzazione iniziale tra il server di pubblicazione e il Sottoscrittore. Se si aggiunge o si modifica una proprietà estesa dopo la sincronizzazione iniziale, la modifica non viene replicata. Per ulteriori informazioni sulla replica degli oggetti di database, vedere Pubblicazione di dati e oggetti di database.

Utilizzo delle proprietà estese nelle applicazioni

Le proprietà estese costituiscono unicamente una posizione denominata per l'archiviazione dei dati. È quindi necessario codificare tutte le applicazioni in modo che eseguano la query sulla proprietà e scegliere l'operazione appropriata. L'aggiunta di una proprietà di didascalia a una colonna non implica, ad esempio, la creazione di una didascalia visualizzabile in un'applicazione. È quindi necessario codificare ciascuna applicazione in modo da leggere e visualizzare correttamente la didascalia.

Per aggiungere una proprietà estesa

• sp_addextendedproperty (Transact-SQL)

Per aggiornare una proprietà estesa

• sp_updateextendedproperty (Transact-SQL)

Per eliminare una proprietà estesa

• sp_dropextendedproperty (Transact-SQL)

Per visualizzare una proprietà estesa

• fn_listextendedproperty (Transact-SQL)

• sys.extended_properties (Transact-SQL)

Vedere anche

Riferimento

Concetti

Altre risorse