Delen via


DATABASEPROPERTYEX (Transact-SQL)

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Voor een opgegeven database in SQL Server retourneert deze 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. De functie 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:

Opmerking

Als de database nog niet is gestart, retourneert aanroepen null DATABASEPROPERTYEX als DATABASEPROPERTYEX deze waarden worden opgehaald via directe databasetoegang in plaats van metagegevens op te halen. Een database met AUTO_CLOSE ingesteld op AAN of anderszins offline, wordt gedefinieerd als 'niet gestart'.

Vastgoed Beschrijving Geretourneerde waarde
Vergelijken/Rangschikking Standaardsorteringsnaam voor de database. Collatienaam

NULL: De database is niet gestart.

Basisgegevenstype: nvarchar(128)
VergelijkingStijl De vergelijkingsstijl van Windows van de sortering. Gebruik de volgende stijlwaarden om een bitmap te maken voor de voltooide ComparisonStyle-waarde:

Hoofdlettergebruik negeren: 1
Accent negeren: 2
Kana negeren: 65536
Breedte negeren: 131072

De standaardwaarde van 196609 is bijvoorbeeld het resultaat van het combineren van de negeercase, het negeren van kana en het negeren van breedteopties.
Retourneert de vergelijkingsstijl.

Retourneert 0 voor alle binaire sorteringen.

Basisgegevenstype: int
Uitgave De database-editie of servicelaag. Van toepassing op: Azure SQL Database, Azure Synapse Analytics.



Algemeen Doel

Zakelijk cruciaal

Eenvoudig

Standaard

Premiumkwaliteit

Systeem (voor hoofddatabase)

NULL: De database is niet gestart.

Basisgegevenstype: nvarchar(64)
IsAnsiNullDefault Database volgt ISO-regels voor het toestaan van null-waarden. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsAnsiNullsEnabled Alle vergelijkingen met een null-waarde zijn onbekend. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsAnsiPaddingIngeschakeld Tekenreeksen worden opgevuld tot dezelfde lengte voordat vergelijking of invoeging wordt uitgevoerd. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsAnsiWarningsIngeschakeld SQL Server-problemen met fout- of waarschuwingsberichten wanneer er standaardfoutvoorwaarden optreden. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsArithmeticAbortIngeschakeld Query's eindigen wanneer een overloop- of deel-by-nul-fout optreedt tijdens het uitvoeren van query's. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsAutoSluiten De database wordt schoon afgesloten en worden resources vrijgemaakt nadat de laatste gebruiker is afgesloten. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsAutoCreateStatistieken Query optimizer maakt naar behoefte statistieken met één kolom om de queryprestaties te verbeteren. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsAutoCreateStatisticsIncremental Automatisch gemaakte statistieken voor één kolom zijn waar mogelijk incrementeel. Van toepassing op: SQL Server 2014 (12.x) en hoger.

1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsAutoShrink Databasebestanden zijn kandidaten voor automatische periodieke verkleining. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsAutoUpdateStatistieken Wanneer een query gebruikmaakt van mogelijk verouderde bestaande statistieken, worden deze statistieken bijgewerkt door de queryoptimalisatie. 1: WAAR

0: ONWAAR

NULL: invoer is ongeldig

Basisgegevenstype: int
IsClone Database is een schema- en statistiekenkopie van een gebruikersdatabase die is gemaakt met DBCC CLONEDATABASE. Van toepassing op: SQL Server 2014 (12.x) SP2 en hoger.

1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsCloseCursorsOnCommitEnabled Wanneer een transactie doorvoert, worden alle geopende cursors gesloten. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsDatabaseSuspendedForSnapshotBackup Database is onderbroken. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsFulltextIngeschakeld Database is ingeschakeld voor volledige tekst en semantische indexering. van toepassing op: SQL Server 2008 (10.0.x) en hoger.



1: WAAR

0: ONWAAR

NULL: invoer is ongeldig

Basisgegevenstype: int

Notitie: De waarde van deze eigenschap heeft nu geen effect. Gebruikersdatabases zijn altijd ingeschakeld voor zoeken in volledige tekst. In een toekomstige versie van SQL Server wordt deze eigenschap verwijderd. Gebruik deze eigenschap niet in nieuwe ontwikkelwerkzaamheden en wijzig toepassingen die momenteel deze eigenschap gebruiken zo snel mogelijk.
IsInStandBy Database is online als alleen-lezen, waarbij het herstellogboek is toegestaan. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsLocalCursorsDefault Cursordeclaraties zijn standaard ingesteld op LOCAL. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsMemoryOptimizedElevateToSnapshotEnabled Tabellen die zijn geoptimaliseerd voor geheugen, worden geopend met MOMENTOPNAME-isolatie wanneer het SESSIE-INSTELLINGSNIVEAU TRANSACTION ISOLATION IS ingesteld op READ COMMITTED, READ UNCOMMITTED of een lager isolatieniveau. Van toepassing op: SQL Server 2014 (12.x) en hoger.



1: WAAR

0: ONWAAR

Basisgegevenstype: int
IsMergeGepubliceerd SQL Server biedt ondersteuning voor databasetabelpublicatie voor samenvoegreplicatie als replicatie is geïnstalleerd. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsNullConcat Null-samenvoegingsoperand resulteert in NULL. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsNumericRoundAbortEnabled Er worden fouten gegenereerd wanneer er sprake is van een verlies van precisie in expressies. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsParametrisatieGeforceerd DE optie PARAMETERSIZATION-databaseSET is GEFORCEERD. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer
IsQuotedIdentifiersEnabled Dubbele aanhalingstekens op id's zijn toegestaan. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
Gepubliceerd Als replicatie is geïnstalleerd, biedt SQL Server ondersteuning voor databasetabelpublicatie voor momentopname of transactionele replicatie. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsRecursiveTriggersEnabled Recursieve activering van triggers is ingeschakeld. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsGeabonneerd Database is geabonneerd op een publicatie. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsSyncWithBackup De database is een gepubliceerde database of een distributiedatabase en ondersteunt een herstel dat transactionele replicatie niet verstoort. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsTornPageDetectionIngeschakeld De SQL Server Database Engine detecteert onvolledige I/O-bewerkingen die worden veroorzaakt door stroomstoringen of andere systeemstoringen. 1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsGeverifieerde Kloon Database is een schema en statistieken: alleen een kopie van een gebruikersdatabase die is gemaakt met behulp van de optie WITH VERIFY_CLONEDB van DBCC CLONEDATABASE. Van toepassing op: te beginnen met SQL Server 2016 (13.x) SP2.



1: WAAR

0: ONWAAR

NULL: ongeldige invoer

Basisgegevenstype: int
IsXTPSondersteund Geeft aan of de database ondersteuning biedt voor In-Memory OLTP. Bijvoorbeeld het maken en gebruiken van tabellen die zijn geoptimaliseerd voor geheugen en systeemeigen gecompileerde modules.

Specifiek voor SQL Server:

IsXTPSupported is onafhankelijk van het bestaan van een MEMORY_OPTIMIZED_DATA-bestandsgroep, die is vereist voor het maken van In-Memory OLTP-objecten.
Van toepassing op: SQL Server (SQL Server 2016 (13.x) en hoger) en Azure SQL Database.

1: WAAR

0: ONWAAR

NULL: ongeldige invoer, een fout of niet van toepassing

Basisgegevenstype: int
LaatsteGoede ControleDbTijd De datum en tijd van de laatste geslaagde DBCC CHECKDB die is uitgevoerd op de opgegeven database. 1 Als DBCC CHECKDB niet is uitgevoerd op een database, wordt 1900-01-01 00:00:00.000 geretourneerd. Van toepassing op: SQL Server 2016 (13.x) vanaf SP2.
SQL Server 2017 (14.x) vanaf CU9.
SQL Server 2019 (15.x) of hoger.
Azure SQL Database.

Een datum/tijd-waarde

NULL: ongeldige invoer

Basisgegevenstype: datum/tijd
LCID De sortering windows-landinstellings-id (LCID). LCID-waarde (in decimale notatie).

Basisgegevenstype: int
MaxSizeInBytes Maximale databasegrootte, in bytes. Van toepassing op: Azure SQL Database, Azure Synapse Analytics.

Azure SQL Database en Azure Synapse Analytics : waarde is gebaseerd op SLO, tenzij er extra opslag is aangeschaft.

vCore : de waarde is in stappen van 1 GB tot een maximale grootte.

NULL: Database is niet gestart

Basisgegevenstype: bigint
Terugwinning Databaseherstelmodel VOLLEDIG: Volledig herstelmodel

BULK_LOGGED: Model bulksgewijs geregistreerd

EENVOUDIG: Eenvoudig herstelmodel

Basisgegevenstype: nvarchar(128)
Doelstelling van de dienst Beschrijft het prestatieniveau van de database in SQL Database of Azure Synapse Analytics. Een van de volgende waarden:

Null: database is niet gestart

Gedeeld (voor web-/business-edities)

Eenvoudig

S0

S1

S2

S3

P1

P2

Blz. 3

Elastische pool

Systeem (voor hoofddatabase)

Basisgegevenstype: nvarchar(32)
ServiceObjectiveId De id van de servicedoelstelling in SQL Database. uniqueidentifier die de servicedoelstelling identificeert.
SQLSortOrder SQL Server-sorteervolgorde-id die wordt ondersteund in eerdere versies van SQL Server. 0: Database maakt gebruik van Windows-sortering

>0: sorteervolgorde-id van SQL Server

NULL: ongeldige invoer of database is niet gestart

Basisgegevenstype: tinyint
Toestand Databasestatus. ONLINE: Database is beschikbaar voor query's.

Notitie: De functie kan de status ONLINE retourneren terwijl de database wordt geopend en nog niet is hersteld. Als u wilt bepalen of een ONLINE-database verbindingen kan accepteren, voert u een query uit op de sorteringseigenschap van DATABASEPROPERTYEX. De ONLINE-database kan verbindingen accepteren wanneer de databasesortering een niet-null-waarde retourneert. Voor AlwaysOn-databases voert u een query uit op de kolommen database_state of database_state_desc sys.dm_hadr_database_replica_states.

OFFLINE: Database is expliciet offline gehaald.

HERSTELLEN: Databaseherstel is gestart.

HERSTELLEN: Databaseherstel is gestart en de database is nog niet gereed voor query's.

VERDACHTE: Database is niet hersteld.

NOODGEVALLEN: De database heeft een status met het kenmerk Alleen-lezen. Toegang is beperkt tot sysadmin-leden

Basisgegevenstype: nvarchar(128)
Bijwerkbaarheid Geeft aan of gegevens kunnen worden gewijzigd. READ_ONLY: Database ondersteunt gegevensleesbewerkingen, maar geen gegevenswijzigingen.

READ_WRITE: Database ondersteunt lees- en wijzigingsgegevens.

Basisgegevenstype: nvarchar(128)
Toegang voor de gebruiker Geeft aan welke gebruikers toegang hebben tot de database. SINGLE_USER: slechts één gebruiker van db_owner, dbcreator of sysadmin tegelijk

RESTRICTED_USER: Alleen leden van rollen db_owner, dbcreator of sysadmin

MULTI_USER: Alle gebruikers

Basisgegevenstype: nvarchar(128)
Versie Intern versienummer van de SQL Server-code waarmee de database is gemaakt. Alleen ter informatie geïdentificeerd. Wordt niet ondersteund. Toekomstige compatibiliteit is niet gegarandeerd. Versienummer: Database is geopend.

NULL: Database is niet gestart.

Basisgegevenstype: int
Replica-ID De replica-id van een verbonden hyperscale-database/replica. is van toepassing op: Azure SQL Database.

Hiermee wordt alleen de replica-id van een verbonden hyperscale-database/replica geretourneerd. Zie Secundaire Replica's van Hyperscale voor meer informatie over replicatypen.

NULL: het is geen hyperscale-database of de database wordt niet gestart.

Basisgegevenstype: nvarchar(128)

Opmerking

1 Voor databases die deel uitmaken van een beschikbaarheidsgroep, LastGoodCheckDbTime wordt de datum en tijd geretourneerd van de laatste geslaagde DBCC CHECKDB die is uitgevoerd op de primaire replica, ongeacht de replica van waaruit u de opdracht uitvoert.

Retourtypen

sql_variant

Uitzonderingen

Retourneert NULL bij 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 NULL kunnen retourneren als de gebruiker geen machtigingen heeft voor het object. Zie 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

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 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 Azure SQL Database gebruikt om de uitschaalfunctie te lezen, kunt u controleren of u verbinding hebt met een alleen-lezen replica of niet door de volgende query uit te voeren in de context van uw database. Het retourneert READ_ONLY 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'); 

Zie ook

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