Wählen Sie Ihre Cookie-Einstellungen aus

Wir verwenden essentielle Cookies und ähnliche Tools, die für die Bereitstellung unserer Website und Services erforderlich sind. Wir verwenden Performance-Cookies, um anonyme Statistiken zu sammeln, damit wir verstehen können, wie Kunden unsere Website nutzen, und Verbesserungen vornehmen können. Essentielle Cookies können nicht deaktiviert werden, aber Sie können auf „Anpassen“ oder „Ablehnen“ klicken, um Performance-Cookies abzulehnen.

Wenn Sie damit einverstanden sind, verwenden AWS und zugelassene Drittanbieter auch Cookies, um nützliche Features der Website bereitzustellen, Ihre Präferenzen zu speichern und relevante Inhalte, einschließlich relevanter Werbung, anzuzeigen. Um alle nicht notwendigen Cookies zu akzeptieren oder abzulehnen, klicken Sie auf „Akzeptieren“ oder „Ablehnen“. Um detailliertere Entscheidungen zu treffen, klicken Sie auf „Anpassen“.

Migrieren Sie von Couchbase Server zu Couchbase Capella am AWS - AWS Prescriptive Guidance

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Migrieren Sie von Couchbase Server zu Couchbase Capella am AWS

Erstellt von Battulga Purevragchaa (AWS), Mark Gamble und Saurabh Shanbhag () AWS

Übersicht

Couchbase Capella ist ein vollständig verwaltetes Programm ohne SQL Datenbank als Service (DBaaS) für unternehmenskritische Anwendungen (z. B. Benutzerprofile oder Online-Kataloge und Inventarverwaltung). Couchbase Capella verwaltet Ihre DBaaS Arbeitslast in einem von Couchbase verwalteten Amazon Web Services () -Konto. AWS Capella macht es einfach, die Replikation mit mehreren Clustern, mehreren AWS Regionen, Multicloud und Hybrid-Cloud über eine einzige Oberfläche auszuführen und zu verwalten.

Couchbase Capella hilft Ihnen dabei, Ihre Couchbase Server-Anwendungen sofort zu skalieren, sodass Sie innerhalb von Minuten Cluster mit mehreren Knoten erstellen können. Couchbase Capella unterstützt alle Couchbase Server-Funktionen, einschließlich SQL++, Volltextsuche, Eventing Service und Analytics Service. Außerdem entfällt die Notwendigkeit, Installationen, Upgrades, Backups und die allgemeine Datenbankwartung zu verwalten. 

Dieses Muster beschreibt die Schritte und bewährten Methoden für die Migration einer selbstverwalteten Couchbase Server-Umgebung in die Cloud. AWS Das Muster bietet einen wiederholbaren Prozess für die Migration von Daten und Indizes von Couchbase Serverclustern, die entweder vor Ort oder in der Cloud ausgeführt werden, zu Couchbase Capella. Mithilfe dieser Schritte können Sie Probleme bei der Migration vermeiden und den gesamten Migrationsprozess beschleunigen.

Dieses Muster bietet die folgenden zwei Migrationsoptionen:

  • Option 1 ist geeignet, wenn Sie weniger als 50 Indizes migrieren müssen. 

  • Option 2 ist geeignet, wenn Sie mehr als 50 Indizes migrieren müssen. 

Sie können auch Beispieldaten auf Ihrem selbst verwalteten Couchbase-Server einrichten, um sie zusammen mit dem Migrationsleitfaden zu befolgen.

Wenn Sie die Migrationsoption 2 wählen oder Bereiche oder Sammlungen verwenden, die nicht dem Standardwert entsprechen, müssen Sie die Beispielkonfigurationsdatei verwenden, die sich im Abschnitt Zusätzliche Informationen befindet.

Voraussetzungen und Einschränkungen

Voraussetzungen

Für den Migrationsprozess sind außerdem die in der folgenden Tabelle beschriebenen Rollen und Fachkenntnisse erforderlich.

Rolle

Fachwissen

Verantwortlichkeiten

Couchbase-Administrator

  • Vertrautheit mit Couchbase Server und Couchbase Capella

  • Grundkenntnisse in der Befehlszeile sind hilfreich, aber nicht erforderlich

  • Couchbase Server- und Capella-spezifische Aufgaben

Systemadministrator, IT-Administrator

  • Vertrautheit mit der selbstverwalteten Couchbase Server-Systemumgebung und Verwaltung

  • Öffnen von Ports und Ermitteln von IP-Adressen auf selbstverwalteten Couchbase Server-Clusterknoten

Einschränkungen

Produktversionen

Architektur

Quelltechnologie-Stack

  • Couchbase-Server

Zieltechnologie-Stack

  • Couchbase Capella

Zielarchitektur

Die Migration von Couchbase Capella zum Couchbase-Cluster in der Capella-Datenebene erfolgt in vier Schritten. AWS
  1. Sie greifen über die Capella Control Plane auf Couchbase Capella zu. Sie können die Capella Control Plane verwenden, um Folgendes zu tun:

    • Kontrollieren und überwachen Sie Ihr Konto.

    • Verwalten Sie Cluster und Daten, Indizes, Benutzer und Gruppen, Zugriffsberechtigungen, Überwachung und Ereignisse.

  2. Cluster werden erstellt.

  3. Die Capella-Datenebene befindet sich in dem von AWS Couchbase verwalteten Konto. Nachdem Sie einen neuen Cluster erstellt haben, stellt Couchbase Capella ihn in mehreren Availability Zones in der ausgewählten Region bereit. AWS

  4. Sie können Couchbase-Anwendungen in Ihrem Konto entwickeln und bereitstellen. VPC AWS In der Regel wird dabei über VPC Peering auf die Capella-Datenebene zugegriffen. VPC

Tools

  • Couchbase Cross Data Center Replication (XDCR) hilft bei der Replikation von Daten über Cluster hinweg, die sich bei verschiedenen Cloud-Anbietern und verschiedenen Rechenzentren befinden. Es wird verwendet, um Daten aus selbstverwalteten Couchbase Server-Clustern nach Couchbase Capella zu migrieren.

    Anmerkung

    XDCRkann nicht mit Couchbase Server Community Edition für die Migration zu Couchbase Capella verwendet werden. Stattdessen können Sie cbexport verwenden. Weitere Informationen finden Sie im Abschnitt Daten aus der Community Edition migrieren.

  • Couchbase Shell ist eine Befehlszeilen-Shell für Couchbase Server und Couchbase Capella für den Zugriff auf lokale und entfernte Couchbase-Cluster. In diesem Muster wird Couchbase Shell zur Migration von Indizes verwendet.

  • cbexport ist ein Couchbase-Hilfsprogramm zum Exportieren von Daten aus einem Couchbase-Cluster. In den Couchbase Server-Tools enthalten. CLI

Epen

AufgabeBeschreibungErforderliche Fähigkeiten

Bewerten Sie die Größe des selbstverwalteten Couchbase Server-Clusters.

Melden Sie sich bei der Couchbase-Webkonsole für Couchbase Server an und überprüfen Sie die Knoten und Buckets Ihres selbstverwalteten Clusters. 

  1. Um eine Liste der Clusterknoten anzuzeigen, wählen Sie in der Navigationsleiste die Registerkarte Server

  2. Notieren Sie sich die Anzahl der Knoten und wählen Sie dann jeden Knoten in der Liste aus, um seine Eigenschaften anzuzeigen. 

  3. Notieren Sie den Arbeitsspeicher und den Speicherplatz für jeden einzelnen Knoten.

  4. Wählen Sie in der Navigationsleiste die Registerkarte Buckets und wählen Sie dann jeden Bucket in der Liste aus, um dessen Eigenschaften anzuzeigen. Notieren Sie sich das RAM Kontingent und die Einstellung zur Konfliktlösung für jeden Bucket.

Sie verwenden Ihre selbst verwalteten Couchbase Server-Clusterkonfigurationen als allgemeinen Leitfaden für die Dimensionierung und Konfiguration des Zielclusters auf Couchbase Capella.

Wenn Sie Hilfe bei einer detaillierteren Anleitung zur Dimensionierung von Couchbase Capella benötigen, wenden Sie sich an Couchbase.

Couchbase-Administrator

Zeichnen Sie die Couchbase-Dienstverteilung auf dem selbstverwalteten Couchbase Server-Cluster auf.

Couchbase-Administrator

Notieren Sie sich die IP-Adressen der selbstverwalteten Couchbase Server-Clusterknoten.

(Ignorieren Sie diesen Schritt, wenn Sie die Community Edition verwenden.) Notieren Sie sich die IP-Adresse für jeden Knoten in Ihrem Cluster. Sie werden später zur Zulassungsliste auf Ihrem Couchbase Capella-Cluster hinzugefügt.

Couchbase-Administrator, Systemadministrator

Bereiten Sie die Migration vor

AufgabeBeschreibungErforderliche Fähigkeiten

Bewerten Sie die Größe des selbstverwalteten Couchbase Server-Clusters.

Melden Sie sich bei der Couchbase-Webkonsole für Couchbase Server an und überprüfen Sie die Knoten und Buckets Ihres selbstverwalteten Clusters. 

  1. Um eine Liste der Clusterknoten anzuzeigen, wählen Sie in der Navigationsleiste die Registerkarte Server

  2. Notieren Sie sich die Anzahl der Knoten und wählen Sie dann jeden Knoten in der Liste aus, um seine Eigenschaften anzuzeigen. 

  3. Notieren Sie den Arbeitsspeicher und den Speicherplatz für jeden einzelnen Knoten.

  4. Wählen Sie in der Navigationsleiste die Registerkarte Buckets und wählen Sie dann jeden Bucket in der Liste aus, um dessen Eigenschaften anzuzeigen. Notieren Sie sich das RAM Kontingent und die Einstellung zur Konfliktlösung für jeden Bucket.

Sie verwenden Ihre selbst verwalteten Couchbase Server-Clusterkonfigurationen als allgemeinen Leitfaden für die Dimensionierung und Konfiguration des Zielclusters auf Couchbase Capella.

Wenn Sie Hilfe bei einer detaillierteren Anleitung zur Dimensionierung von Couchbase Capella benötigen, wenden Sie sich an Couchbase.

Couchbase-Administrator

Zeichnen Sie die Couchbase-Dienstverteilung auf dem selbstverwalteten Couchbase Server-Cluster auf.

Couchbase-Administrator

Notieren Sie sich die IP-Adressen der selbstverwalteten Couchbase Server-Clusterknoten.

(Ignorieren Sie diesen Schritt, wenn Sie die Community Edition verwenden.) Notieren Sie sich die IP-Adresse für jeden Knoten in Ihrem Cluster. Sie werden später zur Zulassungsliste auf Ihrem Couchbase Capella-Cluster hinzugefügt.

Couchbase-Administrator, Systemadministrator
AufgabeBeschreibungErforderliche Fähigkeiten

Auswahl einer Vorlage.

  1. Melden Sie sich bei Ihrer Couchbase Capella Control Plane an, wählen Sie in der Hauptnavigation die Registerkarte Dashboard oder die Registerkarte Cluster und wählen Sie dann Create Cluster. 

  2. Wählen Sie anhand der Informationen, die Sie bei der Evaluierung Ihres selbstverwalteten Couchbase Server-Clusters aufgezeichnet haben, die Clustervorlage aus, die den Anforderungen der Konfiguration entspricht. Wenn Sie keine geeignete Vorlage finden, wählen Sie im Editor für die Clustergröße die Option Benutzerdefinierte Vorlage aus.

Couchbase-Administrator

Wählen und konfigurieren Sie die Knoten.

Wählen und konfigurieren Sie die Knoten so, dass sie zu Ihrer selbstverwalteten Couchbase Server-Cluster-Umgebung passen, einschließlich der Anzahl der Knoten, der Dienstverteilung, der Rechenleistung und des SpeichersRAM.

Couchbase Capella verwendet bewährte Methoden zur multidimensionalen Skalierung. Dienste und Knoten können nur gemäß den bewährten Bereitstellungsmethoden ausgewählt werden. Dies kann bedeuten, dass Sie die Konfigurationen Ihres selbstverwalteten Couchbase Server-Clusters nicht genau anpassen können.

Couchbase-Administrator

Stellen Sie den Cluster bereit.

Wählen Sie eine Supportzone und ein Supportpaket aus und stellen Sie dann den Cluster bereit. Ausführliche Schritte und Anweisungen finden Sie in der Couchbase-Dokumentation unter Cluster erstellen.

Wichtig

Wenn Sie die kostenlose Testversion von Couchbase Capella verwenden, müssen Sie sie in ein kostenpflichtiges Konto umwandeln, bevor Sie mit der Migration beginnen. Um Ihr Konto zu konvertieren, öffnen Sie in der Couchbase Capella Control Plane den Bereich Abrechnung und wählen Sie dann Aktivierungs-ID hinzufügen. Die Aktivierungs-ID wird an Ihre Rechnungskontakt-E-Mail-Adresse gesendet, nachdem Sie einen Kaufvertrag mit Couchbase Sales abgeschlossen haben oder nachdem Sie einen Kauf über AWS Marketplace getätigt haben.

Couchbase-Administrator

Erstellen Sie einen Benutzer mit Datenbankanmeldedaten.

Ein Benutzer mit Datenbankanmeldedaten ist spezifisch für einen Cluster und besteht aus einem Benutzernamen, einem Passwort und einer Reihe von Bucket-Rechten. Dieser Benutzer ist erforderlich, um Buckets zu erstellen und auf Bucket-Daten zuzugreifen. 

Erstellen Sie in der Couchbase Capella Control Plane Datenbankanmeldedaten für den neuen Cluster, indem Sie den Anweisungen unter Datenbankanmeldedaten konfigurieren in der Couchbase Capella-Dokumentation folgen.

Anmerkung

Einem Organisationsbenutzer müssen Anmeldeinformationen für die Organisationsrolle zugewiesen werden, wenn er entweder remote oder über die Couchbase Capella-Benutzeroberfläche auf Bucket-Daten in einem bestimmten Cluster zugreifen möchte. Dies ist unabhängig von Datenbankanmeldedaten, die normalerweise von Apps und Integrationen verwendet werden. Wenn Sie den Organisationsbenutzer erstellen, können Sie die Ziel-Buckets auf Ihrem Couchbase Capella-Cluster erstellen und verwalten.

Couchbase-Administrator

Wenn Sie die Migrationsoption 2 verwenden, installieren Sie Couchbase Shell.

Sie können Couchbase Shell auf jedem System installieren, das Netzwerkzugriff sowohl auf Ihren selbst verwalteten Couchbase-Server als auch auf die Couchbase Capella-Cluster hat. Weitere Informationen finden Sie unter Installieren von Couchbase Shell Version 1.0.0-beta.5 in der Couchbase Shell-Dokumentation.

Stellen Sie sicher, dass Couchbase Shell installiert ist, indem Sie eine Verbindung zu Ihrem selbstverwalteten Cluster in einem Befehlszeilenterminal testen.

Couchbase-Administrator, Systemadministrator

IP-Adressen zulassen.

  1. Wählen Sie in der Couchbase Capella Control Plane Clusters und dann Ihren Zielcluster aus. 

  2. Wählen Sie die Registerkarte Connect für den Cluster und notieren Sie den Verbindungsendpunkt für Ihren Cluster, der unter Zulässige IP verwalten aufgeführt ist.

  3. Gehen Sie wie folgt vor, um die IP-Adresse für das System, auf dem Sie Couchbase Shell installiert haben, und die IP-Adresse Ihrer selbstverwalteten Couchbase Server-Cluster-Instanzen als zulässige IP-Adressen hinzuzufügen: 

    1. Wählen Sie unter Wide Area Network die Option Zulässige IP verwalten aus. 

    2. Wählen Sie Add Allowed IP, geben Sie die IP-Adresse für das System ein, auf dem Sie Couchbase Shell installiert haben, und wählen Sie dann Add IP. 

    3. Wiederholen Sie den vorherigen Schritt, um die IP-Adresse Ihrer selbstverwalteten Couchbase Server-Clusterinstanz hinzuzufügen. 

Weitere Informationen zu zulässigen IP-Adressen finden Sie unter Zulässige IP-Adressen konfigurieren in der Couchbase-Dokumentation.

Couchbase-Administrator, Systemadministrator

Zertifikate konfigurieren.

  1. Um das Stammzertifikat für Ihren Cluster herunterzuladen, wählen Sie unter Stammzertifikat die Option Herunterladen aus. 

  2. Speichern Sie das Stammzertifikat mit der Dateierweiterung.pem in einem Ordner auf dem System, auf dem Couchbase Shell ausgeführt werden soll.

  3. Melden Sie sich als Nächstes bei Ihrer selbst verwalteten Couchbase Server-Webkonsole an, wählen Sie in der linken Navigationsleiste Sicherheit und dann die Registerkarte Zertifikate.

  4. Kopieren Sie das Stammzertifikat für Ihren selbstverwalteten Couchbase Server-Cluster und speichern Sie es als.pem-Datei in demselben Ordner, in dem Sie die Stammzertifikatsdatei für Ihren Couchbase Capella-Cluster gespeichert haben. Weitere Informationen zum Stammzertifikat finden Sie unter Root-Zertifikat in der Couchbase Server-Dokumentation.

Couchbase-Administrator, Systemadministrator

Erstellen Sie die Konfigurationsdatei für Couchbase Shell.

Erstellen Sie eine Konfigurations-Punktdatei im Home-Verzeichnis der Couchbase Shell-Installation (z. B.). /<HOME_DIRECTORY>/.cbsh/config Weitere Informationen finden Sie unter Config Dotfiles in der Couchbase-Dokumentation.

Fügen Sie der Konfigurationsdatei Verbindungseigenschaften für die Quell- und Zielcluster hinzu. Sie können die Beispielkonfigurationsdatei im Abschnitt Zusätzliche Informationen verwenden und die Einstellungen für Ihre Cluster bearbeiten. 

Speichern Sie die Konfigurationsdatei mit den aktualisierten Einstellungen in dem .cbsh Ordner (z. B./<HOME_DIRECTORY>/.cbsh/config).

Couchbase-Administrator, Systemadministrator

Ziel-Buckets erstellen.

Erstellen Sie für jeden Quell-Bucket einen Ziel-Bucket in Ihrem Couchbase Capella-Cluster, indem Sie den Anweisungen unter Bucket erstellen in der Couchbase-Dokumentation folgen.

Ihre Ziel-Bucket-Konfigurationen müssen mit den Bucket-Namen, Speichereinstellungen und Konfliktlösungseinstellungen der Buckets in Ihrem selbstverwalteten Couchbase Server-Cluster übereinstimmen.

Couchbase-Administrator

Bereiche und Sammlungen erstellen.

Jeder Bucket enthält einen Standardbereich und eine Standardsammlung mit dem _default._default Schlüsselraum. Wenn Sie andere Schlüsselräume für Ihren Bereich und Ihre Sammlung verwenden, müssen Sie identische Schlüsselräume im Capella-Zielcluster erstellen.

  1. Öffnen Sie das Befehlszeilenterminal auf dem System, auf dem Sie Couchbase Shell installiert haben. 

  2. Führen Sie den folgenden Befehl aus, um Couchbase Shell zu starten.

    ./cbsh
  3. Erstellen Sie für jeden Bucket, den Sie migrieren möchten, Bereiche und Sammlungen im Capella-Cluster, indem Sie die folgenden Befehle ausführen. Stellen Sie sicher, dass Sie < BUCKET _ NAME > durch den Namen des Buckets ersetzen, den Sie migrieren möchten.

scopes --clusters "On-Prem-Cluster" --bucket <BUCKET_NAME> | select scope | where scope != "_default" | each { |it| scopes create $it.scope --clusters "Capella-Cluster" } collections --clusters "On-Prem-Cluster" --bucket <BUCKET_NAME> | select scope collection | where $it.scope != "_default" | where $it.collection != "_default" | each { |it| collections create $it.collection --clusters "Capella-Cluster" --bucket <BUCKET_NAME> --scope $it.scope }
Couchbase-Administrator

Stellen Sie Ressourcen auf Couchbase Capella bereit und konfigurieren Sie sie

AufgabeBeschreibungErforderliche Fähigkeiten

Auswahl einer Vorlage.

  1. Melden Sie sich bei Ihrer Couchbase Capella Control Plane an, wählen Sie in der Hauptnavigation die Registerkarte Dashboard oder die Registerkarte Cluster und wählen Sie dann Create Cluster. 

  2. Wählen Sie anhand der Informationen, die Sie bei der Evaluierung Ihres selbstverwalteten Couchbase Server-Clusters aufgezeichnet haben, die Clustervorlage aus, die den Anforderungen der Konfiguration entspricht. Wenn Sie keine geeignete Vorlage finden, wählen Sie im Editor für die Clustergröße die Option Benutzerdefinierte Vorlage aus.

Couchbase-Administrator

Wählen und konfigurieren Sie die Knoten.

Wählen und konfigurieren Sie die Knoten so, dass sie zu Ihrer selbstverwalteten Couchbase Server-Cluster-Umgebung passen, einschließlich der Anzahl der Knoten, der Dienstverteilung, der Rechenleistung und des SpeichersRAM.

Couchbase Capella verwendet bewährte Methoden zur multidimensionalen Skalierung. Dienste und Knoten können nur gemäß den bewährten Bereitstellungsmethoden ausgewählt werden. Dies kann bedeuten, dass Sie die Konfigurationen Ihres selbstverwalteten Couchbase Server-Clusters nicht genau anpassen können.

Couchbase-Administrator

Stellen Sie den Cluster bereit.

Wählen Sie eine Supportzone und ein Supportpaket aus und stellen Sie dann den Cluster bereit. Ausführliche Schritte und Anweisungen finden Sie in der Couchbase-Dokumentation unter Cluster erstellen.

Wichtig

Wenn Sie die kostenlose Testversion von Couchbase Capella verwenden, müssen Sie sie in ein kostenpflichtiges Konto umwandeln, bevor Sie mit der Migration beginnen. Um Ihr Konto zu konvertieren, öffnen Sie in der Couchbase Capella Control Plane den Bereich Abrechnung und wählen Sie dann Aktivierungs-ID hinzufügen. Die Aktivierungs-ID wird an Ihre Rechnungskontakt-E-Mail-Adresse gesendet, nachdem Sie einen Kaufvertrag mit Couchbase Sales abgeschlossen haben oder nachdem Sie einen Kauf über AWS Marketplace getätigt haben.

Couchbase-Administrator

Erstellen Sie einen Benutzer mit Datenbankanmeldedaten.

Ein Benutzer mit Datenbankanmeldedaten ist spezifisch für einen Cluster und besteht aus einem Benutzernamen, einem Passwort und einer Reihe von Bucket-Rechten. Dieser Benutzer ist erforderlich, um Buckets zu erstellen und auf Bucket-Daten zuzugreifen. 

Erstellen Sie in der Couchbase Capella Control Plane Datenbankanmeldedaten für den neuen Cluster, indem Sie den Anweisungen unter Datenbankanmeldedaten konfigurieren in der Couchbase Capella-Dokumentation folgen.

Anmerkung

Einem Organisationsbenutzer müssen Anmeldeinformationen für die Organisationsrolle zugewiesen werden, wenn er entweder remote oder über die Couchbase Capella-Benutzeroberfläche auf Bucket-Daten in einem bestimmten Cluster zugreifen möchte. Dies ist unabhängig von Datenbankanmeldedaten, die normalerweise von Apps und Integrationen verwendet werden. Wenn Sie den Organisationsbenutzer erstellen, können Sie die Ziel-Buckets auf Ihrem Couchbase Capella-Cluster erstellen und verwalten.

Couchbase-Administrator

Wenn Sie die Migrationsoption 2 verwenden, installieren Sie Couchbase Shell.

Sie können Couchbase Shell auf jedem System installieren, das Netzwerkzugriff sowohl auf Ihren selbst verwalteten Couchbase-Server als auch auf die Couchbase Capella-Cluster hat. Weitere Informationen finden Sie unter Installieren von Couchbase Shell Version 1.0.0-beta.5 in der Couchbase Shell-Dokumentation.

Stellen Sie sicher, dass Couchbase Shell installiert ist, indem Sie eine Verbindung zu Ihrem selbstverwalteten Cluster in einem Befehlszeilenterminal testen.

Couchbase-Administrator, Systemadministrator

IP-Adressen zulassen.

  1. Wählen Sie in der Couchbase Capella Control Plane Clusters und dann Ihren Zielcluster aus. 

  2. Wählen Sie die Registerkarte Connect für den Cluster und notieren Sie den Verbindungsendpunkt für Ihren Cluster, der unter Zulässige IP verwalten aufgeführt ist.

  3. Gehen Sie wie folgt vor, um die IP-Adresse für das System, auf dem Sie Couchbase Shell installiert haben, und die IP-Adresse Ihrer selbstverwalteten Couchbase Server-Cluster-Instanzen als zulässige IP-Adressen hinzuzufügen: 

    1. Wählen Sie unter Wide Area Network die Option Zulässige IP verwalten aus. 

    2. Wählen Sie Add Allowed IP, geben Sie die IP-Adresse für das System ein, auf dem Sie Couchbase Shell installiert haben, und wählen Sie dann Add IP. 

    3. Wiederholen Sie den vorherigen Schritt, um die IP-Adresse Ihrer selbstverwalteten Couchbase Server-Clusterinstanz hinzuzufügen. 

Weitere Informationen zu zulässigen IP-Adressen finden Sie unter Zulässige IP-Adressen konfigurieren in der Couchbase-Dokumentation.

Couchbase-Administrator, Systemadministrator

Zertifikate konfigurieren.

  1. Um das Stammzertifikat für Ihren Cluster herunterzuladen, wählen Sie unter Stammzertifikat die Option Herunterladen aus. 

  2. Speichern Sie das Stammzertifikat mit der Dateierweiterung.pem in einem Ordner auf dem System, auf dem Couchbase Shell ausgeführt werden soll.

  3. Melden Sie sich als Nächstes bei Ihrer selbst verwalteten Couchbase Server-Webkonsole an, wählen Sie in der linken Navigationsleiste Sicherheit und dann die Registerkarte Zertifikate.

  4. Kopieren Sie das Stammzertifikat für Ihren selbstverwalteten Couchbase Server-Cluster und speichern Sie es als.pem-Datei in demselben Ordner, in dem Sie die Stammzertifikatsdatei für Ihren Couchbase Capella-Cluster gespeichert haben. Weitere Informationen zum Stammzertifikat finden Sie unter Root-Zertifikat in der Couchbase Server-Dokumentation.

Couchbase-Administrator, Systemadministrator

Erstellen Sie die Konfigurationsdatei für Couchbase Shell.

Erstellen Sie eine Konfigurations-Punktdatei im Home-Verzeichnis der Couchbase Shell-Installation (z. B.). /<HOME_DIRECTORY>/.cbsh/config Weitere Informationen finden Sie unter Config Dotfiles in der Couchbase-Dokumentation.

Fügen Sie der Konfigurationsdatei Verbindungseigenschaften für die Quell- und Zielcluster hinzu. Sie können die Beispielkonfigurationsdatei im Abschnitt Zusätzliche Informationen verwenden und die Einstellungen für Ihre Cluster bearbeiten. 

Speichern Sie die Konfigurationsdatei mit den aktualisierten Einstellungen in dem .cbsh Ordner (z. B./<HOME_DIRECTORY>/.cbsh/config).

Couchbase-Administrator, Systemadministrator

Ziel-Buckets erstellen.

Erstellen Sie für jeden Quell-Bucket einen Ziel-Bucket in Ihrem Couchbase Capella-Cluster, indem Sie den Anweisungen unter Bucket erstellen in der Couchbase-Dokumentation folgen.

Ihre Ziel-Bucket-Konfigurationen müssen mit den Bucket-Namen, Speichereinstellungen und Konfliktlösungseinstellungen der Buckets in Ihrem selbstverwalteten Couchbase Server-Cluster übereinstimmen.

Couchbase-Administrator

Bereiche und Sammlungen erstellen.

Jeder Bucket enthält einen Standardbereich und eine Standardsammlung mit dem _default._default Schlüsselraum. Wenn Sie andere Schlüsselräume für Ihren Bereich und Ihre Sammlung verwenden, müssen Sie identische Schlüsselräume im Capella-Zielcluster erstellen.

  1. Öffnen Sie das Befehlszeilenterminal auf dem System, auf dem Sie Couchbase Shell installiert haben. 

  2. Führen Sie den folgenden Befehl aus, um Couchbase Shell zu starten.

    ./cbsh
  3. Erstellen Sie für jeden Bucket, den Sie migrieren möchten, Bereiche und Sammlungen im Capella-Cluster, indem Sie die folgenden Befehle ausführen. Stellen Sie sicher, dass Sie < BUCKET _ NAME > durch den Namen des Buckets ersetzen, den Sie migrieren möchten.

scopes --clusters "On-Prem-Cluster" --bucket <BUCKET_NAME> | select scope | where scope != "_default" | each { |it| scopes create $it.scope --clusters "Capella-Cluster" } collections --clusters "On-Prem-Cluster" --bucket <BUCKET_NAME> | select scope collection | where $it.scope != "_default" | where $it.collection != "_default" | each { |it| collections create $it.collection --clusters "Capella-Cluster" --bucket <BUCKET_NAME> --scope $it.scope }
Couchbase-Administrator
AufgabeBeschreibungErforderliche Fähigkeiten

Öffnen Sie die TCP Ports auf den selbstverwalteten Couchbase Server-Clusterknoten.

Stellen Sie sicher, dass die entsprechenden Ports für die XDCR Kommunikation auf den Knoten des selbstverwalteten Couchbase Server-Clusters geöffnet sind. Weitere Informationen finden Sie in der Dokumentation zu den Couchbase Server-Ports.

Couchbase-Administrator, Systemadministrator

Wenn Sie Couchbase Server Enterprise Edition verwenden, richten Sie Couchbase ein. XDCR

  1. Wählen Sie in der Hauptnavigation der Couchbase Capella Control Plane die Option Clusters und dann den Zielcluster für die Migration aus. 

  2. Wählen Sie unter Root Certificate die Option Copy aus.

  3. Melden Sie sich bei Ihrer selbst verwalteten Couchbase Server-Web-Konsole an und wählen Sie in der Hauptnavigation. XDCR Wählen Sie dann Add Remote. 

  4. Geben Sie die folgenden Einstellungen ein: 

    • Clustername — Ein Name für die Capella-Cluster-Verbindung

    • IP/Hostname — Der Verbindungsendpunkt für Ihren Couchbase Capella-Cluster

    • Benutzername für Remote Cluster — Der Datenbankbenutzer für Ihren Couchbase Capella-Cluster

    • Passwort — Das Datenbankbenutzerpasswort für Ihren Couchbase Capella-Cluster

    • Sichere Verbindung aktivieren — Ausgewählt

    • Vollständig (Passwort und Daten TLS verschlüsseln) — Ausgewählt

  5. Fügen Sie das Capella-Cluster-Root-Zertifikat ein, das Sie zuvor kopiert haben, und wählen Sie dann Speichern.

Couchbase-Administrator

Starten Sie Couchbase. XDCR

  1. Wählen Sie in Ihrer selbst verwalteten Couchbase Server-Webkonsole XDCRin der Hauptnavigation die Option Replikation hinzufügen aus.

  2. Geben Sie die folgenden Einstellungen ein:

    • Aus Bucket replizieren — Wählen Sie den Quell-Bucket für die Migration aus.

    • Remote-Bucket — Geben Sie den Namen des Ziel-Buckets ein.

    • Remote-Cluster — Wählen Sie den Zielcluster aus, den Sie zuvor erstellt haben.

  3. Wählen Sie „Replizierung speichern“. Der Replikationsvorgang sollte innerhalb weniger Sekunden beginnen.

Couchbase-Administrator

Migrieren Sie die Daten aus der Enterprise Edition

AufgabeBeschreibungErforderliche Fähigkeiten

Öffnen Sie die TCP Ports auf den selbstverwalteten Couchbase Server-Clusterknoten.

Stellen Sie sicher, dass die entsprechenden Ports für die XDCR Kommunikation auf den Knoten des selbstverwalteten Couchbase Server-Clusters geöffnet sind. Weitere Informationen finden Sie in der Dokumentation zu den Couchbase Server-Ports.

Couchbase-Administrator, Systemadministrator

Wenn Sie Couchbase Server Enterprise Edition verwenden, richten Sie Couchbase ein. XDCR

  1. Wählen Sie in der Hauptnavigation der Couchbase Capella Control Plane die Option Clusters und dann den Zielcluster für die Migration aus. 

  2. Wählen Sie unter Root Certificate die Option Copy aus.

  3. Melden Sie sich bei Ihrer selbst verwalteten Couchbase Server-Web-Konsole an und wählen Sie in der Hauptnavigation. XDCR Wählen Sie dann Add Remote. 

  4. Geben Sie die folgenden Einstellungen ein: 

    • Clustername — Ein Name für die Capella-Cluster-Verbindung

    • IP/Hostname — Der Verbindungsendpunkt für Ihren Couchbase Capella-Cluster

    • Benutzername für Remote Cluster — Der Datenbankbenutzer für Ihren Couchbase Capella-Cluster

    • Passwort — Das Datenbankbenutzerpasswort für Ihren Couchbase Capella-Cluster

    • Sichere Verbindung aktivieren — Ausgewählt

    • Vollständig (Passwort und Daten TLS verschlüsseln) — Ausgewählt

  5. Fügen Sie das Capella-Cluster-Root-Zertifikat ein, das Sie zuvor kopiert haben, und wählen Sie dann Speichern.

Couchbase-Administrator

Starten Sie Couchbase. XDCR

  1. Wählen Sie in Ihrer selbst verwalteten Couchbase Server-Webkonsole XDCRin der Hauptnavigation die Option Replikation hinzufügen aus.

  2. Geben Sie die folgenden Einstellungen ein:

    • Aus Bucket replizieren — Wählen Sie den Quell-Bucket für die Migration aus.

    • Remote-Bucket — Geben Sie den Namen des Ziel-Buckets ein.

    • Remote-Cluster — Wählen Sie den Zielcluster aus, den Sie zuvor erstellt haben.

  3. Wählen Sie „Replizierung speichern“. Der Replikationsvorgang sollte innerhalb weniger Sekunden beginnen.

Couchbase-Administrator
AufgabeBeschreibungErforderliche Fähigkeiten

Migrieren Sie selbstverwaltete Cluster-Indizes zu Couchbase Capella.

Wichtig

Wir empfehlen diesen Vorgang, wenn Sie weniger als 50 Indizes migrieren müssen. Wenn Sie mehr als 50 Indizes migrieren müssen, empfehlen wir Ihnen, die Migrationsoption 2 zu verwenden.

  1. Wählen Sie auf der Couchbase-Webkonsole Indizes aus.

  2. Wählen Sie in der Liste der Indizes den ersten Index aus, den Sie migrieren möchten. Die Indexdefinition wird dann angezeigt.

  3. Kopieren Sie die Indexdefinition mithilfe der CREATE Anweisung, aber kopieren Sie sie nichtWITH { "defer_build":true }.

    Aus der folgenden Beispielindexdefinition würden Sie beispielsweise nur kopierenCREATE INDEX `cityindex` ON `travel-sample`(`city`)

    CREATE INDEX `cityindex` ON `travel-sample`(`city`) WITH { "defer_build":true }
  4. Wählen Sie in der Couchbase Capella Control Plane Clusters und dann den Zielcluster aus. 

  5. Wählen Sie in der Dropdownliste Tools die Option Query Workbench aus. Fügen Sie die CREATE Anweisung, die Sie zuvor kopiert haben, in den Abfrage-Editor ein, und wählen Sie dann Ausführen. Dadurch wird der Index erstellt und erstellt.

  6. Um zu bestätigen, dass der Index erstellt wurde, wählen Sie Indizes aus der Dropdownliste Tools aus. Die Liste zeigt, dass der Index erstellt und erstellt wurde.

  7. Wiederholen Sie diesen Vorgang für jeden Index, der migriert werden muss.

Couchbase-Administrator, Systemadministrator

Migrieren Sie die Indizes mithilfe von Option 1

AufgabeBeschreibungErforderliche Fähigkeiten

Migrieren Sie selbstverwaltete Cluster-Indizes zu Couchbase Capella.

Wichtig

Wir empfehlen diesen Vorgang, wenn Sie weniger als 50 Indizes migrieren müssen. Wenn Sie mehr als 50 Indizes migrieren müssen, empfehlen wir Ihnen, die Migrationsoption 2 zu verwenden.

  1. Wählen Sie auf der Couchbase-Webkonsole Indizes aus.

  2. Wählen Sie in der Liste der Indizes den ersten Index aus, den Sie migrieren möchten. Die Indexdefinition wird dann angezeigt.

  3. Kopieren Sie die Indexdefinition mithilfe der CREATE Anweisung, aber kopieren Sie sie nichtWITH { "defer_build":true }.

    Aus der folgenden Beispielindexdefinition würden Sie beispielsweise nur kopierenCREATE INDEX `cityindex` ON `travel-sample`(`city`)

    CREATE INDEX `cityindex` ON `travel-sample`(`city`) WITH { "defer_build":true }
  4. Wählen Sie in der Couchbase Capella Control Plane Clusters und dann den Zielcluster aus. 

  5. Wählen Sie in der Dropdownliste Tools die Option Query Workbench aus. Fügen Sie die CREATE Anweisung, die Sie zuvor kopiert haben, in den Abfrage-Editor ein, und wählen Sie dann Ausführen. Dadurch wird der Index erstellt und erstellt.

  6. Um zu bestätigen, dass der Index erstellt wurde, wählen Sie Indizes aus der Dropdownliste Tools aus. Die Liste zeigt, dass der Index erstellt und erstellt wurde.

  7. Wiederholen Sie diesen Vorgang für jeden Index, der migriert werden muss.

Couchbase-Administrator, Systemadministrator
AufgabeBeschreibungErforderliche Fähigkeiten

Migrieren Sie die Indexdefinitionen.

Wichtig

Wir empfehlen diesen Vorgang, wenn Sie mehr als 50 Indizes migrieren müssen. Wenn Sie weniger als 50 Indizes migrieren müssen, empfehlen wir Ihnen, die Migrationsoption 1 zu verwenden.

  1. Öffnen Sie das Befehlszeilenterminal auf dem System, auf dem Sie Couchbase Shell installiert haben. 

  2. Führen Sie den folgenden Befehl aus, um Couchbase Shell zu starten.

    ./cbsh
  3. Führen Sie den folgenden Befehl aus, um eine Verbindung zum selbstverwalteten Couchbase Server-Cluster herzustellen.

    cb-env cluster On-Prem-Cluster
  4. Um Indexdefinitionen vom selbstverwalteten Couchbase Server-Cluster zum Couchbase Capella-Cluster zu migrieren, führen Sie den folgenden Befehl für jeden Bucket aus, den Sie migrieren möchten. Stellen Sie sicher, dass Sie es durch den Bucket-Namen <BUCKET_NAME> ersetzen, der den Indizes entspricht, die Sie migrieren möchten. Diese Migrationsoption setzt voraus, dass Ihre Ziel-Bucket-Namen mit den Quell-Bucket-Namen identisch sind.

    query indexes --definitions | where bucket =~ <BUCKET_NAME>| get definition | each { |it| query $it --clusters Capella-Cluster }
Couchbase-Administrator, Systemadministrator

Erstellen Sie die Indexdefinitionen.

  1. Führen Sie den folgenden Befehl aus, um den Kontext zum Couchbase Capella-Cluster zu wechseln:

    cb-env cluster Capella-Cluster
  2. Um die Indexdefinitionen zu erstellen, die auf den Couchbase Capella-Cluster migriert wurden, führen Sie den folgenden Befehl aus und <BUCKET_NAME> ersetzen Sie ihn durch den Bucket-Namen, der den Indizes entspricht, die Sie erstellen möchten.

    query 'SELECT RAW CONCAT("BUILD INDEX ON ", k , "(['", CONCAT2 ("','", inames), "']);") FROM system:indexes AS s LET bid = CONCAT("`",s.bucket_id, "`"), sid = CONCAT("`", s.scope_id, "`"), kid = CONCAT("`", s.keyspace_id, "`"), k = NVL2(bid, CONCAT2(".", bid, sid, kid), kid) WHERE s.namespace_id = "default" AND s.bucket_id = "" GROUP BY k LETTING inames = ARRAY_AGG(s.name) FILTER (WHERE s.state = 'deferred') HAVING ARRAY_LENGTH(inames) > 0;' | each { |it| query $it }
  3. Wiederholen Sie den Vorgang für jeden Bucket.

Couchbase-Administrator, Systemadministrator

Migrieren Sie die Indizes mithilfe von Option 2

AufgabeBeschreibungErforderliche Fähigkeiten

Migrieren Sie die Indexdefinitionen.

Wichtig

Wir empfehlen diesen Vorgang, wenn Sie mehr als 50 Indizes migrieren müssen. Wenn Sie weniger als 50 Indizes migrieren müssen, empfehlen wir Ihnen, die Migrationsoption 1 zu verwenden.

  1. Öffnen Sie das Befehlszeilenterminal auf dem System, auf dem Sie Couchbase Shell installiert haben. 

  2. Führen Sie den folgenden Befehl aus, um Couchbase Shell zu starten.

    ./cbsh
  3. Führen Sie den folgenden Befehl aus, um eine Verbindung zum selbstverwalteten Couchbase Server-Cluster herzustellen.

    cb-env cluster On-Prem-Cluster
  4. Um Indexdefinitionen vom selbstverwalteten Couchbase Server-Cluster zum Couchbase Capella-Cluster zu migrieren, führen Sie den folgenden Befehl für jeden Bucket aus, den Sie migrieren möchten. Stellen Sie sicher, dass Sie es durch den Bucket-Namen <BUCKET_NAME> ersetzen, der den Indizes entspricht, die Sie migrieren möchten. Diese Migrationsoption setzt voraus, dass Ihre Ziel-Bucket-Namen mit den Quell-Bucket-Namen identisch sind.

    query indexes --definitions | where bucket =~ <BUCKET_NAME>| get definition | each { |it| query $it --clusters Capella-Cluster }
Couchbase-Administrator, Systemadministrator

Erstellen Sie die Indexdefinitionen.

  1. Führen Sie den folgenden Befehl aus, um den Kontext zum Couchbase Capella-Cluster zu wechseln:

    cb-env cluster Capella-Cluster
  2. Um die Indexdefinitionen zu erstellen, die auf den Couchbase Capella-Cluster migriert wurden, führen Sie den folgenden Befehl aus und <BUCKET_NAME> ersetzen Sie ihn durch den Bucket-Namen, der den Indizes entspricht, die Sie erstellen möchten.

    query 'SELECT RAW CONCAT("BUILD INDEX ON ", k , "(['", CONCAT2 ("','", inames), "']);") FROM system:indexes AS s LET bid = CONCAT("`",s.bucket_id, "`"), sid = CONCAT("`", s.scope_id, "`"), kid = CONCAT("`", s.keyspace_id, "`"), k = NVL2(bid, CONCAT2(".", bid, sid, kid), kid) WHERE s.namespace_id = "default" AND s.bucket_id = "" GROUP BY k LETTING inames = ARRAY_AGG(s.name) FILTER (WHERE s.state = 'deferred') HAVING ARRAY_LENGTH(inames) > 0;' | each { |it| query $it }
  3. Wiederholen Sie den Vorgang für jeden Bucket.

Couchbase-Administrator, Systemadministrator
AufgabeBeschreibungErforderliche Fähigkeiten

Migrieren Sie selbstverwaltete Cluster-Volltextsuchindizes zu Couchbase Capella.

  1. Wählen Sie in der Couchbase-Webkonsole Suchen aus. 

  2. Wählen Sie in der Liste der Volltextsuchindizes (FTS) den ersten FTS Index aus, den Sie migrieren möchten, wählen Sie Indexdefinition anzeigen und dann In die JSON Zwischenablage kopieren. Notieren Sie sich den Indexnamen und den Bucket, zu dem er gehört.

  3. Wählen Sie in der Couchbase Capella Control Plane Clusters und dann den Zielcluster aus. 

  4. Wählen Sie in der Dropdownliste Tools die Option Volltextsuche aus. 

  5. Wählen Sie Index importieren und fügen Sie die FTS Indexdefinition ein. 

  6. Geben Sie den Indexnamen ein, wählen Sie den richtigen Bucket aus, wie auf dem selbstverwalteten Cluster angegeben, und wählen Sie dann Create aus.

  7. Wiederholen Sie diesen Vorgang für jeden FTS Index, der migriert werden muss.

Couchbase-Administrator

Migrieren Sie Volltext-Suchindexe

AufgabeBeschreibungErforderliche Fähigkeiten

Migrieren Sie selbstverwaltete Cluster-Volltextsuchindizes zu Couchbase Capella.

  1. Wählen Sie in der Couchbase-Webkonsole Suchen aus. 

  2. Wählen Sie in der Liste der Volltextsuchindizes (FTS) den ersten FTS Index aus, den Sie migrieren möchten, wählen Sie Indexdefinition anzeigen und dann In die JSON Zwischenablage kopieren. Notieren Sie sich den Indexnamen und den Bucket, zu dem er gehört.

  3. Wählen Sie in der Couchbase Capella Control Plane Clusters und dann den Zielcluster aus. 

  4. Wählen Sie in der Dropdownliste Tools die Option Volltextsuche aus. 

  5. Wählen Sie Index importieren und fügen Sie die FTS Indexdefinition ein. 

  6. Geben Sie den Indexnamen ein, wählen Sie den richtigen Bucket aus, wie auf dem selbstverwalteten Cluster angegeben, und wählen Sie dann Create aus.

  7. Wiederholen Sie diesen Vorgang für jeden FTS Index, der migriert werden muss.

Couchbase-Administrator
AufgabeBeschreibungErforderliche Fähigkeiten

Exportieren Sie Daten aus der selbstverwalteten Couchbase Server Community Edition.

Verschlüsselt XDCR ist in der Couchbase Community Edition nicht verfügbar. Sie können Daten aus der Couchbase Community Edition exportieren und die Daten dann manuell in Couchbase Capella importieren.

Verwenden cbexport Sie die Befehlszeile, um Daten aus dem Quell-Bucket zu exportieren.

Der folgende Befehl dient als Beispiel.

cbexport json \ --cluster localhost \ --bucket <SOURCE BUCKET NAME> \ --format lines \ --username <USERNAME> \ --password <PASSWORD> \ --include-key cbkey \ --scope-field cbscope \ --collection-field cbcoll \ --output cbexported_data.json

Beachten Siecbkey, dass cbscopecbcoll, und beliebige Bezeichnungen cbexported_data.json sind. Sie werden später im Prozess referenziert. Wenn Sie sie also anders benennen möchten, notieren Sie sich das.

Couchbase-Administrator

Daten in Couchbase Capella importieren.

  1. Wählen Sie in der Couchbase Capella Control Plane Clusters und dann den Zielcluster aus.

  2. Wählen Sie in der Dropdownliste Tools die Option Import aus. Dadurch wird ein Assistent mit den folgenden sechs Schritten geöffnet:

    1. Bucket — Wählen Sie den Ziel-Bucket aus.

    2. Datei — Wählen Sie JSONLinien“ und dann „Ihren Webbrowser verwenden“. Wenn Sie über eine große Datenmenge verfügen, können Sie die Option Manuell ausprobieren. Wählen Sie die Datei aus, die von erstellt wurdecbexport.  

    3. Sammlungen — Wählen Sie „Benutzerdefiniertes Sammlungs-Mapping“. 

      Wenn Ihre Community Edition-Datenbank keine Bereiche oder Sammlungen oder nur _default verwendet, können Sie stattdessen die Option Einzelne Sammlung auswählen wählen.

      Geben Sie als Ausdruck für die Zuordnung von Sammlungen den Wert ein. %cbscope%.%cbcoll% Um zu überprüfen, ob dieser Ausdruck korrekt funktioniert, können Sie Beispieldaten einfügen, z. B. die folgenden.

      { "cbscope":"inventory", "cbcoll":"landmark", "cbkey":"landmark_3991" }
    4. Schlüssel — Wählen Sie Customer Generation. (Wenn Sie nicht daran interessiert sind, die Schlüssel der zu importierenden Daten beizubehalten, können Sie UUID stattdessen Automatisch generiert auswählen und mit Schritt 5 fortfahren.) Geben Sie für Key Name Generator Expression %cbkey% ein. Um zu überprüfen, ob dieser Ausdruck korrekt funktioniert, fügen Sie einige Beispieldaten ein.

    5. Konfigurationen — Wählen Sie Felder ignorieren und geben Sie cbscope, cbcoll, cbkey ein. Diese Felder enthalten vorübergehende Informationen, die sich nach einem Import nicht im Ziel-Bucket befinden müssen. Übernehmen Sie für die anderen Einstellungen die Standardwerte.

    6. Import — Überprüfen Sie den Vorgang und wählen Sie Import, wenn Sie bereit sind. Warten Sie auf den Upload und den Datenimport.

Für große Dateien unterstützt Couchbase Capella den Befehlszeilenimport mit c. URL Weitere Informationen zu den Importoptionen finden Sie unter Daten importieren in der Couchbase Capella-Dokumentation.

Couchbase-Administrator

Migrieren Sie Daten aus der Couchbase Community Edition

AufgabeBeschreibungErforderliche Fähigkeiten

Exportieren Sie Daten aus der selbstverwalteten Couchbase Server Community Edition.

Verschlüsselt XDCR ist in der Couchbase Community Edition nicht verfügbar. Sie können Daten aus der Couchbase Community Edition exportieren und die Daten dann manuell in Couchbase Capella importieren.

Verwenden cbexport Sie die Befehlszeile, um Daten aus dem Quell-Bucket zu exportieren.

Der folgende Befehl dient als Beispiel.

cbexport json \ --cluster localhost \ --bucket <SOURCE BUCKET NAME> \ --format lines \ --username <USERNAME> \ --password <PASSWORD> \ --include-key cbkey \ --scope-field cbscope \ --collection-field cbcoll \ --output cbexported_data.json

Beachten Siecbkey, dass cbscopecbcoll, und beliebige Bezeichnungen cbexported_data.json sind. Sie werden später im Prozess referenziert. Wenn Sie sie also anders benennen möchten, notieren Sie sich das.

Couchbase-Administrator

Daten in Couchbase Capella importieren.

  1. Wählen Sie in der Couchbase Capella Control Plane Clusters und dann den Zielcluster aus.

  2. Wählen Sie in der Dropdownliste Tools die Option Import aus. Dadurch wird ein Assistent mit den folgenden sechs Schritten geöffnet:

    1. Bucket — Wählen Sie den Ziel-Bucket aus.

    2. Datei — Wählen Sie JSONLinien“ und dann „Ihren Webbrowser verwenden“. Wenn Sie über eine große Datenmenge verfügen, können Sie die Option Manuell ausprobieren. Wählen Sie die Datei aus, die von erstellt wurdecbexport.  

    3. Sammlungen — Wählen Sie „Benutzerdefiniertes Sammlungs-Mapping“. 

      Wenn Ihre Community Edition-Datenbank keine Bereiche oder Sammlungen oder nur _default verwendet, können Sie stattdessen die Option Einzelne Sammlung auswählen wählen.

      Geben Sie als Ausdruck für die Zuordnung von Sammlungen den Wert ein. %cbscope%.%cbcoll% Um zu überprüfen, ob dieser Ausdruck korrekt funktioniert, können Sie Beispieldaten einfügen, z. B. die folgenden.

      { "cbscope":"inventory", "cbcoll":"landmark", "cbkey":"landmark_3991" }
    4. Schlüssel — Wählen Sie Customer Generation. (Wenn Sie nicht daran interessiert sind, die Schlüssel der zu importierenden Daten beizubehalten, können Sie UUID stattdessen Automatisch generiert auswählen und mit Schritt 5 fortfahren.) Geben Sie für Key Name Generator Expression %cbkey% ein. Um zu überprüfen, ob dieser Ausdruck korrekt funktioniert, fügen Sie einige Beispieldaten ein.

    5. Konfigurationen — Wählen Sie Felder ignorieren und geben Sie cbscope, cbcoll, cbkey ein. Diese Felder enthalten vorübergehende Informationen, die sich nach einem Import nicht im Ziel-Bucket befinden müssen. Übernehmen Sie für die anderen Einstellungen die Standardwerte.

    6. Import — Überprüfen Sie den Vorgang und wählen Sie Import, wenn Sie bereit sind. Warten Sie auf den Upload und den Datenimport.

Für große Dateien unterstützt Couchbase Capella den Befehlszeilenimport mit c. URL Weitere Informationen zu den Importoptionen finden Sie unter Daten importieren in der Couchbase Capella-Dokumentation.

Couchbase-Administrator
AufgabeBeschreibungErforderliche Fähigkeiten

Überprüfen Sie die Datenmigration.

  1. Wählen Sie in der Couchbase Capella Control Plane Clusters und dann den Zielcluster in Ihrer Cluster-Liste aus. 

  2. Wählen Sie die Registerkarte Buckets für Ihren Zielcluster. Stellen Sie sicher, dass die Anzahl der Elemente (Dokumente) im Ziel-Bucket mit der Anzahl der Elemente im Quell-Bucket übereinstimmt.

  3. Wählen Sie im Zielcluster in der Dropdownliste Tools die Option Dokumente aus. Stellen Sie sicher, dass alle Dokumente migriert wurden.

  4. (Optional) Nachdem alle Daten migriert wurden, können Sie die Replikation beenden, indem Sie sie löschen. Weitere Informationen finden Sie in der Couchbase-Dokumentation unter Löschen einer Replikation.

Couchbase-Administrator

Überprüfen Sie die Indexmigration.

Wählen Sie in der Couchbase Capella Control Plane in der Dropdownliste Tools für Ihren Zielcluster die Option Indizes aus. Stellen Sie sicher, dass die Indizes migriert und erstellt wurden.

Couchbase-Administrator

Überprüfen Sie die Abfrageergebnisse.

  1. Wählen Sie in der Couchbase Capella Control Plane in der Dropdownliste Tools für Ihren Zielcluster die Option Query Workbench aus. 

  2. Führen Sie eine N1QL-Beispielabfrage oder eine in Ihrer Anwendung verwendete Abfrage aus. Stellen Sie sicher, dass Sie dieselben Ergebnisse erhalten wie bei der Ausführung der Abfrage in Ihrem selbstverwalteten Couchbase Server-Cluster.

Couchbase-Administrator

Überprüfen Sie die Ergebnisse der Volltextsuche (gilt, wenn Sie Indizes migriert FTS haben).

  1. Wählen Sie in der Couchbase Capella Control Plane in der Dropdownliste Tools für Ihren Zielcluster die Option Volltextsuche aus. 

  2. Wählen Sie einen FTS Index aus, indem Sie seinen Namen wählen. 

  3. Wählen Sie Search (Suchen) aus. 

  4. Geben Sie eine Beispielsuchabfrage ein und wählen Sie Suchen aus. 

  5. Stellen Sie sicher, dass die Ergebnisse dieselben sind wie bei der Ausführung der Suche auf Ihrem selbstverwalteten Cluster.

Couchbase-Administrator

Testen und verifizieren Sie die Migration

AufgabeBeschreibungErforderliche Fähigkeiten

Überprüfen Sie die Datenmigration.

  1. Wählen Sie in der Couchbase Capella Control Plane Clusters und dann den Zielcluster in Ihrer Cluster-Liste aus. 

  2. Wählen Sie die Registerkarte Buckets für Ihren Zielcluster. Stellen Sie sicher, dass die Anzahl der Elemente (Dokumente) im Ziel-Bucket mit der Anzahl der Elemente im Quell-Bucket übereinstimmt.

  3. Wählen Sie im Zielcluster in der Dropdownliste Tools die Option Dokumente aus. Stellen Sie sicher, dass alle Dokumente migriert wurden.

  4. (Optional) Nachdem alle Daten migriert wurden, können Sie die Replikation beenden, indem Sie sie löschen. Weitere Informationen finden Sie in der Couchbase-Dokumentation unter Löschen einer Replikation.

Couchbase-Administrator

Überprüfen Sie die Indexmigration.

Wählen Sie in der Couchbase Capella Control Plane in der Dropdownliste Tools für Ihren Zielcluster die Option Indizes aus. Stellen Sie sicher, dass die Indizes migriert und erstellt wurden.

Couchbase-Administrator

Überprüfen Sie die Abfrageergebnisse.

  1. Wählen Sie in der Couchbase Capella Control Plane in der Dropdownliste Tools für Ihren Zielcluster die Option Query Workbench aus. 

  2. Führen Sie eine N1QL-Beispielabfrage oder eine in Ihrer Anwendung verwendete Abfrage aus. Stellen Sie sicher, dass Sie dieselben Ergebnisse erhalten wie bei der Ausführung der Abfrage in Ihrem selbstverwalteten Couchbase Server-Cluster.

Couchbase-Administrator

Überprüfen Sie die Ergebnisse der Volltextsuche (gilt, wenn Sie Indizes migriert FTS haben).

  1. Wählen Sie in der Couchbase Capella Control Plane in der Dropdownliste Tools für Ihren Zielcluster die Option Volltextsuche aus. 

  2. Wählen Sie einen FTS Index aus, indem Sie seinen Namen wählen. 

  3. Wählen Sie Search (Suchen) aus. 

  4. Geben Sie eine Beispielsuchabfrage ein und wählen Sie Suchen aus. 

  5. Stellen Sie sicher, dass die Ergebnisse dieselben sind wie bei der Ausführung der Suche auf Ihrem selbstverwalteten Cluster.

Couchbase-Administrator

Zugehörige Ressourcen

Bereiten Sie die Migration vor

Migrieren Sie die Daten und Indizes

Couchbase Capella und Support SLAs

Zusätzliche Informationen

Der folgende Code ist eine Beispielkonfigurationsdatei für Couchbase Shell. 

Version = 1 [[clusters]] identifier = "On-Prem-Cluster" hostnames = ["<SELF_MANAGED_COUCHBASE_CLUSTER>"] default-bucket = "travel-sample" username = "<SELF_MANAGED_ADMIN>" password = "<SELF_MANAGED_ADMIN_PWD>" tls-cert-path = "/<ABSOLUTE_PATH_TO_SELF_MANAGED_ROOT_CERT>" data-timeout = "2500ms" connect-timeout = "7500ms" query-timeout = "75s" [[clusters]] identifier = "Capella-Cluster" hostnames = ["<COUCHBASE_CAPELLA_ENDPOINT>"] default-bucket = "travel-sample" username = "<CAPELLA_DATABASE_USER>" password = "<CAPELLA_DATABASE_USER_PWD>" tls-cert-path = "/<ABSOLUTE_PATH_TO_COUCHBASE_CAPELLA_ROOT_CERT>" data-timeout = "2500ms" connect-timeout = "7500ms" query-timeout = "75s"

Bevor Sie die Konfigurationsdatei speichern, stellen Sie anhand der folgenden Tabelle sicher, dass Sie Ihre eigenen Quell- und Zielclusterinformationen hinzugefügt haben.

 

<SELF_MANAGED_COUCHBASE_CLUSTER>

Verwenden Sie die IP-Adresse für Ihren selbstverwalteten Couchbase Server-Cluster.

<SELF_MANAGED_ADMIN>

Verwenden Sie den Administratorbenutzer für Ihren selbstverwalteten Couchbase Server-Cluster.

< ABSOLUTE _ PATH SELF _ZU_ _ _ _ > MANAGED ROOT CERT

Verwenden Sie den absoluten Pfad zur gespeicherten Stammzertifikatsdatei für Ihren selbstverwalteten Couchbase Server-Cluster.

<COUCHBASE_CAPELLA_ENDPOINT>

Verwenden Sie den Verbindungsendpunkt für Ihren Couchbase Capella-Cluster.

<CAPELLA_DATABASE_USER>

Verwenden Sie den Datenbankbenutzer für Ihren Couchbase Capella-Cluster.

<CAPELLA_DATABASE_USER_PWD>

Verwenden Sie das Datenbankbenutzerpasswort für Ihren Couchbase Capella-Cluster.

< ABSOLUTE _ PATH COUCHBASE _ZU_ _ _ _ > CAPELLA ROOT CERT

Verwenden Sie den absoluten Pfad zur gespeicherten Root-Zertifikatsdatei für Ihren Couchbase Capella-Cluster.

DatenschutzNutzungsbedingungen für die WebsiteCookie-Einstellungen
© 2025, Amazon Web Services, Inc. oder Tochtergesellschaften. Alle Rechte vorbehalten.