DATABASEPROPERTYEX (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

W przypadku określonej bazy danych w programie SQL Server ta funkcja zwraca bieżące ustawienie określonej opcji lub właściwości bazy danych.

Transact-SQL konwencje składni

Składnia

DATABASEPROPERTYEX ( database , property )  

Argumenty (w programowaniu)

baza danych
Wyrażenie określające nazwę bazy danych, dla której DATABASEPROPERTYEX będą zwracane nazwane informacje o właściwości. baza danych ma typ danych nvarchar(128).

W przypadku usługi SQL Database DATABASEPROPERTYEX wymagana jest nazwa bieżącej bazy danych. Zwraca wartość NULL dla wszystkich właściwości, jeśli podano inną nazwę bazy danych.

właściwość
Wyrażenie określające nazwę właściwości bazy danych do zwrócenia. właściwość ma typ danych varchar(128) i obsługuje jedną z wartości w tej tabeli:

Typy zwracane

sql_variant

Wyjątki

Zwraca wartość NULL w przypadku błędu lub jeśli obiekt wywołujący nie ma uprawnień do wyświetlania obiektu.

W programie SQL Server użytkownik może wyświetlać tylko metadane zabezpieczanych, które użytkownik jest właścicielem lub którym udzielono użytkownikowi uprawnień. Ta reguła oznacza, że wbudowane funkcje emitujące metadane, takie jak OBJECT_ID mogą zwracać wartość NULL, jeśli użytkownik nie ma uprawnień do obiektu. Aby uzyskać więcej informacji, zobacz Konfiguracja widoczności metadanych .

Uwagi

DATABASEPROPERTYEX Zwraca tylko jedno ustawienie właściwości jednocześnie. Aby wyświetlić wiele ustawień właściwości, użyj widoku katalogu sys.databases .

Przykłady

Odp. Pobieranie stanu opcji bazy danych AUTO_SHRINK

W tym przykładzie jest zwracany stan opcji bazy danych AUTO_SHRINK dla AdventureWorks bazy danych.

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

Oto zestaw wyników. Oznacza to, że AUTO_SHRINK jest wyłączona.

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

B. Pobieranie sortowania domyślnego dla bazy danych

Ten przykład zwraca kilka atrybutów AdventureWorks bazy danych.

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

Oto zestaw wyników.

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

C. Użyj elementu DATABASEPROPERTYEX, aby zweryfikować połączenie z repliką

W przypadku korzystania z usługi Azure SQL Database odczyt funkcji skalowania w poziomie możesz sprawdzić, czy masz połączenie z repliką tylko do odczytu, czy nie, uruchamiając następujące zapytanie w kontekście bazy danych. Zwróci READ_ONLY po nawiązaniu połączenia z repliką tylko do odczytu. W ten sposób można również określić, kiedy zapytanie jest uruchomione w repliki tylko do odczytu.

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

Zobacz także

ZMIEŃ BAZĘ DANYCH (Transact-SQL)
Stany bazy danych
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)
WŁAŚCIWOŚĆ SERWERA (Transact-SQL)