Menyebarkan Objek Database CLR

Artikel
03/29/2023

Berlaku untuk:SQL Server

Penyebaran adalah proses di mana Anda mendistribusikan aplikasi atau modul yang sudah selesai untuk diinstal dan dijalankan di komputer lain. Dengan menggunakan Microsoft Visual Studio, Anda dapat mengembangkan objek database common language runtime (CLR) dan menyebarkannya ke server pengujian. Atau, objek database terkelola juga dapat dikompilasi dengan file redistribusi Microsoft .NET Framework, bukan Visual Studio. Setelah dikompilasi, rakitan yang berisi objek database CLR kemudian dapat disebarkan ke server pengujian menggunakan pernyataan Visual Studio atau Transact-SQL. Perhatikan bahwa Visual Studio .NET 2003 tidak dapat digunakan untuk pemrograman atau penyebaran integrasi CLR. SQL Server menyertakan .NET Framework yang telah diinstal sebelumnya, dan Visual Studio .NET 2003 tidak dapat menggunakan rakitan .NET Framework 2.0.

Setelah metode CLR diuji dan diverifikasi di server pengujian, metode tersebut dapat didistribusikan ke server produksi menggunakan skrip penyebaran. Skrip penyebaran dapat dihasilkan secara manual, atau dengan menggunakan SQL Server Management Studio (lihat prosedur nanti dalam topik ini).

Fitur integrasi CLR dinonaktifkan secara default di SQL Server dan harus diaktifkan untuk menggunakan rakitan CLR. Untuk informasi selengkapnya, lihat Mengaktifkan Integrasi CLR.

Menyebarkan Assembly ke Server Pengujian

Dengan menggunakan Visual Studio, Anda dapat mengembangkan fungsi CLR, prosedur, pemicu, jenis yang ditentukan pengguna (UDT), atau agregat yang ditentukan pengguna (UDA), dan menyebarkannya ke server pengujian. Objek database terkelola ini juga dapat dikompilasi dengan kompilator baris perintah, seperti csc.exe dan vbc.exe, disertakan dengan file redistribusi .NET Framework. Lingkungan Pengembangan Terintegrasi Visual Studio tidak diperlukan untuk mengembangkan objek database terkelola untuk SQL Server.

Pastikan bahwa semua kesalahan dan peringatan pengkompilasi diselesaikan. Rakitan yang berisi rutinitas CLR kemudian dapat didaftarkan dalam database SQL Server menggunakan pernyataan Visual Studio atau Transact-SQL.

Catatan

Protokol jaringan TCP/IP harus diaktifkan pada instans SQL Server untuk menggunakan Microsoft Visual Studio untuk pengembangan, penelusuran kesalahan, dan pengembangan jarak jauh. Untuk informasi selengkapnya tentang mengaktifkan protokol TCP/IP di server, lihat Mengonfigurasi Protokol Klien.

Untuk menyebarkan perakitan menggunakan Visual Studio

Buat proyek dengan memilih Nama> proyek build<dari menu Build.
Atasi semua kesalahan dan peringatan build sebelum menyebarkan rakitan ke server pengujian.
Pilih Sebarkan dari menu Build . Rakitan kemudian akan didaftarkan dalam instans SQL Server dan database yang ditentukan ketika proyek SQL Server pertama kali dibuat di Visual Studio.

Untuk menyebarkan rakitan menggunakan Transact-SQL

Kompilasi rakitan dari file sumber menggunakan kompilator baris perintah yang disertakan dengan .NET Framework.
Untuk file sumber Microsoft Visual C#:
csc /target:library C:\helloworld.cs
Untuk file sumber Microsoft Visual Basic:

vbc /target:library C:\helloworld.vb

Perintah ini meluncurkan pengkompilasi Visual C# atau Visual Basic menggunakan opsi /target untuk menentukan pembuatan DLL pustaka.

Atasi semua kesalahan dan peringatan build sebelum menyebarkan rakitan ke server pengujian.
Buka SQL Server Management Studio di server pengujian. Buat kueri baru, yang tersambung ke database pengujian yang sesuai (seperti AdventureWorks).
Buat rakitan di server dengan menambahkan Transact-SQL berikut ke kueri.

CREATE ASSEMBLY HelloWorld from 'c:\helloworld.dll' WITH PERMISSION_SET = SAFE;

Prosedur, fungsi, agregat, jenis yang ditentukan pengguna, atau pemicu kemudian harus dibuat dalam instans SQL Server. Jika rakitan HelloWorld berisi metode bernama HelloWorld di kelas Prosedur, Transact-SQL berikut dapat ditambahkan ke kueri untuk membuat prosedur yang disebut halo di SQL Server.

CREATE PROCEDURE hello

AS

EXTERNAL NAME HelloWorld.Procedures.HelloWorld

Untuk informasi selengkapnya tentang membuat berbagai jenis objek database terkelola di SQL Server, lihat Fungsi YANG Ditentukan Pengguna CLR, Agregat yang Ditentukan Pengguna CLR, Jenis yang Ditentukan Pengguna CLR, Prosedur Tersimpan CLR, dan Pemicu CLR.

Menyebarkan Assembly ke Server Produksi

Setelah objek database CLR diuji dan diverifikasi di server pengujian, objek tersebut dapat didistribusikan ke server produksi. Untuk informasi selengkapnya tentang penelusuran kesalahan objek database terkelola, lihat Men-debug Objek Database CLR.

Penyebaran objek database terkelola mirip dengan objek database reguler (tabel, rutinitas Transact-SQL, dan sebagainya). Rakitan yang berisi objek database CLR dapat disebarkan ke server lain menggunakan skrip penyebaran. Skrip penyebaran dapat dibangun dengan menggunakan fungsionalitas "Hasilkan Skrip" Dari Management Studio. Skrip penyebaran juga dapat dibangun secara manual, atau dibangun menggunakan "Hasilkan Skrip" dan diubah secara manual. Setelah skrip penyebaran dibuat, skrip dapat dijalankan pada instans SQL Server lain untuk menyebarkan objek database terkelola.

Untuk menghasilkan skrip penyebaran menggunakan buat skrip

Buka Management Studio dan sambungkan ke instans SQL Server tempat rakitan terkelola atau objek database yang akan disebarkan didaftarkan.
Di Object Explorer, perluas <nama> server dan pohon Database. Klik kanan database tempat objek database terkelola didaftarkan, pilih Tugas, lalu pilih Hasilkan Skrip. Wizard Skrip terbuka.
Pilih database dari kotak daftar dan klik Berikutnya.
Di panel Pilih Opsi Skrip, klik Berikutnya, atau ubah opsi lalu klik Berikutnya.
Di panel Pilih Tipe Objek, pilih tipe objek database yang akan disebarkan. Klik Berikutnya.
Untuk setiap jenis objek yang dipilih di panel Pilih Tipe Objek, panel Pilih <jenis> disajikan. Di panel ini, Anda dapat memilih dari semua instans jenis objek database yang terdaftar dalam database yang ditentukan. Pilih satu atau beberapa objek dan klik Berikutnya.
Panel Opsi Output muncul ketika semua tipe objek database yang diinginkan telah dipilih. Pilih Skrip untuk file dan tentukan jalur file untuk skrip. Pilih Selanjutnya. Tinjau pilihan Anda dan klik Selesai. Skrip penyebaran disimpan ke jalur file yang ditentukan.

Pasca Skrip Penyebaran

Anda dapat menjalankan skrip pasca penyebaran.

Untuk menambahkan skrip pasca penyebaran, tambahkan file yang disebut postdeployscript.sql di direktori proyek Visual Studio Anda. Misalnya, klik kanan proyek Anda di Penjelajah Solusi dan pilih Tambahkan Item yang Sudah Ada. Tambahkan file di akar proyek, bukan di folder Uji Skrip.

Saat Anda mengklik sebarkan, Visual Studio akan menjalankan skrip ini setelah penyebaran proyek Anda.

Lihat Juga

Konsep Pemrograman Integrasi Common Language Runtime (CLR)

Bagikan melalui