ROUTINES (Transact-SQL)
Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric
Returns one row for each stored procedure and function that can be accessed by the current user in the current database. The columns that describe the return value apply only to functions. For stored procedures, these columns will be NULL.
To retrieve information from these views, specify the fully qualified name of INFORMATION_SCHEMA.view_name.
Note
The ROUTINE_DEFINITION column contains the source statements that created the function or stored procedure. These source statements are likely to contain embedded carriage returns. If you are returning this column to an application that displays the results in a text format, the embedded carriage returns in the ROUTINE_DEFINITION results may affect the formatting of the overall result set. If you select the ROUTINE_DEFINITION column, you must adjust for the embedded carriage returns; for example, by returning the result set into a grid or returning ROUTINE_DEFINITION into its own text box.
Column name | Data type | Description |
---|---|---|
SPECIFIC_CATALOG | nvarchar(128) | Specific name of the catalog. This name is the same as ROUTINE_CATALOG. |
SPECIFIC_SCHEMA | nvarchar(128) | Specific name of the schema. ** Important ** Do not use INFORMATION_SCHEMA views to determine the schema of an object. INFORMATION_SCHEMA views only represent a subset of the metadata of an object. The only reliable way to find the schema of an object is to query the sys.objects catalog view. |
SPECIFIC_NAME | nvarchar(128) | Specific name of the catalog. This name is the same as ROUTINE_NAME. |
ROUTINE_CATALOG | nvarchar(128) | Catalog name of the function. |
ROUTINE_SCHEMA | nvarchar(128) | Name of the schema that contains this function. ** Important ** Do not use INFORMATION_SCHEMA views to determine the schema of an object. INFORMATION_SCHEMA views only represent a subset of the metadata of an object. The only reliable way to find the schema of an object is to query the sys.objects catalog view. |
ROUTINE_NAME | nvarchar(128) | Name of the function. |
ROUTINE_TYPE | nvarchar(20) | Returns PROCEDURE for stored procedures, and FUNCTION for functions. |
MODULE_CATALOG | nvarchar(128) | NULL. Reserved for future use. |
MODULE_SCHEMA | nvarchar(128) | NULL. Reserved for future use. |
MODULE_NAME | nvarchar(128) | NULL. Reserved for future use. |
UDT_CATALOG | nvarchar(128) | NULL. Reserved for future use. |
UDT_SCHEMA | nvarchar(128) | NULL. Reserved for future use. |
UDT_NAME | nvarchar(128) | NULL. Reserved for future use. |
DATA_TYPE | nvarchar(128) | Data type of the return value of the function. Returns table if a table-valued function. |
CHARACTER_MAXIMUM_LENGTH | int | Maximum length in characters, if the return type is a character type. -1 for xml and large-value type data. |
CHARACTER_OCTET_LENGTH | int | Maximum length in bytes, if the return type is a character type. -1 for xml and large-value type data. |
COLLATION_CATALOG | nvarchar(128) | Always returns NULL. |
COLLATION_SCHEMA | nvarchar(128) | Always returns NULL. |
COLLATION_NAME | nvarchar(128) | Collation name of the return value. For noncharacter types, returns NULL. |
CHARACTER_SET_CATALOG | nvarchar(128) | Always returns NULL. |
CHARACTER_SET_SCHEMA | nvarchar(128) | Always returns NULL. |
CHARACTER_SET_NAME | nvarchar(128) | Name of the character set of the return value. For noncharacter types, returns NULL. |
NUMERIC_PRECISION | smallint | Numeric precision of the return value. For the nonnumeric types, returns NULL. |
NUMERIC_PRECISION_RADIX | smallint | Numeric precision radix of the return value. For nonnumeric types, returns NULL. |
NUMERIC_SCALE | smallint | Scale of the return value. For nonnumeric types, returns NULL. |
DATETIME_PRECISION | smallint | Fractional precision of a second if the return value is of type datetime. Otherwise, returns NULL. |
INTERVAL_TYPE | nvarchar(30) | NULL. Reserved for future use. |
INTERVAL_PRECISION | smallint | NULL. Reserved for future use. |
TYPE_UDT_CATALOG | nvarchar(128) | NULL. Reserved for future use. |
TYPE_UDT_SCHEMA | nvarchar(128) | NULL. Reserved for future use. |
TYPE_UDT_NAME | nvarchar(128) | NULL. Reserved for future use. |
SCOPE_CATALOG | nvarchar(128) | NULL. Reserved for future use. |
SCOPE_SCHEMA | nvarchar(128) | NULL. Reserved for future use. |
SCOPE_NAME | nvarchar(128) | NULL. Reserved for future use. |
MAXIMUM_CARDINALITY | bigint | NULL. Reserved for future use. |
DTD_IDENTIFIER | nvarchar(128) | NULL. Reserved for future use. |
ROUTINE_BODY | nvarchar(30) | Returns SQL for a Transact-SQL function and EXTERNAL for an externally written function. Functions will always be SQL. |
ROUTINE_DEFINITION | nvarchar(4000) | Returns the first 4000 characters of the definition text of the function or stored procedure if the function or stored procedure is not encrypted. Otherwise, returns NULL. To ensure that you obtain the complete definition, query the OBJECT_DEFINITION function or the definition column in the sys.sql_modules catalog view. |
EXTERNAL_NAME | nvarchar(128) | NULL. Reserved for future use. |
EXTERNAL_LANGUAGE | nvarchar(30) | NULL. Reserved for future use. |
PARAMETER_STYLE | nvarchar(30) | NULL. Reserved for future use. |
IS_DETERMINISTIC | nvarchar(10) | Returns YES if the routine is deterministic. Returns NO if the routine is nondeterministic. Always returns NO for stored procedures. |
SQL_DATA_ACCESS | nvarchar(30) | Returns one of the following values: NONE = Function does not contain SQL. CONTAINS = Function possibly contains SQL. READS = Function possibly reads SQL data. MODIFIES = Function possibly modifies SQL data. Returns READS for all functions, and MODIFIES for all stored procedures. |
IS_NULL_CALL | nvarchar(10) | Indicates whether the routine will be called if any one of its arguments is NULL. |
SQL_PATH | nvarchar(128) | NULL. Reserved for future use. |
SCHEMA_LEVEL_ROUTINE | nvarchar(10) | Returns YES if schema-level function, or NO if not a schema-level function. Always returns YES. |
MAX_DYNAMIC_RESULT_SETS | smallint | Maximum number of dynamic result sets returned by routine. Returns 0 if functions. |
IS_USER_DEFINED_CAST | nvarchar(10) | Returns YES if user-defined cast function, and NO if not a user-defined cast function. Always returns NO. |
IS_IMPLICITLY_INVOCABLE | nvarchar(10) | Returns YES if the routine can be implicitly invoked, and NO if function cannot be implicitly invoked. Always returns NO. |
CREATED | datetime | Time when the routine was created. |
LAST_ALTERED | datetime | The last time the function was modified. |
See Also
System Views (Transact-SQL)
Information Schema Views (Transact-SQL)
sys.columns (Transact-SQL)
sys.objects (Transact-SQL)
sys.procedures (Transact-SQL)
sys.sql_modules (Transact-SQL)