Instalar a extensão de idioma SQL Server .NET no Windows

Aplica-se a: SQL Server 2019 (15.x) e versões posteriores

Saiba como instalar o componente .NET Language Extension (usado pelo C#) para SQL Server no Windows. A extensão de linguagem .NET faz parte das extensões de linguagem do SQL Server.

Pré-requisitos

• A Instalação do SQL Server é necessária se você quiser instalar o suporte para a Extensão de Idioma .NET.

• A extensão de linguagem .NET suporta .NET 6 e tempos de execução posteriores e só é suportada no Windows.

• É necessária uma instância do Mecanismo de Banco de Dados. Você não pode instalar apenas os recursos de extensão de linguagem .NET, embora possa adicioná-los incrementalmente a uma instância existente.

• Para continuidade de negócios, os grupos de disponibilidade Always On são suportados para extensões de idioma. Você precisa instalar extensões de idioma e configurar pacotes em cada nó. A instalação da extensão de linguagem .NET também é suportada em uma instância de cluster de failover no SQL Server.

• Não instale as Extensões de Idioma do SQL Server ou a Extensão de Idioma .NET em um controlador de domínio. A parte Language Extensions da instalação falha.

• As Extensões de Linguagem e os Serviços de Aprendizado de Máquina são instalados por padrão em Clusters de Big Data do SQL Server. Se você usa clusters de Big Data, não precisa seguir as etapas neste artigo. Para obter mais informações, consulte Executar scripts Python e R com Serviços de Aprendizado de Máquina em clusters de Big Data do SQL Server 2019.

Tempo de execução do .NET

O suporte de longo prazo (LTS) do .NET 6 é o primeiro tempo de execução suportado. Você pode baixar o tempo de execução do .NET para Windows. Linux não é suportado.

Se você quiser usar a versão LTS mais recente do tempo de execução do .NET, você deve recompilar a extensão de linguagem .NET.

Obtenha a mídia de instalação

O local de download do SQL Server depende da edição:

• Edições SQL Server Enterprise, Standard e Express. Estas edições são licenciadas para uso em produção. Para as edições Enterprise e Standard, entre em contato com o fornecedor do software para obter a mídia de instalação. Você pode encontrar informações de compras e um diretório de parceiros da Microsoft no site de compras da Microsoft.

• A última edição gratuita.

Executar o programa de configuração

Para instalações locais, você deve executar a Instalação como administrador. Se você instalar o SQL Server a partir de um compartilhamento remoto, deverá usar uma conta de domínio que tenha permissões de leitura e execução no compartilhamento remoto.

1. Inicie o assistente de instalação do SQL Server.

2. Na guia Instalação , selecione Nova instalação autônoma do SQL Server ou adicione recursos a uma instalação existente.

3. Na página Seleção de Recursos , selecione estas opções:

   Serviços do Mecanismo de Banco de Dados: para usar Extensões de Idioma com o SQL Server, você deve instalar uma instância do Mecanismo de Banco de Dados. Você pode usar uma instância padrão ou nomeada.

   Serviços de Aprendizado de Máquina e Extensões de Linguagem: esta opção instala o componente Extensões de Linguagem que suporta a execução de código C#.

   

4. Na página Pronto para Instalar , verifique se essas seleções estão incluídas e selecione Instalar.

   • Serviços do Mecanismo de Banco de Dados
   • Serviços de Aprendizagem Automática e Extensões de Linguagem

   Observe o local da pasta sob o caminho ..\Setup Bootstrap\Log onde os arquivos de configuração estão armazenados. Quando a instalação estiver concluída, você poderá revisar os componentes instalados no arquivo de resumo.

5. Após a conclusão da instalação, se você for instruído a reiniciar o computador, faça-o agora. É importante ler a mensagem do Assistente de Instalação quando terminar a Instalação. Para obter mais informações, consulte Exibir e ler arquivos de log da Instalação do SQL Server.

Registar a extensão linguística

1. Siga estas etapas para baixar e registrar a extensão de linguagem .NET, que é usada para executar código C#.

   1. Baixe o dotnet-core-CSharp-lang-extension-windows-release.zip arquivo da extensão de linguagem .NET para o repositório GitHub do SQL Server. Transfira o ficheiro mais recente do Windows dotnet-core-CSharp-lang-extension-windows-release.zip . Se preferir usar um tempo de execução .NET mais recente, você precisa compilar dotnet-core-CSharp-lang-extension a partir do código-fonte do GitHub.

   2. Use o SQL Server Management Studio (SSMS) para se conectar à sua instância do SQL Server e executar o seguinte comando Transact-SQL (T-SQL) para registar a extensão de linguagem .NET com CREATE EXTERNAL LANGUAGE.

   3. Modifique o caminho nesta instrução para refletir o local do arquivo zip de extensão de idioma baixado (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. Reinicie a Barra Inicial.

   1. Abra SQL Server Configuration Manager.

   2. Em Serviços do SQL Server, clique com o botão direito do mouse em Barra Inicial do SQL Server e selecione Reiniciar.

Reiniciar o serviço

Quando a instalação estiver concluída, reinicie o Mecanismo de Banco de Dados antes de continuar para a próxima etapa, habilitando a execução do script.

A reinicialização do serviço também reinicia automaticamente o serviço relacionado da Barra Inicial do SQL Server.

Você pode reiniciar o serviço usando o comando Reiniciar com o botão direito do mouse para a instância no SSMS, com o painel Serviços no Painel de Controle ou usando o SQL Server Configuration Manager.

Habilitar a execução de scripts

1. Abra o SQL Server Management Studio. Conecte-se à instância onde você instalou as Extensões de Idioma, selecione Nova Consulta para abrir uma janela de consulta e execute o seguinte comando:

   EXECUTE sp_configure;
   

   O recurso está desativado (value is 0) por padrão e deve ser explicitamente habilitado por um administrador antes que você possa executar o código C#.

2. Para habilitar o recurso de script externo, execute a seguinte instrução:

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

   Se você já ativou o recurso para Serviços de Aprendizado de Máquina, não execute reconfigurar uma segunda vez para Extensões de Idioma. A plataforma de extensibilidade subjacente suporta ambos.

Registar língua externa

Para cada banco de dados em que você deseja usar extensões de idioma, você precisa registrar o idioma externo com CREATE EXTERNAL LANGUAGE.

O exemplo a seguir adiciona um idioma externo chamado dotnet a um banco de dados no SQL Server no Windows.

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

Para obter mais informações, consulte CREATE EXTERNAL LANGUAGE.

Verificar a instalação

Verifique o status de instalação da instância nos logs de instalação.

Use as etapas a seguir para verificar se todos os componentes usados para iniciar o script externo estão em execução.

1. No SQL Server Management Studio ou no Azure Data Studio, abra uma nova janela de consulta e execute a seguinte instrução:

   EXECUTE sp_configure 'external scripts enabled';
   

   O run_value está agora definido para 1.

2. Abra o painel Serviços ou o SQL Server Configuration Manager e verifique se o serviço Barra Inicial do SQL Server está em execução. Você deve ter um serviço para cada instância do Mecanismo de Banco de Dados que tenha extensões de idioma instaladas. Para obter mais informações sobre o serviço, consulte Arquitetura de extensibilidade em extensões de linguagem do SQL Server.

Configuração adicional

Se a etapa de verificação tiver sido bem-sucedida, você poderá executar código C# do SQL Server Management Studio, Azure Data Studio, Visual Studio Code ou qualquer outro cliente que possa enviar instruções T-SQL para o servidor.

Se você tiver um erro ao executar o comando, revise as etapas de configuração adicionais nesta seção. Talvez seja necessário fazer configurações adicionais apropriadas para o serviço ou banco de dados.

No nível da instância, a configuração extra pode incluir:

• Configuração de firewall para os Serviços de Aprendizado de Máquina do SQL Server
• Habilitar ou desabilitar um protocolo de rede de servidor
• Configuração do Server: acesso remoto
• Criar um login para SQLRUserGroup

No banco de dados, talvez você precise das seguintes atualizações de configuração:

• Conceder permissão aos usuários do banco de dados para executar scripts Python e R com os Serviços de Aprendizado de Máquina do SQL Server
• Dar permissão aos usuários para executar um idioma específico

Otimizações sugeridas

Agora que você tem tudo funcionando, você também pode querer otimizar o servidor para suportar a extensão de linguagem .NET.

Otimizar o servidor para a extensão de linguagem .NET

As configurações padrão para a instalação do SQL Server destinam-se a otimizar o equilíbrio do servidor para uma variedade de serviços suportados pelo Mecanismo de Banco de Dados, que podem incluir processos de extração, transformação e carregamento (ETL), relatórios, auditoria e aplicativos que usam dados do SQL Server. Portanto, nas configurações padrão, você pode achar que os recursos para extensões de idioma às vezes são restritos ou limitados, particularmente em operações que consomem muita memória.

Para garantir que os trabalhos de extensões de idioma sejam priorizados e dotados de recursos adequados, recomendamos que você use o Administrador de Recursos do SQL Server para configurar um pool de recursos externos. Você também pode querer alterar a quantidade de memória alocada para o Mecanismo de Banco de Dados ou aumentar o número de contas executadas no serviço Barra Inicial do SQL Server.

• Para configurar um pool de recursos para gerenciar recursos externos, consulte CREATE EXTERNAL RESOURCE POOL (Transact-SQL).

• Para alterar a quantidade de memória reservada para o banco de dados, consulte Opções de configuração de memória do servidor.

Se você usa a edição Standard e não tem o Administrador de Recursos, pode usar modos de exibição de gerenciamento dinâmico (DMVs) e Eventos Estendidos, bem como o monitoramento de eventos do Windows, para ajudar a gerenciar os recursos do servidor.

Próximo passo

Os desenvolvedores de C# podem começar com alguns exemplos simples e aprender as noções básicas de como o C# funciona com o SQL Server. Para a próxima etapa, consulte o seguinte link: