Menginstal paket dengan alat R

Berlaku untuk: SQL Server 2016 (13.x) SQL Server 2017 (14.x)

Artikel ini menjelaskan cara menggunakan alat R standar untuk menginstal paket R baru ke instans SQL Server Machine Learning Services atau SQL Server R Services. Anda dapat menginstal paket pada SQL Server yang memiliki koneksi Internet, serta paket yang terisolasi dari Internet.

Selain alat R standar, Anda dapat menginstal paket R menggunakan:

• RevoScaleR

• T-SQL (BUAT PUSTAKA EKSTERNAL)

Pertimbangan umum

• Kode R yang berjalan di SQL Server hanya dapat menggunakan paket yang diinstal di pustaka instans default. SQL Server tidak dapat memuat paket dari pustaka eksternal, meskipun pustaka tersebut berada di komputer yang sama. Ini termasuk pustaka R yang diinstal dengan produk Microsoft lainnya.

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

  Non-administrator dapat menginstal paket menggunakan RevoScaleR 9.0.1 dan yang lebih baru, atau menggunakan CREATE EXTERNAL LIBRARY. Pengguna dbo_owner , atau pengguna dengan izin CREATE EXTERNAL LIBRARY, dapat menginstal paket R ke database saat ini. Untuk informasi selengkapnya, lihat:

  • Menggunakan RevoScaleR untuk menginstal paket R
  • Gunakan T-SQL (CREATE EXTERNAL LIBRARY) untuk menginstal paket R di SQL Server

• 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

Penginstalan online (dengan akses Internet)

Jika SQL Server memiliki akses ke Internet, maka Anda dapat menggunakan alat penginstalan paket standar untuk menginstal paket R.

1. Tentukan lokasi pustaka instans (lihat Dapatkan informasi paket R) dan navigasikan ke folder tempat alat R diinstal.

   Misalnya jalur default untuk instans default SQL Server adalah:

   C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\R_SERVICES\bin\x64\

2. Jalankan R atau Rgui sebagai administrator dari folder ini.

3. Jalankan perintah install.packages R dan tentukan nama paket. Jika paket memiliki dependensi, alat penginstal secara otomatis mengunduh dependensi dan menginstalnya.

Jika Anda memiliki beberapa instans SQL Server berdampingan, jalankan penginstalan secara terpisah untuk setiap instans tempat Anda ingin menggunakan paket. Paket tidak dapat dibagikan di seluruh instans.

Penginstalan offline (tanpa akses internet)

Sering kali, server yang menghosting database produksi tidak memiliki koneksi internet. Untuk menginstal paket R di lingkungan tersebut, Anda mengunduh dan menyiapkan paket dan dependensi terlebih dahulu (sebagai file zip), lalu menyalin file ke folder di server. Setelah file diberlakukan, paket dapat diinstal secara offline.

Mengidentifikasi semua dependensi menjadi rumit. Untuk R, kami sarankan Anda menggunakan miniCRAN untuk membuat repositori lokal. miniCRAN mengambil daftar paket yang ingin Anda instal, menganalisis dependensi, dan mengumpulkan semua file zip yang diperlukan. Kemudian membuat satu repositori yang dapat Anda salin ke instans SQL Server yang terisolasi. Paket igraph juga berguna dalam menganalisis dependensi paket.

Untuk informasi selengkapnya, lihat Membuat repositori paket R lokal menggunakan miniCRAN.

Setelah file zip berada di instans SQL Server, Anda dapat menginstalnya menggunakan alat R standar di server.

1. Tentukan lokasi pustaka instans (lihat Dapatkan informasi paket R) dan navigasikan ke folder tempat alat R diinstal.

   Misalnya jalur default untuk instans default SQL Server adalah:

   C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\R_SERVICES\bin\x64\

2. Jalankan R atau Rgui sebagai administrator dari folder ini.

3. Jalankan perintah install.packages R dan tentukan nama paket atau repositori, dan lokasi file zip. Contohnya:

   install.packages("C:\\Temp\\Downloaded packages\\mynewpackage.zip", repos=NULL)
   

   Perintah ini mengekstrak paket mynewpackage R dari file zip lokalnya dan menginstal paket. Jika paket memiliki dependensi, alat penginstal memeriksa paket yang ada di pustaka. Jika Anda telah membuat repositori yang menyertakan dependensi, alat penginstal juga menginstal paket yang diperlukan.

   Catatan

   Jika ada paket yang diperlukan yang tidak ada di pustaka instans, dan tidak dapat ditemukan dalam file zip, penginstalan paket target gagal.

Sebagai alternatif untuk miniCRAN, Anda dapat melakukan langkah-langkah ini secara manual:

1. Identifikasi semua dependensi paket.
2. Periksa apakah ada paket yang diperlukan yang sudah diinstal pada server. Jika paket diinstal, verifikasi bahwa versinya sudah benar.
3. Unduh paket dan semua dependensi ke komputer terpisah dengan akses Internet.
4. Tempatkan paket dan dependensi dalam satu arsip paket.
5. Zip arsip jika belum dalam format zip.
6. Pindahkan file ke folder yang dapat diakses oleh server.
7. Jalankan perintah penginstalan yang didukung atau pernyataan DDL untuk menginstal paket ke pustaka instans.

Lihat juga

• Dapatkan informasi paket R
• Tips untuk menggunakan paket R
• SQL Server tutorial bahasa R