Adatszinkronizálási ügynök az SQL Data Synchez

A következőkre vonatkozik:Azure SQL Database

Fontos

Az SQL Data Sync 2027. szeptember 30-án megszűnik. Fontolja meg az áttelepítést alternatív adatreplikációs/szinkronizálási megoldásokra.

Adatok szinkronizálása SQL Server-adatbázisokkal az SQL Data Sync adatszinkronizálási ügynökének azure-beli telepítésével és konfigurálásával. Az SQL Data Sync szolgáltatással kapcsolatos további információkért lásd : Mi az Azure SQL Data Sync?

Az SQL Data Sync nem támogatja a felügyelt Azure SQL-példányt vagy az Azure Synapse Analyticset.

Letöltés és telepítés

Figyelmeztetés

Fontolja meg az áttelepítést alternatív adatreplikációs/szinkronizálási megoldásokra.

Az adatszinkronizálási ügynök letöltéséhez nyissa meg az SQL Data Sync Agentet. Az adatszinkronizálási ügynök frissítéséhez telepítse az ügynököt a régi ügynökkel megegyező helyre, és felülbírálja az eredetit.

Csendes telepítés

Az adatszinkronizálási ügynök parancssorból történő csendes telepítéséhez írjon be egy, az alábbi példához hasonló parancsot. Ellenőrizze a letöltött .msi fájl nevét, és adja meg saját értékeit a TARGETDIR és a SERVICEACCOUNT argumentumokhoz.

  • Ha nem ad meg értéket a TARGETDIR-hez, az alapértelmezett érték a következő C:\Program Files (x86)\Microsoft SQL Data Sync 2.0.

  • Ha a LocalSystem értékeként adja meg, használja az SQL Server-hitelesítést, amikor konfigurálja az ügynököt az SQL Serverhez való csatlakozásra.

  • Ha a SERVICEACCOUNT értékeként egy tartományi vagy egy helyi felhasználói fiókot ad meg, akkor a JELSZÓT is meg kell adnia a SERVICEPASSWORD argumentummal. Például: 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

Adatok szinkronizálása SQL Server-adatbázissal

Az adatszinkronizálási ügynök konfigurálásához, hogy egy vagy több SQL Server-adatbázissal szinkronizálhassa az adatokat, olvassa el az SQL Server-adatbázis hozzáadása című témakört.

Az SQL Server helyszíni verzióinak támogatása

A szinkronizálási csoportnak csak a helyszíni SQL Server következő verziói lehetnek részei:

  • SQL Server 2008
  • SQL Server 2008 R2
  • SQL Server 2012
  • SQL Server 2016
  • SQL Server 2017 Windows rendszeren
  • SQL Server 2019 Windows rendszeren
  • SQL Server 2022 Windows rendszeren

Adatszinkronizálási ügynök – gyakori kérdések

Miért van szükségem ügyfélügynökre?

Az SQL-adatszinkronizálási szolgáltatás az ügyfélügynökön keresztül kommunikál SQL Server-adatbázisokkal. Ez a biztonsági funkció megakadályozza a tűzfal mögötti adatbázisokkal való közvetlen kommunikációt. Amikor az SQL Data Sync szolgáltatás kommunikál az ügynökkel, titkosított kapcsolatokat és egyedi jogkivonatot vagy ügynökkulcsot használ. Az SQL Server-adatbázisok a kapcsolati sztring és az ügynökkulcs használatával hitelesítik az ügynököt. Ez a kialakítás magas szintű biztonságot nyújt az adatok számára.

A helyi ügynök felhasználói felületének hány példánya futtatható

A felhasználói felületnek csak egy példánya futtatható.

Hogyan módosíthatom a szolgáltatásfiókomat?

Az ügyfélügynök telepítése után csak úgy módosíthatja a szolgáltatásfiókot, ha eltávolítja és új ügyfélügynököt telepít az új szolgáltatásfiókkal.

Hogyan módosíthatom az ügynökkulcsot?

Ügynökkulcsot csak egyszer használhat egy ügynök. Nem használható újra, ha eltávolít, majd újratelepít egy új ügynököt, és több ügynök sem használhatja. Ha új kulcsot kell létrehoznia egy meglévő ügynökhöz, győződjön meg arról, hogy ugyanazt a kulcsot rögzíti az ügyfélügynök és az SQL Data Sync szolgáltatás.

Ügyfélügynök kivonása

Az ügynök azonnali érvénytelenítéséhez vagy kivonásához hozza létre újra a kulcsot a portálon, de ne küldje el az Ügynök felhasználói felületén. A kulcs újragenerálása érvényteleníti az előző kulcsot, függetlenül attól, hogy a megfelelő ügynök online vagy offline állapotban van-e.

Ügyfélügynök áthelyezése másik számítógépre

Ha a helyi ügynököt a jelenlegitől eltérő számítógépről szeretné futtatni, és ugyanazt az ügynököt szeretné újra felhasználni, hajtsa végre az alábbi lépéseket:

  1. Telepítse az ügynököt a kívánt számítógépre.
  2. Jelentkezzen be az SQL Data Sync portálra, és hozza létre újra a meglévő ügynök ügynökkulcsát.
  3. Az új ügynöki felhasználói felületet használja az ügynökkulcs beküldéséhez.
  4. Várjon, amíg az ügyfélügynök letölti a korábban regisztrált helyszíni adatbázisok listáját.
  5. Adja meg az adatbázis hitelesítő adatait az összes olyan adatbázishoz, amely elérhetetlenként jelenik meg. Ezeknek az adatbázisoknak elérhetőnek kell lenniük az ügynököt futtató új számítógépről.

Hogyan törölhetem a szinkronizálási metaadat-adatbázist, ha a Szinkronizálási ügynök továbbra is hozzá van rendelve

Ahhoz, hogy töröljön egy szinkronizálási metaadat-adatbázist, amelyhez szinkronizálási ügynök van társítva, először törölnie kell a Szinkronizálási ügynököt. Az ügynök törléséhez tegye a következőket:

  1. Válassza ki a Szinkronizálás adatbázist.
  2. Lépjen a Szinkronizálás más adatbázisokkal oldalra.
  3. Válassza ki a Szinkronizálási ügynököt, és válassza a Törlés lehetőséget.

A Data Sync Agenttel kapcsolatos problémák elhárítása

Az ügyfélügynök telepítése, eltávolítása vagy javítása meghiúsul

  • Cause. Számos forgatókönyv okozhatja ezt a hibát. A hiba konkrét okának meghatározásához tekintse meg a naplókat.

  • Resolution. A hiba konkrét okának megkereséséhez hozza létre és tekintse meg a Windows Installer naplóit. A naplózást a parancssorban kapcsolhatja be. Például, ha a letöltött telepítési fájl a SQLDataSyncAgent-2.0-x86-ENU.msi, a naplófájlok létrehozásához és vizsgálatához használja a következő parancssorokat:

    • Telepítések esetén: msiexec.exe /i SQLDataSyncAgent-2.0-x86-ENU.msi /l*v LocalAgentSetup.Log

    • Eltávolítások esetén: msiexec.exe /x SQLDataSyncAgent-2.0-x86-ENU.msi /l*v LocalAgentSetup.Log

      A Windows Installer által végrehajtott összes telepítés naplózását is bekapcsolhatja. A Microsoft Tudásbázis A Windows Installer naplózásának engedélyezése című cikkében található egy egykattintásos megoldás a Windows Installer naplózásának bekapcsolására. A naplók helyét is megadja.

Az ügyfélügynök nem működik az eltávolítás megszakítása után

Az ügyfélügynök még az eltávolításának megszakítása után sem működik.

  • Cause. Ez azért fordul elő, mert az SQL Data Sync ügyfélügynöke nem tárolja a hitelesítő adatokat.

  • Resolution. Az alábbi két megoldás kipróbálható:

    • A services.msc használatával újra meg kell adnia az ügyfélügynök hitelesítő adatait.
    • Eltávolíthatja el ezt az ügyfélügynököt, majd telepíthet egy újat. Töltse le és telepítse a legújabb ügyfélügynököt a Letöltőközpontból.

Az adatbázisom nem szerepel az ügynöklistában

Amikor egy meglévő SQL Server-adatbázist próbál hozzáadni egy szinkronizálási csoporthoz, az adatbázis nem jelenik meg az ügynökök listájában.

Az alábbi forgatókönyvek okozhatják ezt a problémát:

  • Cause. Az ügyfélügynök és a szinkronizálási csoport különböző adatközpontban található.

  • Resolution. Az ügyfélügynöknek és a szinkronizálási csoportnak ugyanabban az adatközpontban kell lennie. A beállításhoz két lehetősége van:

    • Hozzon létre egy új ügynököt abban az adatközpontban, ahol a szinkronizálási csoport található. Ezután regisztrálja az adatbázist az ügynökkel.
    • Törölje az aktuális szinkronizálási csoportot. Ezután hozza létre újra a szinkronizálási csoportot abban az adatközpontban, ahol az ügynök található.

  • Cause. Az ügyfélügynök adatbázislistája nem naprakész.

  • Resolution. Állítsa le, majd indítsa újra az ügyfélügynök-szolgáltatást.

    A helyi ügynök csak az ügynökkulcs első beküldésekor tölti le a társított adatbázisok listáját. A későbbi ügynökkulcs-beküldésekkor nem tölti le a társított adatbázisok listáját. Az ügynök áthelyezése során regisztrált adatbázisok nem jelennek meg az eredeti ügynökpéldányban.

Az ügyfélügynök nem indul el (1069-es hiba)

Azt észleli, hogy az ügynök nem olyan számítógépen fut, amely SQL Servert üzemeltet. Amikor megpróbálja manuálisan elindítani az ügynököt, megjelenik egy párbeszédpanel a következő üzenettel: „1069-es hiba: A szolgáltatás bejelentkezési hiba miatt nem indult el”.

Képernyőkép a Data Sync 1069-hiba párbeszédpanelről.

  • Cause. Ennek a hibának valószínűleg az az oka, hogy a helyi kiszolgálón a jelszó megváltozott az ügynök és az ügynök jelszava létrehozása óta.

  • Resolution. Frissítse az ügynök jelszavát az aktuális kiszolgálójelszóra:

    1. Keresse meg a SQL-adatszinkronizálási ügyfélügynök-szolgáltatást.
      a). Válassza az Indítás lehetőséget.
      b. A keresőmezőbe írja be a services.msc kifejezést.
      c) A keresési eredmények közül válassza a Szolgáltatások lehetőséget.
      d. A Szolgáltatások ablakban görgessen az SQL Data Sync Agent bejegyzéséhez.
    2. Kattintson a jobb gombbal az SQL Data Sync Agent elemre, majd válassza a Leállítás lehetőséget.
    3. Kattintson a jobb gombbal az SQL Data Sync Agent elemre, majd válassza a Tulajdonságok lehetőséget.
    4. Az SQL Data Sync Agent tulajdonságai területen válassza a Bejelentkezés lapot.
    5. A Jelszó mezőbe írja be a jelszót.
    6. A Jelszó megerősítése mezőbe írja be újra a jelszót.
    7. Válassza a Alkalmazlehetőséget, majd válassza OKlehetőséget.
    8. A Szolgáltatások ablakban kattintson a jobb gombbal az SQL Data Sync Agent szolgáltatásra, majd válassza az Indítás lehetőséget.
    9. Zárja be a Szolgáltatások ablakot.

Nem tudom elküldeni az ügynökkulcsot

Miután létrehozott vagy újra létrehozott egy kulcsot egy ügynökhöz, próbálja meg elküldeni a kulcsot az SqlAzureDataSyncAgent alkalmazáson keresztül. A beküldés nem fejeződik be.

Képernyőkép a Szinkronizálási hiba párbeszédpanelről – Nem lehet elküldeni az ügynökkulcsot.

  • előfeltételek. A folytatás előtt ellenőrizze a következő előfeltételeket:

    • Az SQL-adatszinkronizálási Windows-szolgáltatás fut.

    • Az SQL-adatszinkronizálási Windows-szolgáltatás szolgáltatásfiókja hozzáfér a hálózathoz.

    • A kimenő 1433-as port meg van nyitva a helyi tűzfalszabályban.

    • A rendszer hozzáadja a helyi IP-címet a szinkronizálási metaadat-adatbázis kiszolgálói vagy adatbázis tűzfalszabályához.

  • Cause. Az ügynökkulcs egyedileg azonosítja az egyes helyi ügynököket. A kulcsnak a következő két feltételnek kell megfelelnie:

    • A SQL-adatszinkronizálási kiszolgálón és a helyi számítógépen lévő ügyfélügynökkulcsnak azonosnak kell lennie.
    • Az ügyfélügynökkulcs csak egyszer használható fel.

  • Resolution. Ha az ügynök nem működik, annak az az oka, hogy az egyik vagy mindkét feltétel nem teljesül. Az ügynök újbóli működésének biztosításához tegye a következőket:

    1. Hozzon létre egy új kulcsot.
    2. Alkalmazza az új kulcsot az ügynökre.

    Az új kulcs alkalmazása az ügynökre:

    1. A Fájlkezelőben lépjen az ügynök telepítési könyvtárába. Az alapértelmezett telepítési könyvtár a C:\Program Files (x86)\Microsoft SQL Data Sync.
    2. Kattintson duplán a bin alkönyvtárra.
    3. Nyissa meg az SqlAzureDataSyncAgent alkalmazást.
    4. Válassza az Ügynökkulcs elküldése lehetőséget.
    5. Illessze be a megjelenő helyre a kulcsot a vágólapról.
    6. Kattintson az OK gombra.
    7. Zárja be a programot.

Az ügyfélügynök nem törölhető a portálról, ha a hozzá társított helyszíni adatbázis nem érhető el

Ha egy SQL Data Sync-ügyfélügynökkel regisztrált helyi végpont (vagyis adatbázis) elérhetetlenné válik, az ügyfélügynök nem törölhető.

  • Cause. A helyi ügynök nem törölhető, mert a nem elérhető adatbázis továbbra is regisztrálva van az ügynökkel. Amikor megpróbálja törölni az ügynököt, a törlési folyamat megpróbálja elérni az adatbázist, ami meghiúsul.

  • Resolution. A nem elérhető adatbázis törléséhez használja a "törlés kényszerítése" parancsot.

Megjegyzés:

Ha a szinkronmetaadat-táblák a "törlés kényszerítése" után is hátra maradnak, törölje deprovisioningutil.exe őket.

A helyi szinkronizációs ügynök alkalmazás nem tud csatlakozni a helyi szinkronizálási szolgáltatáshoz

  • Resolution. Próbálja meg a következőket:

    1. Lépjen ki az alkalmazásból.
    2. Nyissa meg a Komponensszolgáltatások panelt.
      a). A tálcán lévő keresőmezőbe írja be a services.msc nevet.
      b. A keresési eredmények között kattintson duplán a Szolgáltatások elemre.
    3. Állítsa le az SQL-adatszinkronizálás szolgáltatást.
    4. Indítsa újra az SQL-adatszinkronizálás szolgáltatást.
    5. újra meg kell nyitniuk az alkalmazást;

Az adatszinkronizálási ügynök futtatása a parancssorból

A következő Adatszinkronizálási ügynök parancsokat futtathatja a parancssorból:

A szolgáltatás pingelése

Használat

SqlDataSyncAgentCommand.exe -action pingsyncservice

Example

SqlDataSyncAgentCommand.exe -action "pingsyncservice"

Regisztrált adatbázisok megjelenítése

Használat

SqlDataSyncAgentCommand.exe -action displayregistereddatabases

Example

SqlDataSyncAgentCommand.exe -action "displayregistereddatabases"

Az ügynökkulcs elküldése

Használat

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

Example

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]

Adatbázis regisztrálása

Használat

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]

Példák

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

Adatbázis regisztrációja törlése

Amikor ezzel a paranccsal törli az adatbázis regisztrációját, az teljesen megszünteti az adatbázis konfigurációját. Ha az adatbázis más szinkronizálási csoportokban is részt vesz, ez a művelet megszakítja a többi szinkronizálási csoportot.

Használat

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

Example

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

Hitelesítő adatok frissítése

Használat

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]

Példák

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

Kapcsolódó tartalom

Az SQL Data Sync szolgáltatással kapcsolatos további információkért tekintse meg az alábbi cikkeket:

  • Last updated on