Za pomocą właściwości rozszerzonych na obiekty bazy danych

Definiowanie właściwości rozszerzone

Każda właściwość rozszerzona ma nazwę użytkownika i wartość.Wartość właściwość rozszerzona o sql_variant wartość, która może zawierać maksymalnie 7500 bajtów danych. Wiele właściwości rozszerzone można dodawać do jednego obiektu.

Do określania właściwości rozszerzone, obiekty w SQL Server Baza danych dzieli się na trzech poziomach, 0, 1 i 2. Poziom 0 jest najwyższego poziomu i jest definiowana jako obiekty, które znajdują się w zakresie bazy danych.Obiekty poziomu 1 znajdują się w zakresie schematu lub użytkownika, a poziom 2 obiektów znajdują się w obiektach 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, które należy do użytkownika lub je zawierają.Na przykład po dodaniu właściwość rozszerzona o kolumna tabela, poziom 2, należy także określić nazwę tabela, poziom 1, zawierającą kolumna i schemat, poziom 0, który zawiera tabela.

W poniższym przykładzie wartość właściwość rozszerzona 'Minimum inventory quantity.' dodaje się SafetyStockLevel kolumna w Product Tabela, która znajduje się w Production schemat.

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

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

W poniższej tabeli wymieniono obiekty, do których można dodawać właściwości rozszerzone.Ich prawidłowy poziom 0, poziom 1 i wymieniono typy obiektów poziomu 2, a także uprawnień wymaganych do Dodawanie, usuwanie lub wyświetlanie właściwości rozszerzone.

Agregacja

IDENT_INCR

Zestaw

Certyfikat

Kontrakt (usługa Broker)

Database

Przykład

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

Default

zdarzenie powiadomienie

Grupa plików lub nazwa pliku

Przykład

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

Funkcja

Przykład

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

ISNUMERIC

Funkcja partycji

Schemat partycji

Przewodnik planowania

W poniższym przykładzie dodawane właściwość rozszerzona o do plan wykonania kwerendy TemplateGuide1.

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

Procedura

Level	Typ poziom	Uprawnienia wymagane, aby dodać lub usunąć właściwość rozszerzona o	Uprawnienia wymagane do wyświetlenia właściwość rozszerzona o	Komentarze
0	SCHEMA lub USER			SCHEMA powinny być używane zamiast USER.Zobacz temat "a schematu.Użytkownik"w dalszej części tego tematu.
1	PROCEDURA	ALTER o procedurze OBJECT Note: Tylko członkowie sysadmin roli serwera stałe można dodawać właściwości rozszerzone rozszerzonych procedur przechowywanych.	Dowolne na OBJECT	Stosuje się do tych procedur przechowywanych przez użytkownika: CLR Transact-SQL Filtr replikacja Jeżeli nie określono typ należy do poziom 2, właściwość stosuje się do samej procedury.
2	PARAMETR	ALTER o procedurze OBJECT	Dowolne na OBJECT

Kolejki (usługa Broker)

wiązanie usługa zdalnej (usługa Broker)

trasa (usługa Broker)

Reguły

Schemat lub użytkownika

Level	Typ poziom	Uprawnienia wymagane, aby dodać lub usunąć właściwość rozszerzona o	Uprawnienia wymagane do wyświetlenia właściwość rozszerzona o	Komentarze
0	SCHEMA lub USER	ALTER SCHEMA lub ALTER na USER	Dowolne na rola aplikacji Or Dowolne na ROLE Or Dowolne ON USER	Jeżeli nie określono typu poziom 1, właściwość stosuje się do schematu lub użytkownika, sama. USER może być jedną z następujących czynności: IDENT_CURRENT Role bazy danych SQL Server Użytkownik Grupy systemu Windows Użytkownik systemu Windows USER należy używać tylko po dodaniu właściwość rozszerzona o do użytkownika. Important Note: USER jako typ należy do poziom 0 zdefiniowane poziom 1 lub obiekty typu poziom 2 zostaną usunięte w przyszłej wersja programu SQL Server. Należy unikać stosowania tej funkcji w nowej pracy rozwoju i zaplanować do modyfikowania aplikacji korzystających aktualnie z funkcji.Zamiast tego użyj SCHEMA jako typ poziom 0.
1	Zmienia się
2	Zmienia się

usługa

NULLIF

Synonim

Table

Przykład

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

Wyzwalacz

Typ

Typ

Bez opuszczania środowiska, można zarządzać sieci fizycznej i łatwo zespołów projektów.

Kolekcja schematu XML

Nie obsługi rozszerzonych właściwość obiektów

Do tych obiektów nie mogą być definiowane właściwości rozszerzone:

• Obiekty o zakresie bazy danych nie są wymienione w poprzednich tabelach.Dotyczy to obiektów pełnego tekstu.

• Obiekty poza zakres bazy danych, takich jak punkty końcowe HTTP.

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

• Certyfikaty kluczy symetrycznych, klucze asymetryczne i poświadczenia.

• Procedury przechowywane obiektów zdefiniowanych w systemie, takich jak tabele systemowe i widoki wykazu systemu.

W stosunku do schematu.Użytkownik

We wcześniejszych wersjach SQL Server, użytkowników należących do obiektów bazy danych, takich jak tabele, widoki i wyzwalaczy. Dlatego został dozwolony Dodawanie właściwość rozszerzona o 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.

Po określeniu USER jako typ należy do poziom 0 po zastosowaniu do obiektu bazy danych właściwość rozszerzona o może być przyczyną niejednoznaczności rozdzielczości.Załóżmy na przykład, użytkownik Anna jest właścicielem dwóch schematów, Anna and MySchema, a te schematy obu zawiera tabela o nazwie Moja_tabela.Jeśli Anna Tabela dodaje właściwość rozszerzona, oMoja_tabela a określa@level0type = N'USER', @level0name = Mary, nie jest jasne do tabel, które zastosowano właściwość rozszerzona. Aby zachować zgodność z poprzednimi wersjami SQL Server będą miały zastosowanie do tabela, która znajduje się w schemacie o nazwie Joanna właściwość. Aby uzyskać więcej informacji o użytkownikach i schematów zobacz User-Schema Separation.

Za pomocą maski wprowadzania w stosunku do.Ograniczenia CHECK

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

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

• Witryna obsługuje również użytkownicy, którzy mogą aktualizować danych przy użyciu 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 mogą generować błędy dostarczają więcej informacji, jeśli użytkownik dostarcza dane, które jest niepoprawnie sformatowana.Wadą maska wprowadzania jest to, że wymaga oddzielnych wywołanie fn_listextendedproperty or sys.extended_properties uzyskać właściwość i logiki do wymuszenia maski, należy dodać we wszystkich programach.

Replikowanie właściwości rozszerzone

Właściwości rozszerzone są replikowane tylko w wstępna synchronizacja między wydawcę i subskrybent.W przypadku dodawania lub modyfikowania właściwość rozszerzona o po wstępna synchronizacja, zmiany nie są replikowane.Aby uzyskać więcej informacji na temat replikowanie obiektów bazy danych zobacz Obiekty bazy danych i publikowania danych.

Przy użyciu rozszerzonych właściwości w aplikacji

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

Aby dodać właściwość rozszerzona o

• sp_addextendedproperty (Transact-SQL)

Aby zaktualizować właściwość rozszerzona o

• sp_updateextendedproperty (języka Transact-SQL)

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

• sp_dropextendedproperty (języka Transact-SQL)

Aby wyświetlić właściwość rozszerzona o

• fn_listextendedproperty (Transact-SQL)

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

See Also

Other Resources