Udostępnij za pośrednictwem

  • Artykuł

fn_listextendedproperty (języka Transact-SQL)

Zwraca wartooć Rozszerzony wartości właściwość obiektów bazy danych.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

fn_listextendedproperty ( 
    { default | 'property_name' | NULL } 
  , { default | 'level0_object_type' | NULL } 
  , { default | 'level0_object_name' | NULL } 
  , { default | 'level1_object_type' | NULL } 
  , { default | 'level1_object_name' | NULL } 
  , { default | 'level2_object_type' | NULL } 
  , { default | 'level2_object_name' | NULL } 
  )

Argumenty

  • { Domyślnie | 'property_name' | WARTOŚĆ NULL.}
    Jest to nazwa właściwość.property_nameis sysname.Prawidłowe dane wejściowe są domyślnie, wartości NULL lub nazwa właściwość .

  • { Domyślnie | 'level0_object_type' | WARTOŚĆ NULL.}
    Jest typ zdefiniowany przez użytkownikalub użytkownika.level0_object_typejest varchar(128), domyślna wartość NULL.Prawidłowe dane wejściowe są zestawu, umowy, powiadomienie o zdarzeniu, grupa plików, typ wiadomości, funkcja PARTYCJI, schemat PARTYCJI, powiązania usługi zdalnego, trasy, SCHEMATU, usługi, WYZWALACZ, typ, użytkownika i NULL.

    Ważna informacjaWażne:

    Użytkownik i typ jako poziom-0 typy zostaną usunięte w przyszłej wersja programu SQL Server.Unikaj używania tych funkcji w nowych prac rozwojowych i plan do modyfikowania aplikacji, które obecnie korzystają z tych funkcji.Użyj SCHEMATU jako typ poziom 0 w użytkownika.Dla typu należy użyć SCHEMATU jako typ poziom 0 i typ jako typ poziom 1.

  • { Domyślnie | 'level0_object_name' | WARTOŚĆ NULL.}
    Jest nazwą typu obiektu poziom 0 określonego.level0_object_namejest sysname Domyślna wartość NULL.Prawidłowe dane wejściowe są domyślnie, wartości NULL lub nazwę obiektu.

  • { Domyślnie | 'level1_object_type' | WARTOŚĆ NULL.}
    Jest to typ obiektu poziom 1.level1_object_typejest varchar(128) Domyślna wartość NULL.Prawidłowe dane wejściowe są agregacji, domyślny, funkcja, nazwa pliku LOGICZNEGO, procedury, kolejki, reguły, SYNONIM, tabeli, typu, WIDOKU, KOLEKCJI SCHEMATU XML i NULL.

    Ostrzeżenie

    Domyślnie jest mapowany na NULL i "default" mapy do obiektu wpisz DOMYŚLNĄ.

  • {Domyślnie | 'level1_object_name' | WARTOŚĆ NULL.}
    Jest nazwą typu obiektu poziom 1 określonego.level1_object_namejest sysname Domyślna wartość NULL.Prawidłowe dane wejściowe są domyślnie, wartości NULL lub nazwę obiektu.

  • { Domyślnie | 'level2_object_type' | WARTOŚĆ NULL.}
    Jest to typ obiektu poziom 2.level2_object_typejest varchar(128) Domyślna wartość NULL.Prawidłowe dane wejściowe są domyślnie domyślne (map NULL) i wartość NULL.Nieprawidłowe dane wejściowe dla level2_object_type kolumny, ograniczenie, powiadomienie o zdarzeniu, indeks, PARAMETR, WYZWALACZ, i wartość NULL.

  • { Domyślnie | 'level2_object_name' | WARTOŚĆ NULL.}
    Jest nazwą typu obiektu poziom 2 określonego.level2_object_namejest sysname Domyślna wartość NULL.Prawidłowe dane wejściowe są domyślnie, wartości NULL lub nazwę obiektu.

Zwracane tabele

Jest to format tabel zwrócony przez fn_listextendedproperty.

Nazwa kolumny

Typ danych

objtype

sysname

objname

sysname

name

sysname

value

sql_variant

Jeśli tabela zwracana jest pusta, obiekt nie ma właściwości rozszerzone lub użytkownik nie ma uprawnień do wyświetlenia właściwości rozszerzone na obiekcie.Zwracając właściwości rozszerzone do bazy danych, objtype i objname kolumny będą NULL.

Uwagi

Jeśli wartość dla property_name ma wartość NULL lub domyślny fn_listextendedproperty zwraca wszystkie właściwości dla określonego obiektu.

Określony typ obiektu i odpowiadające im nazwy obiektu wartość NULL lub domyślne, fn_listextendedproperty zwraca wszystkie właściwości rozszerzone dla wszystkich obiektów określonego typu.

Obiekty są rozróżniane zgodnie z poziomami z poziom 0 jako najwyższa i poziom 2 najniższa.Jeśli niższegopoziom obiektów, poziom 1 lub 2, określić typ i nazwa, typ obiektu nadrzędnego i nazwa powinny mieć wartości NULL lub domyślne.W przeciwnym wypadku funkcja zwraca pusty zestaw wyników.

Uprawnienia

Uprawnienia, aby wyświetlić listę rozszerzonych właociwooci obiektów są zależne od typu obiektu.Aby uzyskać pełną listę uprawnień, zobacz Używanie rozszerzonych właociwooci obiektów bazy danych.

Przykłady

A.Wyświetlanie właściwości rozszerzone do bazy danych

Poniższy przykład przedstawia zestaw wszystkie właściwości rozszerzone na sam obiekt bazy danych.

USE AdventureWorks2008R2;
GO
SELECT objtype, objname, name, value
FROM fn_listextendedproperty(default, default, default, default, default, default, default);
GO

Oto zestaw wyników.

objtype objname name value

--------- --------- ----------- ----------------------------

NULL NULL MS_Description AdventureWorks2008 Sample OLTP Database

(1 row(s) affected)

B.Wyświetlanie właściwości rozszerzone na wszystkie kolumny w tabela

Poniższy przykład wyświetla listę rozszerzonych właociwooci kolumn w ScrapReason tabela.To jest zawarty w schemacie Production.

USE AdventureWorks2008R2;
GO
SELECT objtype, objname, name, value
FROM fn_listextendedproperty (NULL, 'schema', 'Production', 'table', 'ScrapReason', 'column', default);
GO

Oto zestaw wyników.

objtype objname name value

------- ----------- ------------- ------------------------

COLUMN ScrapReasonID MS_Description Primary key for ScrapReason records.

COLUMN Name MS_Description Failure description.

COLUMN ModifiedDate MS_Description Date the record was last updated.

(3 row(s) affected)

C.Wyświetlanie właściwości rozszerzone na wszystkie tabele w schemacie

Poniższy przykład zawiera listę właściwości rozszerzonych dla wszystkich tabel zawartych w Sales schematu.

USE AdventureWorks2008R2;
GO
SELECT objtype, objname, name, value
FROM fn_listextendedproperty (NULL, 'schema', 'Sales', 'table', default, NULL, NULL);
GO