DATABASEPROPERTYEX (Transact-SQL)

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)

Для указанной базы данных в SQL Server эта функция возвращает текущий параметр указанного параметра базы данных или свойства.

Соглашения о синтаксисе Transact-SQL

Синтаксис

DATABASEPROPERTYEX ( database , property )  

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

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

Для База данных SQL DATABASEPROPERTYEX требуется имя текущей базы данных. Возвращает значение NULL для всех свойств, если указано другое имя базы данных.

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

Примечание.

Если база данных еще не запущена, вызовы DATABASEPROPERTYEX будут возвращать ЗНАЧЕНИЕ NULL, если DATABASEPROPERTYEX извлекает эти значения путем прямого доступа к базе данных, а не извлечение из метаданных. База данных, для которой параметр AUTO_CLOSE имеет значение ON или которая находится вне сети по иной причине, определяется как "незапущенная".

Свойство Description Возвращенное значение
Параметры сортировки Имя параметров сортировки, установленных для базы данных по умолчанию. Имя параметров сортировки.

NULL: база данных не запущена.

Базовый тип данных: nvarchar(128)
ComparisonStyle Стиль сравнения Windows для параметров сортировки. Используйте приведенные ниже значения стиля, чтобы создать растровое изображение для готового значения ComparisonStyle.

Игнорировать случай: 1
Игнорировать акцент: 2
Игнорировать kana: 65536
Игнорировать ширину: 131072

Например, значение по умолчанию 196609 является результатом объединения регистра игнорировать, игнорировать kana и игнорировать параметры ширины.
Возвращает стиль сравнения.

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

Базовый тип данных: int
Выпуск Уровень выпуска или службы базы данных. Применимо к: База данных SQL Azure, Azure Synapse Analytics.



Общее назначение

Критически важный для бизнеса

Basic

Standard

Premium

Системный (для базы данных master)

NULL: база данных не запущена.

Базовый тип данных: nvarchar(64)
IsAnsiNullDefault База данных следует правилам ISO по разрешению значений NULL. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsAnsiNullsEnabled При всех сравнениях со значением NULL результат не определен. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsAnsiPaddingEnabled Строки перед сравнением или вставкой дополняются до одной и той же длины. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsAnsiWarningsEnabled SQL Server выводит сообщения об ошибках или предупреждения, когда возникают стандартные условия ошибки. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsArithmeticAbortEnabled Запрос завершается, если в процессе его выполнения происходит ошибка переполнения или деления на нуль. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsAutoClose После выхода последнего пользователя база данных корректно выключается и освобождает ресурсы. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsAutoCreateStatistics Оптимизатор запросов при необходимости создает статистику по отдельным столбцам для повышения производительности запросов. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsAutoCreateStatisticsIncremental Автоматические статистики в одном столбце создаются в дополнительном виде везде, где это возможно. Область применения: SQL Server 2014 (12.x) и более поздних версий.

1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsAutoShrink Файлы базы данных являются кандидатами на автоматическое периодическое сжатие. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsAutoUpdateStatistics Оптимизатор запросов обновляет существующую статистику, используемую в запросе, если она может оказаться устаревшей. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsClone База данных представляет собой копию только схемы и статистики пользовательской базы данных, созданной с помощью DBCC CLONEDATABASE. Дополнительные сведения см. в этой статье службы поддержки Майкрософт. Область применения: SQL Server 2014 (12.x) с пакетом обновления 2 (SP2) и более поздних версий.

1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsCloseCursorsOnCommitEnabled Все открытые курсоры закрываются при фиксации транзакции. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsDatabaseSuspendedForSnapshotBackup База данных приостановлена. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsFulltextEnabled В базе данных включены полнотекстовое и семантическое индексирование. Применимо: SQL Server 2008 (10.0.x) и более поздних версий.



1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int

Примечание. Значение этого свойства сейчас не учитывается. Полнотекстовый поиск всегда включен для пользовательских баз данных. В будущем выпуске SQL Server будет удалено это свойство. Не используйте его при работе над новыми приложениями и как можно быстрее измените приложения, в которых оно в настоящее время используется.
IsInStandBy В режиме «в сети» база данных доступна только для чтения, при этом разрешен журнал восстановления. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsLocalCursorsDefault Объявления курсора по умолчанию — LOCAL. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsMemoryOptimizedElevateToSnapshotEnabled К таблицам, оптимизированным для памяти, доступ производится с использованием изоляции SNAPSHOT, когда в TRANSACTION ISOLATION LEVEL установлен уровень изоляции READ COMMITTED, READ UNCOMMITTED или более низкий. Область применения: SQL Server 2014 (12.x) и более поздних версий.



1: TRUE

0: FALSE

Базовый тип данных: int
IsMergePublished SQL Server поддерживает публикацию таблиц базы данных для слияния реплика tion, если установлен реплика. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsNullConcat Объединение операнда со значением NULL дает значение NULL. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsNumericRoundAbortEnabled При потере точности в выражениях возникают ошибки. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsParameterizationForced Параметр SET PARAMETERIZATION имеет значение FORCED. 1: TRUE

0: FALSE

NULL: недопустимые входные данные
IsQuotedIdentifiersEnabled Двойные кавычки можно использовать в идентификаторах. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsPublished Если установлен реплика, SQL Server поддерживает публикацию таблиц базы данных для создания моментального снимка или реплика транзакций. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsRecursiveTriggersEnabled Рекурсивное срабатывание триггеров разрешено. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsSubscribed База данных подписана на публикацию. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsSyncWithBackup База данных является опубликованной либо базой данных распространителя и поддерживает восстановление без нарушения репликации транзакций. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsTornPageDetectionEnabled Sql Server ядро СУБД обнаруживает неполные операции ввода-вывода, вызванные сбоями питания или другими системными сбоями. 1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsVerifiedClone База данных представляет собой копию только схемы и статистики пользовательской базы данных, созданной с помощью параметра WITH VERIFY_CLONEDB функции DBCC CLONEDATABASE. Дополнительные сведения см. в этой статье службы поддержки Майкрософт. Применимо: начиная с SQL Server 2016 (13.x) с пакетом обновления 2 (SP2).



1: TRUE

0: FALSE

NULL: недопустимые входные данные

Базовый тип данных: int
IsXTPSupported Указывает, поддерживает ли база данных OLTP в памяти. Например, создание и использование оптимизированных для памяти таблиц и собственных скомпилированных модулей.

Зависит от SQL Server:

IsXTPSupported не зависит от наличия файловой группы MEMORY_OPTIMIZED_DATA, которая требуется для создания объектов выполняющейся в памяти OLTP.
Область применения: SQL Server (SQL Server 2016 (13.x) и более поздних версий) и База данных SQL Azure.

1: TRUE

0: FALSE

NULL: недопустимый ввод, ошибка или неприменимо

Базовый тип данных: int
LastGoodCheckDbTime Дата и время последнего успешного выполнения DBCC CHECKDB, запущенного в указанной базе данных.1 Если DBCC CHECKDB не запущена в базе данных, возвращается 1900-01-01 00:00:00:00.000. Область применения: SQL Server 2016 (13.x) начиная с пакета обновления 2 (SP2).
SQL Server 2017 (14.x) начиная с cu9.
SQL Server 2019 (15.x) или более поздней версии.
База данных SQL Azure.

Значение datetime

NULL: недопустимые входные данные

Базовый тип данных: datetime
LCID Код языка Windows для параметров сортировки. Значение кода языка (в десятичном формате).

Базовый тип данных: int
MaxSizeInBytes Максимальный размер базы данных в байтах. Применимо к: База данных SQL Azure, Azure Synapse Analytics.

База данных SQL Azure и Azure Synapse Analytics — значение зависит от целевого показателя обслуживания, если не куплено дополнительное хранилище.

Виртуальное ядро — значение увеличивается на 1 ГБ до максимального размера.

NULL: база данных не запущена

Базовый тип данных: bigint
Восстановление Модель восстановления базы данных FULL: модель полного восстановления

BULK_LOGGED: модель восстановления с неполным протоколированием

SIMPLE: простая модель восстановления

Базовый тип данных: nvarchar(128)
ServiceObjective Описывает уровень производительности базы данных в База данных SQL или Azure Synapse Analytics. Одно из следующих значений:

NULL = база данных не запущена

Общий (для выпусков Web или Business)

Базовая

S0

S1

S2

S3

P1

P2

P3

ElasticPool

Системный (для базы данных master)

Базовый тип данных: nvarchar(32)
ServiceObjectiveId Идентификатор цели службы в База данных SQL. uniqueidentifier, определяющий цель службы.
SQLSortOrder Идентификатор порядка сортировки SQL Server, поддерживаемый в более ранних версиях SQL Server. 0: в базе данных используются параметры сортировки Windows

>0: идентификатор порядка сортировки SQL Server

NULL: недопустимые входные данные или база данных не запущена

Базовый тип данных: tinyint
Состояние Состояние базы данных. ONLINE: база данных доступна для запросов.

Примечание. Функция может вернуть состояние ONLINE, пока база данных откроется и еще не восстановлена. Чтобы определить, может ли база данных в состоянии ONLINE принимать соединения, запросите свойство Collation функции DATABASEPROPERTYEX. База данных в состоянии ONLINE может принимать соединения, если параметры сортировки базы данных возвращают значение, отличное от NULL. Применительно к базам данных AlwaysOn выполните запрос к столбцу database_state или database_state_desc представления sys.dm_hadr_database_replica_states.

OFFLINE: база данных явным образом переведена в режим "вне сети".

RESTORING: началось восстановление базы данных.

ВОССТАНОВЛЕНИЕ. Восстановление базы данных запущено, и база данных еще не готова к запросам.

ПОДОЗРЕВАЕМЫЙ: База данных не восстановлена.

EMERGENCY: база данных находится в аварийном состоянии и доступна только для чтения. Доступ ограничен членами роли sysadmin.

Базовый тип данных: nvarchar(128)
Updateability Указывает, можно ли изменять данные. READ_ONLY: база данных поддерживает операции чтения, но не изменения данных.

READ_WRITE: база данных поддерживает операции чтения и изменения данных.

Базовый тип данных: nvarchar(128)
UserAccess Указывает пользователей, имеющих доступ к базе данных. SINGLE_USER: в каждый момент времени доступ имеет только один пользователь db_owner, dbcreator или sysadmin

RESTRICTED_USER: только члены ролей db_owner, dbcreator или sysadmin

MULTI_USER: все пользователи

Базовый тип данных: nvarchar(128)
Версия Внутренний номер версии кода SQL Server, с помощью которого была создана база данных. Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется. Номер версии: база данных открыта.

NULL: база данных не запущена.

Базовый тип данных: int
Реплики Идентификатор реплика подключенной базы данных гипермасштабирования или реплика. Область применения: База данных SQL Azure.

Он возвращает только идентификатор реплика подключенной базы данных гипермасштабирования или реплика. Дополнительные сведения о типах реплика см. в дополнительных реплика гипермасштабирования.

NULL: это не база данных гипермасштабирования или база данных не запущена.

Базовый тип данных: nvarchar(128)

Примечание.

1 Для баз данных, входящих в группу доступности, LastGoodCheckDbTime возвращает дату и время последней успешной команды DBCC CHECKDB в первичной реплике независимо от того, из какой реплики она запускалась.

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

sql_variant

Исключения

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

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

Замечания

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

Примеры

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

В приведенном ниже примере возвращается состояние параметра AUTO_SHRINK базы данных AdventureWorks.

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

Результирующий набор: Это означает, что AUTO_SHRINK отключен.

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

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

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

SELECT   
    DATABASEPROPERTYEX('AdventureWorks2022', 'Collation') AS Collation,  
    DATABASEPROPERTYEX('AdventureWorks2022', 'Edition') AS Edition,  
    DATABASEPROPERTYEX('AdventureWorks2022', 'ServiceObjective') AS ServiceObjective,  
    DATABASEPROPERTYEX('AdventureWorks2022', 'MaxSizeInBytes') AS MaxSizeInBytes  

Результирующий набор:

Collation                     Edition        ServiceObjective  MaxSizeInBytes  
----------------------------  -------------  ----------------  --------------  
SQL_Latin1_General_CP1_CI_AS  DataWarehouse  DW1000            5368709120  

C. Проверка подключения к реплике с помощью DATABASEPROPERTYEX

При использовании База данных SQL Azure считывания функции горизонтального масштабирования можно проверить, подключен ли вы к реплика только для чтения или нет, выполнив следующий запрос в контексте базы данных. Вы получите READ_ONLY при подключении к реплике только для чтения. Таким образом можно также узнать, когда запрос выполняется в реплике только для чтения.

SELECT DATABASEPROPERTYEX(DB_NAME(), 'Updateability'); 

См. также

ALTER DATABASE (Transact-SQL)
Состояния базы данных
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)
SERVERPROPERTY (Transact-SQL)