Skip to content

Latest commit

 

History

History
87 lines (63 loc) · 4.01 KB

custom-runtime-python.md

File metadata and controls

87 lines (63 loc) · 4.01 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic ms.custom zone_pivot_groups monikerRange
Install Python custom runtime
Learn how to install a Python custom runtime for SQL Server using Language Extensions. The Python custom runtime can run machine learning scripts.
VanMSFT
vanto
11/09/2022
sql
machine-learning-services
how-to
intro-installation, linux-related-content
sqlml-platforms
=sql-server-ver15||=sql-server-linux-ver15

Install a Python custom runtime for SQL Server

[!INCLUDE SQL Server 2019 and later]

Learn how to install a Python custom runtime for running external Python scripts with SQL Server on:

  • Windows
  • Ubuntu Linux
  • Red Hat Enterprise Linux (RHEL)
  • SUSE Linux Enterprise Server (SLES)

The custom runtime can run machine learning scripts and uses the SQL Server Language Extensions.

Use your own version of the Python runtime with SQL Server, instead of the default runtime version installed with SQL Server Machine Learning Services.

Beginning with [!INCLUDE sssql22-md], runtimes for R, Python, and Java, are no longer installed with SQL Setup. Instead, install your desired Python custom runtime(s) and packages. For more information, see Install SQL Server 2022 Machine Learning Services (Python and R) on Windows or Install SQL Server Machine Learning Services (Python and R) on Linux.

::: zone pivot="platform-windows" [!INCLUDE Python custom runtime - Windows] ::: zone-end

::: zone pivot="platform-linux-ubuntu" [!INCLUDE Python custom runtime - Linux - Prerequisites]

[!INCLUDE Python custom runtime - Linux - Ubuntu specific steps]

[!INCLUDE Python custom runtime on Linux - Common steps] ::: zone-end

::: zone pivot="platform-linux-rhel" [!INCLUDE Python custom runtime - Linux - Prerequisites]

[!INCLUDE Python custom runtime - Linux - RHEL specific steps]

[!INCLUDE Python custom runtime on Linux - Common steps] ::: zone-end

::: zone pivot="platform-linux-sles" [!INCLUDE Python custom runtime - Linux - Prerequisites]

[!INCLUDE Python custom runtime - Linux - SLES specific steps]

[!INCLUDE Python custom runtime on Linux - Common steps] ::: zone-end

Enable external scripts

You can execute a Python external scripts with the stored procedure sp_execute_external script.

To enable external scripts, use Azure Data Studio to execute the statement below.

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

Verify installation

Use the following SQL script to verify the installation and functionality of the Python custom runtime. In the below sample script, myPython is used as the language name because the default language name Python cannot be provided for a custom runtime.

EXEC sp_execute_external_script
@language =N'myPython',
@script=N'
import sys
print(sys.path)
print(sys.version)
print(sys.executable)'

Next steps