Enabling CLR Integration

 

Updated: August 1, 2016

The common language runtime (CLR) integration feature is off by default, and must be enabled in order to use objects that are implemented using CLR integration. To enable CLR integration, use the clr enabled option of the sp_configure stored procedure in SQL Server Management Studio:

  
sp_configure 'show advanced options', 1;  
GO  
RECONFIGURE;  
GO  
sp_configure 'clr enabled', 1;  
GO  
RECONFIGURE;  
GO  

You can disable CLR integration by setting the clr enabled option to 0. When you disable CLR integration, SQL Server stops executing all CLR routines and unloads all application domains.

System_CAPS_ICON_note.jpg Note


To enable CLR integration, you must have ALTER SETTINGS server level permission, which is implicitly held by members of the sysadmin and serveradmin fixed server roles.

System_CAPS_ICON_note.jpg Note


Computers configured with large amounts of memory and a large number of processors may fail to load the CLR integration feature of SQL Server when starting the server. To address this issue, start the server by using the -gmemory_to_reserveSQL Server service startup option, and specify a memory value large enough. For more information, see Database Engine Service Startup Options.

System_CAPS_ICON_note.jpg Note


Common language runtime (CLR) execution is not supported under lightweight pooling. Before enabling CLR integration, you must disable lightweight pooling. For more information, see lightweight pooling Server Configuration Option.

sp_configure (Transact-SQL)
clr enabled Server Configuration Option
RECONFIGURE (Transact-SQL)
GRANT (Transact-SQL)
Server-Level Roles

Community Additions

ADD
Show: