sqlmlutils ile R 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'daki ve Büyük Veri KümelerindekiMachine Learning Services örneğine R paketleri yükleme işlemi açıklanmaktadır. Yüklediğiniz paketler , sp_execute_external_script T-SQL deyimi kullanılarak veritabanında çalıştırılan R betiklerinde kullanılabilir.

Uyarı

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

Önkoşullar

• SQL Server'a bağlanmak için kullandığınız istemci bilgisayara R ve RStudio Desktop'ı yükleyin. Betikleri çalıştırmak için herhangi bir R IDE kullanabilirsiniz, ancak bu makalede RStudio varsayılmaktadır.

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

  Belirli bir SQL Server'da R sürümünü doğrulamak için aşağıdaki T-SQL komutunu kullanın.

  EXECUTE sp_execute_external_script @language = N'R'
  , @script = N'print(R.version)'
  

• 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.

Dikkat edilecek diğer noktalar

• 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.

• SQL Server'da çalıştırılan R betiği yalnızca varsayılan örnek kitaplığında yüklü paketleri kullanabilir. Bu kitaplık aynı bilgisayarda olsa bile SQL Server dış kitaplıklardan paket yükleyemez. Bu, diğer Microsoft ürünleriyle birlikte yüklenen R kitaplıklarını içerir.

• 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

İ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.

sqlmlutils paketi odbc paketine, odbc ise bir dizi başka pakete bağlıdır. Aşağıdaki yordamlar bu paketlerin tümünü doğru sırada yükler.

sqlmlutils'i çevrimiçi yükleme

İstemci bilgisayarın İnternet erişimi varsa sqlmlutils ve bağımlı paketlerini çevrimiçi olarak indirip yükleyebilirsiniz.

1. En son sqlmlutils dosyasını (.zip Windows için, .tar.gz Linux için) https://github.com/microsoft/sqlmlutils/releases adresinden istemci bilgisayara indirin. Dosyayı genişletmeyin.

2. Bir Komut İstemi açın ve odbc ve sqlmlutils paketlerini yüklemek için aşağıdaki komutları çalıştırın. İndirdiğiniz sqlmlutils dosyasının yolunu değiştirin. Odbc paketi çevrimiçi olarak bulunur ve yüklenir.

   R.exe -e "install.packages('odbc', type='binary')"
   R.exe CMD INSTALL sqlmlutils_1.0.0.zip
   

sqlmlutils'i çevrimdışı yükleme

İstemci bilgisayarın İnternet bağlantısı yoksa, İnternet erişimi olan bir bilgisayar kullanarak odbc ve sqlmlutils paketlerini önceden indirmeniz gerekir. Ardından dosyaları istemci bilgisayardaki bir klasöre kopyalayabilir ve paketleri çevrimdışı yükleyebilirsiniz.

Odbc paketinin bir dizi bağımlı paketi vardır ve bir paket için tüm bağımlılıkları tanımlamak karmaşıklaşır. Tüm bağımlı paketleri içeren paket için yerel bir depo klasörü oluşturmak üzere miniCRAN kullanmanızı öneririz. Daha fazla bilgi için bkz. MiniCRAN kullanarak yerel R paketi deposu oluşturma.

sqlmlutils paketi, istemci bilgisayara kopyalayıp yükleyebileceğiniz tek bir dosyadan oluşur.

İnternet erişimi olan bir bilgisayarda:

1. MiniCRAN'ı yükleyin. Ayrıntılar için bkz. MiniCRAN yükleme .

2. RStudio'da aşağıdaki R betiğini çalıştırarak odbc paketinin yerel deposunu oluşturun. Bu örnekte, depo, odbc klasöründe oluşturulacak şekilde varsayılır.

   library("miniCRAN")
   CRAN_mirror <- c(CRAN = "https://cran.microsoft.com")
   local_repo <- "odbc"
   pkgs_needed <- "odbc"
   pkgs_expanded <- pkgDep(pkgs_needed, repos = CRAN_mirror);
   
   makeRepo(pkgs_expanded, path = local_repo, repos = CRAN_mirror, type = "win.binary", Rversion = "3.5");
   

   değeri için Rversion SQL Server'da yüklü R sürümünü kullanın. Yüklü sürümü doğrulamak için aşağıdaki T-SQL komutunu kullanın.

   EXECUTE sp_execute_external_script @language = N'R'
    , @script = N'print(R.version)'
   

3. adresinden en son sqlmlutils dosyasını (.zip Windows için, .tar.gz Linux için) https://github.com/microsoft/sqlmlutils/releasesindirin. Dosyayı genişletmeyin.

4. Odbc deposu klasörünün tamamını ve sqlmlutils dosyasını istemci bilgisayara kopyalayın.

SQL Server'a bağlanmak için kullandığınız istemci bilgisayarda:

1. Komut istemi açın.

2. Odbc ve ardından sqlmlutils yüklemek için aşağıdaki komutları çalıştırın. Odbc deposu klasörünün ve bu bilgisayara kopyaladığınız sqlmlutils dosyasının tam yollarını değiştirin.

   R.exe -e "install.packages('odbc', repos='odbc')"
   R.exe CMD INSTALL sqlmlutils_1.0.0.zip
   

SQL Server'da R paketi ekleme

Aşağıdaki örnekte, tutkal 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, tutkal paketini ve İnternet üzerindeki bağımlılıkları bulmak için sqlmlutils kullanabilir ve ardından paketi bir SQL Server örneğine uzaktan yükleyebilirsiniz.

1. İstemci bilgisayarda RStudio'yu açın ve yeni bir R Betiği dosyası oluşturun.

2. Sqlmlutils kullanarak tutkal paketini yüklemek için aşağıdaki R betiğini kullanın. Kendi SQL Server veritabanı bağlantı bilgilerinizi değiştirin.

   library(sqlmlutils)
   connection <- connectionInfo(
     server   = "server",
     database = "database",
     uid      = "username",
     pwd      = "password")
   
   sql_install.packages(connectionString = connection, pkgs = "glue", verbose = TRUE, scope = "PUBLIC")
   

   Tavsiye

   KapsamGENEL veya ÖZEL olabilir. Genel kapsam, veritabanı yöneticisinin tüm kullanıcıların kullanabileceği paketleri yüklemesi için yararlıdır. Özel kapsam, paketi yalnızca yükleyen kullanıcının kullanımına sunar. Kapsamı belirtmezseniz varsayılan kapsam ÖZEL'dir.

Paketi çevrimdışı ekleme

İstemci bilgisayarın İnternet bağlantısı yoksa, İnternet erişimi olan bir bilgisayar kullanarak tutkal paketini indirmek için miniCRAN kullanabilirsiniz. Ardından paketi istemci bilgisayara kopyalarsınız; burada paketi çevrimdışı yükleyebilirsiniz. MiniCRAN yükleme hakkında bilgi için bkz. MiniCRAN yükleme.

İnternet erişimi olan bir bilgisayarda:

1. Tutkal için yerel bir depo oluşturmak için aşağıdaki R betiğini çalıştırın. Bu örnek içinde c:\downloads\gluedepo klasörünü oluşturur.

   library("miniCRAN")
   CRAN_mirror <- c(CRAN = "https://cran.microsoft.com")
   local_repo <- "c:/downloads/glue"
   pkgs_needed <- "glue"
   pkgs_expanded <- pkgDep(pkgs_needed, repos = CRAN_mirror);
   
   makeRepo(pkgs_expanded, path = local_repo, repos = CRAN_mirror, type = "win.binary", Rversion = "3.5");
   

   değeri için Rversion SQL Server'da yüklü R sürümünü kullanın. Yüklü sürümü doğrulamak için aşağıdaki T-SQL komutunu kullanın.

   EXECUTE sp_execute_external_script @language = N'R'
    , @script = N'print(R.version)'
   

2. Tutkal deposu klasörünün tamamını (c:\downloads\glue) istemci bilgisayara kopyalayın. Örneğin, klasörüne c:\temp\packages\gluekopyalayın.

İstemci bilgisayarda:

1. RStudio'yu açın ve yeni bir R Betiği dosyası oluşturun.

2. Sqlmlutils kullanarak tutkal paketini yüklemek için aşağıdaki R betiğini kullanın. Kendi SQL Server veritabanı bağlantı bilgilerinizi değiştirin (Eğer Windows Kimlik Doğrulaması kullanmıyorsanız, uid ve pwd parametrelerini ekleyin).

   library(sqlmlutils)
   connection <- connectionInfo(
     server= "yourserver",
     database = "yourdatabase")
   localRepo = "c:/temp/packages/glue"
   
   sql_install.packages(connectionString = connection, pkgs = "glue", verbose = TRUE, scope = "PUBLIC", repos=paste0("file:///",localRepo))
   

   Tavsiye

   KapsamGENEL veya ÖZEL olabilir. Genel kapsam, veritabanı yöneticisinin tüm kullanıcıların kullanabileceği paketleri yüklemesi için yararlıdır. Özel kapsam, paketi yalnızca yükleyen kullanıcının kullanımına sunar. Kapsamı belirtmezseniz varsayılan kapsam ÖZEL'dir.

Paketi kullanma

Tutkal paketi yüklendikten sonra, T-SQL sp_execute_external_script komutuyla SQL Server'daki bir R betiğinde kullanabilirsiniz.

1. Azure Data Studio'yu açın ve SQL Server veritabanınıza bağlanın.

2. Aşağıdaki komutu çalıştırın:

   EXECUTE sp_execute_external_script @language = N'R'
       , @script = N'
   library(glue)
   
   name <- "Fred"
   birthday <- as.Date("2020-06-14")
   text <- glue(''My name is {name} '',
   ''and my birthday is {format(birthday, "%A, %B %d, %Y")}.'')
   
   print(text)
         ';
   

   Results

   My name is Fred and my birthday is Sunday, June 14, 2020.
   

Paketi kaldırma

Tutkal paketini kaldırmak isterseniz aşağıdaki R betiğini çalıştırın. Daha önce tanımladığınız bağlantı değişkenini kullanın.

sql_remove.packages(connectionString = connection, pkgs = "glue", scope = "PUBLIC")

Diğer sqlmlutils işlevleri

sqlmlutils paketi, R 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 R README dosyası.

Herhangi bir sqlmlutils işlevi hakkında bilgi için R help işlevini veya ? işlecini kullanın. Örneğin:

library(sqlmlutils)
help("sql_install.packages")

Sonraki Adımlar

• Yüklü R paketleri hakkında bilgi için bkz. R paketi bilgilerini alma
• R paketleriyle çalışma konusunda yardım için bkz. R paketlerini kullanma ipuçları
• Python paketlerini yükleme hakkında bilgi için bkz . Pip ile Python paketlerini yükleme
• SQL Server Machine Learning Services hakkında daha fazla bilgi için bkz. SQL Server Machine Learning Services (Python ve R) nedir?