Bagikan melalui

Objek Automasi OLE di Transact-SQL

  • Artikel

Berlaku untuk: SQL Server

Transact-SQL mencakup beberapa prosedur tersimpan sistem yang memungkinkan objek Otomatisasi OLE dirujuk 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 tersimpan OLE Automation memungkinkan batch Transact-SQL untuk 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 subroutine lain juga disarankan.

Langkah pertama saat menggunakan objek OLE Automation di Transact-SQL adalah memanggil sp_OACreate prosedur tersimpan sistem 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 mengatur 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 Automation OLE mengembalikan data melalui nilai dan metode properti. Prosedur sp_OAGetProperty dan sp_OAMethod mengembalikan nilai data ini dalam bentuk tataan 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.

Lihat juga

Langkah berikutnya