Objek Automasi OLE di Transact-SQL

Transact-SQL mencakup beberapa prosedur tersimpan sistem yang memungkinkan objek Otomatisasi OLE direferensikan dalam batch Transact-SQL, prosedur tersimpan, dan pemicu. Prosedur tersimpan sistem ini berjalan sebagai prosedur tersimpan yang diperluas, dan objek OLE Automation yang dijalankan melalui prosedur tersimpan berjalan di ruang alamat instans Mesin Database SQL Server dengan cara yang sama seperti prosedur tersimpan yang diperluas berjalan.

Prosedur simpan OLE Automation memungkinkan batch Transact-SQL mereferensikan objek SQL-DMO dan objek OLE Automation kustom, seperti objek yang mengekspos antarmuka IDispatch. Server OLE dalam proses kustom yang dibuat dengan menggunakan Microsoft Visual Basic harus memiliki penangan kesalahan (ditentukan dengan pernyataan On Error GoTo ) untuk subroutine Class_Initialize dan Class_Terminate . Kesalahan yang tidak tertangani dalam subroutine Class_Initialize dan Class_Terminate dapat menyebabkan kesalahan yang tidak dapat diprediksi, seperti pelanggaran akses dalam instans Mesin Database. Penanganan kesalahan untuk subrutin lainnya juga disarankan.

Langkah pertama saat menggunakan objek OLE Automation di Transact-SQL adalah memanggil prosedur tersimpan sistem sp_OACreate untuk membuat instans objek di ruang alamat instans Mesin Database.

Setelah instans objek dibuat, panggil prosedur tersimpan berikut untuk bekerja dengan properti, metode, dan informasi kesalahan yang terkait dengan objek:

• sp_OAGetProperty mendapatkan nilai properti.

• sp_OASetProperty menetapkan nilai properti.

• sp_OAMethod memanggil metode.

• sp_OAGetErrorInfo mendapatkan informasi kesalahan terbaru.

Ketika tidak ada lagi kebutuhan untuk objek, panggil sp_OADestroy untuk membatalkan alokasi instans objek yang dibuat dengan menggunakan sp_OACreate.

Objek OLE Automation mengembalikan data melalui metode dan nilai properti. sp_OAGetProperty dan sp_OAMethod mengembalikan nilai data ini dalam bentuk kumpulan hasil.

Cakupan objek OLE Automation adalah batch. Semua referensi ke objek harus terkandung dalam satu batch, prosedur tersimpan, atau pemicu.

Saat mereferensikan objek, objek SQL Server OLE Automation mendukung melintasi objek yang direferensikan ke objek lain yang dikandungnya. Misalnya, saat menggunakan objek SQLServer SQL-DMO, referensi dapat dibuat ke database dan tabel yang terkandung di server tersebut.

Isi Terkait

Sintaks Hierarki Objek (Transact-SQL)

Konfigurasi Area Permukaan

Opsi Konfigurasi Server Prosedur Otomatisasi Ole

sp_OACreate (Transact-SQL)

sp_OAGetProperty (Transact-SQL)

sp_OASetProperty (Transact-SQL)

sp_OAMethod (Transact-SQL)

sp_OAGetErrorInfo (Transact-SQL)

sp_OADestroy (Transact-SQL)