Oktatóanyag: MongoDB offline Azure Cosmos DB Api for MongoDB-be

A következőkre vonatkozik: Azure Cosmos db API a MongoDB

Fontos

A migrálási lépések elvégzése előtt olvassa el a teljes útmutatót.

Ez a MongoDB-migrálási útmutató a MongoDB-migrálásra vonatkozó sorozat része. A MongoDB-migrálás kritikus lépései a migrálást megelőző, a migrálást követő és a migrálás utáni lépések,ahogy az alább látható.

A migrálás lépéseit szemléltető ábra.

A MongoDB-ről a DMS-Azure Cosmos DB offline adatmigrálás áttekintése

A Azure Database Migration Service használatával offline, egyszer migrálást végezhet az adatbázisokról a MongoDB egy helyszíni vagy felhőbeli példányából a MongoDB-hez Azure Cosmos DB API-ba.

Eben az oktatóanyagban az alábbiakkal fog megismerkedni:

  • Hozzon létre egy Azure Database Migration Service-példányt.
  • Hozzon létre egy migrálási projektet a Azure Database Migration Service.
  • A migrálás futtatása.
  • Az áttelepítés monitorozása.

Ebben az oktatóanyagban egy Azure-beli virtuális gépen üzemeltetett mongoDB-beli adatkészletet fog átemelni. A Azure Database Migration Service az adatkészletet a MongoDB-hez Azure Cosmos DB API-ba. Ha még nem állította be a MongoDB-forrást, tekintse meg A MongoDBtelepítése és konfigurálása Windows rendszerű virtuális gépen az Azure-ban.

Előfeltételek

Az oktatóanyag elvégzéséhez a következőkre lesz szüksége:

  • Kövesse az áttelepítés előtti lépéseket, például becsüli meg az átviteli sebességet, és válasszon partíciókulcsot.

  • Hozzon létre egy fiókot a MongoDB-hez Azure Cosmos DB API-hoz.

  • Hozzon létre Microsoft Azure Virtual Network-Azure Database Migration Service a Azure Resource Manager. Ez az üzembe helyezési modell lehetővé teszi a helyszíni forráskiszolgálókhoz való hely–hely kapcsolatot Azure ExpressRoute VPN használatával. A virtuális hálózatok létrehozásával kapcsolatos további információkért tekintse meg az Azure Virtual Networkdokumentációját, különösen a "rövid útmutató" cikkeket részletesen.

    Megjegyzés

    Ha a virtuális hálózat beállítása során az ExpressRoute-et a Microsofttal való hálózati társviszony-létesítés során használja, adja hozzá a következő szolgáltatásvégpontokat ahhoz az alhálózathoz, amelyben a szolgáltatást kiépíti:

    • Céladatbázis végpontja (például SQL-végpont vagy Azure Cosmos DB végpont)
    • Storage-végpont
    • Service Bus-végpont

    Erre a konfigurációra azért van szükség, mert Azure Database Migration Service nem rendelkezik internetkapcsolattal.

  • Győződjön meg arról, hogy a virtuális hálózat hálózati biztonsági csoport (NSG) szabályai nem blokkolják a következő kommunikációs portokat: 53, 443, 445, 9354 és 10000-20000. További információ: Hálózati forgalom szűrése hálózati biztonsági csoportokkal.

  • Nyissa meg a Windows tűzfalat, hogy Azure Database Migration Service a MongoDB-forráskiszolgálóhoz, amely alapértelmezés szerint a 27017-es TCP-port.

  • Ha tűzfalberendezést használ a forrásadatbázis előtt, előfordulhat, hogy tűzfalszabályokat kell hozzáadnia ahhoz, hogy a Azure Database Migration Service hozzáférjenek a forrásadatbázishoz a migráláshoz.

A kiszolgálóoldali újrapróbálkozási szolgáltatás konfigurálása

Az erőforrás-irányítási képességeket akkor használhatja, ha a MongoDB-ről a Azure Cosmos DB. Ezekkel a képességekkel teljes mértékben kihasználhatja a kiépített kérelemegységek (RU/s) átviteli sebességét. Azure Cosmos DB adott kérést Database Migration Service a migrálás során, ha a kérés meghaladja a tároló által kiépített RU/s-t. Ezután újra el kell érvénybe a kérelmet.

Database Migration Service képes újra végrehajtani az újrabeküldetéseket. Fontos megérteni, hogy a hálózati ugráshoz a Database Migration Service és a Azure Cosmos DB közötti oda-visszalépési idő hatással van a kérés teljes válaszidejére. A szabályozásos kérések válaszideje lerövidítheti a migráláshoz szükséges teljes időt.

A szolgáltatás kiszolgálóoldali újrapróbálkozási szolgáltatása Azure Cosmos DB lehetővé teszi, hogy a szolgáltatás elfogja a vezérlő hibakódját, és sokkal kevesebb körbelépési idővel próbálja újrapróbálkozásokat, ami jelentősen javítja a kérések válaszidejeit.

A Kiszolgálóoldali újrapróbálkozás funkciójának Azure Cosmos DB portálon válassza a Szolgáltatások > kiszolgálóoldali újrapróbálkozás lehetőséget.

A Kiszolgálóoldali újrapróbálkozás szolgáltatás helyének képernyőképe.

Ha a funkció le van tiltva, válassza az Engedélyezés lehetőséget.

A kiszolgálóoldali újrapróbálkozás engedélyezését bemutató képernyőkép.

Az erőforrás-szolgáltató regisztrálása

  1. Jelentkezzen be az Azure Portalra, és válassza a Minden szolgáltatás, majd az Előfizetések elemet.

    A portál-előfizetéseket bemutató képernyőkép.

  2. Válassza ki azt az előfizetést, amelyben létre szeretné hozni a Azure Database Migration Service, majd válassza az Erőforrás-szolgáltatók lehetőséget.

    Az erőforrás-szolgáltatókat bemutató képernyőkép.

  3. Keressen rá a migrálás kifejezésre, majd a Microsoft.DataMigration jobb oldalon válassza a Regisztráció lehetőséget.

    Az erőforrás-szolgáltató regisztrálását bemutató képernyőkép.

Példány létrehozása

  1. Az Azure Portalon válassza a + Erőforrás létrehozása lehetőséget, keresse meg az Azure Database Migration Service-t, és a legördülő menüben válassza ki az Azure Database Migration Service-t.

    Képernyőkép az Azure Marketplace-ről.

  2. Az Azure Database Migration Service képernyőn válassza a Létrehozás lehetőséget.

    Képernyőkép a példánypéldányok létrehozásáról Azure Database Migration Service.

  3. A Migrálási szolgáltatás létrehozása oldalon adja meg a szolgáltatás, az előfizetés és egy új vagy meglévő erőforráscsoport nevét.

  4. Válassza ki azt a helyet, ahol létre szeretné hozni a Azure Database Migration Service.

  5. Válasszon ki egy meglévő virtuális hálózatot, vagy hozzon létre egy újat.

    A virtuális hálózat hozzáférést Azure Database Migration Service MongoDB-példányhoz és a fiókhoz Azure Cosmos DB célhálózathoz.

    További információ a virtuális hálózatok létrehozásáról a Azure Portal: Virtuálishálózat létrehozása a Azure Portal.

  6. Válasszon tarifacsomagot.

    További tájékoztatás a költségekről és a tarifacsomagokról a díjszabási lapon olvasható.

    Képernyőkép a példány konfigurációs beállításairól Azure Database Migration Service.

  7. A szolgáltatás létrehozásához válassza a Létrehozás lehetőséget.

Migrálási projekt létrehozása

Miután létrehozott egy szolgáltatást, keresse meg a Azure Portal, és nyissa meg. Ezután hozzon létre egy új migrálási projektet.

  1. Az Azure Portalon válassza a Minden szolgáltatás lehetőséget, keresse meg az Azure Database Migration Service-t, majd válassza ki az Azure Database Migration Servicest.

    Képernyőkép a példányok összes példányának Azure Database Migration Service.

  2. Az Azure Database Migration Services képernyőn keresse meg a létrehozott Azure Database Migration Service nevét, majd válassza ki a példányt.

  3. Válassza az + Új migrálási projekt lehetőséget.

  4. Az Új migrálási projekt mezőben adja meg a projekt nevét, majd a Forráskiszolgáló típusa szövegmezőben válassza a MongoDB lehetőséget. A Célkiszolgáló típusa szövegmezőben válassza a CosmosDB (MongoDB API) lehetőséget, majd a Tevékenység típusának kiválasztása beállításnál válassza az Offline adatáttelepítés lehetőséget.

    Képernyőkép a projekt beállításairól.

  5. Válassza a Tevékenység létrehozása és futtatása lehetőséget a projekt létrehozásához és a migrálási művelet lefuttatásához.

Forrás adatainak megadása

  1. A Forrás részletei képernyőn adja meg a MongoDB-forráskiszolgáló kapcsolati adatait.

    Fontos

    Azure Database Migration Service nem támogatja a Azure Cosmos DB mint forrást.

    A forráshoz való csatlakozásnak három módja van:

    • Standard mód, amely teljes tartománynevet vagy IP-címet, portszámot és kapcsolati hitelesítő adatokat fogad el.

    • Kapcsolati sztring mód, amely egy MongoDB kapcsolati sztringet fogad el a Kapcsolati sztring URI formátuma leírásában leírtak szerint.

    • Az Azure Storage-ból származó adatok, amelyek egy blobtároló SAS URL-címét fogadják el. Válassza a Blob BSON-memóriaképeket tartalmaz lehetőséget, ha a blobtárolóban a MongoDB bsondump eszköze által előállított BSON-memóriaképeket tartalmaz. Ne válassza ezt a lehetőséget, ha a tároló JSON-fájlokat tartalmaz.

      Ha ezt a lehetőséget választja, győződjön meg arról, hogy a tárfiók kapcsolati sztring a következő formátumban jelenik meg:

      https://blobnameurl/container?SASKEY
      

      Ezt a blobtároló SAS kapcsolati sztringet az Azure Storage Explorerben találhatja meg. Ha létrehozza az SAS-t az érintett tárolóhoz, a rendszer a kért formátumban biztosítja az URL-címet.

      Emellett az Azure Storage-ban található memóriaképtípus-információk alapján tartsa szem előtt a következőket:

      • BSON-memóriaképekkel a blobtárolóban lévő adatoknak bsondump formátumúnak kell lennie. Helyezze az adatfájlokat a gyűjtemény.bson formátumú adatbázisokat tartalmazó mappáiba. Nevezze el a metaadatfájlokat a fájl collection.metadata.jsformátumával.

      • A JSON-memóriaképeket a blobtárolóban lévő fájlokat az azokat tartalmazó adatbázisok után elnevezett mappákba kell helyezni. Az egyes adatbázismappákban az adatfájlokat a data nevű almappába kell helyezni, és a fájlban található formátummal collection.jselnevezni. Helyezze el a metaadatfájlokat a metaadatok nevű almappában, és azonos formátumban elnevezve,collection.js a következőn:. A metaadatfájloknak a MongoDB bsondump eszköz által előállított formátumban kell lennie.

    Fontos

    Nem javasoljuk, hogy önaírt tanúsítványt használjon a MongoDB-kiszolgálón. Ha szükséges, csatlakozzon a kiszolgálóhoz a kapcsolati sztring mód használatával, és győződjön meg arról, hogy a kapcsolati sztringben idézőjelek ("") vannak.

    &sslVerifyCertificate=false
    

    Az IP-címet olyan helyzetekben is használhatja, amikor a DNS-névfeloldás nem lehetséges.

    A forrásadatok megadását bemutató képernyőkép.

  2. Kattintson a Mentés gombra.

Cél adatainak megadása

  1. A Migrálási cél részletei képernyőn adja meg a célként megadott Azure Cosmos DB adatait. Ez a fiók az előre kiépített Azure Cosmos DB API a MongoDB-fiókhoz, amelyre a MongoDB-adatokat mikalkulálja.

    A céladatok megadását bemutató képernyőkép.

  2. Kattintson a Mentés gombra.

Leképezés céladatbázisokra

  1. A Leképezés céladatbázisra képernyőn leképezi a forrás- és a céladatbázist a migráláshoz.

    Ha a céladatbázis ugyanazt az adatbázisnevet tartalmazza, mint a forrásadatbázis, Azure Database Migration Service a céladatbázist választja ki.

    Ha a Létrehozás megjelenik az adatbázis neve mellett, az azt jelzi, hogy Azure Database Migration Service nem találja a céladatbázist, és a szolgáltatás létrehozza az adatbázist.

    Az áttelepítés ezen pontján kiépítheti az átviteli sebességet. A Azure Cosmos DB az átviteli sebességet az adatbázis szintjén vagy egyesével is kiépítheti az egyes gyűjtemények számára. Az átviteli sebességet kérelemegységekben mérjük. További információ a Azure Cosmos DB díjszabásról.

    A céladatbázisok leképezését bemutató képernyőkép.

  2. Kattintson a Mentés gombra.

  3. A Gyűjtemény beállítása képernyőn bontsa ki a gyűjtemények listáját, majd tekintse át az áttelepíteni fogja a gyűjtemények listáját.

    Azure Database Migration Service automatikusan kiválasztja a forrás MongoDB-példányon található összes olyan gyűjteményt, amely nem létezik a célként Azure Cosmos DB fiókban. Ha olyan gyűjteményeket szeretne átemelni, amelyek már tartalmaznak adatokat, explicit módon ki kell választania a gyűjteményeket ezen a panelen.

    Megadhatja a gyűjtemények által használni kívánt ru-k számát. Azure Database Migration Service a gyűjtemény mérete alapján intelligens alapértelmezett értékeket javasol.

    Megjegyzés

    Párhuzamosan végezze el az adatbázis-migrálást és -gyűjteményt. Ha szükséges, a futtatás felgyorsít Azure Database Migration Service több példánya is használható.

    Megadhat egy szegmenskulcsot is, hogy kihasználja a horizontális particionálás előnyeit a Azure Cosmos DB méretezhetőség érdekében. Tekintse át a szegmens/partíciókulcs kiválasztásának ajánlott eljárásait.

    Képernyőkép a gyűjteménytáblák kiválasztásáról.

  4. Kattintson a Mentés gombra.

  5. A migrálás összegzése képernyő Tevékenység neve szövegbeviteli mezőjében adja meg a migrálási tevékenység nevét.

    A nigrálás összegzését bemutató képernyőkép.

A migrálás futtatása

Válassza a Migrálás futtatása lehetőséget. Megjelenik a migrálási tevékenység ablaka, és a tevékenység állapota Nincs elindítva.

A tevékenység állapotát bemutató képernyőkép.

A migrálás monitorozása

A migrálási tevékenység képernyőjén válassza a Frissítés lehetőséget a megjelenítés frissítéséhez, amíg a migrálás állapota Befejezve nem lesz.

Megjegyzés

A tevékenység kiválasztásával lekérte az adatbázis- és gyűjteményszintű migrálási metrikák részleteit.

A befejezett tevékenység állapotát bemutató képernyőkép.

Az adatok ellenőrzése a Azure Cosmos DB

A migrálás befejezése után ellenőrizheti a Azure Cosmos DB, hogy az összes gyűjtemény áttelepítése sikeresen megtörtént-e.

Képernyőkép a fiók ellenőrzéséhez Azure Cosmos DB a gyűjtemények sikeres áttelepítésének ellenőrzéséhez.

Migrálás utáni optimalizálás

A MongoDB-adatbázisban tárolt adatok mongoDB-hez Azure Cosmos DB API-ba való áttelepítése után csatlakozhat a Azure Cosmos DB és kezelheti az adatokat. A migrálás utáni optimalizálási lépéseket is elvégezheti. Ezek közé tartozhat az indexelési szabályzat optimalizálása, az alapértelmezett konzisztenciaszint frissítése vagy a globális terjesztés konfigurálása a Azure Cosmos DB számára. További információ: Migrálás utáni optimalizálás.

Következő lépések

Tekintse át a migrálási útmutatót az Azure Database migrálási útmutatóját ismertető dokumentum további forgatókönyveiért.