Aracılığıyla paylaş

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 kurma

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 SQL Server veritabanlarıyla istemci aracısı yoluyla iletişim kurar. Bu güvenlik özelliği, 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 üst düzey bir 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ı değiştirme Nasıl yaparım?

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.

Nasıl yaparım? bir istemci aracıyı devre dışı bırakma

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.

Nasıl yaparım? istemci aracısını başka bir bilgisayara taşıma

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 yaparım? silin

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.

Data Sync Agent sorunlarını giderme

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

  • 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 tam nedenini bulmak için Windows Installer günlüklerini oluşturun ve bu günlüklere bakın. Günlüğü komut isteminde 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ükleme işlemleri için: msiexec.exe /i SQLDataSyncAgent-2.0-x86-ENU.msi /l*v LocalAgentSetup.Log

    • Kaldırma işlemleri 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 de günlüğe kaydetmeyi açabilirsiniz. Windows Installer günlüğünü etkinleştirme adlı Microsoft Bilgi Bankası makalesi Windows Installer’da günlüğü açmak için tek tıklamalı bir çözüm sağlar. Ayrıca günlüklerin konumunu da gösterir.

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

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

  • 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ının kimlik bilgilerini yeniden girmek için services.msc dosyasını kullanın.
    • Bu istemci aracısını kaldırın ve yenisini yükleyin. İndirme Merkezi’nden en son istemci aracısını indirin ve yükleyin.

Veritabanım aracı listesinde yer almıyor

Mevcut SQL Server veritabanını bir eşitleme grubuna eklemeye çalıştığınızda veritabanı aracılar listesinde görünmüyor.

Bu senaryolar bu soruna neden olabilir:

  • Neden. İstemci aracısı ile eşitleme grubu farklı veri merkezlerindedir.

  • Çözüm. İstemci aracısı ile eşitleme grubunun aynı veri merkezlerinde bulunması gerekir. 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ıyla kaydedin.
    • Geçerli eşitleme grubunu silin. Ardından aracının bulunduğu veri merkezinde eşitleme grubunu yeniden oluşturun.

  • Neden. İstemci aracısının veritabanı listesi güncel değil.

  • Çözüm. İstemci aracısı hizmetini durdurun ve sonra 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ıyı taşıma işlemi 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şfettiniz. Aracıyı el ile başlatmayı denediğinizde "Hata 1069: Oturum açma hatası nedeniyle hizmet başlatılmadı." iletisinin görüntülendiği bir iletişim kutusu görüyorsunuz.

Veri Eşitleme hatası 1069 iletişim kutusu

  • Neden. Bu hatanın olası bir nedeni, aracıyı ve aracı parolasını oluşturmanızdan bu yana yerel sunucudaki parolanın değişmiş olmasıdır.

  • Çö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 girin.
      c. Arama sonuçlarında Hizmetler’i seçin.
      d. Hizmetler penceresinde, SQL Data Sync Aracısı girdisine gidin.
    2. SQL Data Sync Agent’a sağ tıklayın ve ardından Durdur’u seçin.
    3. SQL Data Sync Agent’a sağ tıklayın ve ardından Özellikler’i seçin.
    4. SQL Data Sync Agent Özellikleri’nde Oturum aç sekmesini seçin.
    5. Parola kutusuna parolanızı girin.
    6. Parolayı Onayla kutusuna parolanızı yeniden girin.
    7. Uygula’yı ve sonra Tamam’ı seçin.
    8. Hizmetler penceresinde SQL Data Sync Agent hizmetine sağ tıklayın ve ardından Başlat’ı seçin.
    9. Hizmetler penceresini kapatın.

Aracı anahtarını gönderemiyorum

Aracı için anahtarı oluşturduktan veya yeniden oluşturduktan sonra bu anahtarı SqlAzureDataSyncAgent uygulaması aracılığıyla göndermeyi deniyorsunuz. Gönderim tamamlanamadı.

Eşitleme Hatası iletişim kutusu - Aracı anahtarı gönderemiyorum

  • Ö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 var.

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

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

  • Neden. Aracı anahtarı her yerel aracıyı benzersiz olarak tanımlar. Anahtar iki koşula uymalıdır:

    • SQL Data Sync sunucusu ile yerel bilgisayardaki istemci aracısı anahtarları aynı olmalıdır.
    • İstemci aracısı anahtarı tek bir kez kullanılabilir.

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

    1. Yeni anahtar oluşturun.
    2. Yeni anahtarı aracıya uygulayın.

    Yeni anahtarı aracıya 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 dizinidir.
    2. Bin 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 panonuzdaki anahtarı yapıştırın.
    6. Tamam'ı seçin.
    7. Programı kapatın.

İstemci aracısıyla ilişkili şirket içi veritabanına ulaşılamıyorsa, istemci aracısı portaldan silinemiyor

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

  • Neden. Yerel aracı silinemiyor çünkü ulaşılamayan veritabanı hala aracıya kayıtlı. Aracıyı silmeye çalıştığınızda, silme işlemi veritabanına ulaşmayı deniyor ve bu işlem başarısız oluyor.

  • Çö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: