Creare funzioni CLR

  • Articolo

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 programmato in un assembly creato in Common Language Runtime (CLR) di Microsoft .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 sulla programmazione di funzioni in CLR, 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 con 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 tali riferimenti non verranno eseguiti in SQL Server a meno che non si abiliti l'opzione clr enabled usando sp_configure (Transact-SQL).

Con la distribuzione di un progetto SQL Server in Microsoft Visual Studio viene registrato un assembly nel database specificato per il progetto. La distribuzione del progetto consente anche di creare funzioni CLR nel database per tutti i metodi annotati con l'attributo SqlFunction . Per altre informazioni, vedere Distribuzione di oggetti di database CLR.

Accedere a risorse esterne

Le funzioni CLR possono essere utilizzate per accedere a risorse esterne, ad esempio file, risorse di rete, servizi Web o altri database, comprese istanze remote di SQL Server. A questo scopo è possibile utilizzare varie classi di .NET Framework, ad esempio System.IO, System.WebServices, System.Sql e così via. L'assembly che contiene tali funzioni deve essere configurato almeno con l'autorizzazione EXTERNAL_ACCESS impostata a questo scopo. Per altre informazioni, vedere CREATE ASSEMBLY (Transact-SQL). È 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.

Per creare, modificare o eliminare assembly in SQL Server

Per 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. In questo modo è possibile riutilizzare codice legacy, quali funzioni CLR definite dall'utente, o scrivere funzioni definite dall'utente critiche in codice nativo, e richiede l'uso di un assembly UNSAFE. Vedere Sicurezza dall'accesso di codice dell'integrazione con CLR per le cautele da prendere per l'uso di assembly UNSAFE.

Vedi anche