Leggere in inglese

Condividi tramite


Creare e gestire processi di copia del contenitore in Azure Cosmos DB (anteprima)

I processi di copia consentono di creare copie di contenitori negli account Azure Cosmos DB.

Questo articolo descrive come creare, monitorare e gestire processi di copia usando i comandi dell'interfaccia della riga di comando di Azure.

Prerequisiti

  • È possibile usare il portale Cloud Shell per eseguire i comandi di copia del contenitore. In alternativa, è possibile eseguire i comandi in locale; Assicurarsi di avere scaricato e installato l'interfaccia della riga di comando di Azure nel computer.
  • Attualmente, la copia del contenitore è supportata solo in queste aree. Assicurarsi che l'area di scrittura dell'account appartenga a questo elenco.
  • Installare l'estensione di anteprima di Azure Cosmos DB che contiene i comandi di copia del contenitore.
    az extension add --name cosmosdb-preview
    

Impostare le variabili della shell

Innanzitutto, impostare tutte le variabili usate da ogni singolo script.

$sourceSubId = "<source-subscription-id>" 
$destinationSubId = "<destination-subscription-id>" 
$sourceAccountRG = "<source-resource-group-name>"
$destinationAccountRG = "<destination-resource-group-name>"
$sourceAccount = "<cosmos-source-account-name>"
$destinationAccount = "<cosmos-destination-account-name>"
$jobName = ""
$sourceDatabase = ""
$sourceContainer = ""
$destinationDatabase = ""
$destinationContainer = ""

Assegnare l'autorizzazione di lettura

Nota

Questo passaggio non è obbligatorio se si copiano dati all'interno dello stesso account Azure Cosmos DB.

Durante la copia dei dati da un contenitore di un account al contenitore di un altro account, è necessario concedere l'accesso in lettura del contenitore di origine all'identità dell'account di destinazione per eseguire l'operazione di copia. Seguire questa procedura per assegnare l'autorizzazione di lettura necessaria all'account di destinazione.

Uso dell'identità gestita dal sistema

  1. Impostare il contesto della sottoscrizione di destinazione
    az account set --subscription $destinationSubId
    
  2. Aggiungere un'identità di sistema nell'account di destinazione
    $identityOutput = az cosmosdb identity assign -n $destinationAccount -g $destinationAccountRG
    $principalId = ($identityOutput | ConvertFrom-Json).principalId
    
  3. Impostare l'identità predefinita nell'account di destinazione
    az cosmosdb update -n $destinationAccount -g $destinationAccountRG --default-identity="SystemAssignedIdentity"
    
  4. Impostare il contesto della sottoscrizione di origine
    az account set --subscription $sourceSubId
    
  5. Aggiungere un'assegnazione di ruolo nell'account di origine
    # Read-only access role
    $roleDefinitionId = "00000000-0000-0000-0000-000000000001" 
    az cosmosdb sql role assignment create --account-name $sourceAccount --resource-group $sourceAccountRG --role-definition-id $roleDefinitionId --scope "/" --principal-id $principalId
    
  6. Reimpostare il contesto della sottoscrizione di destinazione
    az account set --subscription $destinationSubId
    

Uso dell'identità gestita assegnata dall'utente

  1. Assegnare una variabile di identità gestita assegnata dall'utente
    $userAssignedManagedIdentityResourceId = "<CompleteResourceIdOfUserAssignedManagedIdentity>"
    
  2. Impostare il contesto della sottoscrizione di destinazione
    az account set --subscription $destinationSubId
    
  3. Aggiungere un'identità gestita assegnata dall'utente nell'account di destinazione
    $identityOutput = az cosmosdb identity assign -n $destinationAccount -g $destinationAccountRG --identities $userAssignedManagedIdentityResourceId
    $principalId = ($identityOutput | ConvertFrom-Json).userAssignedIdentities.$userAssignedManagedIdentityResourceId.principalId
    
  4. Impostare l'identità predefinita nell'account di destinazione
    az cosmosdb update -n $destinationAccount -g $destinationAccountRG --default-identity=UserAssignedIdentity=$userAssignedManagedIdentityResourceId
    
  5. Impostare il contesto della sottoscrizione di origine
    az account set --subscription $sourceSubId
    
  6. Aggiungere un'assegnazione di ruolo nell'account di origine
    $roleDefinitionId = "00000000-0000-0000-0000-000000000001"  # Read-only access role
    az cosmosdb sql role assignment create --account-name $sourceAccount --resource-group $sourceAccountRG --role-definition-id $roleDefinitionId --scope "/" --principal-id $principalId
    
  7. Reimpostare il contesto della sottoscrizione di destinazione
    az account set --subscription $destinationSubId
    

Creare un processo di copia

az cosmosdb copy create `
    --resource-group $destinationAccountRG `
    --job-name $jobName `
    --dest-account $destinationAccount `
    --src-account $sourceAccount `
    --dest-nosql database=$destinationDatabase container=$destinationContainer `
    --src-nosql database=$sourceDatabase container=$sourceContainer
    --mode Online

Monitorare lo stato di avanzamento

Monitorare lo stato di avanzamento usando il comando seguente.

az cosmosdb copy show `
    --resource-group $destinationAccountRG `
    --account-name $destinationAccount `
    --job-name $jobName
  1. Conteggio totale: rappresenta il numero totale di modifiche (documento totale + eventuali nuove modifiche) nel contenitore di origine in qualsiasi momento.
  2. Conteggio elaborato: rappresenta il numero totale di eventi provenienti dal feed di modifiche del contenitore di origine che sono stati elaborati dal processo di copia.

Completare il processo di copia

  1. Quando il conteggio elaborato diventa maggiore o uguale al conteggio totale, disattivare tutti gli aggiornamenti nel contenitore di origine e attendere 5-10 minuti per scaricare eventuali modifiche rimanenti.
  2. Eseguire l'API di completamento per completare il processo di copia e liberare risorse di calcolo, verranno scritte anche le modifiche rimanenti (se presenti) nel contenitore di destinazione.
    az cosmosdb copy complete `
        --resource-group $destinationAccountRG `
        --account-name $destinationAccount `
        --job-name $jobName
  1. Aggiornare le applicazioni client per iniziare a usare il nuovo contenitore (destinazione) se necessario.

Impostare le variabili della shell

Innanzitutto, impostare tutte le variabili usate da ogni singolo script.

$destinationRG = "<destination-resource-group-name>"
$sourceAccount = "<cosmos-source-account-name>"
$destinationAccount = "<cosmos-destination-account-name>"
$jobName = ""
$sourceDatabase = ""
$sourceCollection = ""
$destinationDatabase = ""
$destinationCollection = ""

Creare un processo di copia

Creare un processo per copiare una raccolta all'interno di un account DELL'API Azure Cosmos DB per MongoDB:

az cosmosdb copy create `
    --resource-group $destinationRG `
    --job-name $jobName `
    --dest-account $destinationAccount `
    --src-account $sourceAccount `
    --dest-mongo database=$destinationDatabase collection=$destinationCollection `
    --src-mongo database=$sourceDatabase collection=$sourceCollection 

Nota

--job-name deve essere univoco per ogni processo all'interno di un account.

Impostare le variabili della shell

Innanzitutto, impostare tutte le variabili usate da ogni singolo script.

$destinationRG = "<destination-resource-group-name>"
$sourceAccount = "<cosmos-source-account-name>"
$destinationAccount = "<cosmos-destination-account-name>"
$jobName = ""
$sourceKeySpace = ""
$sourceTable = ""
$destinationKeySpace = ""
$destinationTable = ""

Creare un processo di copia

Creare un processo per copiare una tabella in un account Azure Cosmos DB per Apache Cassandra:

az cosmosdb copy create `
    --resource-group $destinationRG `
    --job-name $jobName `
    --dest-account $destinationAccount `
    --src-account $sourceAccount `
    --dest-cassandra keyspace=$destinationKeySpace table=$destinationTable `
    --src-cassandra keyspace=$sourceKeySpace table=$sourceTable 

Nota

--job-name deve essere univoco per ogni processo all'interno di un account.

Gestione dei processi di copia

Monitorare lo stato di avanzamento di un processo di copia

Visualizzare lo stato e lo stato di un processo di copia:

az cosmosdb copy show `
    --resource-group $destinationAccountRG `
    --account-name $destinationAccount `
    --job-name $jobName

Elencare tutti i processi di copia creati in un account

Per elencare tutti i processi di copia creati in un account:

az cosmosdb copy list `
    --resource-group $destinationAccountRG `
    --account-name $destinationAccount

Sospendere un processo di copia

Per sospendere un processo di copia in corso, è possibile usare il comando :

az cosmosdb copy pause `
    --resource-group $destinationAccountRG `
    --account-name $destinationAccount `
    --job-name $jobName

Riprendere un processo di copia

Per riprendere un processo di copia in corso, è possibile usare il comando :

az cosmosdb copy resume `
    --resource-group $destinationAccountRG `
    --account-name $destinationAccount `
    --job-name $jobName

Annullare un processo di copia

Per annullare un processo di copia in corso, è possibile usare il comando :

az cosmosdb copy cancel `
    --resource-group $destinationAccountRG `
    --account-name $destinationAccount `
    --job-name $jobName

Ottenere supporto per i problemi di copia

Per i problemi relativi a un processo di copia, generare una nuova richiesta di supporto dal portale di Azure. Impostare il tipo di problema come sottotipo "Migrazione dati" e "Copia contenitore".

Passaggi successivi

  • Per altre informazioni sui processi di copia dei contenitori, vedere Copiare i processi.