DATABASEPROPERTYEX (Transact-SQL)

Применимо к:SQL ServerБаза данных SQL AzureУправляемый экземпляр SQL AzureAzure Synapse AnalyticsСистема платформы аналитики (PDW)База данных SQL в предварительной версии Microsoft Fabric

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

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

Синтаксис

DATABASEPROPERTYEX ( database , property )

Аргументы

база данных

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

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

свойство

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

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

sql_variant

Исключения

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

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

Замечания

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

Примеры

Примеры кода в этой статье используют базу данных образца AdventureWorks2022 или AdventureWorksDW2022, которую можно скачать с домашней страницы образцов и проектов сообщества Microsoft SQL Server и.

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

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

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

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

0

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

В приведенном ниже примере возвращаются несколько атрибутов базы данных 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

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

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

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

Связанный контент

• Изменить базу данных (Transact-SQL)
• Состояния базы данных
• sys.databases (Transact-SQL)
• sys.database_files (Transact-SQL)
• SERVERPROPERTY (Transact-SQL)