Självstudie: Migrera MongoDB till Azure Cosmos DB s API för MongoDB offline med DMSTutorial: Migrate MongoDB to Azure Cosmos DB's API for MongoDB offline using DMS

Du kan använda Azure Database Migration Service för att utföra en migrering offline (eng ång slö sen) av databaser från en lokal eller moln instans av MongoDB till Azure Cosmos DB s API för MongoDB.You can use Azure Database Migration Service to perform an offline (one-time) migration of databases from an on-premises or cloud instance of MongoDB to Azure Cosmos DB's API for MongoDB.

I den här guiden får du lära dig att:In this tutorial, you learn how to:

  • Skapa en instans av Azure Database Migration Service.Create an instance of Azure Database Migration Service.
  • Skapa ett migreringsjobb med hjälp av Azure Database Migration Service.Create a migration project by using Azure Database Migration Service.
  • Köra migreringen.Run the migration.
  • Övervaka migreringen.Monitor the migration.

I den här självstudien migrerar du en data uppsättning i MongoDB som finns på en virtuell Azure-dator till Azure Cosmos DB API för MongoDB med hjälp av Azure Database Migration Service.In this tutorial, you migrate a dataset in MongoDB hosted in an Azure Virtual Machine to Azure Cosmos DB's API for MongoDB by using Azure Database Migration Service. Om du inte har konfigurerat någon MongoDB-källa, kan du läsa artikeln Installera och konfigurera MongoDB på en virtuell Windows-dator i Azure.If you don't have a MongoDB source set up already, see the article Install and configure MongoDB on a Windows VM in Azure.

KravPrerequisites

För att slutföra den här kursen behöver du:To complete this tutorial, you need to:

  • Slutför stegen innan migreringen , till exempel genom att uppskatta data flödet, välja en partitionsnyckel och indexerings principen.Complete the pre-migration steps such as estimating throughput, choosing a partition key, and the indexing policy.

  • Skapa ett Azure Cosmos DB-API för MongoDB-konto.Create an Azure Cosmos DB's API for MongoDB account.

  • Skapa en Microsoft Azure Virtual Network för Azure Database Migration Service med hjälp av Azure Resource Manager distributions modell, som tillhandahåller plats-till-plats-anslutning till dina lokala käll servrar genom att använda antingen ExpressRoute eller VPN.Create a Microsoft Azure Virtual Network for Azure Database Migration Service by using Azure Resource Manager deployment model, which provides site-to-site connectivity to your on-premises source servers by using either ExpressRoute or VPN. Mer information om hur du skapar ett virtuellt nätverk finns i Virtual Network-dokumentationenoch i synnerhet snabb starts artiklar med stegvisa anvisningar.For more information about creating a virtual network, see the Virtual Network Documentation, and especially the quickstart articles with step-by-step details.

    Anteckning

    Om du använder ExpressRoute med nätverks-peering till Microsoft under installationen av det virtuella nätverket lägger du till följande tjänst slut punkter i under nätet där tjänsten ska tillhandahållas:During virtual network setup, if you use ExpressRoute with network peering to Microsoft, add the following service endpoints to the subnet in which the service will be provisioned:

    • Slut punkt för mål databas (till exempel SQL-slutpunkt, Cosmos DB slut punkt och så vidare)Target database endpoint (for example, SQL endpoint, Cosmos DB endpoint, and so on)
    • Lagrings slut punktStorage endpoint
    • Service Bus-slutpunktService bus endpoint

    Den här konfigurationen är nödvändig eftersom Azure Database Migration Service saknar Internet anslutning.This configuration is necessary because Azure Database Migration Service lacks internet connectivity.

  • Se till att dina regler för nätverks säkerhets gruppen (NSG) för virtuella nätverk inte blockerar följande kommunikations portar: 53, 443, 445, 9354 och 10000-20000.Ensure that your virtual network Network Security Group (NSG) rules don't block the following communication ports: 53, 443, 445, 9354, and 10000-20000. Mer information om NSG för trafik filtrering i virtuellt nätverk finns i artikeln filtrera nätverks trafik med nätverks säkerhets grupper.For more detail on virtual network NSG traffic filtering, see the article Filter network traffic with network security groups.

  • Öppna Windows-brandväggen för att tillåta Azure Database Migration Service att få åtkomst till MongoDB-servern, som standard är TCP-port 27017.Open your Windows firewall to allow Azure Database Migration Service to access the source MongoDB server, which by default is TCP port 27017.

  • När du använder en brand Väggs installation framför dina käll databaser, kan du behöva lägga till brand Väggs regler för att tillåta Azure Database Migration Service åtkomst till käll databaserna för migrering.When using a firewall appliance in front of your source database(s), you may need to add firewall rules to allow Azure Database Migration Service to access the source database(s) for migration.

Registrera resursprovidern Microsoft.DataMigrationRegister the Microsoft.DataMigration resource provider

  1. Logga in på Azure Portal och välj Alla tjänster och sedan Prenumerationer.Sign in to the Azure portal, select All services, and then select Subscriptions.

    Visa portalprenumerationer

  2. Välj den prenumeration där du vill skapa en instans av Azure Database Migration Service och välj sedan Resursprovidrar.Select the subscription in which you want to create the instance of the Azure Database Migration Service, and then select Resource providers.

    Visa resursprovidrar

  3. Sök efter migrering och välj sedan Registrera till höger om Microsoft. data migration.Search for migration, and then to the right of Microsoft.DataMigration, select Register.

    Registrera resursprovider

Skapa en instansCreate an instance

  1. I Azure Portal väljer du + Skapa en resurs, söker efter Azure Database Migration Service och väljer sedan Azure Database Migration Service i listrutan.In the Azure portal, select + Create a resource, search for Azure Database Migration Service, and then select Azure Database Migration Service from the drop-down list.

    Azure Marketplace

  2. På sidan Azure Database Migration Service väljer du Skapa.On the Azure Database Migration Service screen, select Create.

    Skapa Azure Database Migration Service-instans

  3. På sidan Create Migration Service anger du ett namn för tjänsten, prenumerationen och en ny eller befintlig resursgrupp.On the Create Migration Service screen, specify a name for the service, the subscription, and a new or existing resource group.

  4. Välj den plats där du vill skapa instansen av Azure Database Migration Service.Select the location in which you want to create the instance of Azure Database Migration Service.

  5. Välj ett befintligt virtuellt nätverk eller skapa ett nytt.Select an existing virtual network or create a new one.

    Det virtuella nätverket ger Azure Database Migration Service åtkomst till käll MongoDB-instansen och mål Azure Cosmos DB kontot.The virtual network provides Azure Database Migration Service with access to the source MongoDB instance and the target Azure Cosmos DB account.

    Mer information om hur du skapar ett virtuellt nätverk i Azure Portal finns i artikeln skapa ett virtuellt nätverk med hjälp av Azure Portal.For more information about how to create a virtual network in the Azure portal, see the article Create a virtual network using the Azure portal.

  6. Välj en prisnivå.Select a pricing tier.

    Mer information om kostnader och prisnivåer finns på sidan med priser.For more information on costs and pricing tiers, see the pricing page.

    Konfigurera Azure Database Migration Service-instansinställningar

  7. Välj Skapa för att skapa tjänsten.Select Create to create the service.

Skapa ett migreringsprojektCreate a migration project

När tjänsten har skapats letar du reda på den i Azure Portal, öppnar den och skapar sedan ett nytt migreringsprojekt.After the service is created, locate it within the Azure portal, open it, and then create a new migration project.

  1. I Azure Portal väljer du Alla tjänster, söker efter Azure Database Migration Service och väljer sedan Azure Database Migration Services.In the Azure portal, select All services, search for Azure Database Migration Service, and then select Azure Database Migration Services.

    Hitta alla instanser av Azure Database Migration Service

  2. På skärmen Azure Database migration Services söker du efter namnet på Azure Database migration service-instansen som du skapade och väljer sedan instansen.On the Azure Database Migration Services screen, search for the name of Azure Database Migration Service instance that you created, and then select the instance.

  3. Välj + Nytt migreringsprojekt.Select + New Migration Project.

  4. På sidan Nytt migreringsprojekt anger du namnet på projektet. I textrutan Typ av källserver väljer du MongoDB, i textrutan Målservertyp väljer du CosmosDB (MongoDB API) och i Välj typ av aktivitet väljer du sedan Offline-datamigrering.On the New migration project screen, specify a name for the project, in the Source server type text box, select MongoDB, in the Target server type text box, select CosmosDB (MongoDB API), and then for Choose type of activity, select Offline data migration.

    Skapa ett Database Migration Service-projekt

  5. Välj Skapa och kör aktivitet för att skapa projektet och köra migreringsaktiviteten.Select Create and run activity to create the project and run the migration activity.

Ange källinformationSpecify source details

  1. På sidan Källinformation anger du anslutningsinformationen för MongoDB-källservern.On the Source details screen, specify the connection details for the source MongoDB server.

    Viktigt

    Azure Database Migration Service stöder inte Azure Cosmos DB som källa.Azure Database Migration Service does not support Azure Cosmos DB as a source.

    Det finns tre lägen för att ansluta till en datakälla:There are three modes to connect to a source:

    • Standardläge som accepterar ett fullständigt kvalificerat domännamn eller en IP-adress, portnummer och autentiseringsuppgifter för anslutningen.Standard mode, which accepts a fully qualified domain name or an IP address, Port number, and connection credentials.

    • Anslutningssträngsläge som tar emot en MongoDB-anslutningssträng som beskrivs i artikeln URI-anslutningssträngens format.Connection string mode, which accepts a MongoDB Connection string as described in the article Connection String URI Format.

    • Data från Azure-lagring som tar emot en blobcontainers SAS-URL.Data from Azure storage, which accepts a blob container SAS URL. Välj Bloben innehåller BSON-dumpar om blobcontainern innehåller BSON-dumpar som producerats av MongoDB:s bsondump-verktyg och avmarkera den om containern innehåller JSON-filer.Select Blob contains BSON dumps if the blob container has BSON dumps produced by the MongoDB bsondump tool, and de-select it if the container contains JSON files.

      Om du väljer det här alternativet ska du se till att anslutningssträngen för lagringskontot har följande format:If you select this option, be sure that the storage account connection string appears in the format:

      https://blobnameurl/container?SASKEY
      

      Den här BLOB-behållarens SAS-anslutningssträng finns i Azure Storage Explorer.This blob container SAS connection string can be found in Azure Storage explorer. När du skapar SAS för den aktuella behållaren får du URL: en i ovanstående format.Creating the SAS for the concerned container will provide you the URL in above requested format.

      Tänk också på följande när du använder information om typ dump i Azure Storage:Also, based on the type dump information in Azure Storage, keep the following detail in mind.

      • För BSON-dumpar måste data i blob-containern vara i bsondump-format, så att datafilerna placeras i mappar som namnges efter de innehållande databaserna i formatet collection.bson.For BSON dumps, the data within the blob container must be in bsondump format, such that data files are placed into folders named after the containing databases in the format collection.bson. Metadatafiler (om sådana finns) bör namnges med formatet samling.metadata.json.Metadata files (if any) should be named using the format collection.metadata.json.

      • För JSON-dumpar måste filerna i blob-containern placeras i mappar som namnges efter de innehållande databaserna.For JSON dumps, the files in the blob container must be placed into folders named after the containing databases. I varje databasmapp måste datafiler placeras i en undermapp som heter ”data” och namnges med formatet samling.json.Within each database folder, data files must be placed in a subfolder called "data" and named using the format collection.json. Metadatafiler (om sådana finns) måste placeras i en undermapp som heter ”metadata” och namnges med samma format, samling.json.Metadata files (if any) must be placed in a subfolder called "metadata" and named using the same format, collection.json. Metadatafilerna måste vara i samma format som det som skapas av verktyget MongoDB bsondump.The metadata files must be in the same format as produced by the MongoDB bsondump tool.

    Viktigt

    Det rekommenderas inte att använda ett självsignerat certifikat på Mongo-servern.It is discouraged to use a self-signed certificate on the mongo server. Om ett sådant används måste du dock ansluta till servern med anslutnings sträng läge och se till att anslutnings strängen har ""However, if one is used, please connect to the server using connection string mode and ensure that your connection string has “”

    &sslVerifyCertificate=false
    

    Du kan även använda IP-adressen i situationer då DNS-namnmatchning inte är möjlig.You can also use the IP Address for situations in which DNS name resolution isn't possible.

    Ange källinformation

  2. Välj Spara.Select Save.

Ange målinformationSpecify target details

  1. På sidan Information om migreringsmål anger du anslutningsinformationen för Azure Cosmos DB-målkontot, vilket är det företablerade Azure Cosmos DB-API för MongoDB-kontot som du ska migrera dina MongoDB-data till.On the Migration target details screen, specify the connection details for the target Azure Cosmos DB account, which is the pre-provisioned Azure Cosmos DB's API for MongoDB account to which you're migrating your MongoDB data.

    Ange målinformation

  2. Välj Spara.Select Save.

Mappa till måldatabaserMap to target databases

  1. På skärmen Mappa till måldatabaser mappar du käll- och måldatabasen för migreringen.On the Map to target databases screen, map the source and the target database for migration.

    Om mål databasen innehåller samma databas namn som käll databasen Azure Database Migration Service väljer mål databasen som standard.If the target database contains the same database name as the source database, Azure Database Migration Service selects the target database by default.

    Om strängen create visas bredvid databas namnet, betyder det att Azure Database migration service inte har hittat mål databasen, och tjänsten kommer att skapa databasen åt dig.If the string Create appears next to the database name, it indicates that Azure Database Migration Service didn't find the target database, and the service will create the database for you.

    I det här läget i migreringen, kan du etablera ett dataflöde.At this point in the migration, you can provision throughput. I Cosmos DB kan du etablera dataflöden på databasnivå eller separat för varje samling.In Cosmos DB, you can provision throughput either at the database-level or individually for each collection. Dataflödet mäts i enheter för programbegäran (RU:er).Throughput is measured in Request Units (RUs). Mer information om Azure Cosmos DB-prissättning.Learn more about Azure Cosmos DB pricing.

    Mappa till måldatabaser

  2. Välj Spara.Select Save.

  3. På skärmen Mängdinställning expanderar du samlingslistan och granskar sedan listan över de samlingar som ska migreras.On the Collection setting screen, expand the collections listing, and then review the list of collections that will be migrated.

    Azure Database Migration Service väljer automatiskt alla samlingar som finns på käll MongoDB-instansen som inte finns på mål Azure Cosmos DB kontot.Azure Database Migration Service auto selects all the collections that exist on the source MongoDB instance that don't exist on the target Azure Cosmos DB account. Om du vill migrera samlingar som redan innehåller data på nytt, måste du uttryckligen välja samlingarna på det här bladet.If you want to remigrate collections that already include data, you need to explicitly select the collections on this blade.

    Du kan ange hur många RU:er som du vill att samlingarna ska använda.You can specify the amount of RUs that you want the collections to use. Azure Database Migration Service föreslår smarta standardvärden baserat på samlingens storlek.Azure Database Migration Service suggests smart defaults based on the collection size.

    Anteckning

    Utför migreringen och insamling av databasen parallellt med flera instanser av Azure Database Migration Service, om det behövs, för att påskynda körningen.Perform the database migration and collection in parallel using multiple instances of Azure Database Migration Service, if necessary, to speed up the run.

    Du kan också ange en shardnyckel för att kunna utnyttja partitionering i Azure Cosmos DB för optimal skalbarhet.You can also specify a shard key to take advantage of partitioning in Azure Cosmos DB for optimal scalability. Läs igenom metodtipsen för att välja en shard-/partitionsnyckel.Be sure to review the best practices for selecting a shard/partition key.

    Välja tabeller för samlingar

  4. Välj Spara.Select Save.

  5. På sidan Migreringssammanfattning, i textrutan Aktivitetsnamn anger du ett namn på migreringsaktiviteten.On the Migration summary screen, in the Activity name text box, specify a name for the migration activity.

    Migreringssammanfattning

Köra migreringenRun the migration

  • Välj Kör migrering.Select Run migration.

    Migreringsaktivitetsfönstret visas och Status för aktiviteten är Inte startad.The migration activity window appears, and the Status of the activity is Not started.

    Aktivitetsstatus

Övervaka migreringenMonitor the migration

  • På migreringsaktivitetssidan väljer du Uppdatera för att uppdatera visningen tills Status för migreringen är Slutförd.On the migration activity screen, select Refresh to update the display until the Status of the migration shows as Completed.

    Anteckning

    Du kan välja Aktivitet för att få information om databasens och samlingsnivåns migreringsmått.You can select the Activity to get details of database- and collection-level migration metrics.

    Aktivitetsstatus Slutförd

Kontrollera data i Cosmos DBVerify data in Cosmos DB

  • När migreringen är klar kan du kontrollera ditt Azure Cosmos DB-konto för att se om alla samlingar migrerades korrekt.After the migration completes, you can check your Azure Cosmos DB account to verify that all the collections were migrated successfully.

    Skärm bild som visar var du kan kontrol lera Azure Cosmos DB-kontot för att kontrol lera att alla samlingar har migrerats.

Optimering efter migreringPost-migration optimization

När du har migrerat data som lagras i MongoDB-databasen till Azure Cosmos DB s API för MongoDB, kan du ansluta till Azure Cosmos DB och hantera data.After you migrate the data stored in MongoDB database to Azure Cosmos DB’s API for MongoDB, you can connect to Azure Cosmos DB and manage the data. Du kan också utföra andra optimerings steg efter migrering, till exempel optimera indexerings principen, uppdatera standard konsekvens nivån eller konfigurera global distribution för ditt Azure Cosmos DB-konto.You can also perform other post-migration optimization steps such as optimizing the indexing policy, update the default consistency level, or configure global distribution for your Azure Cosmos DB account. Mer information finns i artikeln optimering efter migreringen .For more information, see the Post-migration optimization article.

Ytterligare resurserAdditional resources

Nästa stegNext steps