Menginstal Ekstensi Bahasa .NET SQL Server di Windows

Berlaku untuk: SQL Server 2019 (15.x) dan versi yang lebih baru

Pelajari cara menginstal komponen Ekstensi Bahasa .NET (digunakan oleh C#) untuk SQL Server di Windows. Ekstensi Bahasa .NET adalah bagian dari Ekstensi Bahasa SQL Server.

Catatan

Artikel ini untuk penginstalan Ekstensi Bahasa .NET untuk SQL Server di Windows. Linux tidak didukung.

Prasyarat

Catatan

Kemampuan fitur dan opsi penginstalan bervariasi di antara versi SQL Server. Gunakan daftar dropdown pemilih versi untuk memilih versi SQL Server yang sesuai.

• Penyiapan SQL Server diperlukan jika Anda ingin menginstal dukungan untuk Ekstensi Bahasa .NET.

• Ekstensi Bahasa .NET mendukung .NET 6 dan runtime yang lebih baru, dan hanya didukung di Windows.

• Instans Mesin Database diperlukan. Anda tidak dapat menginstal hanya fitur Ekstensi Bahasa .NET, meskipun Anda dapat menambahkannya secara bertahap ke instans yang ada.

• Untuk kelangsungan bisnis, grup ketersediaan AlwaysOn didukung untuk Ekstensi Bahasa. Anda harus menginstal ekstensi bahasa, dan mengonfigurasi paket, pada setiap simpul. Menginstal Ekstensi Bahasa .NET juga didukung pada instans kluster failover di SQL Server.

• Jangan instal Ekstensi Bahasa SQL Server atau Ekstensi Bahasa .NET pada pengontrol domain. Bagian Ekstensi Bahasa dari penyetelan gagal.

• Ekstensi Bahasa dan Layanan Pembelajaran Mesin diinstal secara default pada Kluster Big Data SQL Server. Jika Anda menggunakan Kluster Big Data, Anda tidak perlu mengikuti langkah-langkah dalam artikel ini. Untuk informasi selengkapnya, lihat Menjalankan skrip Python dan R dengan Pembelajaran Mesin Services di Kluster Big Data SQL Server 2019.

Penting

Setelah penyiapan selesai, pastikan untuk menyelesaikan langkah-langkah pasca-konfigurasi yang dijelaskan dalam artikel ini. Langkah-langkah ini termasuk mengaktifkan SQL Server untuk menggunakan kode eksternal, dan menambahkan akun yang diperlukan SQL Server untuk menjalankan kode C# atas nama Anda. Perubahan konfigurasi umumnya memerlukan mulai ulang instans, atau menghidupkan ulang layanan Launchpad.

Runtime .NET

Dukungan jangka panjang .NET 6 (LTS) adalah runtime paling awal yang didukung. Anda dapat mengunduh runtime .NET untuk Windows. Linux tidak didukung.

Jika Anda ingin menggunakan rilis LTS terbaru dari runtime .NET, Anda harus mengkompilasi ulang Ekstensi Bahasa .NET.

Mendapatkan media penginstalan

Lokasi unduhan untuk SQL Server tergantung pada edisi:

• Edisi SQL Server Enterprise, Standard, dan Express. Edisi ini dilisensikan untuk penggunaan produksi. Untuk edisi Enterprise dan Standard, hubungi vendor perangkat lunak Anda untuk media penginstalan. Anda dapat menemukan informasi pembelian dan direktori mitra Microsoft di situs web pembelian Microsoft.

• Edisi gratis terbaru.

Jalankan Penyetelan

Untuk penginstalan lokal, Anda harus menjalankan Penyetelan sebagai administrator. Jika Anda menginstal SQL Server dari berbagi jarak jauh, Anda harus menggunakan akun domain yang memiliki izin baca dan jalankan pada berbagi jarak jauh.

1. Mulai wizard penyetelan untuk SQL Server.

2. Pada tab Penginstalan , pilih Penginstalan mandiri SQL Server baru atau tambahkan fitur ke penginstalan yang sudah ada.

3. Pada halaman Pilihan Fitur, pilih opsi ini:

   Layanan Mesin Database: Untuk menggunakan Ekstensi Bahasa dengan SQL Server, Anda harus menginstal instans Mesin Database. Anda dapat menggunakan instans default atau bernama.

   Pembelajaran Mesin Layanan dan Ekstensi Bahasa: Opsi ini menginstal komponen Ekstensi Bahasa yang mendukung eksekusi kode C#.

   

4. Pada halaman Siap Diinstal , verifikasi bahwa pilihan ini disertakan, dan pilih Instal.

   • Mengelola Database Engine Services
   • Layanan Pembelajaran Mesin dan Ekstensi Bahasa

   Perhatikan lokasi folder di bawah jalur ..\Setup Bootstrap\Log tempat file konfigurasi disimpan. Setelah penyiapan selesai, Anda dapat meninjau komponen yang diinstal dalam file Ringkasan.

5. Setelah penyetelan selesai, jika Anda diinstruksikan untuk memulai ulang komputer, lakukan sekarang. Penting untuk membaca pesan dari Wizard Penginstalan saat Anda selesai dengan Penyetelan. Untuk informasi selengkapnya, lihat Menampilkan dan Membaca File Log Penyetelan SQL Server.

Mendaftarkan ekstensi bahasa

1. Ikuti langkah-langkah ini untuk mengunduh dan mendaftarkan ekstensi bahasa .NET, yang digunakan untuk menjalankan kode C#.

   1. dotnet-core-CSharp-lang-extension-windows-release.zip Unduh file dari ekstensi bahasa .NET untuk repositori GitHub SQL Server. Unduh file Windows dotnet-core-CSharp-lang-extension-windows-release.zip terbaru. Jika Anda lebih suka menggunakan runtime .NET yang lebih baru, Anda perlu mengkompilasi dotnet-core-CSharp-lang-extension dari kode sumber GitHub.

   2. Gunakan SQL Server Management Studio (SSMS) atau Azure Data Studio untuk menyambungkan ke instans SQL Server Anda dan jalankan perintah Transact-SQL (T-SQL) berikut untuk mendaftarkan ekstensi bahasa .NET dengan CREATE EXTERNAL LANGUAGE.

   3. Ubah jalur dalam pernyataan ini untuk mencerminkan lokasi file zip ekstensi bahasa yang diunduh (dotnet-core-CSharp-lang-extension-windows-release.zip).

   CREATE EXTERNAL LANGUAGE [dotnet]
   FROM (CONTENT = N'C:\path\to\dotnet-core-CSharp-lang-extension-windows-release.zip',
       FILE_NAME = 'dotnetextension.dll');
   GO
   

2. Mulai ulang Launchpad.

   1. Buka Pengelola Konfigurasi SQL Server.

   2. Di bawah Layanan SQL Server, klik kanan Launchpad SQL Server dan pilih Mulai Ulang.

Mulai ulang layanan

Ketika penginstalan selesai, mulai ulang Mesin Database sebelum melanjutkan ke langkah berikutnya, mengaktifkan eksekusi skrip.

Memulai ulang layanan juga secara otomatis memulai ulang layanan Launchpad SQL Server terkait.

Anda dapat memulai ulang layanan menggunakan perintah Hidupkan ulang klik kanan untuk instans di SSMS, dengan panel Layanan di Panel Kontrol, atau dengan menggunakan Pengelola Konfigurasi SQL Server.

Aktifkan eksekusi skrip

1. Buka SQL Server Management Studio. Sambungkan ke instans tempat Anda menginstal Ekstensi Bahasa, pilih Kueri Baru untuk membuka jendela kueri, dan jalankan perintah berikut:

   EXEC sp_configure;
   

   Fitur ini nonaktif (value adalah 0) secara default, dan harus diaktifkan secara eksplisit oleh administrator sebelum Anda dapat menjalankan kode C#.

2. Untuk mengaktifkan fitur pembuatan skrip eksternal, jalankan pernyataan berikut:

   EXEC sp_configure 'external scripts enabled', 1;
   GO
   RECONFIGURE WITH OVERRIDE
   

   Jika Anda sudah mengaktifkan fitur untuk layanan Pembelajaran Mesin, jangan jalankan konfigurasi ulang untuk kedua kalinya untuk Ekstensi Bahasa. Platform ekstensibilitas yang mendasar mendukung keduanya.

Mendaftarkan bahasa eksternal

Untuk setiap database yang ingin Anda gunakan ekstensi bahasa, Anda perlu mendaftarkan bahasa eksternal dengan CREATE EXTERNAL LANGUAGE.

Contoh berikut menambahkan bahasa eksternal yang dipanggil dotnet ke database di SQL Server di Windows.

CREATE EXTERNAL LANGUAGE [dotnet]
FROM (CONTENT = N'<path-to-zip>', FILE_NAME = 'dotnetextension.dll');
GO

Untuk informasi selengkapnya, lihat MEMBUAT BAHASA EKSTERNAL.

Verifikasi penginstalan

Periksa status penginstalan instans dalam log penyiapan.

Gunakan langkah-langkah berikut untuk memverifikasi bahwa semua komponen yang digunakan untuk meluncurkan skrip eksternal sedang berjalan.

1. Di SQL Server Management Studio atau Azure Data Studio, buka jendela kueri baru, dan jalankan pernyataan berikut:

   EXEC sp_configure 'external scripts enabled';
   

   sekarang run_value diatur ke 1.

2. Buka panel Layanan atau Pengelola Konfigurasi SQL Server, dan verifikasi layanan Launchpad SQL Server sedang berjalan. Anda harus memiliki satu layanan untuk setiap instans Mesin Database yang memiliki ekstensi bahasa yang terinstal. Untuk informasi selengkapnya tentang layanan ini, lihat Arsitektur ekstensibilitas di Ekstensi Bahasa SQL Server.

Konfigurasi tambahan

Jika langkah verifikasi berhasil, Anda dapat menjalankan kode C# dari SQL Server Management Studio, Azure Data Studio, Visual Studio Code, atau klien lain yang dapat mengirim pernyataan T-SQL ke server.

Jika Anda mendapatkan kesalahan saat menjalankan perintah, tinjau langkah-langkah konfigurasi tambahan di bagian ini. Anda mungkin perlu membuat konfigurasi ekstra yang sesuai ke layanan atau database.

Pada tingkat instans, konfigurasi tambahan mungkin mencakup:

• Konfigurasi firewall untuk SQL Server Machine Learning Services
• Mengaktifkan atau menonaktifkan protokol jaringan server
• Mengonfigurasi akses jarak jauh (opsi konfigurasi server)
• Membuat login untuk SQLRUserGroup

Pada database, Anda mungkin memerlukan pembaruan konfigurasi berikut:

• Memberikan izin pengguna database untuk menjalankan skrip Python dan R dengan SQL Server Pembelajaran Mesin Services
• Beri pengguna izin untuk menjalankan bahasa tertentu

Catatan

Apakah konfigurasi tambahan diperlukan tergantung pada skema keamanan Anda, tempat Anda menginstal SQL Server, dan bagaimana Anda mengharapkan pengguna tersambung ke database dan menjalankan skrip eksternal.

Pengoptimalan yang disarankan

Setelah semuanya berfungsi, Anda mungkin juga ingin mengoptimalkan server untuk mendukung Ekstensi Bahasa .NET.

Mengoptimalkan server untuk Ekstensi Bahasa .NET

Pengaturan default untuk penyiapan SQL Server dimaksudkan untuk mengoptimalkan keseimbangan server untuk berbagai layanan yang didukung oleh Mesin Database, yang mungkin mencakup proses ekstrak, transformasi, dan pemuatan (ETL), pelaporan, audit, dan aplikasi yang menggunakan data SQL Server. Oleh karena itu, di bawah pengaturan default, Anda mungkin menemukan bahwa sumber daya untuk ekstensi bahasa terkadang dibatasi atau dibatasi, terutama dalam operasi intensif memori.

Untuk memastikan bahwa pekerjaan ekstensi bahasa diprioritaskan dan diprioritaskan dengan tepat, kami sarankan Anda menggunakan SQL Server Resource Governor untuk mengonfigurasi kumpulan sumber daya eksternal. Anda mungkin juga ingin mengubah jumlah memori yang dialokasikan ke Mesin Database, atau menambah jumlah akun yang berjalan di bawah layanan Launchpad SQL Server.

• Untuk mengonfigurasi kumpulan sumber daya untuk mengelola sumber daya eksternal, lihat MEMBUAT KUMPULAN SUMBER DAYA EKSTERNAL (Transact-SQL).

• Untuk mengubah jumlah memori yang dicadangkan untuk database, lihat Opsi konfigurasi memori server.

Jika Anda menggunakan edisi Standar dan tidak memiliki Resource Governor, Anda dapat menggunakan tampilan manajemen dinamis (DMV) dan Extended Events, serta pemantauan peristiwa Windows, untuk membantu mengelola sumber daya server.

Langkah selanjutnya

Pengembang C# dapat memulai dengan beberapa contoh sederhana, dan mempelajari dasar-dasar cara kerja C# dengan SQL Server. Untuk langkah Anda berikutnya, lihat tautan berikut ini:

Tutorial: Ekspresi reguler dengan C#