Beim Migrationsverfahren wird die gcloud CLI verwendet, um die Migrationsschritte zu konfigurieren und auszuführen. Installieren Sie bei Bedarf die gcloud CLI, indem Sie der Anleitung auf der Seite gcloud CLI installieren folgen.
Quellspezifische Konfiguration
MongoDB auf Compute Engine
Eine MongoDB-Datenbank, die auf Compute Engine-VMs in einem selbstverwalteten Cluster ausgeführt wird, ist normalerweise nicht für das öffentliche Internet zugänglich. Beim Migrationsverfahren wird Private Service Connect in Datastream verwendet, um die Datastream-Pipeline mit Ihrer Quelldatenbank zu verbinden.
Notieren Sie den Configuration ID-Parameter der erstellten Konfiguration. Sie verwenden sie später, um die erforderlichen Umgebungsvariablen einzurichten.
Auf Amazon DocumentDB-Cluster kann nicht direkt von außerhalb des Amazon VPC-Netzwerk zugegriffen werden. Wenn Sie eine Verbindung zu einem DocumentDB-Cluster herstellen möchten, müssen Sie eine EC2-Instanz im Amazon VPC-Netzwerk bereitstellen und diese Instanz als Bastion Host für einen SSH-Tunnel verwenden.
Um eine Verbindung zum DocumentDB-Cluster herzustellen, müssen Sie den privaten SSH-Schlüssel für die EC2-Instanz sowie das entsprechende Zertifikatbündel für die Region abrufen, in der Ihr Cluster bereitgestellt wird. Rufen Sie die Ressourcenseite Certificate bundles by AWS Region (Zertifikatspakete nach AWS-Region) auf, um das entsprechende Paket im PEM-Format herunterzuladen.
Das Zertifikatsbündel enthält mehrere Zertifikate. Sie müssen ein einzelnes Zertifikat extrahieren, um eine Datastream-Verbindung einzurichten. Es wird empfohlen, die DocumentDB-Verbindung manuell zu validieren, um sicherzustellen, dass Sie sowohl einen gültigen SSH-Schlüssel als auch ein gültiges DocumentDB-Zertifikat aus dem regionalen Bundle haben. In der DocumentDB-Entwicklerdokumentation finden Sie Befehlszeilenbeispiele für das Herstellen einer direkten Verbindung von außerhalb der VPC.
Firestore-Datenbank mit MongoDB-Kompatibilität als Ziel konfigurieren
Ihr Projekt muss eine Firestore-Datenbank mit MongoDB-Kompatibilität haben, in die Sie Daten aus Ihrer MongoDB-Quelldatenbank migrieren. Weitere Informationen zum Erstellen einer Datenbank finden Sie unter Datenbanken erstellen und verwalten.
Für diese Migration empfehlen wir, einen Nutzernamen und ein Passwort für die Firestore-Datenbank mit MongoDB-Kompatibilität zu erstellen, die mit dem SCRAM-SHA-256-Authentifizierungsprotokoll verwendet werden sollen. Dieser Nutzername kann nach Abschluss der Migration gefahrlos gelöscht werden. Sie können diese Anmeldedaten aber auch weiterhin verwenden, um Ihre Mongo-Clients mit Ihrer neuen Firestore-Datenbank mit MongoDB-Kompatibilität zu verbinden.
Sie benötigen den Namen dieser Firestore-Datenbank mit MongoDB-Kompatibilität und die Nutzeranmeldedaten in späteren Schritten.
Größe des Oplog-Fensters der Quelldatenbank anpassen
Wir empfehlen, das Oplog-Fenster Ihrer Quell-MongoDB auf drei Tage des gesamten Schreibzugriffs auf diese Datenbank einzustellen. Wenn die Rate des Schreibzugriffs die Rate übersteigt, mit der Datastream Änderungen aus Ihrer Datenbank verarbeiten kann, wird durch diese Anpassung ein Datenverlust verhindert.
Der Wert muss möglicherweise noch weiter angepasst werden, je nach Trafficmuster und Volumen des Spitzen-Traffics. Wenn beispielsweise der Traffic einer Woche in kurzer Zeit geschrieben wird, erfasst Datastream die Änderungen möglicherweise nicht schnell genug aus dem Oplog, bevor sie aus dem Oplog-Fenster fallen. In diesem Fall müssen Sie möglicherweise die Größe des Oplog-Fensters auf 7 Tage des gesamten Schreibverkehrs anpassen.
Cloud Storage-Bucket erstellen
So erstellen Sie einen neuen Cloud Storage-Bucket:
Wählen Sie eine Cloud Storage-Region aus, in der die Migrationspipeline ausgeführt werden soll. Wir empfehlen, die Region zu verwenden, in der sich Ihre Firestore-Datenbank mit MongoDB-Kompatibilität befindet.
Wählen Sie einen Namen für diesen Bucket aus. Beispiel: mongo-migration-bucket. Sie benötigen diesen Namen in späteren Schritten.
Erstellen Sie einen neuen Cloud Storage-Bucket mit dem ausgewählten Namen und in der ausgewählten Region. Folgen Sie dazu der Anleitung auf der Seite Bucket erstellen in der Cloud Storage-Dokumentation.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[],[],null,["# Configure resources for migration\n=================================\n\nThis page describes the preparation part of the\n[migration process](/firestore/mongodb-compatibility/docs/migrate-data)\nwhere you configure resources for the migration.\n\nAt this stage, you do the following:\n\n1. Install command-line tools required for running commands at later stages of the migration process.\n2. Configure Firestore with MongoDB compatibility database.\n3. (Optional) Adjust the operation log (oplog) settings on your MongoDB compatible source.\n4. Create a Cloud Storage bucket for intermediate data storage.\n\nConfigure IAM permissions\n-------------------------\n\nYour account requires appropriate IAM roles in all\nservices used in the migration process:\n\n- [Datastream roles](/iam/docs/roles-permissions/datastream)\n- [Dataflow roles](/dataflow/docs/concepts/access-control)\n- [Cloud Storage roles](/storage/docs/access-control/iam-roles)\n- [Datastore roles](/datastore/docs/access/iam)\n\nInstall command-line tools\n--------------------------\n\nThe migration procedure uses the gcloud CLI to configure and\nactuate the migration steps. If required, install the gcloud CLI by\nfollowing instructions on the [Install the gcloud CLI](/sdk/docs/install) page.\n\nSource-specific configuration\n-----------------------------\n\n### MongoDB on Compute Engine\n\nA MongoDB database that runs on Compute Engine VMs in a self-managed\ncluster isn't normally exposed to the public internet. The migration\nprocedure will use\n[Private Service Connect in Datastream](/datastream/docs/psc-interfaces)\nto connect the Datastream pipeline to your source database.\n\nDo the following:\n\n1. Configure Datastream Private Connectivity by following\n instructions outlined in\n [Create a private connectivity configuration](/datastream/docs/create-a-private-connectivity-configuration#create-the-configuration).\n\n2. Note the `Configuration ID` parameter of the created configuration. You\n will use it in later stages to set up required environment variables.\n\n### Azure Cosmos DB\n\nMake sure that\n[Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest)\nis installed on your computer.\n\n### Amazon DocumentDB\n\nAmazon DocumentDB clusters are not directly accessible from outside the Amazon\nVPC network. To connect to a DocumentDB cluster you will have to provision\nan EC2 instance within the Amazon VPC network, and use that instance as a\n[Bastion Host](https://en.wikipedia.org/wiki/Bastion_host) for an SSH tunnel.\n\nVisit the [Connecting to an Amazon DocumentDB cluster from outside an Amazon VPC](https://docs.aws.amazon.com/documentdb/latest/developerguide/connect-from-outside-a-vpc.html) developer guide for instructions on setting\nup an EC2 instance for external connectivity to DocumentDB.\n\nTo establish a connection to the DocumentDB cluster you will have to obtain\nthe private SSH key for the EC2 instance as well as the appropriate\nCertificate Bundle for the region in which your cluster is deployed. Visit the\n[Certificate bundles by AWS Region](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html#UsingWithRDS.SSL.CertificatesAllRegions)\nresource page to download the appropriate bundle in PEM format.\n\nNote that the Certificate Bundle contains multiple certificates. You have to\nextract a single certificate to set up the a Datastream connection. It is\nrecommended that you validate the DocumentDB connectivity manually to ensure\nthat you have both a valid SSH key and a valid DocumentDB certificate from\nthe regional bundle. The DocumentDB [developer guide](https://docs.aws.amazon.com/documentdb/latest/developerguide/connect-from-outside-a-vpc.html) provides commandline examples for establish a direct connection from outside\nthe VPC.\n\nConfigure a destination Firestore with MongoDB compatibility database\n---------------------------------------------------------------------\n\n1. Make sure that your project has a Firestore with MongoDB\n compatibility database where you will migrate data\n from your source Mongo database. For more information about creating a\n database, see\n [Create and manage databases](/firestore/mongodb-compatibility/docs/create-databases).\n\n2. For the purpose of this migration, we recommend to\n [create a username and password](/firestore/mongodb-compatibility/docs/connect#scram)\n for the Firestore with MongoDB compatibility database to\n use with the SCRAM-SHA-256 authentication protocol. This username can be\n safely deleted after the migration completes, or you may choose to keep\n using these credentials to connect your Mongo clients to your new\n Firestore with MongoDB compatibility database.\n\nYou will use the name of this Firestore with MongoDB\ncompatibility database and the user credentials in later steps.\n\nAdjust the oplog window size of the source database\n---------------------------------------------------\n\nWe recommend to adjust the oplog window of your source Mongo database to 3 days\nworth of total write traffic to this database. If the rate of write traffic\nexceeds the rate at which Datastream can consume changes from\nyour database, this adjustment will prevent data loss.\n\nThe value might need to be adjusted further, depending on the pattern of the\ntraffic and the volume of peak traffic. For example, if a week's worth of\ntraffic is written in a short period of time, then Datastream\nmight not capture the changes from the oplog fast enough before changes fall\nout of the oplog window. In this case you might need to resize the oplog window\nto 7 days worth of total write traffic.\n\nCreate a Cloud Storage bucket\n-----------------------------\n\nCreate a new Cloud Storage bucket in the following way:\n\n1. Choose a [Cloud Storage region](/storage/docs/locations) where the\n migration pipeline will run. We recommend to use the region where your\n destination Firestore with MongoDB compatibility database\n is located.\n\n2. Choose the name for this bucket. Example: `mongo-migration-bucket`. You will\n use this name in later steps.\n\n3. Create a new Cloud Storage bucket with the chosen name and in the\n chosen region by following instructions provided on the\n [Create a bucket](/storage/docs/creating-buckets#create-bucket) page in\n the Cloud Storage documentation.\n\nWhat's next\n-----------\n\nProceed to\n[Configure environment variables](/firestore/mongodb-compatibility/docs/migrate-configure-env-vars)."]]
