Attività di copia in Azure Cosmos DB (anteprima)

È possibile eseguire la copia dei dati in Azure Cosmos DB usando i processi di copia del contenitore.

Potrebbe essere necessario copiare dati dall'account Azure Cosmos DB se si vuole ottenere uno di questi scenari:

• Copiare tutti gli elementi da un contenitore a un altro.
• Modificare la granularità in base alla quale viene effettuato il provisioning della velocità effettiva, da database a contenitore e viceversa.
• Modificare la chiave di partizione di un contenitore.
• Aggiornare le chiavi univoche di un contenitore.
• Rinominare un contenitore o un database.
• Modificare la modalità di capacità di un account da serverless a con provisioning o viceversa.
• Adottare nuove funzionalità supportate solo per i nuovi contenitori, ad esempio chiavi di partizione gerarchica.

I processi di copia possono essere creati e gestiti usando i comandi dell'interfaccia della riga di comando di Azure.

Fattori che influiscono sulla velocità di una copiatura

La velocità di avanzamento del processo di copia del contenitore è determinata da questi fattori:

• Impostazione di velocità effettiva del contenitore o del database di origine.

• Impostazione di velocità effettiva del contenitore o del database di destinazione.

  Suggerimento

  Impostare la velocità effettiva del contenitore di destinazione su un valore pari ad almeno il doppio della velocità effettiva del contenitore di origine.

• Istanze di calcolo lato server allocate all'account Azure Cosmos DB per l'esecuzione del trasferimento dei dati.

  Importante

  Lo SKU predefinito offre due istanze lato server da 16 GB con 4 vCPU per account.

Limiti

Criteri di idoneità per l'anteprima

Le operazioni di copia dei contenitori non funzionano con gli account che hanno abilitate le seguenti funzionalità. Disabilitare queste funzionalità prima di eseguire i processi di copia del contenitore:

• Unisci partizione
• Disabilita autenticazione locale

Configurazioni dell'account

L'impostazione relativa alla Durata del ciclo di vita (TTL) non viene modificata nel contenitore di destinazione. Di conseguenza, se un documento non è scaduto nel contenitore di origine, avvia nuovamente il conto alla rovescia nel contenitore di destinazione.

Domande frequenti

Esiste un contratto di servizio per i processi di copia del contenitore?

I processi di copia del contenitore sono attualmente supportati in base al principio del massimo impegno. Non vengono fornite garanzie relative al contratto di servizio per il tempo necessario per il completamento dei processi.

È possibile creare più processi di copia del contenitore all'interno di un account?

Sì, è possibile creare più lavori all'interno dello stesso account. I lavori verranno eseguiti consecutivamente. È possibile elencare tutti i processi creati all'interno di un account e monitorarne lo stato.

È possibile copiare un intero database all'interno dell'account Azure Cosmos DB?

È necessario creare un processo per ogni contenitore nel database.

Ho un account Azure Cosmos DB con più aree. In quale area verrà eseguito il processo di copia del contenitore?

Il processo di copia del contenitore viene eseguito nell'area di scrittura. In un account configurato con le scritture in più aree, il processo viene eseguito in una delle aree presenti nell'elenco delle aree di scrittura.

Cosa accade alle attività di copia dei container se cambia l'area di scrittura dell'account?

L'area di scrittura dell'account potrebbe cambiare nell'improbabile caso di un'interruzione di servizio nell'area o a causa del failover manuale. In questo scenario, i processi di copia del contenitore incompleti creati all'interno dell'account avranno esito negativo. Sarà necessario creare nuovamente questi processi non riusciti. I processi ricreati vengono quindi eseguiti nella nuova (corrente) area di scrittura.

Aree geografiche supportate

Attualmente, la copia del contenitore è supportata nelle aree seguenti:

Problemi noti e comuni

• Quando si usa la funzionalità di copia del contenitore online, se il id campo viene modificato nel contenitore di origine, il contenitore di destinazione archivia due documenti separati, ognuno corrispondente ai valori distinti id .

• Quando si modificano le chiavi di partizione durante la copia dei dati nel contenitore di destinazione, assicurarsi che le nuove combinazioni e id chiave di partizione siano univoche nel contenitore.

  Ad esempio, si consideri il seguente scenario:

  Chiave di partizione originale:/department
  Documenti di origine:

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

  Nuova chiave di partizione:/employeeName
  Documenti risultanti nel contenitore di destinazione:

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

  In questo caso, entrambi i documenti condividono ora la stessa chiave di partizione (/employeeName) e la combinazione (id"employeeName": "John Doe", "id": "101"), che causa un conflitto. Questo conflitto genera un errore di inserimento. Per evitare questi problemi, assicurarsi che la nuova chiave di partizione e id le nuove combinazioni siano univoche in tutti i documenti nel contenitore di destinazione.

• Errore : la chiave di partizione ha raggiunto le dimensioni massime di 20 GB

  Quando si modificano le chiavi di partizione durante la copia dei dati nel contenitore di destinazione, assicurarsi che la nuova chiave di partizione rimanga entro il limite di dimensioni della chiave di partizione logica di 20 GB. Se questo limite viene superato, il processo avrà esito negativo con l'errore seguente:

  "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"]"
  

• Errore: La risorsa proprietaria non esiste.

  Se la creazione del processo ha esito negativo e restituisce l'errore La risorsa proprietaria non esiste (codice errore 404), il contenitore di destinazione non è stato ancora creato o il nome del contenitore usato per creare il processo non corrisponde a un nome di contenitore effettivo.

  Assicurarsi che il contenitore di destinazione venga creato prima di eseguire il processo e assicurarsi che il nome del contenitore nel processo corrisponda a un nome di contenitore effettivo.

  "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\"]
  

• Errore: La richiesta non è autorizzata.

  Se la richiesta ha esito negativo e restituisce l'errore Non autorizzato (codice errore 401), l'autorizzazione locale potrebbe essere disabilitata.

  I processi di copia del contenitore usano le chiavi primarie per l'autenticazione. Se l'autorizzazione locale è disabilitata, la creazione del processo ha esito negativo. L'autorizzazione locale deve essere abilitata affinché le operazioni di copia dei container funzionino.

  "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."
  

• Errore: Errore durante il recupero delle risorse per il compito.

  Questo errore può verificarsi a causa di problemi interni del server. Per risolvere questo problema, contattare il supporto tecnico Microsoft aprendo una Nuova richiesta di supporto nel portale di Azure. Per Tipo di problema: selezionare Migrazione dei dati. Per Sottotipo problema, selezionare Copia del contenitore all'interno dell'account.

  "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
  

Passaggi successivi

• Informazioni su come creare, monitorare e gestire i processi di copia del contenitore nell'account Azure Cosmos DB usando i comandi dell'interfaccia della riga di comando.