Kopieraufträge in Azure Cosmos DB (Vorschau)

Sie können Datenkopien in Azure Cosmos DB mithilfe von Containerkopieraufträgen erstellen.

Möglicherweise müssen Sie in einem der folgenden Szenarien Daten in Ihrem Azure Cosmos DB-Konto kopieren:

• Kopieren aller Elemente von einem Container in einen anderen.
• Ändern der Granularität, bei der der Durchsatz bereitgestellt wird – von Datenbank zu Container und umgekehrt.
• Ändern des Partitionsschlüssel eines Containers.
• Aktualisieren der eindeutigen Schlüssel für einen Container.
• Umbenennen eines Containers oder einer Datenbank.
• Ändern Sie den Kapazitätsmodus eines Kontos von „Serverlos“ in „Bereitgestellt“ oder umgekehrt.
• Übernehmen neuer Features, die nur für neue Container unterstützt werden, z. B. hierarchische Partitionsschlüssel.

Kopieraufträge können mit Azure CLI-Befehlen erstellt und verwaltet werden.

Erste Schritte

Onlinekopie

Um mit der Erstellung einer Onlinecontainerkopie für Azure Cosmos DB for NoSQL-API-Konten zu beginnen, registrieren Sie sich im Azure-Portal für die Previewfunktion mit dem Flag Onlinecontainerkopie (NoSQL) in Previewfunktionen. Sobald die Registrierung abgeschlossen ist, wird die Vorschau für alle NoSQL-API-Konten im Abonnement angezeigt.

Voraussetzungen

1. Aktivieren Sie die fortlaufende Sicherung im Azure Cosmos DB-Quellkonto.
2. Registrieren Sie sich für die Previewfunktion Alle Versionen und Änderungsfeed löschen für das Abonnement des Quellkontos.

Wichtig

Alle Schreibvorgänge im Quellcontainer werden mit doppelten RUs in Rechnung gestellt, um sowohl die vorherigen als auch die aktuellen Versionen von Änderungen an Elementen im Container beizubehalten. Diese Erhöhung der RU-Gebühren kann zukünftig geändert werden.

Kopieren der Daten eines Containers

1. Erstellen Sie den Azure Cosmos DB-Zielcontainer mithilfe der Einstellungen, die Sie verwenden möchten (Partitionsschlüssel, Durchsatzgranularität, Anforderungseinheiten, eindeutiger Schlüssel usw.).
2. Erstellen Sie den Containerkopieauftrag.
3. Überwachen des Status des Kopiervorgangs
4. Nachdem alle Dokumente kopiert wurden, beenden Sie die Updates im Quellcontainer und rufen die Fertigstellungs-API auf, um den Auftrag als abgeschlossen zu markieren.
5. Sie setzen die Vorgänge fort, indem Sie die Anwendung oder den Client wie vorgesehen auf den Quell- oder Zielcontainer verweisen.

Wie funktioniert das Kopieren eines Containers?

1. Die Plattform ordnet dem Azure Cosmos DB-Konto für das Ziel serverseitige Compute-Instanzen zu, um die Containerkopieraufträge auszuführen.
2. Ein einzelner Auftrag wird jederzeit in allen Instanzen ausgeführt.
3. Die Onlinekopieraufträge verwenden den Modus Alle Versionen und Änderungsfeed löschen, um die Daten zu kopieren und inkrementelle Änderungen vom Quellcontainer in den Zielcontainer zu replizieren.
4. Nach Abschluss des Auftrags werden diese Instanzen von der Plattform nach 15 Minuten Inaktivität deaktiviert.

Offlinekopie

Beginnen Sie mit der Offlinekopie, indem Sie den Artikel Erstellen, Überwachen und Verwalten von Kopieraufträgen befolgen.

Kopieren der Daten eines Containers

1. Erstellen Sie den Azure Cosmos DB-Zielcontainer mithilfe der Einstellungen, die Sie verwenden möchten (Partitionsschlüssel, Durchsatzgranularität, Anforderungseinheiten, eindeutiger Schlüssel usw.).
2. Beenden Sie die Vorgänge im Quellcontainer, indem Sie die Anwendungsinstanzen oder alle Clients pausieren, die mit ihnen verbunden sind.
3. Erstellen Sie den Containerkopieauftrag.
4. Überwachen Sie den Fortschritt des Containerkopieauftrags und warten Sie, bis er abgeschlossen ist.
5. Sie setzen die Vorgänge fort, indem Sie die Anwendung oder den Client wie vorgesehen auf den Quell- oder Zielcontainer verweisen.

Hinweis

Es wird dringend empfohlen, die Durchführung von Vorgängen im Quellcontainer zu beenden, bevor der Offlinekopierauftrag für den Container gestartet wird. Elementlöschungen und -aktualisierungen, die nach dem Beginn des Kopierauftrags auf dem Quellcontainer durchgeführt werden, werden möglicherweise nicht erfasst. Die Fortsetzung der Vorgänge im Quellcontainer kann während der Bearbeitung des Containerauftrags zu doppelten oder fehlenden Daten im Zielcontainer führen.

Wie funktioniert das Kopieren eines Containers?

1. Die Plattform ordnet dem Azure Cosmos DB-Konto serverseitige Computeinstanzen zu.
2. Diese Instanzen werden zugeordnet, wenn ein oder mehrere Containerkopieraufträge innerhalb des Kontos erstellt werden.
3. Die Containerkopieaufträge werden in diesen Instanzen ausgeführt.
4. Ein einzelner Auftrag wird jederzeit in allen Instanzen ausgeführt.
5. Die Instanzen werden von allen Containerkopieraufträgen, die unter demselben Konto laufen, gemeinsam genutzt.
6. Bei Offlinekopieraufträgen wird der Modus Aktuelle Version des Änderungsfeeds verwendet, um die Daten zu kopieren und inkrementelle Änderungen aus dem Quellcontainer in den Zielcontainer zu replizieren.
7. Die Plattform kann die Zuweisung der Instanzen aufheben, wenn diese länger als 15 Minuten inaktiv sind.

Sie können Kopieraufträge für Offlinesammlungen ausführen, um Daten innerhalb desselben Azure Cosmos DB for MongoDB-Kontos zu kopieren.

Kopieren der Daten einer Auflistung

1. Erstellen Sie die Azure Cosmos DB-Zielauflistung mithilfe der Einstellungen, die Sie verwenden möchten (Partitionsschlüssel, Durchsatzgranularität, Anforderungseinheiten, eindeutiger Schlüssel usw.).
2. Beenden Sie die Vorgänge in der Quellauflistung, indem Sie die Anwendungsinstanzen oder alle Clients anhalten, die damit verbunden sind.
3. Erstellen Sie den Kopierauftrag.
4. Überwachen Sie den Status des Kopierauftrags, und warten Sie, bis er abgeschlossen ist.
5. Setzen Sie die Vorgänge fort, indem Sie die Anwendung oder den Client wie vorgesehen auf die Quell- oder Zielauflistung verweisen.

Hinweis

Es wird dringend empfohlen, die Durchführung von Vorgängen in der Quellauflistung zu beenden, bevor der Offlinekopierauftrag für die Auflistung gestartet wird. Elementlöschungen und -aktualisierungen, die nach dem Beginn des Kopierauftrags in der Quellauflistung durchgeführt werden, werden möglicherweise nicht erfasst. Die Fortsetzung der Vorgänge in der Quellauflistung kann während der Bearbeitung des Kopierauftrags zu doppelten oder fehlenden Daten in der Zielauflistung führen.

Wie funktioniert das Kopieren von Auflistungen?

1. Die Plattform ordnet dem Azure Cosmos DB-Konto serverseitige Computeinstanzen zu.
2. Diese Instanzen werden zugeordnet, wenn mindestens ein Auflistungskopierauftrag im Konto erstellt wird.
3. Die Kopieraufträge werden in diesen Instanzen ausgeführt.
4. Ein einzelner Auftrag wird jederzeit in allen Instanzen ausgeführt.
5. Die Instanzen werden von allen Kopieraufträgen, die unter demselben Konto laufen, gemeinsam genutzt.
6. Die Offlinekopieraufträge verwenden Änderungsdatenströme, um die Daten zu kopieren und inkrementelle Änderungen aus der Quellauflistung in die Zielauflistung zu replizieren.
7. Die Plattform kann die Zuweisung der Instanzen aufheben, wenn diese länger als 15 Minuten inaktiv sind.

Sie können eine Offlinekopie der Tabelle erstellen, um Daten einer Tabelle in eine andere Tabelle innerhalb desselben Azure Cosmos DB for Apache Cassandra-Kontos zu kopieren.

Kopieren der Daten einer Tabelle

1. Erstellen Sie die Azure Cosmos DB-Zieltabelle mithilfe der Einstellungen, die Sie verwenden möchten (Partitionsschlüssel, Durchsatzgranularität, Anforderungseinheiten, eindeutiger Schlüssel usw.).
2. Beenden Sie die Vorgänge in der Quelltabelle, indem Sie die Anwendungsinstanzen oder alle Clients anhalten, die damit verbunden sind.
3. Erstellen Sie den Kopierauftrag.
4. Überwachen Sie den Status des Kopierauftrags, und warten Sie, bis er abgeschlossen ist.
5. Sie setzen die Vorgänge fort, indem Sie die Anwendung oder den Client wie vorgesehen auf die Quell- oder Zieltabelle verweisen.

Hinweis

Es wird dringend empfohlen, die Durchführung von Vorgängen im Quellcontainer zu beenden, bevor der Offlinekopierauftrag für die Tabelle gestartet wird. Elementlöschungen und -aktualisierungen, die nach dem Beginn des Kopierauftrags in der Quelltabelle durchgeführt werden, werden möglicherweise nicht erfasst. Die Fortsetzung der Vorgänge in der Quelltabelle kann während der Bearbeitung des Kopierauftrags zu doppelten oder fehlenden Daten in der Zieltabelle führen.

Wie funktioniert das Kopieren von Tabellen?

1. Die Plattform ordnet dem Azure Cosmos DB-Konto serverseitige Computeinstanzen zu.
2. Diese Instanzen werden zugeordnet, wenn mindestens ein Kopierauftrag im Konto erstellt wird.
3. Die Kopieraufträge werden in diesen Instanzen ausgeführt.
4. Ein einzelner Auftrag wird jederzeit in allen Instanzen ausgeführt.
5. Die Instanzen werden von allen Kopieraufträgen, die unter demselben Konto laufen, gemeinsam genutzt.
6. Die Offlinekopieraufträge verwenden den Änderungsfeed, um die Daten zu kopieren und inkrementelle Änderungen aus der Quelltabelle in die Zieltabelle zu replizieren.
7. Die Plattform kann die Zuweisung der Instanzen aufheben, wenn diese länger als 15 Minuten inaktiv sind.

Faktoren, die sich auf die Geschwindigkeit der Ausführung von Kopieraufträgen auswirken

Die Geschwindigkeit des Containerkopieauftrags wird durch diese Faktoren bestimmt:

• Einstellung des Quellcontainer- oder Datenbankdurchsatzes.

• Einstellung des Zielcontainer- oder Datenbankdurchsatzes.

  Tipp

  Legen Sie den Zielcontainerdurchsatz auf mindestens das Doppelte des Quellcontainerdurchsatzes fest.

• Serverseitige Computeinstanzen, die dem Azure Cosmos DB-Konto zur Ausführung der Datenübertragung zugeordnet sind.

  Wichtig

  Die Standard-SKU beinhaltet zwei 4-vCPU 16-GB-serverseitige Instanzen pro Konto.

Einschränkungen

Vorschauberechtigungskriterien

Containerkopieraufträge funktionieren nicht bei Konten, für die die folgenden Funktionen aktiviert sind. Deaktivieren Sie diese Funktionen, bevor Sie Containerkopieraufträge ausführen:

• Partition zusammenführen
• Deaktivieren der lokalen Authentifizierung

Kontokonfigurationen

Die Einstellung für die Gültigkeitsdauer (Time-to-Live, TTL) wurde im Zielcontainer nicht angepasst. Wenn ein Dokument im Quellcontainer nicht abgelaufen ist, wird der Countdown im Zielcontainer daher neu gestartet.

Häufig gestellte Fragen

Gibt es eine Vereinbarung zum Servicelevel (SLA, Service-Level Agreement) für Containerkopieraufträge?

Containerkopieraufträge werden derzeit bestmöglich unterstützt. Wir bieten keine SLA-Garantien für die Zeit, die bis zum Abschluss der Aufträge benötigt wird.

Kann ich mehrere Containerkopieaufträge in einem Konto erstellen?

Ja. Sie können mehrere Aufträge innerhalb desselben Kontos erstellen. Die Aufträge werden nacheinander ausgeführt. Sie können alle in einem Konto erstellten Aufträge auflisten und deren Fortschritt überwachen.

Kann ich eine komplette Datenbank im Azure Cosmos DB-Konto kopieren?

Sie müssen einen Auftrag für jeden Container in der Datenbank erstellen.

Ich habe ein Azure Cosmos DB-Konto mit mehreren Regionen. In welcher Region wird der Containerkopieauftrag ausgeführt?

Der Containerkopierauftrag wird in der Schreibregion ausgeführt. In einem Konto, das mit Schreibvorgängen in mehreren Regionen konfiguriert ist, wird der Auftrag in einer der Regionen in der Liste der Schreibregionen ausgeführt.

Was geschieht mit den Containerkopieaufträgen, wenn sich die Schreibregion des Kontos ändert?

Die Schreibregion des Kontos kann sich im seltenen Szenario des Ausfalls einer Region oder aufgrund eines manuellen Failovers ändern. In diesem Szenario würden nicht abgeschlossene Containerkopieraufträge, die innerhalb des Kontos erstellt wurden, fehlschlagen. In diesem Fall müssten Sie diese fehlgeschlagenen Aufträge neu erstellen. Die neu erstellten Aufträge werden dann in der neuen (aktuellen) Schreibregion ausgeführt.

Unterstützte Regionen

Derzeit wird die Containerkopie nur in den folgenden Regionen unterstützt:

Nord-, Mittel- und Südamerika	Europa und Afrika	Asien-Pazifik
Brasilien Süd	Frankreich, Mitte	Australien, Mitte
Kanada, Mitte	Frankreich, Süden	Australien, Mitte 2
Kanada, Osten	Deutschland, Norden	Australien (Osten)
USA (Mitte)	Deutschland, Westen-Mitte	Indien, Mitte
USA, Mitte (EUAP)	Nordeuropa	Japan, Osten
East US	Norwegen, Osten	Korea, Mitte
USA (Ost) 2	Norwegen, Westen	Asien, Südosten
USA, Osten 2 (EUAP)	Schweiz, Norden	VAE, Mitte
USA Nord Mitte	Schweiz, Westen	Indien, Westen
USA Süd Mitte	UK, Süden	Asien, Osten
USA, Westen-Mitte	UK, Westen	Malaysia, Süden
USA (Westen)	Europa, Westen	Japan, Westen
USA, Westen 2	Israel, Mitte	Australien, Südosten
Nicht unterstützt	Südafrika, Norden	Nicht unterstützt

Bekannte und häufige Probleme

• Fehler: Besitzerressource ist nicht vorhanden.

  Wenn bei der Auftragserstellung ein Fehler auftritt und der Fehler Besitzerressource nicht vorhanden angezeigt wird (Fehlercode 404), wurde entweder der Zielcontainer noch nicht erstellt, oder der Containername, der zum Erstellen des Auftrags verwendet wird, stimmt nicht mit einem tatsächlichen Containernamen überein.

  Stellen Sie sicher, dass der Zielcontainer erstellt wird, bevor Sie den Auftrag ausführen, und stellen Sie sicher, dass der Containername im Auftrag mit einem tatsächlichen Containernamen übereinstimmt.

  "code": "404",
  "message": "Response status code does not indicate success: NotFound (404); Substatus: 1003; ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; Reason: (Message: {\"Errors\":[\"Owner resource does not exist\"]
  

• Fehler: Die Anforderung ist nicht autorisiert.

  Wenn die Anforderung fehlschlägt und der Fehler Nicht autorisiert angezeigt wird (Fehlercode 401), ist die lokale Autorisierung möglicherweise deaktiviert.

  Containerkopieraufträge verwenden Primärschlüssel zur Authentifizierung. Wenn die lokale Autorisierung deaktiviert ist, schlägt die Auftragserstellung fehl. Die lokale Autorisierung muss aktiviert sein, damit Containerkopieraufträge funktionieren.

  "code": "401",
  "message": " Response status code does not indicate success: Unauthorized (401); Substatus: 5202; ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; Reason: Local Authorization is disabled. Use an AAD token to authorize all requests."
  

• Fehler: Fehler beim Abrufen von Ressourcen für den Auftrag.

  Dieser Fehler kann aufgrund interner Serverprobleme auftreten. Zur Behebung dieses Problems wenden Sie sich an den Microsoft-Support. Erstellen Sie dazu im Azure-Portal eine neue Supportanfrage. Wählen Sie unter Problemtyp die Option Datenmigration aus. Wählen Sie unter Problemuntertyp die Option Kontointerne Containerkopie aus.

  "code": "500"
  "message": "Error while getting resources for job, StatusCode: 500, SubStatusCode: 0, OperationId:  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  

Nächste Schritte

• Informieren Sie sich über das Erstellen, Überwachen und Verwalten von Containerkopieraufträgen innerhalb eines Azure Cosmos DB-Kontos mithilfe von CLI-Befehlen.