OBJECTPROPERTY (Transact-SQL)

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

Returnerar information om schemaomfattande objekt i den aktuella databasen. En lista över schemaomfattande objekt finns i sys.objects (Transact-SQL). Den här funktionen kan inte användas för objekt som inte är schemaomfattande, till exempel DDL-utlösare (datadefinitionsspråk) och händelsemeddelanden.

Transact-SQL syntaxkonventioner

Syntax

OBJECTPROPERTY ( ID , property )

Arguments

ID

Uttryck som representerar objektets ID i den aktuella databasen. ID är int och antas vara ett schemaomfattande objekt i den aktuella databaskontexten.

egenskap

Uttryck som representerar den information som ska returneras för objektet som anges av ID. egenskapen kan vara något av följande värden.

Returtyper

int

Exceptions

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

Permissions

En användare kan bara visa metadata för skyddsbara filer som användaren äger eller som användaren har beviljats behörighet för. Det innebär att metadatautsändande, inbyggda funktioner som OBJECTPROPERTY returnerar NULL om användaren inte har någon behörighet för objektet. Mer information finns i Konfiguration av synlighet för metadata.

Anmärkningar

Databasmotorn förutsätter att object_id finns i den aktuella databaskontexten. En fråga som refererar till en object_id i en annan databas returnerar NULL eller felaktiga resultat. I följande fråga är till exempel den aktuella databaskontexten master databasen. Databasmotorn försöker returnera egenskapsvärdet för den angivna object_id i databasen i stället för den databas som anges i frågan. Frågan returnerar felaktiga resultat eftersom vyn vEmployee inte finns i master databasen.

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

OBJECTPROPERTY(view_id, 'IsIndexable') kan använda betydande datorresurser eftersom utvärdering av egenskapen IsIndexable kräver parsning av vydefinition, normalisering och partiell optimering. Även om egenskapen IsIndexable identifierar tabeller eller vyer som kan indexeras, kan det faktiska skapandet av indexet fortfarande misslyckas om vissa indexnyckelkrav inte uppfylls. Mer information finns i CREATE INDEX (Transact-SQL).

OBJECTPROPERTY(table_id, 'TableHasActiveFulltextIndex') returnerar värdet 1 (sant) när minst en kolumn i en tabell läggs till för indexering. Fulltextindexering blir aktiv för populationen så snart den första kolumnen har lagts till för indexering.

När en tabell skapas QUOTED IDENTIFIER lagras alternativet alltid som ON i tabellens metadata, även om alternativet är inställt OFF på när tabellen skapas. Därför OBJECTPROPERTY(table_id, 'IsQuotedIdentOn') returnerar alltid värdet 1 (sant).

Examples

A. Kontrollera att ett objekt är en tabell

I följande exempel testas om UnitMeasure är en tabell i AdventureWorks2022 databasen.

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. Kontrollera att en skalvärdesbevärderad användardefinierad funktion är deterministisk

I följande exempel testas om den användardefinierade skalärvärdesfunktionen ufnGetProductDealerPrice, som returnerar ett pengavärde , är deterministisk.

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

Resultatuppsättningen visar att det ufnGetProductDealerPrice inte är en deterministisk funktion.

-----
0

C: Hitta de tabeller som tillhör ett specifikt schema

I följande exempel returneras alla tabeller i dbo schemat.

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

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

D: Kontrollera att ett objekt är en tabell

I följande exempel testas om dbo.DimReseller är en tabell i databasen 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

Relaterat innehåll

• COLUMNPROPERTY (Transact-SQL)
• Metadata functions (Transact-SQL)
• OBJECTPROPERTYEX (Transact-SQL)
• ÄNDRA AUKTORISERING (Transact-SQL)
• TYPEPROPERTY (Transact-SQL)
• sys.objects (Transact-SQL)