20260206-polybase-linux-update (#36571)

HugoMSFT · web-flow · commit 1d2a953b1573 · 2026-02-10T16:13:45.000-07:00
diff --git a/docs/relational-databases/polybase/polybase-linux-setup.md b/docs/relational-databases/polybase/polybase-linux-setup.md
@@ -5,7 +5,7 @@ description: Learn how to install SQL Server PolyBase on Linux. PolyBase enables
 author: MikeRayMSFT
 ms.author: mikeray
 ms.reviewer: dakryze, hudequei, randolphwest
-ms.date: 09/12/2025
+ms.date: 02/06/2026
 ms.service: sql
 ms.subservice: linux
 ms.topic: install-set-up-deploy
@@ -18,15 +18,21 @@ monikerRange: ">=sql-server-linux-ver15 || >=sql-server-ver15"
 
 [!INCLUDE [sqlserver2019-linux](../../includes/applies-to-version/sqlserver2019-linux.md)]
 
-The following steps install [PolyBase](polybase-guide.md) (`mssql-server-polybase` and `mssql-server-polybase-hadoop`) on Linux. PolyBase enables you to run external queries against remote data sources.
+The following steps install [PolyBase](polybase-guide.md) (`mssql-server-polybase` and `mssql-server-polybase-hadoop`) on Linux. With PolyBase, you can run external queries against remote data sources.
 
 ## Prerequisites
 
 Before you install PolyBase, first [install SQL Server](../../linux/sql-server-linux-setup.md#platforms). This step configures the keys and repositories that you use when installing the `mssql-server-polybase` and `mssql-server-polybase-hadoop` package.
 
+## Support for ODBC data sources
+
+**Applies to**: [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)]
+
+Starting in [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)], PolyBase supports ODBC data sources on Linux. ODBC data source support for Linux requires the .NET runtime, which is automatically downloaded and installed during PolyBase setup. Internet access is required during the installation.
+
 ## Limitations
 
-The length of the hostname where [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] is installed needs to be 15 characters or less.
+The hostname where [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] is installed has a maximum length of 15 characters.
 
 PolyBase isn't supported on [!INCLUDE [sssql17-md](../../includes/sssql17-md.md)] for Linux.
 
@@ -46,14 +52,14 @@ Install PolyBase for your operating system:
 
 ### Install on RHEL
 
-**Applies to:** [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] and later versions.
+**Applies to**: [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] and later versions.
 
 1. Download the Microsoft Red Hat repository configuration file.
 
-   For RHEL 10 (in preview):
+   For RHEL 10:
 
    ```console
-   sudo curl -o /etc/yum.repos.d/msprod.repo https://packages.microsoft.com/config/rhel/10/mssql-server-2025.repo
+   sudo curl -o /etc/yum.repos.d/msprod.repo https://packages.microsoft.com/config/rhel/10/prod.repo
    ```
 
    For RHEL 9:
@@ -74,41 +80,41 @@ Install PolyBase for your operating system:
    sudo curl -o /etc/yum.repos.d/msprod.repo https://packages.microsoft.com/config/rhel/7/prod.repo
    ```
 
-1. Use the following command to install the `mssql-server-polybase` on Red Hat Enterprise Linux.
+1. Use the following command to install the `mssql-server-polybase` on Red Hat Enterprise Linux:
 
    ```console
    sudo yum install -y mssql-server-polybase
    ```
 
-1. You're prompted to restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance. Use the following command to do so.
+1. Restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance when prompted:
 
    ```console
    sudo systemctl restart mssql-server
    ```
 
 > [!NOTE]  
-> After installation, you must [enable the PolyBase feature](#enable).
+> After installation, [enable the PolyBase feature](#enable).
 
 ::: moniker range="<=sql-server-linux-ver15 || <=sql-server-ver15"
 
 ### Install Hadoop on RHEL
 
-**Applies to:** [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] only.
+**Applies to**: [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] only.
 
-1. Use the following command to install the `mssql-server-polybase-hadoop`.
+1. Use the following command to install the `mssql-server-polybase-hadoop` package:
 
    ```console
    sudo yum install -y mssql-server-polybase-hadoop
    ```
 
-   The PolyBase Hadoop package has dependencies on the following packages:
+   The PolyBase Hadoop package depends on the following packages:
 
    - `mssql-server`
    - `mssql-server-polybase`
    - `mssql-server-extensibility`
    - `mssql-zulu-jre-11`
 
-1. Installation prompts to restart `launchpadd`. Use the following command to do so.
+1. Restart `launchpadd` when prompted:
 
    ```console
    sudo systemctl restart mssql-launchpadd
@@ -117,15 +123,15 @@ Install PolyBase for your operating system:
 > [!NOTE]  
 > After installation, you must [set the Hadoop connectivity level](../../database-engine/configure-windows/polybase-connectivity-configuration-transact-sql.md#c-set-hadoop-connectivity).
 
-If you need an offline installation, locate the PolyBase package download in the [Release notes for SQL Server 2019 on Linux](../../linux/sql-server-linux-release-notes-2019.md). Then use the same offline installation steps described in the article [Install SQL Server](../../linux/sql-server-linux-setup.md#offline).
+If you need an offline installation, find the PolyBase package download in the [Release notes for SQL Server 2019 on Linux](../../linux/sql-server-linux-release-notes-2019.md). Then use the same offline installation steps described in the article [Install SQL Server](../../linux/sql-server-linux-setup.md#offline).
 
 ::: moniker-end
 
 ## [Ubuntu](#tab/ubuntu)
 
 ### Install on Ubuntu
 
-**Applies to:** [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] and later versions.
+**Applies to**: [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] and later versions.
 
 1. Register the Microsoft Ubuntu repository.
 
@@ -153,58 +159,64 @@ If you need an offline installation, locate the PolyBase package download in the
    curl https://packages.microsoft.com/config/ubuntu/22.04/prod.list | sudo tee /etc/apt/sources.list.d/msprod.list
    ```
 
-1. Use the following command to install the `mssql-server-polybase` on Ubuntu.
+   For Ubuntu 24.04:
+
+   ```console
+   curl https://packages.microsoft.com/config/ubuntu/24.04/prod.list | sudo tee /etc/apt/sources.list.d/msprod.list
+   ```
+
+1. Use the following command to install the `mssql-server-polybase` on Ubuntu:
 
    ```console
    sudo apt-get install mssql-server-polybase
    ```
 
-1. When prompted, restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance.
+1. Restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance when prompted:
 
    ```console
    sudo systemctl restart mssql-server
    ```
 
 > [!NOTE]  
-> After installation, you must [enable the PolyBase feature](#enable).
+> After installation, [enable the PolyBase feature](#enable).
 
-If you need an offline installation, locate the PolyBase package download in the [Release notes for SQL Server 2019 on Linux](../../linux/sql-server-linux-release-notes-2019.md). Then use the same offline installation steps described in the article [Install SQL Server](../../linux/sql-server-linux-setup.md#offline).
+If you need an offline installation, find the PolyBase package download in the release notes for [SQL Server 2019](../../linux/sql-server-linux-release-notes-2019.md), [SQL Server 2022](../../linux/sql-server-linux-release-notes-2022.md), or [SQL Server 2025](../../linux/sql-server-linux-release-notes-2025.md). Then use the same offline installation steps described in the article [Install SQL Server](../../linux/sql-server-linux-setup.md#offline).
 
 ::: moniker range="<=sql-server-linux-ver15 || <=sql-server-ver15"
 
 ### Install Hadoop on Ubuntu
 
-**Applies to:** [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] only.
+**Applies to**: [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] only.
 
-1. Use the following command to install the `mssql-server-polybase-hadoop`.
+1. Use the following command to install the `mssql-server-polybase-hadoop` package:
 
    ```console
    sudo apt-get install mssql-server-polybase-hadoop
    ```
 
-   The PolyBase Hadoop package has dependencies on the following packages:
+   The PolyBase Hadoop package depends on the following packages:
 
    - `mssql-server`
    - `mssql-server-polybase`
    - `mssql-server-extensibility`
    - `mssql-zulu-jre-11`
 
-1. Installation prompts to restart `launchpadd`. Use the following command to do so.
+1. Restart `launchpadd` when prompted:
 
    ```console
    sudo systemctl restart mssql-launchpadd
    ```
 
 > [!NOTE]  
-> After installation, you must [set the Hadoop connectivity level](../../relational-databases/polybase/polybase-configure-hadoop.md#configure-hadoop-connectivity). This step only applies to [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)].
+> After installation, you must [set the Hadoop connectivity level](polybase-configure-hadoop.md#configure-hadoop-connectivity). This step only applies to [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)].
 
 ::: moniker-end
 
 ## [SUSE Linux Enterprise Server (SLES)](#tab/sles)
 
 ### Install on SLES
 
-**Applies to:** [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] and later versions.
+**Applies to**: [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] and later versions.
 
 1. Add the Microsoft [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] repository to Zypper.
 
@@ -222,30 +234,30 @@ If you need an offline installation, locate the PolyBase package download in the
    sudo zypper --gpg-auto-import-keys refresh
    ```
 
-1. Use the following commands to install the `mssql-server-polybase` on SUSE Linux Enterprise Server.
+1. Use the following commands to install the `mssql-server-polybase` package on SUSE Linux Enterprise Server:
 
    ```console
    sudo zypper install mssql-server-polybase
    ```
 
-1. You're prompted to restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance. Use the following command to do so.
+1. Restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance when prompted:
 
    ```console
    sudo systemctl restart mssql-server
    ```
 
 > [!NOTE]  
-> After installation, you must [enable the PolyBase feature](#enable).
+> After installation, [enable the PolyBase feature](#enable).
 
-If you need an offline installation, locate the PolyBase package download in the [Release notes for SQL Server 2019 on Linux](../../linux/sql-server-linux-release-notes-2019.md). Then use the same offline installation steps described in the article [Install SQL Server](../../linux/sql-server-linux-setup.md#offline).
+If you need an offline installation, find the PolyBase package download in the [Release notes for SQL Server 2019 on Linux](../../linux/sql-server-linux-release-notes-2019.md). Then use the same offline installation steps described in the article [Install SQL Server](../../linux/sql-server-linux-setup.md#offline).
 
 ---
 
 <a id="enable"></a>
 
 ## Enable PolyBase
 
-After installation, PolyBase must be enabled to access its features. Connect to the installed [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance and use the following Transact-SQL command to enable.
+After installation, enable PolyBase to access its features. Connect to the installed [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance and run the following Transact-SQL command:
 
 ```sql
 EXECUTE sp_configure
@@ -257,7 +269,7 @@ RECONFIGURE WITH OVERRIDE;
 
 ### Trace flag
 
-**Applies to:** [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] 
+**Applies to**: [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)]
 
 To use PolyBase capabilities on Linux, you must enable [trace flag 13702](../../t-sql/database-console-commands/dbcc-traceon-trace-flags-transact-sql.md#tf13702) during SQL Server start up. For more information, see [Configure SQL Server on Linux with the mssql-conf tool](../../linux/sql-server-linux-configure-mssql-conf.md).
 
@@ -269,7 +281,7 @@ If you already have `mssql-server-polybase` installed, you can update to the lat
 
 ### RHEL with Hadoop
 
-**Applies to:** [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] only.
+**Applies to**: [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] only.
 
 ```console
 sudo yum remove -y mssql-server-polybase-hadoop
@@ -287,7 +299,7 @@ sudo yum check-update
 sudo yum install -y mssql-server-polybase
 ```
 
-You're prompted to restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance. Use the following command to do so.
+Restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance when prompted:
 
 ```console
 sudo systemctl restart mssql-server
@@ -297,7 +309,7 @@ sudo systemctl restart mssql-server
 
 ### Ubuntu with Hadoop
 
-**Applies to:** [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] only.
+**Applies to**: [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] only.
 
 ```console
 sudo apt-get remove mssql-server-polybase-hadoop
@@ -315,7 +327,7 @@ sudo apt-get update
 sudo apt-get install mssql-server-polybase
 ```
 
-You're prompted to restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance. Use the following command to do so.
+Restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance when prompted:
 
 ```console
 sudo systemctl restart mssql-server
@@ -331,7 +343,7 @@ sudo zypper refresh
 sudo zypper install mssql-server-polybase
 ```
 
-You're prompted to restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance. Use the following command to do so.
+Restart the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] instance when prompted:
 
 ```console
 sudo systemctl restart mssql-server
@@ -340,11 +352,19 @@ sudo systemctl restart mssql-server
 ---
 
 > [!NOTE]  
-> After installation, you must [enable the PolyBase feature](#enable).
+> After installation, [enable the PolyBase feature](#enable).
+
+## Known issues
+
+### Offline installation isn't available for SQL Server 2025
+
+**Applies to**: [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)]
+
+Currently, installing PolyBase on Linux for [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)] requires internet access because the setup downloads the .NET runtime. An offline installation method will be provided in a future update.
 
 ## Related links
 
-PolyBase on Linux can access the following data sources. Follow the provided links for more information on how to create an external table from these sources on PolyBase is enabled.
+PolyBase on Linux can access the following data sources. Use these links for information on how to create an external table when PolyBase is enabled:
 
 - [SQL Server and Azure SQL](polybase-configure-sql-server.md)
 - [Hadoop](polybase-configure-hadoop.md)
