DATABASEPROPERTYEX (Transact-SQL)

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalysplattformssystem (PDW)SQL-databas i Förhandsversion av Microsoft Fabric

För en angiven databas i SQL Server DATABASEPROPERTYEX returnerar funktionen den aktuella inställningen för det angivna databasalternativet eller -egenskapen.

Transact-SQL syntaxkonventioner

Syntax

DATABASEPROPERTYEX ( database , property )

Argumentpunkter

databas

Ett uttryck som anger namnet på databasen som DATABASEPROPERTYEX returnerar den namngivna egenskapsinformationen. databasen har datatypen nvarchar(128).

För SQL Database DATABASEPROPERTYEX kräver namnet på den aktuella databasen. Den returnerar NULL för alla egenskaper om den får ett annat databasnamn.

egenskap

Ett uttryck som anger namnet på den databasegenskap som ska returneras. egenskapen har datatypen varchar(128) och stöder ett av värdena i den här tabellen:

Returtyper

sql_variant

Undantag

Returnerar NULL vid fel, eller om en anropare inte har behörighet att visa objektet.

I SQL Server kan en användare bara visa metadata för skyddsbara objekt som användaren äger eller som användaren har beviljats behörighet till. Den här regeln innebär att metadatautsändande, inbyggda funktioner som OBJECT_ID kan returneras NULL om användaren inte har några behörigheter för objektet. Mer information finns i Konfiguration av synlighet för metadata.

Anmärkningar

DATABASEPROPERTYEX returnerar endast en egenskapsinställning i taget. Om du vill visa flera egenskapsinställningar använder du katalogvyn sys.databases .

Exempel

Kodexemplen i den här artikeln använder AdventureWorks2022- eller AdventureWorksDW2022-exempeldatabasen, som du kan ladda ned från startsidan Microsoft SQL Server Samples och Community Projects.

A. Hämta status för AUTO_SHRINK-databasalternativet

Det här exemplet returnerar status för AUTO_SHRINK databasalternativet AdventureWorks för databasen.

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

Här är resultatet. Detta indikerar att är AUTO_SHRINK av.

0

B. Hämta standardsortering för en databas

Det här exemplet returnerar flera attribut för AdventureWorks databasen.

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

Här är resultatet.

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

C. Använd DATABASEPROPERTYEX för att verifiera anslutningen till repliken

När du använder utskalningsfunktionen i Azure SQL Database kan du kontrollera om du är ansluten till en skrivskyddad replik eller inte genom att köra följande fråga i databasens kontext. Den returnerar READ_ONLY när du är ansluten till en skrivskyddad replik. På så sätt kan du också identifiera när en fråga körs på en skrivskyddad replik.

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

Relaterat innehåll

• ÄNDRA DATABAS (Transact-SQL)
• Databastillstånd
• sys.databaser (Transact-SQL)
• sys.database_files (Transact-SQL)
• SERVEREGENDOM (Transact-SQL)