Kopieraufträge in Azure Cosmos DB (Vorschau)

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

Falls Sie eines der folgenden Szenarien erreichen möchten, müssen Sie möglicherweise Daten von 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 Sie neue 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.

# Set shell variables.
 $resourceGroupName = <azure_resource_group>
 $accountName = <azure_cosmos_db_account_name>
 $EnableOnlineContainerCopy = "EnableOnlineContainerCopy"

# List down existing capabilities of your account.
 $cosmosdb = az cosmosdb show \
    --resource-group $resourceGroupName \
    --name $accountName

$capabilities = (($cosmosdb | ConvertFrom-Json).capabilities)

# Append EnableOnlineContainerCopy capability in the list of capabilities.
 $capabilitiesToAdd = @()
 foreach ($item in $capabilities) {
    $capabilitiesToAdd += $item.name
 }
 $capabilitiesToAdd += $EnableOnlineContainerCopy

 # Update Cosmos DB account
 az cosmosdb update --capabilities $capabilitiesToAdd \
    -n $accountName -g $resourceGroupName

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

Die Geschwindigkeit des Containerkopierauftrags wird durch diese Faktoren bestimmt:

• Einstellung des Quellcontainer- oder Datenbankdurchsatzes.

• Einstellung des Durchsatzes für den Zielcontainer oder die Datenbank.

  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

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) 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 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 Containerkopieraufträ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:

Bekannte und häufige Probleme

• Beim Verwenden der Online-Container-Kopierfunktion, falls das id-Feld im Quellcontainer geändert wird, speichert der Zielcontainer zwei separate Dokumente, die jeweils den unterschiedlichen id-Werten entsprechen.

• Stellen Sie beim Ändern von Partitionsschlüsseln beim Kopieren in den Zielcontainer sicher, dass der neue Partitionsschlüssel und id die Kombinationen für den gesamten Container eindeutig sind.

  Betrachten Sie z. B. das folgende Szenario:

  Ursprünglicher Partitionsschlüssel:/department
  Quelldokumente:

  {
      "id": "101",
      "employeeName": "John Doe",
      "department": "HR"
  },
  {
      "id": "101",
      "employeeName": "John Doe",
      "department": "Finance"
  }
  

  Neuer Partitionsschlüssel:/employeeName
  Resultierende Dokumente im Zielcontainer:

  {
      "id": "101",
      "employeeName": "John Doe",
      "department": "HR"
  },
  {
      "id": "101",
      "employeeName": "John Doe",
      "department": "Finance"
  }
  

  In diesem Fall verwenden beide Dokumente jetzt denselben Partitionsschlüssel (/employeeName) und id Kombination ("employeeName": "John Doe", "id": "101"), was zu einem Konflikt führt. Dieser Konflikt führt zu einem Einfügefehler. Um solche Probleme zu vermeiden, stellen Sie sicher, dass der neue Partitionsschlüssel und id kombinationen für alle Dokumente im Zielcontainer eindeutig sind.

• Fehler : Partitionsschlüssel erreichte maximale Größe von 20 GB

  Stellen Sie beim Ändern von Partitionsschlüsseln während der Datenkopie in den Zielcontainer sicher, dass der neue Partitionsschlüssel innerhalb des Grenzwerts für die Größe des logischen Partitionsschlüssels von 20 GB verbleibt. Wenn dieser Grenzwert überschritten wird, schlägt der Auftrag mit dem folgenden Fehler fehl:

  "code": "403",
  "message": "Response status code does not indicate success: Forbidden (403); Substatus: 1014; ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; Reason: (Message: {"Errors":["Partition key reached maximum size of 20 GB. Learn more: https://aka.ms/CosmosDB/sql/errors/full-pk"]"
  

• Fehler : Besitzerressource ist nicht vorhanden.

  Wenn die Auftragserstellung fehlschlägt und der Fehler "Besitzerressource ist nicht vorhanden" (Fehlercode 404) angezeigt wird, 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 – 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ächster Schritt

• Erstellen und Verwalten von Containerkopieaufträgen in Azure Cosmos DB