Creare funzioni CLR
Si applica a:
SQL Server 2016 (13.x) e versioni successive
È possibile creare un oggetto di database all'interno di un'istanza di SQL Server programmata in un assembly creato in Common Language Runtime (CLR) di .NET Framework. Gli oggetti di database in grado di utilizzare il ricco modello di programmazione fornito da Common Language Runtime includono funzioni di aggregazione, funzioni, stored procedure, trigger e tipi.
La creazione di una funzione CLR in SQL Server prevede i seguenti passaggi:
Definire la funzione come metodo statico di una classe in un linguaggio supportato da .NET Framework. Per altre informazioni su come programmare le funzioni in Common Language Runtime, vedere funzioni CLR definite dall'utente. Quindi, compilare la classe per compilare un assembly in .NET Framework utilizzando il compilatore per il linguaggio appropriato.
Registrare l'assembly in SQL Server usando l'istruzione
CREATE ASSEMBLY. Per altre informazioni sugli assembly in SQL Server, vedere Assembly (motore di database).Creare la funzione che fa riferimento all'assembly registrato usando l'istruzione CREATE FUNCTION .
L'esecuzione di codice CLR in SQL Server è disattivata per impostazione predefinita. È possibile creare, modificare ed eliminare oggetti di database che fanno riferimento a moduli di codice gestito, ma questi riferimenti non vengono eseguiti in SQL Server, a meno che l'opzione di configurazione del server clr abilitata per server non sia abilitata tramite sp_configure.
Distribuire un progetto di SQL Server in Visual Studio registra un assembly nel database specificato per il progetto. La distribuzione del progetto crea anche funzioni CLR nel database per tutti i metodi annotati con l'attributo SqlFunction. Per ulteriori informazioni, vedere Distribuzione di oggetti di database CLR.
Accedere a risorse esterne
È possibile usare funzioni CLR per accedere a risorse esterne, ad esempio file, risorse di rete, servizi Web e altri database (incluse le istanze remote di SQL Server). Le funzioni CLR possono usare varie classi in .NET Framework, ad esempio System.IO, System.WebServices, System.Sqle così via. L'assembly che contiene tali funzioni deve essere configurato almeno con il set di autorizzazioni EXTERNAL_ACCESS per questo scopo. Per altre informazioni, vedere CREATE ASSEMBLY.
È possibile utilizzare il provider gestito del client SQL per accedere a istanze remote di SQL Server, tuttavia nelle funzioni CLR le connessioni loopback al server di origine non sono supportate.
Creare, modificare o eliminare assembly in SQL Server
Creare una funzione CLR
Accedere al codice nativo
Le funzioni CLR possono essere usate per accedere al codice nativo (non gestito), ad esempio codice scritto in C o C++, tramite l'uso di PInvoke da codice gestito. Per informazioni dettagliate, vedere Chiamata a funzioni native da codice gestito. È possibile riutilizzare il codice legacy come funzioni definite dall'utente CLR o scrivere funzioni definite dall'utente critiche per le prestazioni nel codice nativo e richiede l'uso di un assembly UNSAFE. Consultare Integrazione CLR per le avvertenze sull'uso degli assembly UNSAFE.