Cara memanggil runtime Java di Ekstensi Bahasa SQL Server
Berlaku untuk: SQL Server 2019 (15.x) dan versi yang lebih baru
Fitur Ekstensi Bahasa SQL Server menggunakan prosedur tersimpan sistem sp_execute_external_script sebagai antarmuka untuk memanggil runtime Java.
Artikel panduan ini menjelaskan detail implementasi untuk kelas dan metode Java yang dijalankan di SQL Server.
Tempat menempatkan kelas Java
Ada dua metode untuk memanggil kelas Java di SQL Server:
Tempatkan
.class
atau.jar
file di classpath Java Anda.Unggah kelas yang
.jar
dikompilasi dalam file dan dependensi lain ke dalam database menggunakan DDL pustaka eksternal.
Catatan
Sebagai rekomendasi umum, gunakan .jar
file dan bukan file individual .class
. Ini adalah praktik umum di Java dan akan membuat pengalaman keseluruhan lebih mudah. Lihat juga, Membuat file Java .jar dari file kelas.
Menggunakan Classpath
Prinsip dasar
Berikut ini adalah beberapa prinsip dasar saat menjalankan Java di SQL Server.
Kelas Java kustom yang dikompilasi harus ada dalam
.class
file atau.jar
file di classpath Java Anda. Parameter CLASSPATH menyediakan jalur ke file Java yang dikompilasi.Metode Java yang Anda panggil harus disediakan dalam
script
parameter pada prosedur tersimpan.Jika kelas termasuk dalam paket,
packageName
kelas harus disediakan.params
digunakan untuk meneruskan parameter ke kelas Java. Memanggil metode yang memerlukan argumen tidak didukung. Oleh karena itu, parameter adalah satu-satunya cara untuk meneruskan nilai argumen ke metode Anda.
Catatan
Catatan ini memulihkan operasi yang didukung dan tidak didukung khusus untuk Java di SQL Server 2019 (15.x) dan versi yang lebih baru. Pada prosedur tersimpan, parameter input didukung, sementara parameter output tidak didukung.
Memanggil kelas Java
Prosedur tersimpan sistem sp_execute_external_script adalah antarmuka yang digunakan untuk memanggil runtime Java. Contoh berikut menunjukkan sp_execute_external_script
penggunaan ekstensi Java, dan parameter untuk menentukan jalur, skrip, dan kode kustom Anda.
Catatan
Anda tidak perlu menentukan metode mana yang akan dipanggil. Secara default, metode yang disebut execute
dipanggil. Ini berarti Anda perlu mengikuti SDK Ekstensibilitas Microsoft untuk Java untuk SQL Server dan menerapkan metode eksekusi di kelas Java Anda.
DECLARE @param1 INT
SET @param1 = 3
EXEC sp_execute_external_script @language = N'Java',
@script = N'<packageName>.<ClassName>',
@input_data_1 = N'<Input Query>',
@param1 = @param1;
Atur CLASSPATH
Setelah mengkompilasi kelas atau kelas Java, dan membuat .jar
file di Java classpath
, Anda memiliki dua opsi untuk menyediakan jalur ke ekstensi Java SQL Server:
Menggunakan pustaka eksternal
Opsi termampukan adalah membuat SQL Server secara otomatis menemukan kelas Anda dengan membuat pustaka eksternal dan mengarahkan pustaka ke jar. Menggunakan pustaka eksternal untuk Java
Mendaftarkan variabel lingkungan sistem
Anda dapat membuat variabel lingkungan sistem dan menyediakan jalur ke file Anda
.jar
yang berisi kelas. Buat variabel lingkungan sistem yang disebutCLASSPATH
.
Menggunakan pustaka eksternal
Di SQL Server 2019 (15.x) dan versi yang lebih baru, Anda dapat menggunakan pustaka eksternal untuk bahasa Java di Windows dan Linux. Anda dapat mengkompilasi kelas Anda ke dalam .jar
file dan mengunggah .jar
file dan dependensi lainnya ke dalam database menggunakan CREATE EXTERNAL LIBRARY DDL.
Contoh cara mengunggah .jar
file dengan pustaka eksternal:
CREATE EXTERNAL LIBRARY myJar
FROM (CONTENT = '<local path to .jar file>')
WITH (LANGUAGE = 'Java');
GO
Saat membuat pustaka eksternal, SQL Server secara otomatis memiliki akses ke kelas Java, dan Anda tidak perlu mengatur izin khusus apa pun ke classpath.
Kode berikut adalah contoh memanggil metode di kelas dari paket, yang diunggah sebagai pustaka eksternal:
EXEC sp_execute_external_script
@language = N'Java',
@script = N'MyPackage.MyCLass',
@input_data_1 = N'SELECT * FROM MYTABLE'
WITH RESULT SETS((column1 INT));
Untuk informasi selengkapnya, lihat MEMBUAT PUSTAKA EKSTERNAL.
Koneksi loopback ke SQL Server
Gunakan koneksi loopback untuk menyambungkan kembali ke SQL Server melalui JDBC untuk membaca atau menulis data dari Java yang dijalankan dari sp_execute_external_script
. Anda dapat menggunakan ini saat menggunakan InputDataSet
argumen sp_execute_external_script
dan OutputDataSet
tidak dimungkinkan.
Untuk membuat koneksi loopback di Windows, gunakan contoh berikut:
jdbc:sqlserver://localhost:1433;databaseName=Adventureworks;integratedSecurity=true;
Untuk membuat koneksi loopback di Linux, driver JDBC memerlukan tiga properti koneksi yang ditentukan dalam Sertifikat berikut: