Konfigurieren von MongoDB Atlas in einer Kopieraktivität

In diesem Artikel wird beschrieben, wie Sie die Kopieraktivität in einer Pipeline verwenden, um Daten aus und nach MongoDB Atlas zu kopieren.

Unterstützte Konfiguration

Für die Konfiguration der einzelnen Registerkarten unter Kopieraktivität wechseln Sie zu den folgenden Abschnitten.

• Allgemein
• Quelle
• Ziel
• Abbildung
• Einstellungen

Allgemein

Informationen zum Konfigurieren der Registerkarte "Allgemeine Einstellungen" finden Sie unter "Allgemeine Einstellungen".

Quelle

Wechseln Sie zur Registerkarte " Quelle ", um ihre Kopieraktivitätsquelle zu konfigurieren. Die detaillierte Konfiguration finden Sie in den folgenden Inhalten.

Die folgenden Eigenschaften sind erforderlich:

• Verbindung: Wählen Sie eine MongoDB Atlas-Verbindung aus der Verbindungsliste aus. Wenn keine Verbindung vorhanden ist, erstellen Sie eine neue MongoDB Atlas-Verbindung.
• Datenbank: Wählen Sie Ihre Datenbank aus der Dropdownliste aus.
• Sammlungsname: Geben Sie den Namen der Auflistung in der MongoDB Atlas-Datenbank an. Sie können die Sammlung aus der Dropdownliste auswählen oder "Bearbeiten" auswählen, um sie manuell einzugeben.
• Version: Die von Ihnen angegebene Version. Empfehlen Sie ein Upgrade auf die neueste Version, um die neuesten Verbesserungen zu nutzen. Informationen zum Unterschied zwischen verschiedenen Versionen finden Sie in diesem Abschnitt.

Unter "Erweitert" können Sie die folgenden Felder angeben:

• Filter: Gibt den Auswahlfilter mithilfe von Abfrageoperatoren an. Wenn Sie alle Dokumente in einer Auflistung zurückgeben möchten, lassen Sie diesen Parameter aus, oder übergeben Sie ein leeres Dokument ({}).

• Cursormethoden: Wählen Sie + New, um anzugeben, wie die zugrunde liegende Abfrage auszuführen ist. Die Möglichkeiten zum Ausführen von Abfragen sind:

  • Projekt: Gibt die Felder an, die in den Dokumenten für die Projektion zurückgegeben werden sollen. Um alle Felder in den übereinstimmenden Dokumenten zurückzugeben, lassen Sie diesen Parameter aus.
  • sort: Gibt die Reihenfolge an, in der die Abfrage übereinstimmende Dokumente zurückgibt. Verweisen Sie auf cursor.sort().
  • limit: Gibt die maximale Anzahl von Dokumenten an, die der Server zurückgibt. Verweisen Sie auf cursor.limit().
  • skip: Gibt die Anzahl der dokumente an, die übersprungen werden sollen, und von wo mongoDB Atlas beginnt, Ergebnisse zurückzugeben. Verweisen Sie auf cursor.skip().

• Batchgröße: Gibt die Anzahl der Dokumente an, die in jedem Batch der Antwort von der MongoDB Atlas-Instanz zurückgegeben werden sollen. In den meisten Fällen wirkt sich das Ändern der Batchgröße nicht auf den Benutzer oder die Anwendung aus.

• Zusätzliche Spalten: Fügen Sie zusätzliche Datenspalten hinzu, um den relativen Pfad oder statischen Wert der Quelldateien zu speichern. Der Ausdruck wird für letzteres unterstützt.

Bestimmungsort

Wechseln Sie zur Registerkarte "Ziel", um ihr Kopieraktivitätsziel zu konfigurieren. Die detaillierte Konfiguration finden Sie in den folgenden Inhalten.

Die folgenden Eigenschaften sind erforderlich:

• Verbindung: Wählen Sie eine MongoDB Atlas-Verbindung aus der Verbindungsliste aus. Wenn keine Verbindung vorhanden ist, erstellen Sie eine neue MongoDB Atlas-Verbindung.
• Datenbank: Wählen Sie Ihre Datenbank aus der Dropdownliste aus.
• Sammlungsname: Geben Sie den Namen der Auflistung in der MongoDB Atlas-Datenbank an. Sie können die Sammlung aus der Dropdownliste auswählen oder "Bearbeiten" auswählen, um sie manuell einzugeben.

Unter "Erweitert" können Sie die folgenden Felder angeben:

• Schreibverhalten: Beschreibt, wie Daten in MongoDB Atlas geschrieben werden. Zulässige Werte: Einfügen und Upsert.

  Das Verhalten von Upsert besteht darin, das Dokument zu ersetzen, wenn ein Dokument mit demselben _id bereits vorhanden ist. Andernfalls fügen Sie das Dokument ein.

  Hinweis

  Der Dienst generiert automatisch ein _id für ein Dokument, wenn ein _id weder im Originaldokument noch durch Spaltenzuordnung angegeben ist. Dies bedeutet, dass Sie sicherstellen müssen, dass Upsert wie erwartet funktioniert und Ihr Dokument über eine ID verfügt.

• Batchtimeout schreiben: Geben Sie die Wartezeit an, bis der Batcheinfügevorgang abgeschlossen werden soll, bevor ein Timeout auftritt. Der zulässige Wert ist Zeitbereich.

• Schreib-Batchgröße: Diese Eigenschaft steuert die Größe von Dokumenten, die in jedem Batch geschrieben werden. Sie können versuchen, den Wert zu erhöhen, um die Leistung zu verbessern und den Wert zu verringern, wenn die Dokumentgröße groß ist.

Tip

Informationen zum Importieren von JSON-Dokumenten in unveränderter Form finden Sie im Abschnitt Importieren oder Exportieren von JSON-Dokumenten. Informationen zum Kopieren aus tabellarisch strukturierten Daten finden Sie unter Schemazuordnung.

Zuordnung

Informationen zur Konfiguration der Registerkarte " Zuordnung " finden Sie unter "Konfigurieren Ihrer Zuordnungen" auf der Registerkarte "Zuordnung". Die Zuordnung wird nicht unterstützt, wenn sowohl Quell- als auch Zieldaten hierarchische Daten sind.

Einstellungen

Wechseln Sie für die Konfiguration der Registerkarte "Einstellungen " auf der Registerkarte "Einstellungen" zu "Andere Einstellungen konfigurieren".

Importieren und Exportieren von JSON-Dokumenten

Sie können diesen MongoDB Atlas-Connector verwenden, um die folgenden Aufgaben auf einfache Weise zu erledigen:

• Dokumente zwischen zwei MongoDB Atlas-Sammlungen unverändert kopieren.
• Importieren Sie JSON-Dokumente aus verschiedenen Quellen in MongoDB Atlas, einschließlich aus Azure Cosmos DB, Azure Blob-Speicher, Azure Data Lake Store und anderen unterstützten dateibasierten Speicher.
• Exportieren von JSON-Dokumenten aus einer MongoDB Atlas-Sammlung in verschiedene dateibasierte Speicher.

Um eine solche schemaagnostische Kopie zu erreichen, überspringen Sie die Schemazuordnung in Kopieraktivitäten.

Datentypzuordnung für MongoDB Atlas

Beim Kopieren von Daten aus dem MongoDB Atlas werden die folgenden Zuordnungen von MongoDB Atlas-Datentypen zu den internen Zwischendatentypen verwendet, die vom Dienst genutzt werden.

MongoDB Atlas-Datentyp	Zwischendienstdatentyp (für Version 1.1)	Zwischendienstdatentyp (für Version 1.0)
Datum	DateTime	String
Objekt-ID	String	String
Dezimal128	String	String
Zeitstempel	Die wichtigsten 32 Bits –> DateTime Die niedrigstwertigen 32 Bits -> Int32	Die wichtigsten 32 Bits -> Int64 Die niedrigstwertigen 32 Bits -> Int64
String	String	String
Double	Double	String
Int32	Int32	String
Int64	Int64	String
Boolean	Boolean	Boolean
Null	Null	Null
JavaScript	String	String
Regulärer Ausdruck	String	String
Min-Taste	String	Int64
Max-Taste	String	Int64
Binary	GUID (wenn SubType "04" ist) String	String

Unterschiede zwischen MongoDB Atlas-Versionen

Die folgende Tabelle zeigt die Featureunterschiede zwischen verschiedenen Versionen.

Version 1.1	Version 1.0
Die folgenden Zuordnungen werden von den MongoDB Atlas-Datentypen zu den Zwischendienst-Datentypen verwendet. Datum -> Datum und Uhrzeit TimeStamp (die wichtigsten 32 Bits) –> DateTime TimeStamp (die am wenigsten signifikanten 32 Bits) -> Int32 Doppel -> Doppel Int32 -> Int32 Int64 -> Int64 Min-Taste –> String Max.-Taste –> Zeichenfolge Binary -> GUID (wenn SubType "04" ist) / Zeichenfolge	Die folgenden Zuordnungen werden von den MongoDB Atlas-Datentypen zu den Zwischendienst-Datentypen verwendet. Datum -> Zeichenfolge TimeStamp (die wichtigsten 32 Bits) -> Int64 TimeStamp (die niederwertigsten 32 Bits) -> Int64 Double -> String Int32 –> Zeichenfolge Int64 –> Zeichenfolge Min-Taste -> Int64 Maximalschlüssel -> Int64 > Binär - Zeichenfolge

Tabellenzusammenfassung

Die folgende Tabelle enthält weitere Informationen zur Kopieraktivität in MongoDB Atlas.

Quellinformationen

Name	Description	Wert	Erforderlich	JSON-Skripteigenschaft
Verbindung	Ihre Verbindung zum Quelldatenspeicher.	< Ihre MongoDB Atlas-Verbindung >	Yes	connection
Datenbank	Ihre Datenbank, die Sie als Quelle verwenden.	< Ihre Datenbank >	Yes	Datenbank
Sammlungsname	Name der Sammlung in der MongoDB Atlas-Datenbank.	< Ihre Sammlung >	Yes	Sammlung
Version	Die von Ihnen angegebene Version.	• 1.1 • 1.0	Yes	Version: • 1.1 • 1.0
Filter	Der Auswahlfilter mithilfe von Abfrageoperatoren. Wenn Sie alle Dokumente in einer Auflistung zurückgeben möchten, lassen Sie diesen Parameter aus, oder übergeben Sie ein leeres Dokument ({}).	< Ihr Auswahlfilter >	Nein	Filter
Cursormethoden	Die Art und Weise, wie die zugrunde liegende Abfrage ausgeführt wird.	• Projekt • Sortieren • Limit • überspringen	Nein	cursorMethods: •Projekt •sortieren •Grenze •hüpfen
Losgröße	Die Anzahl der Dokumente, die in jedem Batch der Antwort von der MongoDB Atlas-Instanz zurückgegeben werden sollen.	< Ihre Schreibbatch-Größe > (Der Standardwert ist 100)	Nein	batchSize
Zusätzliche Spalten	Fügen Sie zusätzliche Datenspalten hinzu, um den relativen Pfad oder statischen Wert der Quelldateien zu speichern. Der Ausdruck wird für letzteres unterstützt.	•Namen •Wert	Nein	zusätzlicheSpalten: •Name •Wert

Zielinformationen

Name	Description	Wert	Erforderlich	JSON-Skripteigenschaft
Verbindung	Ihre Verbindung mit dem Zieldatenspeicher.	< Ihre MongoDB Atlas-Verbindung >	Yes	connection
Datenbank	Ihre Datenbank, die Sie als Ziel verwenden.	< Ihre Datenbank >	Yes	Datenbank
Sammlungsname	Name der Sammlung in der MongoDB Atlas-Datenbank.	< Ihre Sammlung >	Yes	Sammlung
Schreibverhalten	Beschreibt, wie Daten in MongoDB Atlas geschrieben werden. Zulässige Werte: Einfügen und Upsert. Das Verhalten von Upsert besteht darin, das Dokument zu ersetzen, wenn ein Dokument mit demselben _id bereits vorhanden ist. Andernfalls fügen Sie das Dokument ein. Hinweis: Der Dienst generiert automatisch ein _id, wenn _id weder im Originaldokument noch durch Spaltenzuordnung spezifiziert ist. Dies bedeutet, dass Sie sicherstellen müssen, dass Upsert wie erwartet funktioniert und Ihr Dokument über eine ID verfügt.	• Einfügen (Standard) • Upsert	Nein	writeBehavior: •einfügen • Upsert (Aktualisieren oder Einfügen)
Schreiben eines Batch-Timeouts	Die Wartezeit, bis der Batcheinfügevorgang abgeschlossen ist, bevor ein Timeout eintritt.	timespan (Der Standardwert ist 00:30:00 - 30 Minuten)	Nein	writeBatchTimeout
Batchgröße festlegen	Steuert die Größe von Dokumenten, die in jedem Batch geschrieben werden sollen. Sie können versuchen, diesen Wert zu erhöhen, um die Leistung zu verbessern und den Wert zu verringern, wenn die Dokumentgröße groß ist.	< Ihre Schreibbatch-Größe >	Nein	writeBatchSize

Verwandte Inhalte

• Übersicht über den MongoDB Atlas Connector