DATABASEPROPERTYEX (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL-database in Microsoft Fabric Preview

Voor een opgegeven database in SQL Server retourneert de DATABASEPROPERTYEX functie de huidige instelling van de opgegeven databaseoptie of eigenschap.

Transact-SQL syntaxis-conventies

Syntaxis

DATABASEPROPERTYEX ( database , property )

Argumenten

databank

Een expressie die de naam opgeeft van de database waarvoor DATABASEPROPERTYEX de benoemde eigenschapsgegevens worden geretourneerd. database heeft een nvarchar(128) gegevenstype.

Voor SQL Database DATABASEPROPERTYEX is de naam van de huidige database vereist. Deze retourneert NULL voor alle eigenschappen als deze een andere databasenaam krijgt.

eigenschap

Een expressie die de naam van de database-eigenschap opgeeft die moet worden geretourneerd. de eigenschap heeft een gegevenstype varchar(128) en ondersteunt een van de waarden in deze tabel:

Retourtypen

sql_variant

Uitzonderingen

Retourneert NULL een fout of als een aanroeper niet gemachtigd is om het object weer te geven.

In SQL Server kan een gebruiker alleen de metagegevens bekijken van beveiligbare items waarvan de gebruiker eigenaar is of waarvoor de gebruiker is gemachtigd. Deze regel betekent dat metagegevens die ingebouwde functies verzenden, zoals OBJECT_ID die kunnen worden geretourneerd NULL als de gebruiker geen machtigingen heeft voor het object. Zie de zichtbaarheidsconfiguratie voor metagegevens voor meer informatie.

Opmerkingen

DATABASEPROPERTYEX retourneert slechts één eigenschapsinstelling tegelijk. Als u meerdere eigenschapsinstellingen wilt weergeven, gebruikt u de catalogusweergave sys.databases .

Voorbeelden

De codevoorbeelden in dit artikel gebruiken de AdventureWorks2022 of AdventureWorksDW2022 voorbeelddatabase die u kunt downloaden van de startpagina van Microsoft SQL Server Samples en Community Projects .

Eén. De status van de AUTO_SHRINK-databaseoptie ophalen

In dit voorbeeld wordt de status van de AUTO_SHRINK databaseoptie voor de AdventureWorks database geretourneerd.

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

Hier is het resultatenoverzicht. Dit geeft aan dat AUTO_SHRINK dit is uitgeschakeld.

0

B. De standaardsortering voor een database ophalen

In dit voorbeeld worden verschillende kenmerken van de AdventureWorks database geretourneerd.

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

Hier is het resultatenoverzicht.

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

C. DATABASEPROPERTYEX gebruiken om verbinding met replica te verifiëren

Wanneer u de uitschaalfunctie van Azure SQL Database gebruikt, kunt u controleren of u bent verbonden met een alleen-lezen replica of niet door de volgende query uit te voeren in de context van uw database. Deze keert READ_ONLY terug wanneer u bent verbonden met een alleen-lezen replica. Op deze manier kunt u ook bepalen wanneer een query wordt uitgevoerd op een alleen-lezen replica.

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

Verwante inhoud

• ALTER DATABANK (Transact-SQL)
• Databasestatussen
• sys.databases (Transact-SQL)
• sys.database_files (Transact-SQL)
• SERVEREIGENSCHAP (Transact-SQL)