Używanie rozszerzonych właociwooci obiektów bazy danych

Definiowanie właściwości rozszerzone

Każda właściwość rozszerzone ma nazwę użytkownika i wartość.Wartość właściwość rozszerzonej jest sql_variant wartość, która może zawierać maksymalnie 7500 bajtów danych.Do jednego obiektu można dodać wiele właściwości rozszerzone.

Do określania właściwości rozszerzone, obiektów w SQL Server bazy danych dzieli się na trzy poziomy 0, 1 i 2.Poziom 0 jest najwyższym poziomem i jest zdefiniowany jako obiekty, które są zawarte w bazie danych zakres.Poziom 1 obiekty są zawarte w zakres schematu lub użytkownika i poziom 2 obiekty są zawarte przez obiekty poziomu 1.Właściwości rozszerzone można zdefiniować dla obiektów w każdym z tych poziomów.

Odwołania do obiektu w jeden poziom musi być kwalifikowany z nazwami obiektów wyższego poziomu, lub je zawierają.Na przykład po dodaniu właściwość rozszerzone do kolumna tabela, poziom 2, należy także określić nazwę tabela, poziom 1, zawierającej kolumna i schemat, poziom 0, który zawiera tabela.

W poniższym przykładzie wartość właściwość rozszerzone 'Minimum inventory quantity.' dodaje się SafetyStockLevel kolumna w Product tabela zawartej w Production schematu.

USE AdventureWorks2008R2;
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

Dodawanie właściwości rozszerzone do obiektów

W poniższej tabeli wymieniono obiekty, do których można dodać właściwości rozszerzone.Ich prawidłowy poziom 0, poziom 1 i wymieniono typy obiektów poziom 2, a także uprawnienia wymagane do dodawania, drop lub wyświetlić właściwości rozszerzone.

Agregacja

Klucza asymetrycznego

Zestaw

Certyfikat

Umowy (Service Broker)

Baza danych

Przykład

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

Default

Powiadomienie o zdarzeniu

Grupa plików lub nazwa pliku

Przykład

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

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

Funkcja

Przykład

USE AdventureWorks2008R2;
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 AdventureWorks2008R2;
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

Typ wiadomości

Funkcja Partition

Schemat partycji

Przewodnik planowania

Poniższy przykład dodaje właściwość rozszerzone do przewodnik planu TemplateGuide1.

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

Procedura

Level	Typ poziomu	Uprawnienia wymagane do Dodawanie lub usuwanie właściwość rozszerzone	Uprawnienia wymagane do wyświetlenia właściwość rozszerzone	Komentarze
0	SCHEMAT lub użytkownika			Można użyć SCHEMATU, zamiast użytkownika.Zobacz "vs schematu.Użytkownik" w dalszej części tego tematu.
1	PROCEDURA	ZMIANY w procedurze obiektu Uwaga: Tylko członkowie sysadmin stała rola serwera można dodać właściwości rozszerzone do rozszerzonych procedur przechowywanych.	Dowolny obiekt	Stosuje się do tych procedur przechowywanych przez użytkownika: CLR Transact-SQL Filtr replikacji Jeśli nie określono typ poziom 2, właściwość dotyczy samą procedurę.
2	PARAMETR	ZMIANY w procedurze obiektu	Dowolny obiekt

Kolejki (Service Broker)

Wiązanie zdalnych usługi (Service Broker)

Trasy (Service Broker)

Reguły

Schemat lub użytkownika

Level	Typ poziomu	Uprawnienia wymagane do Dodawanie lub usuwanie właściwość rozszerzone	Uprawnienia wymagane do wyświetlenia właściwość rozszerzone	Komentarze
0	SCHEMAT lub użytkownika	ZMIANY w SCHEMACIE lub ZMIEŃ na użytkownika	Dowolne na ROLĘ aplikacji Or Dowolne na roli Or Dowolny użytkownik	Jeżeli nie określono typ poziom 1, właściwość stosuje się do schematu lub samego użytkownika. Użytkownik może być jedną z następujących czynności: Rola aplikacji Roli bazy danych SQL Server Użytkownik Grupy systemu Windows Użytkownik systemu Windows UŻYTKOWNIKA można używać tylko po dodaniu właściwość rozszerzone do użytkownika. Ważne: Zdefiniowane przez użytkownika jako typ poziom 0 poziom 1 lub poziom 2 obiekty zostaną usunięte w przyszłej wersja SQL Server.Plan do modyfikowania aplikacji, które aktualnie funkcji i uniknąć używania tej funkcji w nowych prac rozwojowych.Użyj SCHEMATU jako typ poziom 0.Zobacz "vs schematu.Użytkownik" w dalszej części tego tematu.
1	Zmienny
2	Zmienny

Przykład

USE AdventureWorks2008R2;
GO
EXECUTE sys.sp_addextendedproperty 
@name = N'MS_Description',
@value = N'Contains objects related to employees and departments.',
@level0type = N'SCHEMA', 
@level0name = HumanResources;

USE AdventureWorks2008R2;
GO
CREATE APPLICATION ROLE Buyers
WITH Password = '987G^bv876sPY)Y5m23';
GO
EXEC sys.sp_addextendedproperty 
@name = N'MS_Description', 
@value = N'Application Role for the Purchasing Department.',
@level0type = N'USER',
@level0name = N'Buyers';

Usługi

Klucz symetryczny

Synonim

Tabela

Przykład

USE AdventureWorks2008R2;
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 AdventureWorks2008R2;
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

Wyzwalacz

Typ

Typ

Wyświetlanie

Kolekcji schematu XML

Obiekty bez obsługi rozszerzonych właociwooci

Nie można zdefiniować właściwości rozszerzone na te obiekty:

• Obiekty bazy danych zakres niewymienionych w poprzednich tabelach.Zawiera obiekty pełnego tekstu.

• Obiekty poza zakres bazy danych, takich jak HTTP punktów końcowych.

• Nazwy obiektów, takich jak parametry funkcja partycji.

• Certyfikaty kluczy symetrycznych, klucze asymetryczne poświadczenia.

• Zdefiniowana przez system obiektów, takich jak tabele systemowe, procedur przechowywanych w katalogu widoki i systemu.

Vs schematu.Użytkownik

W starszych wersjach SQL Server, użytkownicy własność obiektów bazy danych, takich jak tabele, widoki i wyzwalaczy.Dlatego został dozwolony Dodawanie właściwość rozszerzone do jednego z tych obiektów i określanie nazwy użytkownika jako typ poziom 0.Obiekty bazy danych znajdują się teraz w schematów, które są niezależne od użytkowników, którzy własne schematy.

Zastosowanie właściwość rozszerzone do obiektu bazy danych określić użytkownika jako typ poziom 0, może spowodować niejednoznaczności rozdzielczość.Załóżmy na przykład, użytkownik Mary jest właścicielem dwóch schematów Mary i MySchema, a te schematy zarówno zawiera tabela o nazwie MyTable.Jeśli Mary dodaje rozszerzonych właściwość tabela MyTable i określa @level0type = N'USER', @level0name = Mary, nie jest jasne do tabel, które zastosowano właściwość rozszerzone.Aby zachować zgodność ze starszymi wersjami, SQL Server zastosuje właściwość tabela znajduje się w schemacie o nazwie Mary.Aby uzyskać więcej informacji o użytkownikach i schematów, zobacz Oddzielanie schematu użytkownika.

Za pomocą maski wprowadzania vs.Ograniczenia CHECK

Ograniczenia CHECK i właściwości rozszerzone, które zapewniają maska wprowadzania może służyć do określenia wzorca oczekiwano dla kolumn tabela lub widoku danych.Większość witryn wybierz jeden z nich, chyba że występuje w następujących:

• Ograniczenia CHECK były używane jako miara tymczasowy, dopóki wszystkie programy zajmujących się w tej tabela może być zmieniony używanie właściwości maska wprowadzania.

• Witryna obsługuje również użytkowników można aktualizować dane za pomocą narzędzia ad hoc, które nie odczytać właściwości rozszerzone.

Zaletą maski wprowadzania przez ograniczenie typu CHECK jest zastosowana logikę w aplikacji.Te generować bardziej miarodajne błędy, jeśli użytkownik udostępnia dane, które jest niepoprawnie sformatowana.Wadą maska wprowadzania jest wymaga oddzielnych wywołanie fn_listextendedproperty lub sys.extended_properties uzyskać właściwość i logiki do wymuszenia maski należy dodać wszystkie programy.

Replikowanie właściwości rozszerzone

Właściwości rozszerzone są replikowane tylko w synchronizacja początkowa między Wydawca i subskrybenta.Jeśli dodać lub zmodyfikować właściwość rozszerzone po synchronizacja początkowa, zmiana nie jest replikowana.Aby uzyskać więcej informacji na temat replikowania obiektów bazy danych, zobacz Publikowanie danych i obiektów bazy danych.

Używanie rozszerzonych właociwooci w aplikacjach

Właściwości rozszerzone zawierają nazwaną lokalizację do przechowywania danych.Wszystkie aplikacje muszą być kodowane kwerendy właściwość i podjąć odpowiednie akcja.Na przykład dodanie właściwość caption do kolumna nie tworzy podpis, który może być wyświetlany przez aplikację.Każda aplikacja musi kodowane odczytać podpis i wyświetlania go poprawnie.

Aby dodać właściwość rozszerzone

• sp_addextendedproperty (języka Transact-SQL)

Aby zaktualizować właściwość rozszerzone

• sp_updateextendedproperty (języka Transact-SQL)

Aby usunąć właściwość rozszerzone

• sp_dropextendedproperty (języka Transact-SQL)

Aby wyświetlić właściwość rozszerzone

• fn_listextendedproperty (języka Transact-SQL)

• sys.extended_properties (języka Transact-SQL)

Zobacz także

Odwołanie

Koncepcje

Inne zasoby