Mengelola langkah-langkah pekerjaan

2025-06-16

Berlaku untuk:SQL Server Azure SQL Managed Instance

Penting

Pada Azure SQL Managed Instance, sebagian besar, tetapi tidak semua fitur SQL Server Agent saat ini didukung. Lihat perbedaan T-SQL Azure SQL Managed Instance dibandingkan dengan SQL Server atau batasan pada pekerjaan Agen SQL di SQL Managed Instance untuk detail lebih lanjut.

Langkah pekerjaan adalah tindakan yang dilakukan pekerjaan pada database atau server. Setiap pekerjaan harus memiliki setidaknya satu tahap pekerjaan. Langkah-langkah pekerjaan dapat berupa:

Program yang dapat dieksekusi dan perintah sistem operasi.
Transact-SQL pernyataan, termasuk prosedur simpan dan prosedur simpan diperluas.
Skrip PowerShell.
Tugas replikasi.
Tugas Layanan Analisis
Paket Layanan Integrasi.

Setiap langkah pekerjaan berjalan dalam konteks keamanan tertentu. Jika langkah pekerjaan menentukan proksi, langkah pekerjaan akan berjalan dalam konteks keamanan berdasarkan kredensial dari proksi tersebut. Jika langkah pekerjaan tidak menentukan proksi, langkah pekerjaan berjalan dalam konteks akun layanan SQL Server Agent. Hanya anggota peran server tetap sysadmin yang dapat membuat tugas yang tidak menentukan proksi secara eksplisit.

Karena langkah-langkah pekerjaan berjalan dalam konteks pengguna Windows tertentu, pengguna tersebut harus memiliki izin dan konfigurasi yang diperlukan agar langkah pekerjaan dijalankan. Misalnya, jika Anda membuat pekerjaan yang memerlukan surat penanda drive atau jalur Universal Naming Convention (UNC), langkah-langkah tugas tersebut mungkin dijalankan menggunakan akun pengguna Windows Anda saat menguji tugas-tugas tersebut. Namun, pengguna Windows untuk langkah pekerjaan juga harus memiliki izin yang diperlukan, konfigurasi huruf drive, atau akses yang diperlukan ke drive tersebut. Jika tidak, langkah pekerjaan akan gagal. Untuk mencegah masalah ini, pastikan bahwa proksi pada setiap langkah tugas memiliki izin yang diperlukan untuk tugas yang dilakukan oleh langkah tersebut. Untuk informasi selengkapnya, lihat Keamanan untuk Mesin Database SQL Server dan Azure SQL Database.

Log langkah pekerjaan

SQL Server Agent dapat menulis output dari beberapa langkah pekerjaan baik ke file sistem operasi atau ke tabel sysjobstepslogs dalam msdb database. Jenis langkah pekerjaan berikut dapat menulis output ke kedua tujuan:

Program yang dapat dieksekusi dan perintah sistem operasi.
Transact-SQL pernyataan
Tugas Layanan Analisis

Hanya langkah pekerjaan yang dijalankan oleh pengguna yang merupakan anggota peran server tetap sysadmin yang dapat menulis output langkah pekerjaan ke file sistem operasi. Jika langkah-langkah pekerjaan dijalankan oleh pengguna yang merupakan anggota SQLAgentUserRole, SQLAgentReaderRole, atau peran database tetap SQLAgentOperatorRole dalam msdb database, maka output dari langkah-langkah pekerjaan ini hanya dapat ditulis ke tabel sysjobstepslogs.

Log tahap pekerjaan dihapus secara otomatis saat pekerjaan atau tahap pekerjaan dihapus.

Nota

Tugas replikasi dan pencatatan langkah pekerjaan paket Layanan Integrasi ditangani oleh subsistem masing-masing. Anda tidak dapat menggunakan SQL Server Agent untuk mengonfigurasi pencatatan langkah pekerjaan untuk jenis langkah pekerjaan ini.

Program yang dapat dieksekusi dan perintah sistem operasi sebagai langkah pekerjaan

Program yang dapat dieksekusi dan perintah sistem operasi dapat digunakan sebagai langkah-langkah pekerjaan. File-file ini mungkin memiliki ekstensi file .bat, .cmd, .com, atau .exe.

Saat Anda menggunakan program yang dapat dieksekusi atau perintah sistem operasi sebagai langkah pekerjaan, Anda harus menentukan:

Kode keluar proses dikembalikan jika perintah berhasil.
Perintah untuk dijalankan. Untuk menjalankan perintah sistem operasi, ini hanyalah perintah itu sendiri. Untuk program eksternal, ini adalah nama program dan argumen untuk program, misalnya:
```
C:\Program Files\Microsoft SQL Server\160\Tools\Binn\sqlcmd.exe -e -q "sp_who"
```
Berikan jalur lengkap ke aplikasi jika aplikasi tersebut tidak terletak di direktori yang ditentukan dalam jalur sistem, atau jalur untuk pengguna yang menjalankan langkah tugas tersebut.

langkah-langkah pekerjaan Transact-SQL

Saat membuat langkah pekerjaan Transact-SQL, Anda harus:

Identifikasi database untuk menjalankan pekerjaan.
Ketik pernyataan yang akan dijalankan: Transact-SQL. Pernyataan mungkin memanggil prosedur tersimpan atau prosedur simpan terperpanjang.

Secara opsional, Anda dapat membuka file Transact-SQL yang ada sebagai perintah untuk langkah pekerjaan.

Petunjuk / Saran

Langkah-langkah pekerjaan T-SQL dalam pekerjaan SQL Server Agent memodifikasi nilai TEXTSIZE, untuk membatasi panjang kolom tertentu dalam tataan hasil. Perilaku ini dapat menyebabkan hasil yang tidak terduga. Misalnya, SELECT kueri yang berfungsi seperti yang diharapkan di SQL Server Management Studio dapat mengembalikan nilai kolom terpotong saat dijalankan melalui SQL Server Agent. Untuk menghindari pemotongan, atur TEXTSIZE dalam kueri yang dijalankan oleh langkah kerja T-SQL.

Transact-SQL tahapan pekerjaan tidak memanfaatkan proksi SQL Server Agent. Sebaliknya, langkah pekerjaan berjalan sebagai pemilik langkah pekerjaan, atau sebagai akun layanan SQL Server Agent jika pemilik langkah pekerjaan adalah anggota peran server tetap sysadmin. Anggota peran server tetap sysadmin juga dapat menentukan bahwa langkah-langkah tugas Transact-SQL berjalan dalam konteks pengguna lain dengan menggunakan parameter database_user_name dari prosedur yang disimpan sp_add_jobstep. Untuk informasi selengkapnya, lihat sp_add_jobstep.

Nota

Satu langkah pekerjaan Transact-SQL dapat berisi beberapa batch. Transact-SQL langkah pekerjaan dapat berisi perintah GO yang disematkan.

Langkah-langkah pekerjaan pembuatan skrip PowerShell

Saat membuat langkah pekerjaan skrip PowerShell, Anda harus menentukan salah satu dari dua hal sebagai perintah untuk langkah tersebut:

Teks dari sebuah skrip PowerShell.
File skrip PowerShell yang sudah ada yang akan dibuka.

Subsistem PowerShell SQL Server Agent membuka sesi PowerShell dan memuat snap-in PowerShell SQL Server. Skrip PowerShell yang digunakan sebagai perintah langkah pekerjaan dapat mereferensikan penyedia dan cmdlet PowerShell SQL Server. Untuk informasi selengkapnya tentang menulis skrip PowerShell menggunakan snap-in PowerShell SQL Server, lihat SQL Server PowerShell.

Langkah-langkah tugas replikasi

Saat Anda membuat publikasi dan langganan menggunakan replikasi, pekerjaan replikasi dibuat secara default. Jenis pekerjaan yang dibuat ditentukan oleh jenis replikasi (rekam jepret, transaksional, atau penggabungan) dan opsi yang digunakan.

Langkah-langkah pekerjaan replikasi mengaktifkan salah satu agen replikasi ini:

Agen Rekam Jepret (Pekerjaan rekam jepret)
Agen Pembaca Log (pekerjaan LogReader)
Agen Distribusi (Pekerjaan distribusi)
Agen Penggabungan (Tugas Penggabungan)
Agen Pembaca Antrean (pekerjaan QueueReader)

Ketika replikasi disiapkan, Anda dapat menentukan untuk menjalankan agen replikasi dengan salah satu dari tiga cara: terus menerus setelah SQL Server Agent dimulai, sesuai permintaan, atau sesuai dengan jadwal. Untuk informasi selengkapnya tentang agen replikasi, lihat Gambaran Umum Agen Replikasi .

Langkah-langkah pekerjaan Analysis Services

SQL Server Agent mendukung dua jenis langkah pekerjaan Analysis Services yang berbeda, langkah-langkah pekerjaan perintah, dan langkah-langkah pekerjaan kueri.

Langkah-langkah tugas perintah Analysis Services

Saat Anda membuat langkah pekerjaan perintah pada Analysis Services, Anda harus:

Identifikasi server OLAP database untuk menjalankan langkah pekerjaan.
Ketik pernyataan yang akan dijalankan. Pernyataan harus berupa XML untuk metode Execute dalam Analysis Services. Pernyataan mungkin tidak berisi amplop SOAP lengkap atau XML untuk metode Discover di Analysis Services. Perhatikan bahwa, sementara SQL Server Management Studio mendukung amplop SOAP lengkap dan metode Discover, langkah pekerjaan SQL Server Agent tidak mendukungnya.

Langkah-langkah pekerjaan kueri di Analysis Services

Saat membuat langkah pekerjaan kueri Analysis Services, Anda harus:

Identifikasi server OLAP database untuk menjalankan langkah pekerjaan.
Ketik pernyataan yang akan dijalankan. Pernyataan harus berupa kueri ekspresi multidmensional (MDX).

Untuk informasi selengkapnya tentang MDX, lihat MDX Statement Fundamentals (MDX).

Paket Layanan Integrasi

Saat membuat langkah pekerjaan paket Integration Services, Anda harus melakukan langkah-langkah berikut:

Identifikasi sumber paket.
Identifikasi lokasi paket.
Jika file konfigurasi diperlukan untuk paket, identifikasi file konfigurasi.
Jika dibutuhkan file perintah untuk paket, identifikasikan file perintah tersebut.
Tentukan verifikasi yang akan digunakan untuk paket. Misalnya, Anda dapat menentukan bahwa paket harus ditandatangani, atau bahwa paket harus memiliki ID paket tertentu.
Identifikasi sumber data untuk paket.
Identifikasi penyedia log untuk paket tersebut.
Tentukan variabel dan nilai yang akan diatur sebelum menjalankan paket.
Identifikasi opsi eksekusi.
Menambahkan atau mengubah opsi baris perintah.

Jika Anda menyebarkan paket ke Katalog SSIS dan Anda menentukan Katalog SSIS sebagai sumber paket, sebagian besar informasi konfigurasi ini diperoleh secara otomatis dari paket. Di bawah tab Konfigurasi Anda dapat menentukan lingkungan, nilai parameter, nilai manajer koneksi, penimpaan properti, dan apakah paket berjalan di lingkungan runtime 32-bit.

Untuk informasi selengkapnya tentang membuat langkah-langkah pekerjaan yang menjalankan paket Layanan Integrasi, lihat Pekerjaan Agen SQL Server untuk Paket.

Deskripsi	Artikel
Menjelaskan cara membuat langkah pekerjaan dengan program yang dapat dieksekusi.	Membuat Tahap Tugas CmdExec
Menjelaskan cara mengatur ulang izin SQL Server Agent.	Mengonfigurasi Pengguna untuk Membuat dan Mengelola Pekerjaan Agen SQL Server
Menjelaskan cara membuat langkah tugas Transact-SQL.	Membuat Langkah Pekerjaan Transact-SQL
Menjelaskan cara menentukan opsi untuk langkah-langkah pekerjaan Microsoft SQL Server Agent Transact-SQL.	Tentukan Opsi Langkah Pekerjaan Transact-SQL
Menjelaskan cara membuat langkah pekerjaan skrip ActiveX.	Membuat langkah pekerjaan skrip ActiveX
Menjelaskan cara membuat dan menentukan langkah-langkah pekerjaan SQL Server Agent yang menjalankan perintah dan kueri SQL Server Analysis Services.	Membuat Langkah Tugas Analysis Services
Menjelaskan tindakan apa yang harus diambil SQL Server jika kegagalan terjadi selama eksekusi pekerjaan.	Mengatur keberhasilan langkah pekerjaan atau alur kegagalan
Menjelaskan cara menampilkan detail langkah pekerjaan dalam dialog Properti Langkah Pekerjaan.	Lihat Informasi Tahapan Pekerjaan
Menjelaskan cara menghapus log langkah pekerjaan SQL Server Agent.	Menghapus Log Langkah Tugas

Bagikan melalui