OBJECT_DEFINITION (Transact-SQL)

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric

Geeft de Transact-SQL brontekst van de definitie van een gespecificeerd object terug.

Transact-SQL syntaxis-conventies

Syntaxis

OBJECT_DEFINITION ( object_id )  

Arguments

object_id
Is de ID van het object dat gebruikt moet worden. object_id is int, en wordt aangenomen een object te representeren in de huidige databasecontext.

Retourtypen

nvarchar(max)

Exceptions

Retourneert NULL bij 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 metadata-uitzendende, ingebouwde functies zoals OBJECT_DEFINITION NULL kunnen teruggeven als de gebruiker geen toestemming heeft voor het object. Zie Zichtbaarheidsconfiguratie voor metagegevensvoor meer informatie.

Opmerkingen

De SQL Server Database Engine gaat ervan uit dat object_id zich in de huidige databasecontext bevindt. De collatie van de objectdefinitie komt altijd overeen met die van de aanroepende databasecontext.

OBJECT_DEFINITION geldt voor de volgende objecttypes:

• C = Controlebeperking

• D = Standaard (beperking of stand-alone)

• P = SQL stored procedure

• FN = SQL-scalairfunctie

• R = Regel

• RF = Replicatiefilterprocedure

• TR = SQL-trigger (schema-scoped DML-trigger, of DDL-trigger op de database- of serverscope)

• IF = SQL inline tabelwaardefunctie

• TF = SQL-tabelwaardige functie

• V = Weergave

Permissions

Definities van systeemobjecten zijn openbaar zichtbaar. De definitie van gebruikersobjecten is zichtbaar voor de objecteigenaar of ontvangers van een van de volgende machtigingen: ALTER, CONTROL, TAKE OWNERSHIP of VIEW DEFINITION. Deze machtigingen worden impliciet bewaard door leden van de db_owner, db_ddladminen db_securityadmin vaste databaserollen.

Voorbeelden

Eén. Het teruggeven van de brontekst van een door de gebruiker gedefinieerd object

Het volgende voorbeeld geeft de definitie van een door de gebruiker gedefinieerde trigger, uAddress, terug in het Person schema. De ingebouwde functie OBJECT_ID wordt gebruikt om de object-ID van de trigger terug te geven aan de OBJECT_DEFINITION instructie.

USE AdventureWorks2022;  
GO  
SELECT OBJECT_DEFINITION (OBJECT_ID(N'Person.uAddress')) AS [Trigger Definition];   
GO  

B. Het teruggeven van de brontekst van een systeemobject

Het volgende voorbeeld geeft de definitie van de systeemopgeslagen procedure sys.sp_columns.

USE AdventureWorks2022;  
GO  
SELECT OBJECT_DEFINITION (OBJECT_ID(N'sys.sp_columns')) AS [Object Definition];  
GO  

Zie ook

Metagegevensfuncties (Transact-SQL)
OBJECT_NAME (Transact-SQL)
OBJECT_ID (Transact-SQL)
sp_helptext (Transact-SQL)
sys.sql_modules (Transact-SQL)
sys.server_sql_modules (Transact-SQL)