Bagikan melalui

Agen Sinkronisasi Data untuk Sinkronisasi Data SQL

  • Artikel

Berlaku untuk:Azure SQL Database

Sinkronkan data dengan database SQL Server dengan memasang dan mengonfigurasi Agen Sinkronisasi Data untuk Sinkronisasi Data SQL di Azure. Untuk informasi selengkapnya tentang Sinkronisasi Data SQL, lihat Sinkronkan data di beberapa database cloud dan lokal dengan Sinkronisasi Data SQL.

Penting

Sinkronisasi Data SQL tidak mendukung Azure SQL Managed Instance atau Azure Synapse Analytics saat ini.

Mengunduh dan menginstal

Untuk mengunduh Agen Sinkronisasi Data, buka Agen Sinkronisasi Data SQL. Untuk meningkatkan Agen Sinkronisasi Data, pasang Agen di lokasi yang sama dengan Agen lama dan Agen tersebut akan menimpa yang asli.

Pasang secara diam-diam

Untuk memasang Agen Sinkronisasi Data secara diam-diam dari perintah, masukkan perintah yang mirip dengan contoh berikut. Periksa nama file .msi yang diunduh, dan sediakan nilai Anda sendiri untuk argumen TARGETDIR dan SERVICEACCOUNT .

  • Jika Anda tidak menyediakan nilai untuk TARGETDIR, nilai defaultnya adalah C:\Program Files (x86)\Microsoft SQL Data Sync 2.0.

  • Jika Anda menyediakan LocalSystem sebagai nilai SERVICEACCOUNT, gunakan autentikasi SQL Server saat Anda mengonfigurasi agen untuk menyambungkan ke SQL Server.

  • Jika Anda menyediakan akun pengguna domain atau akun pengguna lokal sebagai nilai SERVICEACCOUNT, Anda juga harus menyediakan kata sandi dengan argumen SERVICEPASSWORD. Contohnya:SERVICEACCOUNT="<domain>\<user>" SERVICEPASSWORD="<password>"

msiexec /i "SQLDataSyncAgent-2.0-x86-ENU.msi" TARGETDIR="C:\Program Files (x86)\Microsoft SQL Data Sync 2.0" SERVICEACCOUNT="LocalSystem" /qn

Menyinkronkan data dengan database SQL Server

Untuk mengonfigurasi Agen Sinkronisasi Data sehingga Anda bisa menyinkronkan data dengan satu atau beberapa database SQL Server, lihat Tambahkan database SQL Server.

Tanya Jawab Umum Agen Sinkronisasi Data

Mengapa saya memerlukan agen klien

Layanan Sinkronisasi Data SQL berkomunikasi dengan database SQL Server melalui agen klien. Fitur keamanan ini mencegah komunikasi langsung dengan database di balik firewall. Ketika layanan Sinkronisasi Data SQL berkomunikasi dengan agen, layanan tersebut melakukannya menggunakan koneksi terenkripsi dan token unik atau kunci agen. Database SQL Server mengautentikasi agen menggunakan string koneksi dan kunci agen. Desain ini memberikan tingkat keamanan yang tinggi untuk data Anda.

Berapa banyak contoh antarmuka pengguna agen lokal yang dapat dijalankan

Hanya satu contoh antarmuka pengguna yang dapat dijalankan.

Bagaimana cara mengubah akun layanan saya

Setelah Anda memasang agen klien, satu-satunya cara untuk mengubah akun layanan adalah dengan menghapus pemasangannya dan memasang agen klien baru dengan akun layanan baru.

Bagaimana cara mengubah kunci agen saya

Kunci agen hanya dapat digunakan sekali oleh agen. Kunci tersebut tidak dapat digunakan kembali ketika Anda menghapus kemudian memasang ulang agen baru, kunci tersebut juga tidak dapat digunakan oleh beberapa agen. Jika Anda perlu membuat kunci baru untuk agen yang sudah ada, Anda harus yakin bahwa kunci yang sama direkam dengan agen klien dan dengan layanan Sinkronisasi Data SQL.

Bagaimana cara menghentikan agen klien

Untuk segera membatalkan atau menghentikan agen, regenerasi kuncinya di portal tetapi jangan mengirimkannya di antarmuka pengguna Agen. Meregenerasi kunci membatalkan kunci sebelumnya terlepas dari apakah agen yang sesuai sedang online atau offline.

Bagaimana cara memindahkan agen klien ke komputer lain

Jika Anda ingin menjalankan agen lokal dari komputer yang berbeda dari saat ini, lakukan hal-hal berikut:

  1. Pasang agen pada komputer yang diinginkan.
  2. Masuk ke portal SQL Data Sync dan regenerasi kunci agen untuk agen baru.
  3. Gunakan antarmuka pengguna agen baru untuk mengirimkan kunci agen baru.
  4. Tunggu sementara agen klien mengunduh daftar database lokal yang didaftarkan sebelumnya.
  5. Sediakan informasi masuk database untuk semua database yang ditampilkan sebagai tidak dapat dijangkau. Database ini harus dapat dijangkau dari komputer baru tempat agen dipasang.

Bagaimana cara menghapus database metadata Sinkronisasi jika agen Sinkronisasi masih terkait dengannya

Untuk menghapus database metadata Sinkronisasi yang memiliki agen Sinkronisasi yang terkait dengannya, Anda harus terlebih dahulu menghapus agen Sinkronisasi. Untuk menghapus agen, lakukan hal-hal berikut:

  1. Pilih database Sinkronisasi.
  2. Masuk ke halaman Sinkronkan ke database lain.
  3. Pilih agen Sinkronisasi dan pilih Hapus.

Memecahkan masalah Agen Sinkronisasi Data

Pemasangan, penghapusan pemasangan, atau perbaikan agen klien mengalami kegagalan

  • Penyebab. Banyak skenario yang dapat menyebabkan kegagalan ini. Untuk menentukan penyebab spesifik kegagalan ini, lihat log.

  • Resolusi. Untuk menemukan penyebab spesifik kegagalan tersebut, hasilkan dan lihat log Pemasang Windows. Anda dapat mengaktifkan pengelogan di perintah. Misalnya, jika file pemasangan yang diunduh adalah SQLDataSyncAgent-2.0-x86-ENU.msi, hasilkan dan periksa file log dengan menggunakan baris perintah berikut:

    • Untuk pemasangan: msiexec.exe /i SQLDataSyncAgent-2.0-x86-ENU.msi /l*v LocalAgentSetup.Log

    • Untuk penghapusan pemasangan: msiexec.exe /x SQLDataSyncAgent-2.0-x86-ENU.msi /l*v LocalAgentSetup.Log

      Anda juga dapat mengaktifkan pengelogan untuk semua pemasangan yang dilakukan oleh Pemasang Windows. Artikel Pangkalan Pengetahuan Microsoft Cara mengaktifkan pengelogan Pemasang Windows menyediakan solusi satu klik untuk mengaktifkan pengelogan untuk Pemasang Windows. Artikel ini juga menyediakan lokasi log.

Agen klien tidak berfungsi setelah saya membatalkan penghapusan pemasangan

Agen klien tidak berfungsi, bahkan setelah Anda membatalkan penghapusan pemasangan.

  • Penyebab. Ini terjadi karena agen klien Sinkronisasi Data SQL tidak menyimpan informasi masuk.

  • Resolusi. Anda dapat mencoba dua solusi ini:

    • Gunakan services.msc untuk memasukkan kembali informasi masuk untuk agen klien.
    • Hapus pemasangan agen klien ini lalu pasang yang baru. Unduh dan pasang agen klien terbaru dari Pusat Unduhan.

Database saya tidak tercantum dalam daftar agen

Ketika Anda mencoba menambahkan database SQL Server yang sudah ada ke grup sinkronisasi, database tidak muncul dalam daftar agen.

Skenario ini dapat menyebabkan masalah berikut:

  • Penyebab. Agen klien dan grup sinkronisasi berada di pusat data yang berbeda.

  • Resolusi. Agen klien dan grup sinkronisasi harus berada di pusat data yang sama. Untuk menyetel ini, Anda memiliki dua opsi:

    • Buat agen baru di pusat data tempat grup sinkronisasi berada. Kemudian, daftarkan database dengan agen tersebut.
    • Hapus grup sinkronisasi saat ini. Kemudian, buat ulang grup sinkronisasi di pusat data tempat agen berada.

  • Penyebab. Daftar database agen klien tidak terkini.

  • Resolusi. Hentikan lalu hidupkan ulang layanan agen klien.

    Agen lokal mengunduh daftar database terkait hanya pada pengiriman pertama kunci agen. Agen lokal tidak mengunduh daftar database terkait pada pengiriman kunci agen berikutnya. Database yang didaftarkan selama pemindahan agen tidak muncul di instans agen asli.

Agen klien tidak dimulai (Kesalahan 1069)

Anda menemukan bahwa agen tidak berjalan di komputer yang meng-hosting SQL Server. Ketika Anda mencoba untuk memulai agen secara manual, Anda melihat kotak dialog yang menampilkan pesan, "Kesalahan 1069: Layanan tidak dimulai karena kegagalan masuk."

Data Sync error 1069 dialog box

  • Penyebab. Kemungkinan penyebab kesalahan ini adalah bahwa kata sandi pada server lokal telah berubah sejak Anda membuat agen dan kata sandi agen.

  • Resolusi. Perbarui kata sandi agen ke kata sandi server Anda saat ini:

    1. Temukan layanan agen klien Sinkronisasi Data SQL.
      a. Pilih Mulai.
      b. Dalam kotak pencarian, masukkan services.msc.
      c. Dalam hasil pencarian, pilih Layanan.
      d. Di jendela Layanan, gulir ke entri untuk Agen Sinkronisasi Data SQL.
    2. Klik kanan Agen Sinkronisasi Data SQL, dan pilih Hentikan.
    3. Klik kanan Agen Sinkronisasi Data SQL, dan pilih Properti.
    4. Pada Properti Agen Sinkronisasi Data SQL, pilih tab Masuk.
    5. Di kotak Kata Sandi, masukkan kata sandi Anda.
    6. Di kotak Konfirmasi Kata Sandi, masukkan kembali kata sandi Anda.
    7. Pilih Terapkan, lalu pilih OK.
    8. Di jendela Layanan , klik kanan layanan SQL Data Sync Agent , lalu pilih Mulai.
    9. Tutup jendela Layanan.

Saya tidak dapat mengirimkan kunci agen

Setelah Anda membuat atau membuat ulang kunci untuk agen, Anda mencoba mengirimkan kunci melalui aplikasi SqlAzureDataSyncAgent. Pengiriman gagal diselesaikan.

Sync Error dialog box - Can't submit agent key

  • Prasyarat. Sebelum melanjutkan, periksa prasyarat berikut:

    • Layanan Windows Sinkronisasi Data SQL sedang berjalan.

    • Akun layanan untuk layanan Windows Sinkronisasi Data SQL memiliki akses jaringan.

    • Port 1433 keluar terbuka dalam aturan firewall lokal Anda.

    • Ip lokal ditambahkan ke aturan firewall server atau database untuk database metadata sinkronisasi.

  • Penyebab. Kunci agen secara unik mengidentifikasi setiap agen lokal. Kunci harus memenuhi dua syarat:

    • Kunci agen klien pada server Sinkronisasi Data SQL dan komputer lokal harus identik.
    • Kunci agen klien hanya dapat digunakan sekali.

  • Resolusi. Jika agen Anda tidak bekerja, itu karena salah satu atau kedua syarat ini tidak terpenuhi. Untuk membuat agen Anda bekerja lagi:

    1. Buat kunci baru.
    2. Terapkan kunci baru ke agen.

    Untuk menerapkan kunci baru ke agen:

    1. Di File Explorer, buka direktori pemasangan agen Anda. Direktori penginstalan default adalah C:\Program Files (x86)\Sinkronisasi Data SQL Microsoft.
    2. Klik ganda subdirektori bin.
    3. Buka aplikasi SqlAzureDataSyncAgent.
    4. Pilih Kirim Kunci Agen.
    5. Di ruang yang disediakan, tempelkan kunci dari clipboard Anda.
    6. PilihOK.
    7. Tutup programnya.

Agen klien tidak dapat dihapus dari portal jika database lokal terkait tidak dapat dijangkau

Jika titik akhir lokal (yaitu, database) yang terdaftar dengan agen klien Sinkronisasi Data SQL menjadi tidak dapat dijangkau, agen klien tidak dapat dihapus.

  • Penyebab. Agen lokal tidak dapat dihapus karena database yang tidak dapat dijangkau masih terdaftar di agen. Ketika Anda mencoba untuk menghapus agen, proses penghapusan mencoba untuk menjangkau database, yang kemudian mengalami kegagalan.

  • Resolusi. Gunakan "hapus paksa" untuk menghapus database yang tidak dapat dijangkau.

Catatan

Jika tabel metadata sinkronisasi tetap dalam keadaan sebelumnya setelah "hapus paksa", gunakan deprovisioningutil.exe untuk membersihkannya.

Aplikasi Agen Sinkronisasi Klien tidak dapat tersambung ke layanan sinkronisasi lokal

  • Resolusi. Cobalah langkah-langkah berikut:

    1. Keluar dari aplikasi.
    2. Buka Panel Layanan Komponen.
      a. Dalam kotak pencarian di taskbar, masukkan services.msc.
      b. Di hasil pencarian, klik ganda Layanan.
    3. Hentikan layanan Sinkronisasi Data SQL.
    4. Hidupkan ulang layanan Sinkronisasi Data SQL.
    5. Membuka kembali aplikasi.

Jalankan Agen Sinkronisasi Data dari perintah

Anda bisa menjalankan perintah Agen Sinkronisasi Data berikut ini dari perintah:

Ping layanan

Penggunaan

SqlDataSyncAgentCommand.exe -action pingsyncservice

Contoh

SqlDataSyncAgentCommand.exe -action "pingsyncservice"

Menampilkan database terdaftar

Penggunaan

SqlDataSyncAgentCommand.exe -action displayregistereddatabases

Contoh

SqlDataSyncAgentCommand.exe -action "displayregistereddatabases"

Mengirimkan kunci agen

Penggunaan

Usage: SqlDataSyncAgentCommand.exe -action submitagentkey -agentkey [agent key]  -username [user name] -password [password]

Contoh

SqlDataSyncAgentCommand.exe -action submitagentkey -agentkey [agent key generated from portal, PowerShell, or API] -username [user name to sync metadata database] -password [user name to sync metadata database]

Mendaftarkan database

Penggunaan

SqlDataSyncAgentCommand.exe -action registerdatabase -servername [on-premisesdatabase server name] -databasename [on-premisesdatabase name]  -username [domain\\username] -password [password] -authentication [sql or windows] -encryption [true or false]

Contoh

SqlDataSyncAgentCommand.exe -action "registerdatabase" -serverName localhost -databaseName testdb -authentication sql -username <user name> -password <password> -encryption true

SqlDataSyncAgentCommand.exe -action "registerdatabase" -serverName localhost -databaseName testdb -authentication windows -encryption true

Membatalkan pendaftaran database

Ketika Anda menggunakan perintah ini untuk membatalkan pendaftaran database, perintah tersebut mencabut akses database sepenuhnya. Jika database berpartisipasi dalam grup sinkronisasi lainnya, operasi ini akan memutuskan grup sinkronisasi lainnya.

Penggunaan

SqlDataSyncAgentCommand.exe -action unregisterdatabase -servername [on-premisesdatabase server name] -databasename [on-premisesdatabase name]

Contoh

SqlDataSyncAgentCommand.exe -action "unregisterdatabase" -serverName localhost -databaseName testdb

Memperbarui informasi masuk

Penggunaan

SqlDataSyncAgentCommand.exe -action updatecredential -servername [on-premisesdatabase server name] -databasename [on-premisesdatabase name]  -username [domain\\username] -password [password] -authentication [sql or windows] -encryption [true or false]

Contoh

SqlDataSyncAgentCommand.exe -action "updatecredential" -serverName localhost -databaseName testdb -authentication sql -username <user name> -password <password> -encryption true

SqlDataSyncAgentCommand.exe -action "updatecredential" -serverName localhost -databaseName testdb -authentication windows -encryption true

Langkah berikutnya

Untuk informasi selengkapnya tentang Sinkronisasi Data SQL, lihat artikel berikut ini: