Sdílet prostřednictvím

Instalace rozšíření jazyka SQL Server .NET ve Windows

Platí pro: SQL Server 2019 (15.x) a novější verze

Zjistěte, jak nainstalovat komponentu .NET Language Extension (kterou používá C#) pro SQL Server ve Windows. Rozšíření jazyka .NET je součástí jazykových rozšíření SQL Server.

Poznámka:

Tento článek se zabývá instalací rozšíření jazyka .NET pro SQL Server ve Windows. Linux se nepodporuje.

Požadavky

Poznámka:

Možnosti funkce a možnosti instalace se liší mezi verzemi SQL Serveru. Pomocí rozevíracího seznamu selektoru verzí zvolte odpovídající verzi SQL Serveru.

  • Instalace SQL Serveru je nutná, pokud chcete nainstalovat podporu pro rozšíření jazyka .NET.

  • Rozšíření jazyka .NET podporuje moduly runtime .NET 6 a novější a je podporováno pouze ve Windows.

  • Je vyžadována instance databázového stroje. Nemůžete nainstalovat jenom funkce rozšíření jazyka .NET, i když je můžete přírůstkově přidat do existující instance.

  • V případě provozní kontinuity jsou skupiny dostupnosti AlwaysOn podporovány pro rozšíření jazyka. Na každý uzel musíte nainstalovat jazyková rozšíření a nakonfigurovat balíčky. Instalace rozšíření jazyka .NET se také podporuje v instanci clusteru s podporou převzetí služeb při selhání v SQL Serveru.

  • Nenainstalujte jazyková rozšíření SQL Serveru ani rozšíření jazyka .NET na řadiči domény. Část Jazykové rozšíření instalačního programu se nezdaří.

  • Jazykové rozšíření a služby Machine Learning Services se ve výchozím nastavení instalují v clusterech s velkými objemy dat SQL Serveru. Pokud používáte clustery s velkými objemy dat, nemusíte postupovat podle kroků v tomto článku. Další informace najdete v tématu Spouštění skriptů Pythonu a R pomocí služby Machine Learning Services v clusterech s velkými objemy dat SQL Serveru 2019.

Důležité

Po dokončení instalace nezapomeňte dokončit kroky po konfiguraci popsané v tomto článku. Mezi tyto kroky patří povolení použití externího kódu SQL Serveru a přidání účtů potřebných pro spuštění kódu jazyka C# vaším jménem. Změny konfigurace obecně vyžadují restartování instance nebo restartování služby Launchpad.

Modul runtime .NET

Dlouhodobé podpory .NET 6 (LTS) je nejstarší podporovaný modul runtime. Modul runtime .NET pro Windows si můžete stáhnout. Linux se nepodporuje.

Pokud chcete použít nejnovější verzi modulu runtime .NET LTS, musíte překompilovat jazykovou příponu .NET.

Získání instalačního média

Umístění stahování pro SQL Server závisí na edici:

  • Edice SQL Server Enterprise, Standard a Express. Tyto edice jsou licencované pro produkční použití. V případě edicí Enterprise a Standard se obraťte na dodavatele softwaru pro instalační médium. Informace o nákupu a adresář partnerů Microsoftu najdete na nákupním webu Microsoftu.

  • Nejnovější bezplatná edice.

Spuštění instalace

Pro místní instalace musíte spustit instalační program jako správce. Pokud instalujete SQL Server ze vzdálené sdílené složky, musíte použít účet domény, který má oprávnění ke čtení a spouštění pro vzdálenou sdílenou složku.

  1. Spusťte průvodce instalací pro SQL Server.

  2. Na kartě Instalace vyberte Samostatná instalace Nového SQL Serveru nebo přidejte funkce do existující instalace.

  3. Na stránce Výběr funkcí vyberte tyto možnosti:

    Služby databázového stroje: Chcete-li používat jazyková rozšíření s SQL Serverem, musíte nainstalovat instanci databázového stroje. Můžete použít buď výchozí, nebo pojmenovanou instanci.

    Machine Learning Services a rozšíření jazyka: Tato možnost nainstaluje komponentu Language Extensions, která podporuje spouštění kódu jazyka C#.

    Snímek obrazovky s funkcemi instance

  4. Na stránce Připraveno k instalaci ověřte, že jsou tyto možnosti zahrnuté, a vyberte Nainstalovat.

    • Služby databázového stroje
    • Machine Learning Services a rozšíření jazyka

    Poznamenejte si umístění složky pod cestou ..\Setup Bootstrap\Log , kam jsou uložené konfigurační soubory. Po dokončení instalace můžete zkontrolovat nainstalované součásti v souboru Souhrn.

  5. Po dokončení instalace, pokud máte pokyn k restartování počítače, udělejte to teď. Při dokončení instalace je důležité přečíst zprávu průvodce instalací. Další informace naleznete v tématu Zobrazení a čtení souborů protokolu instalace SYSTÉMU SQL Server.

Registrace rozšíření jazyka

  1. Podle těchto kroků stáhněte a zaregistrujte rozšíření jazyka .NET, které se používá ke spuštění kódu jazyka C#.

    1. dotnet-core-CSharp-lang-extension-windows-release.zip Stáhněte si soubor z rozšíření jazyka .NET pro úložiště SQL Server GitHub. Stáhněte si nejnovější soubor Windows dotnet-core-CSharp-lang-extension-windows-release.zip . Pokud raději používáte novější modul runtime .NET, musíte zkompilovat dotnet-core-CSharp-lang-extension zdrojový kód GitHubu.

    2. Pomocí aplikace SQL Server Management Studio (SSMS) se připojte k instanci SQL Serveru a spuštěním následujícího příkazu Transact-SQL (T-SQL) zaregistrujte rozšíření jazyka .NET v jazyce CREATE EXTERNAL LANGUAGE.

    3. Upravte cestu v tomto příkazu tak, aby odrážela umístění staženého souboru ZIP s příponou jazyka (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. Restartujte Launchpad.

    1. Otevřete SQL Server Configuration Manager.

    2. V části Služby SQL Serveru klikněte pravým tlačítkem myši na launchpad SQL Serveru a vyberte Restartovat.

Restartujte službu.

Po dokončení instalace restartujte databázový stroj a teprve potom pokračujte dalším krokem a povolte spuštění skriptu.

Restartování služby také automaticky restartuje související službu SQL Server Launchpad.

Službu můžete restartovat pomocí příkazu Restartovat pravým tlačítkem myši pro instanci v nástroji SSMS, pomocí panelu Služby v Ovládacích panelech nebo pomocí nástroje SQL Server Configuration Manager.

Povolení spouštění skriptů

  1. Otevřete SQL Server Management Studio. Připojte se k instanci, do které jste nainstalovali jazyková rozšíření, vyberte Nový dotaz , aby se otevřelo okno dotazu, a spusťte následující příkaz:

    EXECUTE sp_configure;

    Funkce je ve výchozím nastavení vypnutá (value je 0) a musí ji explicitně povolit správce, aby bylo možné spustit kód jazyka C#.

  2. Pokud chcete povolit funkci externího skriptování, spusťte následující příkaz:

    EXECUTE sp_configure 'external scripts enabled', 1;
GO

RECONFIGURE WITH OVERRIDE;
GO

    Pokud jste už tuto funkci povolili pro Machine Learning Services, znovu nekonfigurujte rozšíření jazyka. Základní platforma rozšiřitelnosti podporuje obojí.

Registrace externího jazyka

Pro každou databázi, ve které chcete používat jazyková rozšíření, je potřeba zaregistrovat externí jazyk v jazyce CREATE EXTERNAL LANGUAGE.

Následující příklad přidá externí jazyk volaný dotnet do databáze na SQL Serveru ve Windows.

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

Další informace naleznete v tématu VYTVOŘENÍ EXTERNÍHO JAZYKA.

Ověření instalace

Zkontrolujte stav instalace instance v protokolech instalace.

Pomocí následujícího postupu ověřte, že jsou spuštěné všechny komponenty použité ke spuštění externího skriptu.

  1. V aplikaci SQL Server Management Studio nebo Azure Data Studio otevřete nové okno dotazu a spusťte následující příkaz:

    EXECUTE sp_configure 'external scripts enabled';

    Nyní run_value je nastavena na 1.

  2. Otevřete panel Služby nebo SQL Server Configuration Manager a ověřte, že je spuštěná služba Launchpad SYSTÉMU SQL Server . Pro každou instanci databázového stroje s nainstalovanými jazykovými rozšířeními byste měli mít jednu službu. Další informace o službě naleznete v tématu Architektura rozšiřitelnosti v sql Server Language Extensions.

Další konfigurace

Pokud byl krok ověření úspěšný, můžete spustit kód jazyka C# z aplikace SQL Server Management Studio, Azure Data Studio, editoru Visual Studio Code nebo jakéhokoli jiného klienta, který může odesílat příkazy T-SQL na server.

Pokud při spuštění příkazu dojde k chybě, projděte si další kroky konfigurace v této části. Možná budete muset provést další vhodné konfigurace pro službu nebo databázi.

Na úrovni instance může další konfigurace zahrnovat:

V databázi možná budete potřebovat následující aktualizace konfigurace:

Poznámka:

Jestli se vyžaduje další konfigurace, závisí na schématu zabezpečení, na kterém jste nainstalovali SQL Server, a na tom, jak očekáváte, že se uživatelé budou připojovat k databázi a spouštět externí skripty.

Navrhované optimalizace

Teď, když máte všechno funkční, můžete také optimalizovat server tak, aby podporoval rozšíření jazyka .NET.

Optimalizace serveru pro rozšíření jazyka .NET

Výchozí nastavení pro nastavení SQL Serveru jsou určená k optimalizaci rovnováhy serveru pro různé služby podporované databázovým strojem, které můžou zahrnovat procesy extrakce, transformace a načítání (ETL), generování sestav, auditování a aplikace, které používají data SQL Serveru. Proto v rámci výchozího nastavení můžete zjistit, že prostředky pro jazyková rozšíření jsou někdy omezené nebo omezené, zejména v operacích náročných na paměť.

Pokud chcete zajistit, aby úlohy rozšíření jazyka byly správně seřazené podle priority a prostředky, doporučujeme ke konfiguraci externího fondu zdrojů použít správce prostředků SQL Serveru. Můžete také změnit množství paměti přidělené databázovému stroji nebo zvýšit počet účtů, které běží ve službě SQL Server Launchpad.

Pokud používáte edici Standard a nemáte správce prostředků, můžete použít zobrazení dynamické správy (DMV) a rozšířené události a také monitorování událostí windows, které vám pomůžou spravovat prostředky serveru.

Další krok

Vývojáři v C# můžou začít s několika jednoduchými příklady a seznámit se se základy fungování jazyka C# s SQL Serverem. Další krok najdete na následujícím odkazu:

Kurz: Regulární výrazy s jazykem C#

  • Last updated on