Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
van toepassing op:SQL Server
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Analytics 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)