OBJECTPROPERTYEX (Transact-SQL)

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

De OBJECTPROPERTYEX functie retourneert informatie over objecten met schemabereik in de huidige database.

Zie sys.objects (Transact-SQL) voor een lijst met deze objecten. OBJECTPROPERTYEX kan niet worden gebruikt voor objecten die geen schemabereik hebben, zoals DDL-triggers (Data Definition Language) en gebeurtenismeldingen.

Transact-SQL syntaxis-conventies

Syntaxis

OBJECTPROPERTYEX ( id , property )

Arguments

Id

Een expressie die de id van het object in de huidige database vertegenwoordigt. De id is int en wordt ervan uitgegaan dat het een schemabereikobject is in de huidige databasecontext.

eigenschap

Een expressie die de informatie bevat die moet worden geretourneerd voor het object dat is opgegeven door id. Het retourtype is sql_variant. In de volgende tabel ziet u het basisgegevenstype voor elke eigenschapswaarde.

Retourtypen

sql_variant

Exceptions

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

Een gebruiker kan alleen de metagegevens van beveiligbare items bekijken waarvan de gebruiker eigenaar is of waarvoor de gebruiker is gemachtigd. Dit betekent dat metagegevens verzenden, ingebouwde functies zoals OBJECTPROPERTYEX mogelijk retourneren NULL als de gebruiker geen machtiging voor het object heeft. Zie de zichtbaarheidsconfiguratie voor metagegevens voor meer informatie.

Opmerkingen

De database-engine gaat ervan uit dat object_id zich in de huidige databasecontext bevindt. Een query die verwijst naar een object_id in een andere database, retourneert NULL of onjuiste resultaten. In de volgende query is de huidige databasecontext bijvoorbeeld de master database. De database-engine probeert de eigenschapswaarde voor de opgegeven object_id in die database te retourneren in plaats van de database die is opgegeven in de query. De query retourneert onjuiste resultaten omdat de weergave vEmployee zich niet in de master database bevindt.

USE master;
GO
SELECT OBJECTPROPERTYEX(OBJECT_ID(N'AdventureWorks2022.HumanResources.vEmployee'), 'IsView');
GO

OBJECTPROPERTYEX(view_id, 'IsIndexable') kan aanzienlijke computerbronnen verbruiken omdat voor de evaluatie van de eigenschap IsIndexable het parseren van de weergavedefinitie, normalisatie en gedeeltelijke optimalisatie is vereist. Hoewel de eigenschap IsIndexable tabellen of weergaven identificeert die kunnen worden geïndexeerd, kan het maken van de index nog steeds mislukken als niet aan bepaalde vereisten voor de indexsleutel wordt voldaan. Zie CREATE INDEX (Transact-SQL)voor meer informatie.

OBJECTPROPERTYEX (table_id, 'TableHasActiveFulltextIndex') retourneert een waarde van 1 (true) wanneer ten minste één kolom van een tabel wordt toegevoegd voor indexering. Indexering in volledige tekst wordt actief voor de populatie zodra de eerste kolom wordt toegevoegd voor indexering.

Beperkingen voor zichtbaarheid van metagegevens worden toegepast op de resultatenset. Zie de zichtbaarheidsconfiguratie voor metagegevens voor meer informatie.

Voorbeelden

Eén. Het basistype van een object zoeken

In het volgende voorbeeld wordt een SYNONYMMyEmployeeTable voor de tabel in de EmployeeAdventureWorks2022 database gemaakt en wordt vervolgens het basistype van de SYNONYMdatabase geretourneerd.

USE AdventureWorks2022;
GO
CREATE SYNONYM MyEmployeeTable FOR HumanResources.Employee;
GO
SELECT OBJECTPROPERTYEX ( object_id(N'MyEmployeeTable'), N'BaseType')AS [Base Type];
GO

In de resultatenset ziet u dat het basistype van het onderliggende object, de Employee tabel, een gebruikerstabel is.

Base Type
--------
U

B. Een eigenschapswaarde retourneren

In het volgende voorbeeld wordt het aantal UPDATE triggers in de opgegeven tabel geretourneerd.

USE AdventureWorks2022;
GO
SELECT OBJECTPROPERTYEX(OBJECT_ID(N'HumanResources.Employee'), N'TABLEUPDATETRIGGERCOUNT');
GO

C. Tabellen zoeken met een beperking REFERERENDE SLEUTEL

In het volgende voorbeeld wordt de TableHasForeignKey eigenschap gebruikt om alle tabellen met een FOREIGN KEY beperking te retourneren.

USE AdventureWorks2022;
GO
SELECT name, object_id, schema_id, type_desc
FROM sys.objects
WHERE OBJECTPROPERTYEX(object_id, N'TableHasForeignKey') = 1
ORDER BY name;
GO

Voorbeelden: Azure Synapse Analytics and Analytics Platform System (PDW)

D: Het basistype van een object zoeken

In het volgende voorbeeld wordt het basistype van dbo.DimReseller het object geretourneerd.

-- Uses AdventureWorks

SELECT OBJECTPROPERTYEX ( object_id(N'dbo.DimReseller'), N'BaseType')AS BaseType;

In de resultatenset ziet u dat het basistype van het onderliggende object, de dbo.DimReseller tabel, een gebruikerstabel is.

BaseType
--------
U

Verwante inhoud

• SYNONIEM MAKEN (Transact-SQL)
• Metagegevensfuncties (Transact-SQL)
• OBJECT_DEFINITION (Transact-SQL)
• OBJECT_ID (Transact-SQL)
• OBJECT_NAME (Transact-SQL)
• sys.objects (Transact-SQL)
• ALTER AUTHORIZATION (Transact-SQL)
• TYPEPROPERTY (Transact-SQL)