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

Funktionen OBJECTPROPERTYEX returnerar information om schemaomfattande objekt i den aktuella databasen.

En lista över dessa objekt finns i sys.objects (Transact-SQL). OBJECTPROPERTYEX 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

OBJECTPROPERTYEX ( id , property )

Arguments

ID

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

egenskap

Ett uttryck som innehåller den information som ska returneras för objektet som anges av ID. Returtypen är sql_variant. I följande tabell visas basdatatypen för varje egenskapsvärde.

Returtyper

sql_variant

Exceptions

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

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 OBJECTPROPERTYEX kan returneras 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 databasen som anges i frågan. Frågan returnerar felaktiga resultat eftersom vyn vEmployee inte finns i master databasen.

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

OBJECTPROPERTYEX(view_id, 'IsIndexable') kan förbruka 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).

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

Begränsningar för metadatasynlighet tillämpas på resultatuppsättningen. Mer information finns i Konfiguration av synlighet för metadata.

Examples

A. Hitta bastypen för ett objekt

I följande exempel skapas en SYNONYMför tabellen i AdventureWorks2022 databasen och returnerar sedan bastypen för SYNONYM.EmployeeMyEmployeeTable

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

Resultatuppsättningen visar att bastypen för det underliggande objektet, Employee tabellen, är en användartabell.

Base Type
--------
U

B. Returnera ett egenskapsvärde

I följande exempel returneras antalet UPDATE utlösare i den angivna tabellen.

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

C. Hitta tabeller som har en FOREIGN KEY-begränsning

I följande exempel används egenskapen TableHasForeignKey för att returnera alla tabeller som har en FOREIGN KEY begränsning.

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

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

D: Hitta bastypen för ett objekt

I följande exempel returneras bastypen för dbo.DimReseller objektet.

-- Uses AdventureWorks

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

Resultatuppsättningen visar att bastypen för det underliggande objektet, dbo.DimReseller tabellen, är en användartabell.

BaseType
--------
U

Relaterat innehåll

• SKAPA SYNONYM (Transact-SQL)
• Metadata functions (Transact-SQL)
• OBJECT_DEFINITION (Transact-SQL)
• OBJECT_ID (Transact-SQL)
• OBJECT_NAME (Transact-SQL)
• sys.objects (Transact-SQL)
• ÄNDRA AUKTORISERING (Transact-SQL)
• TYPEPROPERTY (Transact-SQL)