SQL Data Sync için Data Sync Aracısı

  • Makale

Şunlar için geçerlidir:Azure SQL Veritabanı

Azure'da SQL Data Sync için Data Sync Aracısı'nı yükleyip yapılandırarak verileri SQL Server veritabanlarıyla eşitleyin. SQL Data Sync hakkında daha fazla bilgi için bkz . SQL Data Sync ile verileri birden çok bulut ve şirket içi veritabanı arasında eşitleme.

Önemli

SQL Data Sync şu anda Azure SQL Yönetilen Örneği veya Azure Synapse Analytics'i desteklememektedir.

İndirme ve yükleme

Data Sync Aracısı'nı indirmek için SQL Data Sync Aracısı'na gidin. Data Sync Aracısını yükseltmek için Aracı'yı eski Aracı ile aynı konuma yüklediğinizde özgün aracı geçersiz kılınacaktır.

Sessizce yükleme

Data Sync Aracısını komut isteminden sessizce yüklemek için aşağıdaki örneğe benzer bir komut girin. İndirilen .msi dosyasının dosya adını denetleyin ve TARGETDIR ve SERVICEACCOUNT bağımsız değişkenleri için kendi değerlerinizi sağlayın.

  • TARGETDIR için bir değer sağlamazsanız, varsayılan değer olurC:\Program Files (x86)\Microsoft SQL Data Sync 2.0.

  • SERVICEACCOUNT değerini sağlarsanızLocalSystem, aracıyı SQL Server'a bağlanacak şekilde yapılandırırken SQL Server kimlik doğrulamasını kullanın.

  • SERVICEACCOUNT değeri olarak bir etki alanı kullanıcı hesabı veya yerel kullanıcı hesabı sağlarsanız, parolayı SERVICEPASSWORD bağımsız değişkeniyle de sağlamanız gerekir. Örneğin, 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

SQL Server veritabanıyla veri eşitleme

Verileri bir veya daha fazla SQL Server veritabanıyla eşitleyebilmeniz için Data Sync Aracısı'nı yapılandırmak için bkz . SQL Server veritabanı ekleme.

Data Sync Aracısı hakkında SSS

Neden bir istemci aracıya ihtiyacım var?

SQL Data Sync hizmeti, istemci aracısı aracılığıyla SQL Server veritabanlarıyla iletişim kurar. Bu güvenlik özelliği, bir güvenlik duvarının arkasındaki veritabanlarıyla doğrudan iletişimi engeller. SQL Data Sync hizmeti aracıyla iletişim kurarken, şifreli bağlantılar ve benzersiz bir belirteç veya aracı anahtarı kullanarak bunu yapar. SQL Server veritabanları, bağlantı dizesini ve aracı anahtarını kullanarak aracının kimliğini doğrular. Bu tasarım, verileriniz için yüksek düzeyde güvenlik sağlar.

Yerel aracı kullanıcı arabiriminin kaç örneği çalıştırılabilir?

Kullanıcı arabiriminin yalnızca bir örneği çalıştırılabilir.

Hizmet hesabımı nasıl değiştirebilirim?

Bir istemci aracısını yükledikten sonra, hizmet hesabını değiştirmenin tek yolu hesabı kaldırmak ve yeni hizmet hesabıyla yeni bir istemci aracısı yüklemektir.

Aracı anahtarımı nasıl değiştirebilirim?

Aracı anahtarı bir aracı tarafından yalnızca bir kez kullanılabilir. Yeni bir aracıyı kaldırıp yeniden yüklerken yeniden kullanılamaz veya birden çok aracı tarafından kullanılamaz. Mevcut bir aracı için yeni bir anahtar oluşturmanız gerekiyorsa, aynı anahtarın istemci aracısı ve SQL Data Sync hizmetiyle kaydedilip kaydedilmediğini bilmeniz gerekir.

Bir istemci aracıyı nasıl devre dışı bırakabilirim?

Bir aracıyı hemen geçersiz kmak veya devre dışı bırakması için portalda anahtarını yeniden oluşturun, ancak aracı kullanıcı arabiriminde göndermeyin. Bir anahtarın yeniden yenilenmesi, ilgili aracı çevrimiçi veya çevrimdışı olmasına bakılmadan önceki anahtarı geçersiz kılır.

İstemci aracısını başka bir bilgisayara nasıl taşıyabilirim?

Yerel aracıyı şu anda açık olduğundan farklı bir bilgisayardan çalıştırmak istiyorsanız, aşağıdakileri yapın:

  1. Aracıyı istediğiniz bilgisayara yükleyin.
  2. SQL Data Sync portalında oturum açın ve yeni aracı için bir aracı anahtarı yeniden oluşturun.
  3. Yeni aracı anahtarını göndermek için yeni aracının kullanıcı arabirimini kullanın.
  4. İstemci aracısı daha önce kaydedilmiş şirket içi veritabanlarının listesini indirirken bekleyin.
  5. Ulaşılamaz olarak görüntülenen tüm veritabanları için veritabanı kimlik bilgilerini sağlayın. Bu veritabanlarına aracının yüklü olduğu yeni bilgisayardan erişilebilir olmalıdır.

Eşitleme aracısı hala ilişkiliyse Eşitleme meta veri veritabanını nasıl silebilirim?

Kendisiyle ilişkilendirilmiş bir Eşitleme aracısı olan eşitleme meta verileri veritabanını silmek için önce Eşitleme aracısını silmeniz gerekir. Aracıyı silmek için aşağıdakileri yapın:

  1. Eşitleme veritabanını seçin.
  2. Diğer veritabanlarıyla eşitle sayfasına gidin.
  3. Eşitleme aracısını seçin ve Sil'i seçin.

Veri Eşitleme Aracısı sorunlarını giderme

İstemci aracısını yükleme, kaldırma veya onarma başarısız oluyor

  • Neden, neden? Birçok senaryo bu hataya neden olabilir. Bu hatanın belirli nedenini belirlemek için günlüklere bakın.

  • Çözüm. Hatanın belirli nedenini bulmak için Windows Installer günlüklerini oluşturun ve bakın. Bir komut isteminde günlüğe kaydetmeyi açabilirsiniz. Örneğin, indirilen yükleme dosyası ise SQLDataSyncAgent-2.0-x86-ENU.msi, aşağıdaki komut satırlarını kullanarak günlük dosyalarını oluşturun ve inceleyin:

    • Yüklemeler için: msiexec.exe /i SQLDataSyncAgent-2.0-x86-ENU.msi /l*v LocalAgentSetup.Log

    • Kaldırmalar için: msiexec.exe /x SQLDataSyncAgent-2.0-x86-ENU.msi /l*v LocalAgentSetup.Log

      Ayrıca, Windows Installer tarafından gerçekleştirilen tüm yüklemeler için günlüğe kaydetmeyi de açabilirsiniz. Microsoft Bilgi Bankası makalesi Windows Installer günlüğünü etkinleştirme, Windows Installer için günlüğe kaydetmeyi açmak için tek tıklamayla bir çözüm sağlar. Ayrıca günlüklerin konumunu da sağlar.

Kaldırma işlemini iptal ettikten sonra istemci aracısı çalışmıyor

kaldırma işlemini iptal ettikten sonra bile istemci aracısı çalışmaz.

  • Neden, neden? Bunun nedeni SQL Data Sync istemci aracısının kimlik bilgilerini depolamamasıdır.

  • Çözüm. Şu iki çözümü deneyebilirsiniz:

    • İstemci aracısı için kimlik bilgilerini yeniden giriş yapmak için services.msc kullanın.
    • Bu istemci aracıyı kaldırın ve yenisini yükleyin. İndirme Merkezi'nden en son istemci aracısını indirin ve yükleyin.

Veritabanım aracı listesinde yok

Eşitleme grubuna mevcut bir SQL Server veritabanını eklemeyi denediğinizde, veritabanı aracılar listesinde görünmez.

Bu senaryolar bu soruna neden olabilir:

  • Neden, neden? İstemci aracısı ve eşitleme grubu farklı veri merkezlerindedir.

  • Çözüm. İstemci aracısı ve eşitleme grubu aynı veri merkezinde olmalıdır. Bunu ayarlamak için iki seçeneğiniz vardır:

    • Eşitleme grubunun bulunduğu veri merkezinde yeni bir aracı oluşturun. Ardından veritabanını bu aracıya kaydedin.
    • Geçerli eşitleme grubunu silin. Ardından, aracının bulunduğu veri merkezinde eşitleme grubunu yeniden oluşturun.

  • Neden, neden? İstemci aracısının veritabanı listesi geçerli değil.

  • Çözüm. İstemci aracısı hizmetini durdurun ve yeniden başlatın.

    Yerel aracı, ilişkili veritabanlarının listesini yalnızca aracı anahtarının ilk gönderiminde indirir. Sonraki aracı anahtarı gönderimlerinde ilişkili veritabanlarının listesini indirmez. Aracı taşıma sırasında kaydedilen veritabanları özgün aracı örneğinde gösterilmez.

İstemci aracısı başlatılamıyor (Hata 1069)

Aracının SQL Server barındıran bir bilgisayarda çalışmadığını keşfedersiniz. Aracıyı el ile başlatmayı denediğinizde, "Hata 1069: Hizmet bir oturum açma hatası nedeniyle başlatılmadı" iletisini görüntüleyen bir iletişim kutusu görürsünüz.

Data Sync error 1069 dialog box

  • Neden, neden? Bu hatanın olası bir nedeni, aracı ve aracı parolasını oluşturduğunuzdan beri yerel sunucudaki parolanın değişmesidir.

  • Çözüm. Aracının parolasını geçerli sunucu parolanızla güncelleştirin:

    1. SQL Data Sync istemci aracısı hizmetini bulun.
      a. Başlat'ı seçin.
      b. Arama kutusuna services.msc yazın.
      c. Arama sonuçlarında Hizmetler’i seçin.
      d. Hizmetler penceresinde, SQL Data Sync Aracısı girdisine gidin.
    2. SQL Data Sync Aracısı'ne sağ tıklayın ve ardından Durdur'u seçin.
    3. SQL Data Sync Aracısı'ne sağ tıklayın ve özellikler'i seçin.
    4. SQL Data Sync Aracısı Özellikleri'nde Oturum aç sekmesini seçin.
    5. Parola kutusuna parolanızı girin.
    6. Parolayı Onayla kutusunda parolanızı yeniden girin.
    7. Uygula öğesini ve sonra Tamam öğesini seçin.
    8. Hizmetler penceresinde SQL Data Sync Aracısı hizmetine sağ tıklayın ve ardından Başlat'ı seçin.
    9. Hizmetler penceresini kapatın.

Aracı anahtarını gönderemiyorum

Bir aracı için anahtar oluşturduktan veya yeniden oluşturduktan sonra, anahtarı SqlAzureDataSyncAgent uygulaması aracılığıyla göndermeye çalışırsınız. Gönderim tamamlanamadı.

Sync Error dialog box - Can't submit agent key

  • Önkoşullar. Devam etmeden önce aşağıdaki önkoşulları denetleyin:

    • SQL Data Sync Windows hizmeti çalışıyor.

    • SQL Data Sync Windows hizmeti için hizmet hesabının ağ erişimi vardır.

    • Giden 1433 bağlantı noktası yerel güvenlik duvarı kuralınızda açık.

    • Eşitleme meta verileri veritabanı için sunucu veya veritabanı güvenlik duvarı kuralına yerel ip eklenir.

  • Neden, neden? Aracı anahtarı her yerel aracıyı benzersiz olarak tanımlar. Anahtarın iki koşula uyması gerekir:

    • SQL Data Sync sunucusundaki istemci aracısı anahtarı ve yerel bilgisayar aynı olmalıdır.
    • İstemci aracısı anahtarı yalnızca bir kez kullanılabilir.

  • Çözüm. Aracınız çalışmıyorsa, bunun nedeni bu koşullardan birinin veya ikisinin karşılanmamasıdır. Temsilcinizin yeniden çalışmasını sağlamak için:

    1. Yeni bir anahtar oluşturun.
    2. Aracıya yeni anahtarı uygulayın.

    Aracıya yeni anahtarı uygulamak için:

    1. Dosya Gezgini'nde aracı yükleme dizininize gidin. Varsayılan yükleme dizini C:\Program Files (x86)\Microsoft SQL Data Sync'tir.
    2. Bölme alt dizinine çift tıklayın.
    3. SqlAzureDataSyncAgent uygulamasını açın.
    4. Aracı Anahtarını Gönder'i seçin.
    5. Sağlanan alana anahtarı panonuzdan yapıştırın.
    6. Tamam’ı seçin.
    7. Programı kapatın.

İlişkili şirket içi veritabanına ulaşılamıyorsa istemci aracısı portaldan silinemez

SQL Data Sync istemci aracısı ile kaydedilen yerel bir uç noktaya (veritabanı) ulaşılamaz hale gelirse istemci aracısı silinemez.

  • Neden, neden? Ulaşılamayan veritabanı aracıya kaydedilmeye devam ettiğinden yerel aracı silinemiyor. Aracıyı silmeye çalıştığınızda silme işlemi veritabanına ulaşmaya çalışır ve bu işlem başarısız olur.

  • Çözüm. Ulaşılamayan veritabanını silmek için "zorla silmeyi" kullanın.

Not

Eşitleme meta veri tabloları "zorla silme" sonrasında kalırsa, bunları temizlemek için kullanın deprovisioningutil.exe .

Yerel Eşitleme Aracısı uygulaması yerel eşitleme hizmetine bağlanamıyor

  • Çözüm. Aşağıdaki adımları deneyin:

    1. Uygulamadan çıkın.
    2. Bileşen Hizmetleri Paneli'ni açın.
      a. Görev çubuğundaki arama kutusuna services.msc yazın.
      b. Arama sonuçlarında Hizmetler'e çift tıklayın.
    3. SQL Data Sync hizmetini durdurun.
    4. SQL Data Sync hizmetini yeniden başlatın.
    5. Uygulamayı yeniden açmak.

Komut isteminden Data Sync Aracısı'nı çalıştırın

Komut isteminden aşağıdaki Data Sync Aracısı komutlarını çalıştırabilirsiniz:

Hizmete ping işlemi

Kullanım

SqlDataSyncAgentCommand.exe -action pingsyncservice

Örnek

SqlDataSyncAgentCommand.exe -action "pingsyncservice"

Kayıtlı veritabanlarını görüntüleme

Kullanım

SqlDataSyncAgentCommand.exe -action displayregistereddatabases

Örnek

SqlDataSyncAgentCommand.exe -action "displayregistereddatabases"

Aracı anahtarını gönderme

Kullanım

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

Örnek

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]

Veritabanını kaydetme

Kullanım

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]

Örnekler

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

Veritabanının kaydını kaldırma

Veritabanının kaydını kaldırmak için bu komutu kullandığınızda, veritabanının sağlamasını tamamen kaldırmış olursunuz. Veritabanı diğer eşitleme gruplarına katılırsa, bu işlem diğer eşitleme gruplarını bozar.

Kullanım

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

Örnek

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

Kimlik bilgilerini güncelleştirme

Kullanım

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]

Örnekler

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

Sonraki adımlar

SQL Data Sync hakkında daha fazla bilgi için aşağıdaki makalelere bakın: