Opsi Pemutaran Ulang (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

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

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

Opsi pemutaran ulang memulai tahap pemutaran ulang peristiwa, di mana pengontrol mengirimkan data pemutaran ulang ke klien yang ditentukan, meluncurkan pemutaran ulang terdistribusi dan menyinkronkan klien. Secara opsional, setiap klien yang berpartisipasi dalam pemutaran ulang dapat merekam aktivitas pemutaran ulang dan menyimpan file pelacakan hasil secara lokal.

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

Sintaks


dreplay replay [-m controller] -d controller_working_dir [-o]  
    [-s target_server] -w clients [-c config_file]  
    [-f status_interval]

Parameter

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

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

-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 drive (misalnya, c:\WorkingDir).

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

  • Jalur UNC tidak didukung.

-O
Mengambil aktivitas pemutaran ulang klien dan menyimpannya ke file pelacakan hasil di jalur yang ditentukan oleh <ResultDirectory> elemen dalam file konfigurasi klien, DReplayClient.xml.

Ketika parameter -o tidak ditentukan, file pelacakan hasil tidak dihasilkan. Output konsol mengembalikan informasi ringkasan di akhir pemutaran ulang, tetapi tidak ada statistik pemutaran ulang lainnya yang tersedia.

-starget_server
Menentukan instans target SQL Server yang harus diputar ulang oleh beban kerja terdistribusi. Anda harus menentukan parameter ini dalam format server_name[\nama instans].

Anda tidak dapat menggunakan "localhost" atau "." sebagai server target.

Parameter -s tidak diperlukan jika <Server> elemen ditentukan di bagian <ReplayOptions> file konfigurasi pemutaran ulang, DReplay.exe.replay.config.

Jika parameter -s digunakan, <Server> elemen di bagian <ReplayOptions> file konfigurasi pemutaran ulang akan diabaikan.

-wklien
Parameter yang diperlukan ini adalah daftar yang dipisahkan koma (tanpa spasi) yang menentukan nama komputer klien yang harus berpartisipasi dalam pemutaran ulang terdistribusi. Alamat IP tidak diizinkan. Ketahuilah bahwa klien harus sudah terdaftar di pengontrol.

Catatan

Setiap klien mendaftar dengan pengontrol yang ditentukan dalam file konfigurasi klien saat layanan klien dimulai.

-cconfig_file
Adalah jalur lengkap file konfigurasi pemutaran ulang; digunakan untuk menentukan lokasi saat disimpan di lokasi yang berbeda.

Parameter -c tidak diperlukan jika Anda ingin menggunakan nilai default file konfigurasi pemutaran ulang, DReplay.exe.replay.config.

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

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

Contoh

Dalam contoh ini, pemutaran ulang terdistribusi memperoleh banyak perilakunya dari file konfigurasi pemutaran ulang yang dimodifikasi, DReplay.exe.replay.config.

  • Parameter -m menentukan bahwa komputer bernama controller1 bertindak sebagai pengontrol. Nama komputer harus ditentukan ketika layanan pengontrol berjalan pada komputer lain.

  • Parameter -d menentukan lokasi file perantara pada pengontrol, c:\WorkingDir.

  • Parameter -o menentukan bahwa setiap klien yang ditentukan mengambil aktivitas pemutaran ulang dan menyimpannya ke file pelacakan hasil. Catatan: <ResultTrace> Elemen dalam file konfigurasi dapat digunakan untuk menentukan apakah jumlah baris dan tataan hasil direkam.

  • Parameter -w menentukan bahwa komputer client1 melalui client4 berpartisipasi sebagai klien dalam pemutaran ulang terdistribusi.

  • Parameter -c digunakan untuk menunjuk ke file konfigurasi yang dimodifikasi, DReplay.exe.replay.config.

  • Parameter -s tidak diperlukan karena <Server> elemen ditentukan dalam <ReplayOptions> elemen file konfigurasi pemutaran ulang, DReplay.exe.replay.config.

Tahap pemutaran ulang peristiwa dimulai dengan sintaks berikut, ketika alat administrasi dijalankan dari komputer yang berbeda dari pengontrol:

dreplay replay -m controller1 -d c:\WorkingDir -o -w client1,client2,client3,client4 -c c:\DReplay.exe.replay.config

Untuk menentukan mode pengurutan sinkron, <SequencingMode> elemen DReplay.exe.replay.config file diatur sama dengan nilai synchronization. Bagian <ResultTrace> file konfigurasi pemutaran ulang dimodifikasi untuk menentukan bahwa jumlah baris direkam. Perubahan ini diperlihatkan dalam contoh XML berikut:

<?xml version='1.0'?> 
<Options> 
    <ReplayOptions> 
        <Server>server_name\replay_target_instance</Server> 
        <SequencingMode>synchronization</SequencingMode> 
        <ConnectTimeScale></ConnectTimeScale> 
        <ThinkTimeScale></ThinkTimeScale> 
        <HealthmonInterval>60</HealthmonInterval> 
        <QueryTimeout>3600</QueryTimeout> 
        <ThreadsPerClient></ThreadsPerClient> 
    </ReplayOptions> 
    <OutputOptions> 
        <ResultTrace> 
            <RecordRowCount>Yes</RecordRowCount> 
            <RecordResultSet>No</RecordResultSet> 
        </ResultTrace> 
    </OutputOptions> 
</Options>

Untuk menentukan mode pengurutan stres, <SequencingMode> elemen DReplay.exe.replay.config file diatur sama dengan nilai stress. Elemen <ConnectTimeScale> dan <ThinkTimeScale> diatur ke nilai 50 (untuk menentukan 50 persen). Untuk informasi selengkapnya tentang waktu sambungkan dan waktu pikirkan, lihat Mengonfigurasi Pemutaran Ulang Terdistribusi. Perubahan ini diperlihatkan dalam contoh XML berikut:

<?xml version='1.0'?> 
<Options> 
    <ReplayOptions> 
        <Server>server_name\replay_target_instance_name</Server> 
        <SequencingMode>stress</SequencingMode> 
        <ConnectTimeScale>50</ConnectTimeScale> 
        <ThinkTimeScale>50</ThinkTimeScale> 
        <HealthmonInterval>60</HealthmonInterval> 
        <QueryTimeout>3600</QueryTimeout> 
        <ThreadsPerClient></ThreadsPerClient> 
    </ReplayOptions> 
    <OutputOptions> 
        <ResultTrace> 
            <RecordRowCount>Yes</RecordRowCount> 
            <RecordResultSet>No</RecordResultSet> 
        </ResultTrace> 
    </OutputOptions> 
</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.

Baca juga