Instal paket dengan alat Python di SQL Server

Berlaku untuk: hanya SQL Server 2017 (14.x)

Artikel ini menjelaskan cara menggunakan alat Python standar untuk menginstal paket Python baru pada instans SQL Server Machine Learning Services. Secara umum, proses untuk menginstal paket baru mirip dengan yang ada di lingkungan Python standar. Namun, beberapa langkah tambahan diperlukan jika server tidak memiliki koneksi Internet.

Untuk informasi selengkapnya tentang lokasi paket dan jalur penginstalan, lihat Mendapatkan informasi paket Python.

Prasyarat

Pertimbangan lainnya

  • Paket harus sesuai dengan Python 3.5 dan dijalankan di Windows.

  • Pustaka paket Python terletak di folder File Program instans SQL Server Anda dan, secara default, menginstal di folder ini memerlukan izin administrator. Untuk informasi selengkapnya, lihat Lokasi pustaka paket.

  • Penginstalan paket adalah per instans. Jika Anda memiliki beberapa instans Layanan Pembelajaran Mesin, Anda harus menambahkan paket ke masing-masing instans.

  • Server database sering dikunci. Dalam banyak kasus, akses Internet diblokir sepenuhnya. Untuk paket dengan daftar dependensi panjang, Anda harus mengidentifikasi dependensi ini terlebih dahulu dan siap untuk menginstal masing-masing secara manual.

  • Sebelum menambahkan paket, pertimbangkan apakah paket tersebut cocok untuk lingkungan SQL Server.

    • Kami menyarankan agar Anda menggunakan Python dalam database untuk tugas yang mendapat manfaat dari integrasi ketat dengan mesin database, seperti pembelajaran mesin, bukan tugas yang hanya mengkueri database.

    • Jika Anda menambahkan paket yang memberikan terlalu banyak tekanan komputasi pada server, performa akan menderita.

    • Pada lingkungan SQL Server yang diperkeras, Anda mungkin ingin menghindari hal berikut:

      • Paket yang memerlukan akses jaringan
      • Paket yang memerlukan akses sistem file yang ditingkatkan
      • Paket yang digunakan untuk pengembangan web atau tugas lain yang tidak menguntungkan dengan berjalan di dalam SQL Server

Menambahkan paket Python di SQL Server

Untuk menginstal paket Python baru yang dapat digunakan dalam skrip pada SQL Server, Anda menginstal paket dalam instans Layanan Pembelajaran Mesin. Jika Anda memiliki beberapa instans Layanan Pembelajaran Mesin, Anda harus menambahkan paket ke masing-masing instans.

Paket yang diinstal dalam contoh berikut adalah CNTK, kerangka kerja untuk pembelajaran mendalam dari Microsoft yang mendukung penyesuaian, pelatihan, dan berbagi berbagai jenis jaringan neural.

Untuk penginstalan offline, unduh paket Python

Jika Anda menginstal paket Python di server tanpa akses Internet, Anda harus mengunduh file WHL dari komputer dengan akses Internet dan kemudian menyalin file ke server.

Misalnya, pada komputer yang terhubung ke Internet, Anda dapat mengunduh .whl file untuk CNTK lalu menyalin file ke folder lokal di komputer SQL Server. Lihat Menginstal CNTK dari File Roda untuk daftar file yang tersedia .whl untuk CNTK.

Penting

Pastikan Anda mendapatkan paket versi Windows. Jika file berakhiran .gz, mungkin itu bukan versi yang tepat.

Untuk informasi selengkapnya tentang unduhan kerangka kerja CNTK untuk beberapa platform dan untuk beberapa versi Python, lihat Menyiapkan CNTK di komputer Anda.

Menemukan pustaka Python

Temukan lokasi pustaka Python default yang digunakan oleh SQL Server. Jika Anda telah menginstal beberapa instans, temukan PYTHON_SERVICES folder untuk instans tempat Anda ingin menambahkan paket.

Misalnya, jika Layanan Pembelajaran Mesin diinstal menggunakan default, dan pembelajaran mesin diaktifkan pada instans default, jalurnya adalah:

cd "C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\PYTHON_SERVICES"

Tip

Untuk penelusuran kesalahan dan pengujian di masa mendatang, Anda mungkin ingin menyiapkan lingkungan Python khusus untuk pustaka instans.

Menginstal paket menggunakan pip

Gunakan alat penginstal pip untuk menginstal paket baru. Anda dapat menemukan pip.exe di Scripts subfolder PYTHON_SERVICES folder. penyetelan SQL Server tidak menambahkan Scripts subfolder ke jalur sistem, jadi Anda harus menentukan jalur lengkap, atau Anda dapat menambahkan folder Skrip ke variabel PATH di Windows.

Catatan

Jika Anda menggunakan Visual Studio 2017, atau Visual Studio 2015 dengan ekstensi Python, Anda dapat menjalankan pip install dari jendela Lingkungan Python . Klik Paket, dan di kotak teks, berikan nama atau lokasi paket untuk diinstal. Anda tidak perlu mengetik pip install; itu diisi untuk Anda secara otomatis.

  • Jika komputer memiliki akses Internet, berikan nama paket:

    scripts\pip.exe install cntk
    

    Anda juga dapat menentukan URL paket dan versi tertentu, misalnya:

    scripts\pip.exe install https://cntk.ai/PythonWheel/CPU-Only/cntk-2.1-cp35-cp35m-win_amd64.whl
    
  • Jika komputer tidak memiliki akses Internet, tentukan file WHL yang Anda unduh sebelumnya. Contohnya:

    scripts\pip.exe install C:\Downloads\cntk-2.1-cp35-cp35m-win_amd64.whl
    

Anda mungkin diminta untuk meningkatkan izin untuk menyelesaikan penginstalan. Saat penginstalan berlangsung, Anda dapat melihat pesan status di jendela prompt perintah.

Muat paket atau fungsinya sebagai bagian dari skrip Anda

Ketika penginstalan selesai, Anda dapat segera mulai menggunakan paket dalam skrip Python di SQL Server.

Untuk menggunakan fungsi dari paket dalam skrip Anda, sisipkan pernyataan standar import <package_name> di baris awal skrip:

EXECUTE sp_execute_external_script 
  @language = N'Python', 
  @script = N'
import cntk
# Python statements ...
'

Lihat juga