Sqlmlutils ile Python paketlerini yükleme

Şunlar için geçerlidir: SQL Server 2019 (15.x) ve sonraki sürümler Azure SQL Managed Instance

Bu makalede sqlmlutils paketindeki işlevleri kullanarak SQL Server'da ve Büyük Veri KümelerindeMachine Learning Services örneğine yeni Python paketleri yükleme işlemi açıklanmaktadır. Yüklediğiniz paketler , sp_execute_external_script T-SQL deyimi kullanılarak veritabanında çalışan Python betiklerinde kullanılabilir.

Paket konumu ve yükleme yolları hakkında daha fazla bilgi için bkz. Python paket bilgilerini alma.

Uyarı

Bu makalede açıklanan sqlmlutils paketi, SQL Server 2019 veya sonraki sürümlerine Python paketleri eklemek için kullanılır. SQL Server 2017 ve önceki sürümler için bkz. Python araçlarıyla paketleri yükleme.

Önkoşullar

• Sql Server Machine Learning Services'ın Python dili seçeneğiyle yüklenmiş olması gerekir.

• SQL Server'a bağlanmak için kullandığınız istemci bilgisayara Azure Data Studio'yu yükleyin. Diğer veritabanı yönetimi veya sorgu araçlarını kullanabilirsiniz, ancak bu makalede Azure Data Studio varsayılmaktadır.

• Azure Data Studio'da Python çekirdeğini yükleyin. Ayrıca komut satırından Python yükleyip kullanabilir ve Python Uzantısı ile Visual Studio Code gibi alternatif bir Python geliştirme ortamı kullanabilirsiniz.

  İstemci bilgisayardaki Python sürümünün sunucudaki Python sürümüyle eşleşmesi ve yüklediğiniz paketlerin sahip olduğunuz Python sürümüyle uyumlu olması gerekir. Her SQL Server sürümüne hangi Python sürümünün dahil olduğu hakkında bilgi için bkz. Python ve R sürümleri.

  Belirli bir SQL Server örneğinde Python sürümünü doğrulamak için aşağıdaki T-SQL komutunu kullanın.

  EXECUTE sp_execute_external_script
    @language = N'Python',
    @script = N'
  import sys
  print(sys.version)
  '
  

Dikkat edilecek diğer noktalar

• Python paket kitaplığı SQL Server örneğinizin Program Files klasöründe bulunur ve varsayılan olarak bu klasöre yüklemek için yönetici izinleri gerekir. Daha fazla bilgi için Paket kitaplığı konumu'na bakın.

• Paket yüklemesi sqlmlutils'e sağladığınız bağlantı bilgilerinde belirttiğiniz SQL örneğine, veritabanına ve kullanıcıya özgüdür. Paketi birden çok SQL örneğinde veya veritabanında veya farklı kullanıcılarda kullanmak için paketi her biri için yüklemeniz gerekir. Bunun istisnası, paketin bir üyesi tarafından yüklenmesi durumunda paketin dbogenel olması ve tüm kullanıcılarla paylaşılmış olmasıdır. Bir kullanıcı ortak paketin daha yeni bir sürümünü yüklerse, genel paket etkilenmez, ancak bu kullanıcı daha yeni sürüme erişebilir.

• Paket eklemeden önce paketin SQL Server ortamı için uygun olup olmadığını göz önünde bulundurun.

  • Yalnızca veritabanını sorgulayan görevler yerine makine öğrenmesi gibi veritabanı altyapısıyla sıkı tümleştirmeden yararlanan görevler için veritabanı içi Python kullanmanızı öneririz.

  • Sunucu üzerinde çok fazla hesaplama baskısı oluşturan paketler eklerseniz performans düşer.

  • Sağlamlaştırılmış bir SQL Server ortamında aşağıdakilerden kaçınmak isteyebilirsiniz:

    • Ağ erişimi gerektiren paketler
    • Yükseltilmiş dosya sistemi erişimi gerektiren paketler
    • Web geliştirme veya SQL Server içinde çalıştırılmakla avantaj sağlamayan diğer görevler için kullanılan paketler

  • Python paketi tensorflow sqlmlutils kullanılarak yüklenemez. Daha fazla bilgi ve geçici çözüm için bkz. SQL Server Machine Learning Services'da bilinen sorunlar.

İstemci bilgisayara sqlmlutils yükleme

sqlmlutils kullanmak için önce SQL Server'a bağlanmak için kullandığınız istemci bilgisayara yüklemeniz gerekir.

Azure Data Studio'da

Azure Data Studio'da sqlmlutils kullanacaksanız, Python çekirdek not defterindeki Paketleri Yönet özelliğini kullanarak yükleyebilirsiniz.

1. Azure Data Studio'daki bir Python çekirdek not defterindePaketleri Yönet'e tıklayın.
2. Yeni ekle'ye tıklayın.
3. Pip paketlerini ara alanına "sqlmlutils" yazın ve Ara'ya tıklayın.
4. Yüklemek istediğiniz Paket Sürümünü seçin (en son sürüm önerilir).
5. Yükle'ye ve ardından Kapat'a tıklayın.

Python komut satırından

Python komut isteminden veya IDE'den sqlmlutils kullanacaksanız sqlmlutils'i basit bir pip komutuyla yükleyebilirsiniz:

pip install sqlmlutils

Sqlmlutils'i zip dosyasından da yükleyebilirsiniz:

1. Pip'in yüklü olduğundan emin olun. Daha fazla bilgi için bakınız pip kurulumu.
2. en son sqlmlutils zip dosyasını istemci https://github.com/microsoft/sqlmlutils/tree/master/R/dist bilgisayara indirin. Dosyanın sıkıştırmasını açma.
3. Bir Komut İstemi açın ve sqlmlutils paketini yüklemek için aşağıdaki komutları çalıştırın. İndirdiğiniz sqlmlutils zip dosyasının tam yolunu değiştirin; bu örnekte indirilen dosyanın olduğu varsayılır c:\temp\sqlmlutils-1.0.0.zip.

   pip install --upgrade --upgrade-strategy only-if-needed c:\temp\sqlmlutils-1.0.0.zip
   

SQL Server'da Python paketi ekleme

sqlmlutils kullanarak bir SQL örneğine Python paketleri ekleyebilirsiniz. Ardından bu paketleri SQL örneğinde çalışan Python kodunuzda kullanabilirsiniz. sqlmlutils , paketi ve bağımlılıklarının her birini yüklemek için CREATE EXTERNAL LIBRARY kullanır.

Aşağıdaki örnekte, metin araçları paketini SQL Server'a ekleyeceksiniz.

Paketi çevrimiçi ekleme

SQL Server'a bağlanmak için kullandığınız istemci bilgisayarın İnternet erişimi varsa, metin araçları paketini ve İnternet üzerindeki bağımlılıkları bulmak için sqlmlutils kullanabilir ve ardından paketi uzaktan bir SQL Server örneğine yükleyebilirsiniz.

1. İstemci bilgisayarda Python'ı veya python ortamını açın.

2. Metin araçları paketini yüklemek için aşağıdaki komutları kullanın. Kendi SQL Server veritabanı bağlantı bilgilerinizi değiştirin (Windows Kimlik Doğrulaması kullanıyorsanız ve uid parametrelerine pwd ihtiyacınız yoktur).

import sqlmlutils
connection = sqlmlutils.ConnectionInfo(server="server", database="database", uid="username", pwd="password")
sqlmlutils.SQLPackageManager(connection).install("text-tools")

Paketi çevrimdışı ekleme

SQL Server'a bağlanmak için kullandığınız istemci bilgisayarın İnternet bağlantısı yoksa, paketi ve bağımlı paketleri yerel bir klasöre indirmek için İnternet erişimi olan bir bilgisayarda pip kullanabilirsiniz. Ardından klasörü, paketi çevrimdışı yükleyebileceğiniz istemci bilgisayara kopyalarsınız.

İnternet erişimi olan bir bilgisayarda

1. Bir Komut İstemi açın ve aşağıdaki komutu çalıştırarak metin araçları paketini içeren yerel bir klasör oluşturun. Bu örnek klasörünü c:\temp\text-toolsoluşturur.

   pip download text-tools -d c:\temp\text-tools
   

2. text-tools klasörü istemci bilgisayara kopyalayın. Aşağıdaki örnekte, bunu c:\temp\packages\text-tools öğesine kopyaladığınız varsayılır.

İstemci bilgisayarda

Pip'in oluşturduğu yerel klasörde bulduğunuz her paketi (WHL dosyası) yüklemek için sqlmlutils kullanın. Paketleri hangi sırayla yüklediğiniz önemli değildir.

Bu örnekte metin araçlarının bağımlılıkları yoktur, bu nedenle klasörden text-tools yüklemeniz gereken tek bir dosya vardır. Buna karşılık , scikit-plot gibi bir paketin 11 bağımlılığı vardır, bu nedenle klasörde 12 dosya ( scikit-plot paketi ve 11 bağımlı paket) bulursunuz ve bunların her birini yüklersiniz.

Aşağıdaki Python betiğini çalıştırın. Paketin gerçek dosya yolunu ve adını ve kendi SQL Server veritabanı bağlantı bilgilerinizi değiştirin (Windows Kimlik Doğrulaması kullanıyorsanız ve uid parametrelerine pwd ihtiyacınız yoktur). klasördeki sqlmlutils.SQLPackageManager her paket dosyası için deyimini yineleyin.

import sqlmlutils
connection = sqlmlutils.ConnectionInfo(server="yourserver", database="yourdatabase", uid="username", pwd="password"))
sqlmlutils.SQLPackageManager(connection).install("text_tools-1.0.0-py3-none-any.whl")

Paketi kullanma

Artık paketi SQL Server'daki bir Python betiğinde kullanabilirsiniz. Örneğin:

EXECUTE sp_execute_external_script
  @language = N'Python',
  @script = N'
from text_tools.finders import find_best_string
corpus = "Lorem Ipsum text"
query = "Ipsum"
first_match = find_best_string(query, corpus)
print(first_match)
  '

PAKETI SQL Server'dan kaldırma

Metin araçları paketini kaldırmak isterseniz, daha önce tanımladığınız bağlantı değişkenini kullanarak istemci bilgisayarda aşağıdaki Python komutunu kullanın.

sqlmlutils.SQLPackageManager(connection).uninstall("text-tools")

Diğer sqlmlutils işlevleri

sqlmlutils paketi, Python paketlerini yönetmeye ve SQL Server'da saklı yordamları ve sorguları oluşturmaya, yönetmeye ve çalıştırmaya yönelik bir dizi işlev içerir. Ayrıntılar için bkz. sqlmlutils Python README dosyası.

Herhangi bir sqlmlutils işlevi hakkında bilgi için Python yardım işlevini kullanın. Örneğin:

import sqlmlutils
help(SQLPackageManager.install)

Sonraki Adımlar

• SQL Server Machine Learning Services'da yüklü Python paketleri hakkında bilgi için bkz. Python paketi bilgilerini alma.

• SQL Server Machine Learning Services'da R paketlerini yükleme hakkında bilgi için bkz. SQL Server'a yeni R paketleri yükleme.