Udostępnij za pośrednictwem


fn_listextendedproperty (Transact-SQL)

Zwraca ciąg rozszerzony wartości właściwość obiektów bazy danych.

Topic link iconKonwencje składni języka Transact-SQL

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ślne | "property_name' | NULL}
    Is the name of the property.property_name is sysname.Prawidłowe dane wejściowe są domyślnie, wartości NULL lub nazwę właściwość.

  • { domyślne | "level0_object_type' | NULL}
    Is the user or user-defined type.level0_object_type is varchar(128), with a default of NULL.Prawidłowe dane wejściowe są MONTAŻOWYCH, kontrakt, powiadomienie o zdarzeniu, grupa plików, wiadomości typu PARTITION funkcja PARTITION schemat, REMOTE usługa, trasa SCHEMA, usługa TRIGGER, typ wiązania, USER i NULL.

    Important noteImportant Note:

    USER i typ jako poziom 0 typy zostaną usunięte w przyszłej wersja programu SQL Server. Należy unikać stosowania tych funkcji w nowej pracy rozwoju i zaplanować do modyfikowania aplikacji korzystających aktualnie z tych funkcji.Użyj SCHEMA jako typ poziom 0, a nie użytkownika.Dla typu należy użyć SCHEMA jako poziom 0 typ i WPISZ jako typ poziom 1.

  • { domyślne | "level0_object_name' | NULL}
    Is the name of the level 0 object type specified.level0_object_name is sysname with a default of NULL.Prawidłowe dane wejściowe są domyślnie, wartości NULL lub nazwę obiektu.

  • { domyślne | "level1_object_type' | NULL}
    Is the type of level 1 object.level1_object_type is varchar(128) with a default of NULL.Prawidłowe dane wejściowe są agregacja, domyślny, funkcja, LOGICAL FILE NAME, PROCEDURE, QUEUE, RULE, SYNONYM, tabela, typ, VIEW, kolekcja SCHEMATU XML i wartość NULL.

    Uwaga

    Domyślnie jest mapowany na wartości NULL i mapy 'Domyślne' do obiektu wpisz DEFAULT.

  • {domyślne | "level1_object_name' | NULL}
    Is the name of the level 1 object type specified.level1_object_name is sysname with a default of NULL.Prawidłowe dane wejściowe są domyślnie, wartości NULL lub nazwę obiektu.

  • { domyślne | "level2_object_type' | NULL}
    Is the type of level 2 object.level2_object_type is varchar(128) with a default of NULL.Prawidłowe dane wejściowe są domyślny, domyślne (mapy na wartość NULL) i wartość NULL.Prawidłowe dane wejściowe dla level2_object_type to kolumna, CONSTRAINT, zdarzenie powiadomienie, indeks, PARAMETR, TRIGGER i wartość NULL.

  • { domyślne | "level2_object_name' | NULL}
    Is the name of the level 2 object type specified.level2_object_name is sysname with a default of NULL.Prawidłowe dane wejściowe są domyślnie, wartości NULL lub nazwę obiektu.

Zwracane tabele

Jest to format zwracanych przez fn_listextendedproperty tabel.

Nazwa kolumna

Typ danych

ObjType

sysname

ObjName

sysname

Nazwa

sysname

wartość

sql_variant

Jeśli w 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.Przy właściwości rozszerzone do bazy danych, ObjType and ObjName kolumn będzie równa NULL.

Remarks

Jeżeli wartość parametru property_name ma wartość NULL lub domyślne fn_listextendedproperty zwraca wszystkie właściwości dla określonego obiektu.

Jeśli określono 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ą wyróżnione zgodnie z poziomami jako najwyższy poziom 0 i poziomie 2 najniższej.Jeśli obiekt jest niższego poziomu, poziom 1 lub 2, określony typ i nazwa, typ obiektu nadrzędnego i nazwy należy podać wartości, które nie są wartość NULL lub jest domyślnie.W przeciwnym wypadku funkcja zwraca zestaw wyników puste.

Uprawnienia

Uprawnienia, aby wyświetlić listę właściwości rozszerzone obiektów mogą być różne w zależności od typu obiektu.Aby uzyskać pełną listę uprawnień Zobacz Za pomocą właściwości rozszerzonych na obiekty bazy danych.

Przykłady

A.Wyświetlanie właściwości rozszerzonych z bazą danych

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

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

Here is the result set.

objtype    objname     name            value
---------  ---------   -----------     ----------------------------
NULL       NULL        MS_Description  AdventureWorks Sample OLTP Database

(1 row(s) affected)

B.Wyświetlanie właściwości rozszerzone na wszystkich kolumn w tabela

W następującym przykładzie polecenie wyświetla listę właściwości rozszerzonych dla kolumn w ScrapReason Tabela. To jest zawarty w schemacie Production.

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

Here is the result set.

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

W następującym przykładzie polecenie wyświetla listę właściwości rozszerzonych dla wszystkich tabel zawartych w Sales schemat.

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