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.
- È 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
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 = ""
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
- Impostare il contesto della sottoscrizione di destinazione
az account set --subscription $destinationSubId
- Aggiungere un'identità di sistema nell'account di destinazione
$identityOutput = az cosmosdb identity assign -n $destinationAccount -g $destinationAccountRG $principalId = ($identityOutput | ConvertFrom-Json).principalId
- Impostare l'identità predefinita nell'account di destinazione
az cosmosdb update -n $destinationAccount -g $destinationAccountRG --default-identity="SystemAssignedIdentity"
- Impostare il contesto della sottoscrizione di origine
az account set --subscription $sourceSubId
- 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
- Reimpostare il contesto della sottoscrizione di destinazione
az account set --subscription $destinationSubId
Uso dell'identità gestita assegnata dall'utente
- Assegnare una variabile di identità gestita assegnata dall'utente
$userAssignedManagedIdentityResourceId = "<CompleteResourceIdOfUserAssignedManagedIdentity>"
- Impostare il contesto della sottoscrizione di destinazione
az account set --subscription $destinationSubId
- 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
- Impostare l'identità predefinita nell'account di destinazione
az cosmosdb update -n $destinationAccount -g $destinationAccountRG --default-identity=UserAssignedIdentity=$userAssignedManagedIdentityResourceId
- Impostare il contesto della sottoscrizione di origine
az account set --subscription $sourceSubId
- 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
- Reimpostare il contesto della sottoscrizione di destinazione
az account set --subscription $destinationSubId
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 usando il comando seguente.
az cosmosdb copy show `
--resource-group $destinationAccountRG `
--account-name $destinationAccount `
--job-name $jobName
- Conteggio totale: rappresenta il numero totale di modifiche (documento totale + eventuali nuove modifiche) nel contenitore di origine in qualsiasi momento.
- 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.
- 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.
- 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
- Aggiornare le applicazioni client per iniziare a usare il nuovo contenitore (destinazione) se necessario.
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 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.
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 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.
Visualizzare lo stato e lo stato di un processo di copia:
az cosmosdb copy show `
--resource-group $destinationAccountRG `
--account-name $destinationAccount `
--job-name $jobName
Per elencare tutti i processi di copia creati in un account:
az cosmosdb copy list `
--resource-group $destinationAccountRG `
--account-name $destinationAccount
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
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
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
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".
- Per altre informazioni sui processi di copia dei contenitori, vedere Copiare i processi.