Opsi Praprosces (Alat Administrasi Pemutaran Ulang Terdistribusi)

  • Artikel

Berlaku untuk: SQL Server 2016 (13.x), SQL Server 2017 (14.x), dan SQL Server 2019 (15.x)

Penting

SQL Server Pemutaran Ulang Terdistribusi tidak tersedia dengan SQL Server 2022 (16.x).

Alat administrasi Microsoft SQL Server Distributed Replay, DReplay.exe, adalah alat baris perintah yang dapat Anda gunakan untuk berkomunikasi dengan pengontrol pemutaran ulang terdistribusi. Topik ini menjelaskan opsi baris perintah praproses dan sintaks yang sesuai.

Opsi praprosces memulai tahap praprosces. Selama tahap ini, pengontrol menyiapkan data pelacakan input untuk diputar ulang terhadap server target.

Untuk informasi selengkapnya tentang konvensi sintaksis yang digunakan dengan sintaks alat administrasi, lihat Konvensi sintaks Transact-SQL.

Sintaks


dreplay preprocess [-m controller] -i input_trace_file  
    -d controller_working_dir [-c config_file] [-f status_interval]

Parameter

-mpengontrol
Menentukan nama komputer pengontrol. Anda dapat menggunakan "localhost" atau "." untuk merujuk ke komputer lokal.

Jika parameter -m tidak ditentukan, komputer lokal akan digunakan.

-iinput_trace_file
Menentukan jalur lengkap file jejak input pada pengontrol, seperti D:\Mytrace.trc. Parameter -i diperlukan.

Jika ada file rollover di direktori yang sama, file tersebut akan dimuat dan digunakan secara otomatis. File harus mengikuti konvensi penamaan rollover file, misalnya: Mytrace.trc, , Mytrace_1.trc, Mytrace_2.trcMytrace_3.trc, ... Mytrace_n.trc.

Catatan

Jika Anda menggunakan alat administrasi pada komputer yang berbeda dari pengontrol, Anda harus menyalin file jejak input ke pengontrol sehingga jalur lokal dapat digunakan untuk parameter ini.

-dcontroller_working_dir
Menentukan direktori pada pengontrol tempat file perantara akan disimpan. Parameter -d diperlukan.

Persyaratan berikut berlaku:

  • Direktori harus berada di pengontrol.

  • Anda harus menentukan jalur lengkap, dimulai dengan huruf kandar (misalnya, c:\WorkingDir).

  • Jalur tidak boleh diakhir dengan garis miring terbelakang "\".

  • Jalur UNC tidak didukung.

-cconfig_file
Adalah jalur lengkap dari file konfigurasi praprosces; digunakan untuk menentukan lokasi file konfigurasi praprosces saat disimpan di lokasi yang berbeda. Parameter ini bisa menjadi jalur UNC, atau dapat berada secara lokal di komputer tempat Anda menjalankan alat administrasi.

Parameter -c tidak diperlukan jika tidak ada pemfilteran yang diperlukan, atau jika Anda tidak ingin mengubah waktu menganggur maksimum.

Tanpa parameter -c , file konfigurasi praprosces default, DReplay.exe.preprocess.config, digunakan.

-fstatus_interval
Menentukan frekuensi (dalam detik) untuk menampilkan pesan status.

Jika -f tidak ditentukan, interval default adalah 30 detik.

Contoh

Dalam contoh ini, tahap praprosces dimulai dengan semua pengaturan default. Nilai localhost menunjukkan bahwa layanan pengontrol berjalan pada komputer yang sama dengan alat administrasi. Parameter input_trace_file menentukan lokasi data jejak input, c:\mytrace.trc. Karena tidak ada pemfilteran file pelacakan yang terlibat, parameter -c memang harus ditentukan.

dreplay preprocess -m localhost -i c:\mytrace.trc -d c:\WorkingDir

Dalam contoh ini, tahap praprosces dimulai dan file konfigurasi praprosces yang dimodifikasi ditentukan. Tidak seperti contoh sebelumnya, parameter -c digunakan untuk menunjuk ke file konfigurasi yang dimodifikasi, jika Anda telah menyimpannya di lokasi yang berbeda. Contohnya:

dreplay preprocess -m localhost -i c:\mytrace.trc -d c:\WorkingDir -c c:\DReplay.exe.preprocess.config

Dalam file konfigurasi praprosces yang dimodifikasi, kondisi filter ditambahkan yang memfilter sesi sistem selama pemutaran ulang terdistribusi. Filter ditambahkan dengan memodifikasi <PreprocessModifiers> elemen dalam file konfigurasi praprosces, DReplay.exe.preprocess.config.

Berikut ini menunjukkan contoh file konfigurasi yang dimodifikasi:

<?xml version='1.0'?> 
<Options> 
    <PreprocessModifiers> 
        <IncSystemSession>No</IncSystemSession> 
        <MaxIdleTime>-1</MaxIdleTime> 
    </PreprocessModifiers> 
</Options>

Izin

Anda harus menjalankan alat administrasi sebagai pengguna interaktif, baik sebagai pengguna lokal atau akun pengguna domain. Untuk menggunakan akun pengguna lokal, alat administrasi dan pengontrol harus berjalan pada komputer yang sama.

Untuk informasi selengkapnya, lihat Keamanan Pemutaran Ulang Terdistribusi.

Lihat juga