Installera SQL Server .NET Language Extension i Windows

Gäller för: SQL Server 2019 (15.x) och senare versioner

Lär dig hur du installerar .NET Language Extension-komponenten (används av C#) för SQL Server i Windows. .NET Language Extension är en del av SQL Server Language Extensions.

Förutsättningar

• SQL Server-installationsprogrammet krävs om du vill installera stöd för .NET Language Extension.

• .NET Language Extension stöder .NET 6 och senare körningar och stöds endast i Windows.

• En databasmotorinstans krävs. Du kan inte bara installera .NET Language Extension-funktionerna, även om du kan lägga till dem stegvis i en befintlig instans.

• För affärskontinuitet stöds AlwaysOn-tillgänglighetsgrupper för språktillägg. Du måste installera språktillägg och konfigurera paket på varje nod. Installation av .NET Language Extension stöds också på en redundansklusterinstans i SQL Server.

• Installera inte SQL Server Language Extensions eller .NET Language Extension på en domänkontrollant. Språktilläggsdelen av installationen misslyckas.

• Språktillägg och Machine Learning Services installeras som standard på SQL Server-stordatakluster. Om du använder stordatakluster behöver du inte följa stegen i den här artikeln. Mer information finns i Köra Python- och R-skript med Machine Learning Services på SQL Server 2019 Big Data Clusters.

.NET-körtid

.NET 6 long-term support (LTS) är den tidigaste körningsmiljön som stöds. Du kan ladda ned .NET-körningen för Windows. Linux stöds inte.

Om du vill använda den senaste LTS-versionen av .NET-körningen måste du kompilera om .NET Language Extension.

Hämta installationsmediet

Nedladdningsplatsen för SQL Server beror på utgåvan:

• SQL Server Enterprise-, Standard- och Express-utgåvor. Dessa utgåvor är licensierade för produktionsanvändning. För Enterprise- och Standard-utgåvorna kontaktar du programvaruleverantören för installationsmediet. Du hittar inköpsinformation och en katalog med Microsoft-partner på Microsofts inköpswebbplats.

• Den senaste kostnadsfria utgåvan.

Kör installationsprogrammet

För lokala installationer måste du köra installationsprogrammet som administratör. Om du installerar SQL Server från en fjärrresurs måste du använda ett domänkonto som har läs- och körningsbehörighet på fjärrresursen.

1. Starta installationsguiden för SQL Server.

2. På fliken Installation väljer du Ny fristående SQL Server-installation eller lägger till funktioner i en befintlig installation.

3. Välj följande alternativ på sidan Funktionsval :

   Database Engine Services: Om du vill använda språktillägg med SQL Server måste du installera en instans av databasmotorn. Du kan använda antingen en standardinstans eller en namngiven instans.

   Machine Learning Services och Språktillägg: Det här alternativet installerar komponenten Språktillägg som stöder C#-kodkörning.

   

4. På sidan Klar att installera kontrollerar du att de här valen ingår och väljer Installera.

   • Databasmotortjänster
   • Maskininlärningstjänster och språktillägg

   Observera platsen för mappen under sökvägen ..\Setup Bootstrap\Log där konfigurationsfilerna lagras. När installationen är klar kan du granska de installerade komponenterna i sammanfattningsfilen.

5. När installationen är klar gör du det nu om du uppmanas att starta om datorn. Det är viktigt att läsa meddelandet från installationsguiden när du är klar med installationen. Mer information finns i Visa och läsa sql Server-installationsloggfiler.

Registrera språktillägget

1. Följ dessa steg för att ladda ned och registrera .NET-språktillägget, som används för att köra C#-kod.

   1. dotnet-core-CSharp-lang-extension-windows-release.zip Ladda ned filen från .NET-språktillägget för SQL Server GitHub-lagringsplatsen. Ladda ned den senaste Windows-filen dotnet-core-CSharp-lang-extension-windows-release.zip . Om du föredrar att använda en nyare .NET-körning måste du kompilera dotnet-core-CSharp-lang-extension från GitHub-källkoden.

   2. Använd SQL Server Management Studio (SSMS) eller Azure Data Studio för att ansluta till SQL Server-instansen och kör följande kommando Transact-SQL (T-SQL) för att registrera .NET-språktillägget med CREATE EXTERNAL LANGUAGE.

   3. Ändra sökvägen i den här instruktionen så att den återspeglar platsen för zip-filen för det nedladdade språktillägget (dotnet-core-CSharp-lang-extension-windows-release.zip).

   CREATE EXTERNAL LANGUAGE [dotnet]
   FROM (CONTENT = N'C:\path\to\dotnet-core-CSharp-lang-extension-windows-release.zip',
       FILE_NAME = 'dotnetextension.dll');
   GO
   

2. Starta om Launchpad.

   1. Öppna SQL Server Configuration Manager.

   2. Under SQL Server Services högerklickar du på SQL Server Launchpad och väljer Starta om.

Starta om tjänsten

När installationen är klar startar du om databasmotorn innan du fortsätter till nästa steg, vilket aktiverar skriptkörning.

Om du startar om tjänsten startas även den relaterade SQL Server Launchpad-tjänsten om automatiskt.

Du kan starta om tjänsten med kommandot Starta om för instansen i SSMS, med panelen Tjänster i Kontrollpanelen eller med hjälp av SQL Server Configuration Manager.

Aktivera skriptkörning

1. Öppna SQL Server Management Studio. Anslut till den instans där du installerade Språktillägg, välj Ny fråga för att öppna ett frågefönster och kör följande kommando:

   EXECUTE sp_configure;
   

   Funktionen är inaktiverad (value är 0) som standard och måste uttryckligen aktiveras av en administratör innan du kan köra C#-kod.

2. Om du vill aktivera den externa skriptfunktionen kör du följande instruktion:

   EXECUTE sp_configure 'external scripts enabled', 1;
   GO
   
   RECONFIGURE WITH OVERRIDE;
   GO
   

   Om du redan har aktiverat funktionen för Machine Learning Services kör du inte omkonfigurera en andra gång för Språktillägg. Den underliggande utökningsplattformen stöder båda.

Registrera externt språk

För varje databas som du vill använda språktillägg i måste du registrera det externa språket med SKAPA EXTERNT SPRÅK.

I följande exempel läggs ett externt språk som anropas dotnet till en databas på SQL Server i Windows.

CREATE EXTERNAL LANGUAGE [dotnet]
FROM (CONTENT = N'<path-to-zip>', FILE_NAME = 'dotnetextension.dll');
GO

Mer information finns i SKAPA EXTERNT SPRÅK.

Verifiera installationen

Kontrollera installationsstatusen för instansen i installationsloggarna.

Använd följande steg för att kontrollera att alla komponenter som används för att starta ett externt skript körs.

1. I SQL Server Management Studio eller Azure Data Studio öppnar du ett nytt frågefönster och kör följande instruktion:

   EXECUTE sp_configure 'external scripts enabled';
   

   run_value Är nu inställd på 1.

2. Öppna panelen Tjänster eller SQL Server Configuration Manager och kontrollera att SQL Server Launchpad-tjänsten körs. Du bör ha en tjänst för varje databasmotorinstans som har språktillägg installerade. Mer information om tjänsten finns i Utökningsarkitektur i SQL Server Language Extensions.

Ytterligare konfiguration

Om verifieringssteget lyckades kan du köra C#-kod från SQL Server Management Studio, Azure Data Studio, Visual Studio Code eller någon annan klient som kan skicka T-SQL-instruktioner till servern.

Om du får ett fel när du kör kommandot kan du läsa de ytterligare konfigurationsstegen i det här avsnittet. Du kan behöva göra extra lämpliga konfigurationer för tjänsten eller databasen.

På instansnivå kan extra konfiguration omfatta:

• Brandväggskonfiguration för SQL Server Machine Learning Services
• Aktivera eller inaktivera ett servernätverksprotokoll
• Server-konfiguration: fjärråtkomst
• Skapa en inloggning för SQLRUserGroup

I databasen kan du behöva följande konfigurationsuppdateringar:

• Ge databasanvändare behörighet att köra Python- och R-skript med SQL Server Machine Learning Services
• Ge användarna behörighet att köra ett visst språk

Föreslagna optimeringar

Nu när allt fungerar kanske du också vill optimera servern för att stödja .NET Language Extension.

Optimera servern för .NET Language Extension

Standardinställningarna för SQL Server-konfigurationen är avsedda att optimera serverns balans för en mängd olika tjänster som stöds av databasmotorn, vilket kan omfatta processer för att extrahera, transformera och läsa in (ETL), rapportering, granskning och program som använder SQL Server-data. Under standardinställningarna kan det därför hända att resurser för språktillägg ibland begränsas eller begränsas, särskilt i minnesintensiva åtgärder.

Vi rekommenderar att du använder SQL Server Resource Governor för att konfigurera en extern resurspool för att säkerställa att språktilläggsjobben prioriteras och resursas på rätt sätt. Du kanske också vill ändra mängden minne som allokeras till databasmotorn eller öka antalet konton som körs under SQL Server Launchpad-tjänsten.

• Information om hur du konfigurerar en resurspool för hantering av externa resurser finns i SKAPA EXTERN RESURSPOOL (Transact-SQL).

• Information om hur du ändrar mängden minne som är reserverat för databasen finns i Konfigurationsalternativ för serverminne.

Om du använder Standard Edition och inte har Resource Governor kan du använda dynamiska hanteringsvyer (DMV:er) och utökade händelser samt Windows-händelseövervakning för att hantera serverresurserna.

Nästa steg

C#-utvecklare kan komma igång med några enkla exempel och lära sig grunderna i hur C# fungerar med SQL Server. För nästa steg, se följande länk: