DATABASEPROPERTY (Transact-SQL)

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

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

Важно!
В будущей версии Microsoft SQL Server эта возможность будет удалена. Избегайте использования этой возможности в новых разработках и запланируйте изменение существующих приложений, в которых она применяется. Вместо этой функции рекомендуется использовать функцию DATABASEPROPERTYEX.

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

Синтаксис

DATABASEPROPERTY ( database , property ) 

Аргументы

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

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

  Значение	Описание	Возвращенное значение
  IsAnsiNullDefault	База данных следует правилам SQL-92 по разрешению значений NULL.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsAnsiNullsEnabled	При всех сравнениях со значением NULL результат не определен.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsAnsiWarningsEnabled	Сообщения об ошибках или предупреждения отображаются, если появляются стандартные условия ошибки.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsAutoClose	После выхода последнего пользователя база данных аккуратно выключается и освобождает ресурсы.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsAutoCreateStatistics	Существующая статистика обновляется автоматически, когда она становится устаревшей из-за изменения данных в таблицах.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsAutoShrink	Файлы базы данных являются кандидатами на автоматическое периодическое сжатие.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsAutoUpdateStatistics	Параметр автоматического обновления статистики базы данных установлен.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsBulkCopy	База данных позволяет выполнять операции, не записываемые в журнал.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsCloseCursorsOnCommitEnabled	Открытые курсоры закрываются при фиксации транзакции.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsDboOnly	База данных находится в режиме доступа «только DBO».	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsDetached	База данных была отсоединена путем выполнения операции отсоединения.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsEmergencyMode	Включен аварийный режим, позволяющий использовать подозрительную базу данных.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsFulltextEnabled	База данных поддерживает полнотекстовый поиск.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsInLoad	База данных загружается.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsInRecovery	База данных восстанавливается.	1 = TRUE; 0 = FALSE; NULL1 = Входные данные неверны
  IsInStandBy	База данных доступна в режиме только для чтения, разрешен журнал восстановления.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsLocalCursorsDefault	Объявления курсора по умолчанию — LOCAL.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsNotRecovered	База данных не смогла выполнить восстановление.	1 = TRUE; 0 = FALSE; NULL = Входные данные неверны
  IsNullConcat	Сцепление операнда со значением NULL дает значение NULL.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsOffline	База данных отключена.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsParameterizationForced	Параметр SET PARAMETERIZATION имеет значение FORCED.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsQuotedIdentifiersEnabled	Двойные кавычки можно использовать в идентификаторах.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsReadOnly	База данных находится в режиме «только для чтения».	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsRecursiveTriggersEnabled	Рекурсивное срабатывание триггеров разрешено.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsShutDown	При запуске базы данных возникли проблемы.	1 = TRUE; 0 = FALSE; NULL1 = Входное значение неверно
  IsSingleUser	База данных находится в однопользовательском режиме.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsSuspect	Подозрительная база данных.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  IsTruncLog	База данных усекает контрольные точки входа.	1 = TRUE; 0 = FALSE; NULL = Недопустимые входные данные.
  Version	Внутренний номер версии кода Microsoft SQL Server, которым была создана база данных. Только для внутреннего использования средствами SQL Server и при обработке обновлений.	Номер версии = База данных открыта. NULL = База данных закрыта.

1 Значение NULL возвращается также и в том случае, если база данных никогда не запускалась или была автоматически закрыта.

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

int

Исключения

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

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

Примеры

Следующий пример возвращает значение свойства IsTruncLog для базы данных master.

USE master;
GO
SELECT DATABASEPROPERTY('master', 'IsTruncLog');

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

-------------------
1

См. также

Справочник

ALTER DATABASE (Transact-SQL)
DATABASEPROPERTYEX (Transact-SQL)
Функции метаданных (Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)

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

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

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