OBJECTPROPERTY (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

Retourneert informatie over objecten in schemabereik in de huidige database. Zie sys.objects (Transact-SQL) voor een lijst met objecten met schemabereik. Deze functie kan niet worden gebruikt voor objecten die geen schemabereik hebben, zoals DDL-triggers (Data Definition Language) en gebeurtenismeldingen.

Transact-SQL syntaxis-conventies

Syntaxis

OBJECTPROPERTY ( ID , property )

Arguments

Id

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

Expressie die de informatie vertegenwoordigt die moet worden geretourneerd voor het object dat is opgegeven door de id. de eigenschap kan een van de volgende waarden zijn.

Retourtypen

int

Exceptions

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

Permissions

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 OBJECTPROPERTY 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 OBJECTPROPERTY(OBJECT_ID(N'AdventureWorks2022.HumanResources.vEmployee'), 'IsView');
GO

OBJECTPROPERTY(view_id, 'IsIndexable') kan aanzienlijke computerresources 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.

OBJECTPROPERTY(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.

Wanneer een tabel wordt gemaakt, wordt de QUOTED IDENTIFIER optie altijd opgeslagen als ON in de metagegevens van de tabel, zelfs als de optie is ingesteld OFF op wanneer de tabel wordt gemaakt. OBJECTPROPERTY(table_id, 'IsQuotedIdentOn') Daarom retourneert altijd een waarde van 1 (waar).

Voorbeelden

Eén. Controleren of een object een tabel is

In het volgende voorbeeld wordt getest of UnitMeasure een tabel in de AdventureWorks2022 database is.

USE AdventureWorks2022;
GO
IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') = 1
   PRINT 'UnitMeasure is a table.'
ELSE IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') = 0
   PRINT 'UnitMeasure is not a table.'
ELSE IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') IS NULL
   PRINT 'ERROR: UnitMeasure is not a valid object.';
GO

B. Controleer of een door de gebruiker gedefinieerde scalaire functie deterministisch is

In het volgende voorbeeld wordt getest of de door de gebruiker gedefinieerde scalaire waarde, ufnGetProductDealerPricedie een geldwaarde retourneert, deterministisch is.

USE AdventureWorks2022;
GO
SELECT OBJECTPROPERTY(OBJECT_ID('dbo.ufnGetProductDealerPrice'), 'IsDeterministic');
GO

In de resultatenset ziet u dat dit ufnGetProductDealerPrice geen deterministische functie is.

-----
0

C: De tabellen zoeken die deel uitmaken van een specifiek schema

In het volgende voorbeeld worden alle tabellen in het dbo schema geretourneerd.

-- Uses AdventureWorks

SELECT schema_name(o.schema_id), o.name, o.object_id, o.type_desc
FROM sys.objects AS o
WHERE OBJECTPROPERTY(o.object_id, N'SchemaId') = SCHEMA_ID(N'dbo')
ORDER BY o.type_desc, o.name;
GO

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

D: Controleren of een object een tabel is

In het volgende voorbeeld wordt getest of dbo.DimReseller dit een tabel is in de Database AdventureWorksPDW2022 .

-- Uses AdventureWorks

IF OBJECTPROPERTY (OBJECT_ID(N'dbo.DimReseller'),'ISTABLE') = 1
   SELECT 'DimReseller is a table.'
ELSE
   SELECT 'DimReseller is not a table.';
GO

Verwante inhoud

• COLUMNPROPERTY (Transact-SQL)
• Metagegevensfuncties (Transact-SQL)
• OBJECTPROPERTYEX (Transact-SQL)
• ALTER AUTHORIZATION (Transact-SQL)
• TYPEPROPERTY (Transact-SQL)
• sys.objects (Transact-SQL)