DATABASEPROPERTYEX (Transact-SQL)

Изменения: 17 июля 2006 г.

Возвращает текущее значение заданного параметра или свойства указанной базы данных.

Синтаксические обозначения в Transact-SQL

Синтаксис

DATABASEPROPERTYEX ( database , property )

Аргументы

• database
  Выражение, представляющее собой имя базы данных, для которой возвращается значение названного свойства. Аргумент database имеет тип nvarchar(128).

• property
  Выражение, представляющее собой имя возвращаемого свойства базы данных. Аргумент property имеет тип varchar(128) и может принимать одно из перечисленных ниже значений. Тип возвращаемого значения — sql_variant. В следующей таблице перечислены базовые типы данных для каждого из свойств.

  Примечание.
  Если база данных не запущена, значения свойств, для получения которых компоненту Microsoft SQL Server 2005 Database Engine нужен непосредственный доступ к базе данных вместо доступа к метаданным, возвращаются равными значению NULL. Это происходит в случае, если для базы данных параметр AUTO_CLOSE установлен в ON или если база данных находится в автономном режиме по другой причине.

  Свойство

Типы возвращаемых данных

sql_variant

Исключения

Возвращает значение NULL в случае ошибки или если участник не имеет разрешения на просмотр объекта.

В SQL Server 2005 пользователь может просматривать только метаданные защищаемых объектов, которыми он владеет или на которые пользователю были предоставлены разрешения. Это означает, что встроенные функции, создающие метаданные, такие как OBJECT_ID, могут вернуть значение NULL в случае, если пользователь не имеет разрешений на объект. Дополнительные сведения см. в разделах Настройка видимости метаданных и Устранение неполадок, связанных с видимостью метаданных.

Замечания

Функция DATABASEPROPERTYEX возвращает каждый раз значение только одного свойства. Для отображения значений нескольких свойств используйте представление каталога sys.databases.

Примеры

A. Получение состояния параметра базы данных AUTO_SHRINK

На следующем примере показано, как возвращается состояние параметра AUTO_SHRINK базы данных AdventureWorks.

SELECT DATABASEPROPERTYEX('AdventureWorks', 'IsAutoShrink');

Ниже приводится результирующий набор. Это означает, что параметр AUTO_SHRINK отключен.

------------------
0

Б. Получение установленных по умолчанию параметров сортировки для базы данных

На следующем примере показано, как возвращается имя установленных по умолчанию для базы данных AdventureWorks параметров сортировки.

SELECT DATABASEPROPERTYEX('AdventureWorks', 'Collation');

Ниже приводится результирующий набор.

------------------------------
SQL_Latin1_General_CP1_CI_AI

См. также

Справочник

ALTER DATABASE (Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)

Другие ресурсы

Состояния базы данных
Установка параметров базы данных
Использование данных типа sql_variant

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений

Версия	Журнал
17 июля 2006 г.	Новое содержимое Добавлен раздел «Исключения».
14 апреля 2006 г.	Измененное содержимое Исправлены и расширены описания аргументов ComparisonStyle и LCID.