OBJECT_DEFINITION (Transact-SQL)
Devuelve el texto de origen de Transact-SQL para la definición de un objeto especificado.
Se aplica a: SQL Server (SQL Server 2008 a versión actual), Windows Azure SQL Database (Versión inicial a versión actual). |
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
OBJECT_DEFINITION ( object_id )
Argumentos
- object_id
Es el identificador del objeto que se va a utilizar. object_id es de tipo int y se considera que representa un objeto del contexto de la base de datos actual.
Tipos de valor devueltos
nvarchar(max)
Excepciones
Devuelve NULL si se produce un error o si el autor de la llamada no tiene permiso para ver el objeto.
Un usuario solo puede ver los metadatos de elementos protegibles que posea o para los que se le haya concedido permiso. Esto significa que las funciones integradas de emisión de metadatos, como OBJECT_DEFINITION, pueden devolver NULL si el usuario no tiene ningún permiso para el objeto. Para obtener más información, vea Configuración de visibilidad de los metadatos.
Comentarios
Motor de base de datos de SQL Server presupone que object_id se encuentra en el contexto de la base de datos actual. La intercalación de la definición del objeto siempre coincide con la del contexto de la base de datos que realiza la llamada.
OBJECT_DEFINITION se aplica a los siguientes tipos de objeto:
C = Restricción CHECK
D = DEFAULT (restricción o independiente)
P = Procedimiento almacenado de SQL
FN = Función escalar de SQL
R = Regla
RF = Procedimiento de filtro de replicación
TR = Desencadenador SQL (desencadenador DML en el ámbito del esquema o desencadenador DDL en el ámbito de la base de datos o del servidor)
IF = Función SQL insertada con valores de tabla
TF = Función con valores de tabla de SQL
V = Vista
Permisos
Las definiciones de los objetos del sistema están visibles públicamente. La definición de los objetos de usuario está visible para el propietario del objeto o los receptores de los permisos siguientes: ALTER, CONTROL, TAKE OWNERSHIP o VIEW DEFINITION. Estos permisos corresponden implícitamente a los miembros de los roles fijos de base de datos db_owner, db_ddladmin y db_securityadmin.
Ejemplos
A.Devolver el texto de origen de un objeto definido por el usuario
En el ejemplo siguiente se devuelve la definición de un desencadenador definido por el usuario, uAddress, en el esquema Person. Se utiliza la función integrada OBJECT_ID para devolver el Id. de objeto del desencadenador a la instrucción OBJECT_DEFINITION.
USE AdventureWorks2012;
GO
SELECT OBJECT_DEFINITION (OBJECT_ID(N'Person.uAddress')) AS [Trigger Definition];
GO
B.Devolver el texto de origen de un objeto del sistema
En el ejemplo siguiente se devuelve la definición del procedimiento almacenado del sistema sys.sp_columns.
USE AdventureWorks2012;
GO
SELECT OBJECT_DEFINITION (OBJECT_ID(N'sys.sp_columns')) AS [Object Definition];
GO
Vea también
Referencia
Funciones de metadatos (Transact-SQL)