Instalar o PolyBase no Linux

Aplica-se a: SQL Server 2019 (15.x) no Linux

As etapas a seguir instalam PolyBase (mssql-server-polybase e mssql-server-polybase-hadoop) no Linux. Com o PolyBase, pode executar consultas externas em fontes de dados remotas.

Prerequisites

Antes de instalar o PolyBase, primeiro instale o SQL Server. Esta etapa configura as chaves e repositórios que utiliza ao instalar os pacotes mssql-server-polybase e mssql-server-polybase-hadoop.

Suporte para fontes de dados ODBC

Aplica-se a: SQL Server 2025 (17.x)

No SQL Server 2025 (17.x) e versões posteriores, o PolyBase suporta fontes de dados ODBC no Linux. O suporte à fonte de dados ODBC para Linux requer o runtime .NET, que é automaticamente descarregado e instalado durante a configuração do PolyBase. É necessário acesso à Internet durante a instalação.

Limitations

O nome do host onde o SQL Server está instalado tem um comprimento máximo de 15 caracteres.

O PolyBase não é suportado no SQL Server 2017 (14.x) para Linux.

O scale-out para PolyBase no Linux não está atualmente disponível.

O Hadoop não tem suporte no SQL Server 2022 (16.x) e versões posteriores.

Instalar o PolyBase

Instale o PolyBase para o seu sistema operacional:

  • Red Hat Enterprise Linux (RHEL)
  • Ubuntu
  • Servidor SUSE Linux Enterprise (SLES)

Instalar no RHEL

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

  1. Baixe o arquivo de configuração do repositório Microsoft Red Hat.

    Para RHEL 10:

    sudo curl -o /etc/yum.repos.d/msprod.repo https://packages.microsoft.com/config/rhel/10/prod.repo
    

    Para o RHEL 9:

    sudo curl -o /etc/yum.repos.d/msprod.repo https://packages.microsoft.com/config/rhel/9/prod.repo
    

    Para o RHEL 8:

    sudo curl -o /etc/yum.repos.d/msprod.repo https://packages.microsoft.com/config/rhel/8/prod.repo
    

    Para o RHEL 7:

    sudo curl -o /etc/yum.repos.d/msprod.repo https://packages.microsoft.com/config/rhel/7/prod.repo
    
  2. Use o seguinte comando para instalar o mssql-server-polybase no Red Hat Enterprise Linux:

    sudo yum install -y mssql-server-polybase
    
  3. Reinicie a instância do SQL Server quando solicitado:

    sudo systemctl restart mssql-server
    

Note

Após a instalação, ativa a funcionalidade PolyBase.

Instalar o Hadoop no RHEL

Aplica-se a: SQL Server 2019 (15.x) apenas.

  1. Use o seguinte comando para instalar o mssql-server-polybase-hadoop pacote:

    sudo yum install -y mssql-server-polybase-hadoop
    

    O pacote PolyBase Hadoop depende dos seguintes pacotes:

    • mssql-server
    • mssql-server-polybase
    • mssql-server-extensibility
    • mssql-zulu-jre-11
  2. Reiniciar launchpadd quando for solicitado:

    sudo systemctl restart mssql-launchpadd
    

Note

Após a instalação, você deve definir o nível de conectividade do Hadoop.

Se precisar de uma instalação offline, encontre o pacote PolyBase para descarregar nas notas de lançamento do SQL Server 2019 no Linux. Em seguida, use as mesmas etapas de instalação offline descritas no artigo Instalar o SQL Server.

Ativar o PolyBase

Após a instalação, permita que o PolyBase aceda às suas funcionalidades. Ligue-se à instância SQL Server instalada e execute o seguinte comando Transact-SQL:

EXECUTE sp_configure
    @configname = 'polybase enabled',
    @configvalue = 1;

RECONFIGURE WITH OVERRIDE;

Sinalizador de rastreamento

Aplica-se a: SQL Server 2022 (16.x)

Para usar os recursos do PolyBase no Linux, você deve habilitar o sinalizador de rastreamento 13702 durante a inicialização do SQL Server. Para obter mais informações, consulte Configurar o SQL Server no Linux com a ferramenta mssql-conf.

Atualizar o PolyBase

Se já tiver mssql-server-polybase instalado, pode atualizar para a versão mais recente com os seguintes comandos:

RHEL com Hadoop

Aplica-se a: SQL Server 2019 (15.x) apenas.

sudo yum remove -y mssql-server-polybase-hadoop
sudo yum remove -y mssql-server-polybase
sudo yum check-update
sudo yum install -y mssql-server-polybase
sudo yum install -y mssql-server-polybase-hadoop

RHEL sem Hadoop

sudo yum remove -y mssql-server-polybase
sudo yum check-update
sudo yum install -y mssql-server-polybase

Reinicie a instância do SQL Server quando solicitado:

sudo systemctl restart mssql-server

Note

Após a instalação, ativa a funcionalidade PolyBase.

Instalação offline do PolyBase

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

No SQL Server 2025 (17.x), o PolyBase no Linux suporta fontes de dados ODBC e requer componentes .NET que o gestor de pacotes normalmente instala.

A partir do SQL Server 2025 (17.x) Cumulative Update () 4, pode instalar os componentes .NET necessários offline. Este método é útil para implementações em grande escala e ambientes sem acesso à internet.

Precisas de uma máquina com acesso à internet para descarregar o runtime .NET e de uma máquina SQL Server de destino onde instalas o PolyBase.

  1. Numa máquina com acesso à internet, descarregue o tempo de execução .NET suportado que o PolyBase requer (.NET 8.0.418). Extrair o pacote e copiar os ficheiros extraídos para a máquina SQL Server alvo.

    Na máquina de destino, crie o seguinte diretório se este não existir: /opt/mssql-ees-dotnet/.

    Copie os componentes de .NET extraídos para /opt/mssql-ees-dotnet/.

  2. Instala o PolyBase.

    Se a configuração não conseguir encontrar os componentes na localização padrão (/opt/mssql-ees-dotnet/), forneça o caminho quando solicitado.

  3. Se não fornecer um caminho, a configuração pede-lhe para descarregar os componentes.

O PolyBase no Linux pode acessar as seguintes fontes de dados. Use estes links para obter informações sobre como criar uma tabela externa quando o PolyBase está ativado: