Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Van toepassing op: SQL Server 2017 (14.x)
In dit artikel wordt beschreven hoe u standaard Python-hulpprogramma's gebruikt om nieuwe Python-pakketten te installeren op een exemplaar van SQL Server Machine Learning Services. Over het algemeen is het proces voor het installeren van nieuwe pakketten vergelijkbaar met dat in een standaard Python-omgeving. Er zijn echter enkele extra stappen vereist als de server geen internetverbinding heeft.
Zie Python-pakketgegevens ophalen voor meer informatie over pakketlocatie en installatiepaden.
Prerequisites
- U moet SQL Server Machine Learning Services hebben geïnstalleerd met de python-taaloptie.
Andere overwegingen
Pakketten moeten compatibel zijn met Python 3.5 en worden uitgevoerd in Windows.
De Python-pakketbibliotheek bevindt zich in de map Program Files van uw SQL Server-exemplaar en de installatie in deze map vereist standaard beheerdersmachtigingen. Zie De locatie van de pakketbibliotheek voor meer informatie.
Pakketinstallatie is per exemplaar. Als u meerdere exemplaren van Machine Learning Services hebt, moet u het pakket aan elk exemplaar toevoegen.
Databaseservers worden vaak vergrendeld. In veel gevallen wordt internettoegang volledig geblokkeerd. Voor pakketten met een lange lijst met afhankelijkheden moet u deze afhankelijkheden vooraf identificeren en klaar zijn om ze handmatig te installeren.
Voordat u een pakket toevoegt, moet u overwegen of het pakket geschikt is voor de SQL Server-omgeving.
U wordt aangeraden Python-in-database te gebruiken voor taken die profiteren van een nauwe integratie met de database-engine, zoals machine learning, in plaats van taken die eenvoudig een query uitvoeren op de database.
Als u pakketten toevoegt die te veel rekenkracht op de server hebben, zullen de prestaties lijden.
In een beperkte SQL Server-omgeving wilt u het volgende voorkomen:
- Pakketten waarvoor netwerktoegang is vereist
- Pakketten waarvoor verhoogde toegang tot het bestandssysteem is vereist
- Pakketten die worden gebruikt voor webontwikkeling of andere taken die geen voordeel hebben door in SQL Server uit te voeren
Een Python-pakket toevoegen in SQL Server
Als u een nieuw Python-pakket wilt installeren dat kan worden gebruikt in een script op SQL Server, installeert u het pakket in het exemplaar van Machine Learning Services. Als u meerdere exemplaren van Machine Learning Services hebt, moet u het pakket aan elk exemplaar toevoegen.
Het pakket dat in de volgende voorbeelden is geïnstalleerd, is CNTK, een framework voor deep learning van Microsoft dat ondersteuning biedt voor aanpassing, training en delen van verschillende typen neurale netwerken.
Download het Python-pakket voor offline-installatie
Als u Python-pakketten installeert op een server zonder internettoegang, moet u het WHL-bestand downloaden van een computer met internettoegang en vervolgens het bestand naar de server kopiëren.
Op een computer met internetverbinding kunt u bijvoorbeeld een .whl bestand voor CNTK downloaden en het bestand vervolgens kopiëren naar een lokale map op de SQL Server-computer. Zie CNTK installeren vanuit Wheel Files voor een lijst met beschikbare .whl bestanden voor CNTK.
Important
Zorg ervoor dat u de Windows-versie van het pakket krijgt. Als het bestand eindigt op .gz, is het waarschijnlijk niet de juiste versie.
Zie CNTK instellen op uw computer voor meer informatie over downloads van het CNTK-framework voor meerdere platforms en voor meerdere versies van Python.
De Python-bibliotheek zoeken
Zoek de standaardlocatie van de Python-bibliotheek die wordt gebruikt door SQL Server. Als u meerdere exemplaren hebt geïnstalleerd, zoekt u de PYTHON_SERVICES map voor het exemplaar waar u het pakket wilt toevoegen.
Als Machine Learning Services bijvoorbeeld is geïnstalleerd met behulp van standaardinstellingen en machine learning is ingeschakeld op het standaardexemplaren, is het pad:
cd "C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\PYTHON_SERVICES"
Tip
Voor toekomstige foutopsporing en -tests wilt u mogelijk een Python-omgeving instellen die specifiek is voor de exemplaarbibliotheek.
Het pakket installeren met pip
Gebruik het pip-installatieprogramma om nieuwe pakketten te installeren. U kunt pip.exe vinden in de Scripts submap van de PYTHON_SERVICES map. Sql Server Setup voegt de Scripts submap niet toe aan het systeempad, dus u moet het volledige pad opgeven of u kunt de map Scripts toevoegen aan de variabele PATH in Windows.
Note
Als u Visual Studio 2017 of Visual Studio 2015 gebruikt met de Python-extensies, kunt u uitvoeren pip install vanuit het venster Python-omgevingen . Klik op Pakketten en geef in het tekstvak de naam of locatie op van het pakket dat u wilt installeren. U hoeft niet te typen pip install; deze wordt automatisch voor u ingevuld.
Als de computer internettoegang heeft, geeft u de naam van het pakket op:
scripts\pip.exe install cntkU kunt ook de URL van een specifiek pakket en een specifieke versie opgeven, bijvoorbeeld:
scripts\pip.exe install https://cntk.ai/PythonWheel/CPU-Only/cntk-2.1-cp35-cp35m-win_amd64.whlAls de computer geen internettoegang heeft, geeft u het WHL-bestand op dat u eerder hebt gedownload. Voorbeeld:
scripts\pip.exe install C:\Downloads\cntk-2.1-cp35-cp35m-win_amd64.whl
Mogelijk wordt u gevraagd om machtigingen te verhogen om de installatie te voltooien. Naarmate de installatie vordert, ziet u statusberichten in het opdrachtpromptvenster.
Het pakket of de bijbehorende functies laden als onderdeel van uw script
Wanneer de installatie is voltooid, kunt u het pakket direct gaan gebruiken in Python-scripts in SQL Server.
Als u functies uit het pakket in uw script wilt gebruiken, voegt u de standaardinstructie import <package_name> in de eerste regels van het script in:
EXECUTE sp_execute_external_script
@language = N'Python',
@script = N'
import cntk
# Python statements ...
'