Bagikan melalui

Tugas Skrip

  • Artikel

Berlaku untuk: SQL Server SSIS Integration Runtime di Azure Data Factory

Tugas Skrip menyediakan kode untuk melakukan fungsi yang tidak tersedia dalam tugas dan transformasi bawaan yang disediakan SQL Server Integration Services. Tugas Skrip juga dapat menggabungkan fungsi dalam satu skrip alih-alih menggunakan beberapa tugas dan transformasi. Anda menggunakan tugas Skrip untuk pekerjaan yang harus dilakukan sekali dalam paket (atau sekali per objek enumerasi), bukan sekali per baris data.

Anda dapat menggunakan tugas Skrip untuk tujuan berikut:

  • Akses data dengan menggunakan teknologi lain yang tidak didukung oleh jenis koneksi bawaan. Misalnya, skrip dapat menggunakan Antarmuka Layanan Direktori Aktif (ADSI) untuk mengakses dan mengekstrak nama pengguna dari Direktori Aktif.

  • Buat penghitung kinerja khusus paket. Misalnya, skrip dapat membuat penghitung kinerja yang diperbarui saat tugas yang kompleks atau berkinerja buruk berjalan.

  • Identifikasi apakah file yang ditentukan kosong atau berapa banyak baris yang dikandungnya, lalu berdasarkan informasi tersebut memengaruhi alur kontrol dalam paket. Misalnya, jika file berisi baris nol, nilai variabel yang diatur ke 0, dan batasan prioritas yang mengevaluasi nilai mencegah tugas Sistem File menyalin file.

Jika Anda harus menggunakan skrip untuk melakukan pekerjaan yang sama untuk setiap baris data dalam satu set, Anda harus menggunakan komponen Skrip alih-alih tugas Skrip. Misalnya, jika Anda ingin menilai kewajaran jumlah ongkos kirim dan melewati baris data yang memiliki jumlah yang sangat tinggi atau rendah, Anda akan menggunakan komponen Skrip. Untuk informasi selengkapnya, lihat Komponen Skrip.

Jika lebih dari satu paket menggunakan skrip, pertimbangkan untuk menulis tugas kustom alih-alih menggunakan tugas Skrip. Untuk informasi selengkapnya, lihat Mengembangkan Tugas Kustom.

Setelah Anda memutuskan bahwa tugas Skrip adalah pilihan yang sesuai untuk paket Anda, Anda harus mengembangkan skrip yang digunakan tugas dan mengonfigurasi tugas itu sendiri.

Menulis dan Menjalankan Skrip yang Digunakan Tugas

Tugas Skrip menggunakan Microsoft® Visual Studio® Tools for Applications (VSTA) sebagai lingkungan tempat Anda menulis skrip dan mesin yang menjalankan skrip tersebut.

VSTA menyediakan semua fitur standar lingkungan Visual Studio, seperti editor Visual Studio berkode warna, IntelliSense, dan Object Explorer. VSTA juga menggunakan debugger yang sama dengan yang digunakan alat pengembangan Microsoft lainnya. Titik henti dalam skrip bekerja dengan mulus dengan titik henti pada tugas dan kontainer Integration Services. VSTA mendukung bahasa pemrograman Microsoft Visual Basic dan Microsoft Visual C#.

Untuk menjalankan skrip, Anda harus menginstal VSTA di komputer tempat paket berjalan. Saat paket berjalan, tugas memuat mesin skrip dan menjalankan skrip. Anda dapat mengakses rakitan .NET eksternal dalam skrip dengan menambahkan referensi ke rakitan dalam proyek. Saat ini kami tidak mendukung referensi rakitan standar .NET Core dan .NET.

Catatan

Tidak seperti versi sebelumnya di mana Anda dapat menunjukkan apakah skrip telah dikommpilasikan sebelumnya, semua skrip telah dikommpilasikan sebelumnya di SQL Server 2008 Integration Services (SSIS) dan versi yang lebih baru. Ketika skrip telah dikommpilasikan sebelumnya, mesin bahasa tidak dimuat pada waktu proses dan paket berjalan lebih cepat. Namun, file biner yang telah dikommpilasikan mengonsumsi ruang disk yang signifikan.

Mengonfigurasi Tugas Skrip

Anda dapat mengonfigurasi tugas Skrip dengan cara berikut:

  • Berikan skrip kustom yang dijalankan tugas.

  • Tentukan metode dalam proyek VSTA yang dipanggil runtime Layanan Integrasi sebagai titik masuk ke dalam kode tugas Skrip.

  • Tentukan bahasa skrip.

  • Secara opsional, berikan daftar variabel baca-saja dan baca/tulis untuk digunakan dalam skrip.

Anda dapat mengatur properti ini melalui SSIS Designer atau secara terprogram.

Mengonfigurasi Tugas Skrip di Perancang

Tabel berikut ini menjelaskan peristiwa ScriptTaskLogEntry yang dapat dicatat untuk tugas Skrip. Peristiwa ScriptTaskLogEntry dipilih untuk pengelogan pada tab Detail dari kotak dialog Konfigurasi Log SSIS. Untuk informasi selengkapnya, lihat Pengelogan Integration Services (SSIS).

Entri log Deskripsi
ScriptTaskLogEntry Melaporkan hasil penerapan pengelogan dalam skrip. Tugas menulis entri log untuk setiap panggilan ke metode Log objek Dts. Tugas menulis entri ini ketika kode dijalankan. Untuk informasi selengkapnya, lihat Pengelogan di Tugas Skrip.

Untuk informasi selengkapnya tentang properti yang bisa Anda atur di SSIS Designer, lihat topik berikut ini:

Untuk informasi selengkapnya tentang cara mengatur properti ini di SSIS Designer, lihat topik berikut ini:

Mengonfigurasi Tugas Skrip Secara Terprogram

Untuk informasi selengkapnya tentang mengatur properti ini secara terprogram, lihat topik berikut ini:

Editor Tugas Skrip (Halaman Umum)

Gunakan halaman Umum kotak dialog Editor Tugas Skrip untuk memberi nama dan menjelaskan tugas Skrip.

Untuk mempelajari selengkapnya tentang tugas Skrip, lihat Tugas Skrip dan Mengonfigurasi Tugas Skrip di Editor Tugas Skrip. Untuk mempelajari tentang pemrograman tugas Skrip, lihat Memperluas Paket dengan Tugas Skrip.

Opsi

Nama
Berikan nama unik untuk tugas Skrip. Nama ini digunakan sebagai label dalam ikon tugas.

Catatan

Nama tugas harus unik dalam paket.

Keterangan
Ketik deskripsi tugas Skrip.

Editor Tugas Skrip (Halaman Skrip)

Gunakan halaman Skrip dari kotak dialog Editor Tugas Skrip untuk mengatur properti skrip dan menentukan variabel yang dapat diakses oleh skrip.

Catatan

Di SQL Server 2008 Integration Services (SSIS) dan versi yang lebih baru, semua skrip telah dikommpilasikan sebelumnya. Di versi sebelumnya, Anda mengatur properti PrecompileScriptIntoBinaryCode untuk menentukan bahwa skrip telah dikombinasikan sebelumnya.

Untuk mempelajari selengkapnya tentang tugas Skrip, lihat Tugas Skrip dan Mengonfigurasi Tugas Skrip di Editor Tugas Skrip. Untuk mempelajari tentang pemrograman tugas Skrip, lihat Memperluas Paket dengan Tugas Skrip.

Opsi

ScriptLanguage
Pilih bahasa pembuatan skrip untuk tugas, baik Microsoft Visual Basic atau Microsoft Visual C#.

Setelah membuat skrip untuk tugas, Anda tidak dapat mengubah nilai properti ScriptLanguage .

Untuk mengatur bahasa pembuatan skrip default untuk tugas Skrip, gunakan opsi Bahasa pembuatan Skrip di halaman Umum kotak dialog Opsi . Untuk informasi selengkapnya, lihat Halaman Umum.

EntryPoint
Tentukan metode yang dipanggil runtime Layanan Integrasi sebagai titik masuk ke dalam kode tugas Skrip. Metode yang ditentukan harus berada di kelas ScriptMain dari proyek Microsoft® Visual Studio® Tools for Applications (VSTA) Kelas ScriptMain adalah kelas default yang dihasilkan oleh templat skrip.

Jika Anda mengubah nama metode dalam proyek VSTA, Anda harus mengubah nilai properti EntryPoint .

ReadOnlyVariables
Ketik daftar variabel baca-saja yang dipisahkan koma yang tersedia untuk skrip, atau klik tombol elipsis (...) dan pilih variabel dalam kotak dialog Pilih variabel .

Catatan

Nama variabel peka huruf besar/kecil.

ReadWriteVariables
Ketik daftar variabel baca/tulis yang dipisahkan koma yang tersedia untuk skrip, atau klik tombol elipsis (...) dan pilih variabel dalam kotak dialog Pilih variabel .

Catatan

Nama variabel peka huruf besar/kecil.

Edit Skrip
Membuka VSTA IDE tempat Anda dapat membuat atau memodifikasi skrip.

Konten Terkait