Data Sync Agent SQL-adatszinkronizálás

A következőkre vonatkozik: adatbázis Azure SQL

Adatok szinkronizálása SQL Server adatbázisokkal az Azure-beli SQL-adatszinkronizálás Data Sync Agent telepítésével és konfigurálásával. A SQL-adatszinkronizálás kapcsolatos további információkért lásd: Adatok szinkronizálása több felhőbeli és helyszíni adatbázis között SQL-adatszinkronizálás.

Fontos

SQL-adatszinkronizálás jelenleg nem támogatja Azure SQL Managed Instance vagy Azure Synapse Analytics szolgáltatást.

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

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

Telepítés csendesen

A Data Sync Agent 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 elemhez, az alapértelmezett érték a következő C:\Program Files (x86)\Microsoft SQL Data Sync 2.0: .

  • Ha a SERVICEACCOUNT értékét adja megLocalSystem, SQL Server hitelesítést kell használnia, amikor az ügynököt úgy konfigurálja, hogy csatlakozzon SQL Server.

  • Ha a SERVICEACCOUNT értékeként tartományi vagy 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

A Data Sync Agent 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.

Data Sync Agent gyakori kérdések

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

A SQL-adatszinkronizálás szolgáltatás az ügyfélügynök segítségével 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 a SQL-adatszinkronizálás szolgáltatás kommunikál az ügynökkel, titkosított kapcsolatokkal és egyedi jogkivonattal vagy ügynökkulccsal teszi ezt meg. A 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 az ügynökkulcs módosítása

Az ügynökkulcsot csak egyszer használhatja egy ügynök. Nem használható újra, ha eltávolít, majd újratelepít egy új ügynököt, és nem használhatja több ügynök. 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 a SQL-adatszinkronizálás szolgáltatás.

ügyfélügynök kivonása Hogyan

Egy ügynök azonnali érvénytelenítéséhez vagy kivonásához hozza létre újra a kulcsát a portálon, de ne küldje el az Ügynök felhasználói felületén. A kulcs ismételt létrehozá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 egy másik számítógépre Hogyan

Ha a helyi ügynököt a jelenlegitől eltérő számítógépről szeretné futtatni, tegye a következőket:

  1. Telepítse az ügynököt a kívánt számítógépre.
  2. Jelentkezzen be a SQL-adatszinkronizálás portálra, és hozza létre újra az új ügynök ügynökkulcsát.
  3. Az új ügynök felhasználói felületén küldje el az új ügynökkulcsot.
  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 nem érhető el. Ezeknek az adatbázisoknak elérhetőnek kell lenniük attól az új számítógéptől, amelyre az ügynök telepítve van.

Hogyan törölje a szinkronizálási metaadat-adatbázist, ha a Szinkronizálási ügynök még 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ázisokba lapra .
  3. Válassza ki a Szinkronizálási ügynököt, és válassza a Törlés lehetőséget.

Data Sync Agent problémák elhárítása

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

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

  • Megoldás. A hiba konkrét okának megkereséséhez hozza létre és tekintse meg a Windows Installer naplóit. A naplózást parancssorban kapcsolhatja be. Ha például a letöltött telepítőfájl az SQLDataSyncAgent-2.0-x86-ENU.msi, hozzon létre és vizsgálja meg a naplófájlokat az alábbi parancssorokkal:

    • 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éséről szóló cikkében egy kattintásos megoldást kínál 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 nem működik, még az eltávolítás megszakítása után sem.

  • Ok. Ez azért történik, mert a SQL-adatszinkronizálás ügyfélügynök nem tárolja a hitelesítő adatokat.

  • Megoldás. 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.
    • Távolítsa el ezt az ügyfélügynököt, majd telepítsen 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

Ha 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.

Ezek a forgatókönyvek okozhatják ezt a problémát:

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

  • Megoldás. 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ó.
  • Ok. Az ügyfélügynök adatbázislistája nem aktuális.

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

    A helyi ügynök csak az ügynökkulcs első elküldésekor tölti le a társított adatbázisok listáját. Nem tölti le a társított adatbázisok listáját a későbbi ügynökkulcs-beküldések során. 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-os hiba)

Felfedezheti, hogy az ügynök nem fut olyan számítógépen, amelyen SQL Server fut. Amikor megpróbálja manuálisan elindítani az ügynököt, megjelenik egy párbeszédpanel, amely a következő üzenetet jeleníti meg: "1069-os hiba: A szolgáltatás bejelentkezési hiba miatt nem indult el."

Data Sync error 1069 dialog box

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

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

    1. Keresse meg az SQL-adatszinkronizálás ügyfélügynök-szolgáltatást.
      a. Válassza az Indítás elemet.
      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 a SQL-adatszinkronizálás Agent bejegyzéséhez.
    2. Kattintson a jobb gombbal SQL-adatszinkronizálás ügynökre, majd válassza a Leállítás parancsot.
    3. Kattintson a jobb gombbal SQL-adatszinkronizálás ügynökre, majd válassza a Tulajdonságok parancsot.
    4. A SQL-adatszinkronizálás Agent Properties (Ügynök tulajdonságai) lapon válassza a Log in (Bejelentkezés) lapot.
    5. A Jelszó mezőbe írja be a jelszavát.
    6. A Jelszó megerősítése mezőbe írja be újra a jelszavát.
    7. Válassza az Apply (Alkalmaz) lehetőséget, majd kattintson az OK gombra.
    8. A Szolgáltatások ablakban kattintson a jobb gombbal a SQL-adatszinkronizálás Agent szolgáltatásra, majd válassza a Start parancsot.
    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.

Szinkronizálási hiba párbeszédpanel – Nem lehet elküldeni az ügynökkulcsot

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

    • A windowsos SQL-adatszinkronizálás szolgáltatás fut.

    • A SQL-adatszinkronizálás Windows-szolgáltatás szolgáltatásfiókja hálózati hozzáféréssel rendelkezik.

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

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

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

    • A SQL-adatszinkronizálás kiszolgálón és a helyi számítógépen lévő ügyfélügynök kulcsának azonosnak kell lennie.
    • Az ügyfélügynök kulcsa csak egyszer használható.
  • Megoldás. 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 munkára való kérése:

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

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

    1. Az Fájlkezelő 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-adatszinkronizálás.
    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. A megadott helyre illessze be a vágólapról a kulcsot.
    6. Válassza az OK lehetőséget.
    7. Zárja be a programot.

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

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

  • Ok. 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 sikertelen.

  • Megoldás. A "kényszerített törlés" használatával törölje a nem elérhető adatbázist.

Megjegyzés

Ha a metaadat-táblák szinkronizálása a "kényszerített törlés" után is megmarad, törölje deprovisioningutil.exe őket.

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

  • Megoldás. 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 kifejezést.
      b. A keresési eredmények között kattintson duplán a Szolgáltatások elemre.
    3. Állítsa le a SQL-adatszinkronizálás szolgáltatást.
    4. Indítsa újra a SQL-adatszinkronizálás szolgáltatást.
    5. újra meg kell nyitniuk az alkalmazást;

A Data Sync Agent futtatása a parancssorból

A parancssorból a következő Data Sync Agent parancsokat futtathatja:

A szolgáltatás pingelése

Használat

SqlDataSyncAgentCommand.exe -action pingsyncservice

Példa

SqlDataSyncAgentCommand.exe -action "pingsyncservice"

Regisztrált adatbázisok megjelenítése

Használat

SqlDataSyncAgentCommand.exe -action displayregistereddatabases

Példa

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]

Példa

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

Ha ezzel a paranccsal szünteti meg az adatbázis regisztrációjának törlését, az teljesen megszünteti az adatbázist. 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]

Példa

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

Következő lépések

A SQL-adatszinkronizálás kapcsolatos további információkért tekintse meg a következő cikkeket: