Trabalhos de cópia de contêiner no Azure Cosmos DB (visualização)

APLICA-SE A: NoSQL MongoDB Cassandra

Pode realizar cópias de contentores offline numa conta do Azure Cosmos DB ao utilizar trabalhos de cópia de contentores.

Talvez seja necessário copiar dados em sua conta do Azure Cosmos DB se quiser alcançar qualquer um destes cenários:

• Copiar todos os itens de um contentor para outro.
• Altere a granularidade na qual a taxa de transferência é provisionada, de banco de dados para contêiner e vice-versa.
• Alterar a chave de partição de um contentor.
• Atualizar as chaves exclusivas de um contentor.
• Renomeie um contêiner ou banco de dados.
• Altere o modo de capacidade de uma conta de sem servidor para provisionada ou vice-versa.
• Adote novos recursos que são suportados apenas para novos contêineres, por exemplo , chaves de partição hierárquicas.

Os trabalhos de cópia de contêiner podem ser criados e gerenciados usando comandos da CLI do Azure.

Começar

Para começar, registre-se no recurso de visualização relevante no portal do Azure.

Cópia de contêiner entre contas do Azure Cosmos DB

NoSQL API

Para começar a usar a cópia de contêiner offline entre contas para contas de API do Azure Cosmos DB para NoSQL, registre-se para o sinalizador de recurso de visualização de cópia de contêiner offline entre contas (NoSQL) em Visualizar Recursos no portal do Azure. Quando o registo estiver concluído, a pré-visualização fica ativa para todas as contas da API NoSQL da subscrição.

Cópia de contêiner em uma conta do Azure Cosmos DB

API NoSQL e Cassandra

Para começar a usar a cópia de contêiner offline intraconta para contas de API NoSQL e Cassandra, registre-se para o sinalizador de recurso de visualização Cópia de contêiner offline intraconta (Cassandra & NoSQL) em Visualizar Recursos no portal do Azure. Quando o registro estiver concluído, a visualização será efetiva para todas as contas Cassandra e API para NoSQL na assinatura.

API para MongoDB

Para começar a usar a cópia de contêiner offline intraconta para contas do Azure Cosmos DB para MongoDB, registre-se para o sinalizador do recurso de visualização Cópia de coleção offline intraconta (MongoDB) em Visualizar Recursos no portal do Azure. Quando o registo estiver concluído, a pré-visualização fica ativa para todas as contas MongoDB da API na subscrição.

Copiar dados de um contêiner

1. Crie o contêiner do Azure Cosmos DB de destino usando as configurações que você deseja usar (chave de partição, granularidade da taxa de transferência, unidades de solicitação, chave exclusiva e assim por diante).
2. Pare as operações no contêiner de origem pausando as instâncias do aplicativo ou quaisquer clientes que se conectem a ele.
3. Crie o trabalho de cópia de contêiner.
4. Monitore o progresso do trabalho de cópia de contêiner e aguarde até que ele seja concluído.
5. Retome as operações apontando adequadamente o aplicativo ou cliente para a cópia do contêiner de origem ou de destino, conforme pretendido.

Como funciona a cópia de contêiner?

Os trabalhos de cópia de contêiner executam a cópia de dados offline usando o log de alimentação de alterações incrementais do contêiner de origem.

1. A plataforma aloca instâncias de computação do lado do servidor para a conta de destino do Azure Cosmos DB.
2. Essas instâncias são alocadas quando um ou mais trabalhos de cópia de contêiner são criados na conta.
3. Os trabalhos de cópia de contêiner são executados nessas instâncias.
4. Um único trabalho é executado em todas as instâncias a qualquer momento.
5. As instâncias são compartilhadas por todos os trabalhos de cópia de contêiner que estão sendo executados na mesma conta.
6. A plataforma pode desalocar as instâncias se elas estiverem ociosas por mais de 15 minutos.

Nota

Atualmente, suportamos apenas trabalhos de cópia de contêiner offline. É altamente recomendável que você pare de executar quaisquer operações no contêiner de origem antes de iniciar a cópia do contêiner. As exclusões e atualizações de itens feitas no contêiner de origem depois que você inicia o trabalho de cópia podem não ser capturadas. Se você continuar a executar operações no contêiner de origem enquanto o trabalho de contêiner estiver em andamento, poderá ter dados duplicados ou ausentes no contêiner de destino.

Fatores que afetam a taxa de um trabalho de cópia de contêiner

A taxa de progresso do trabalho de cópia de contêiner é determinada por estes fatores:

• A configuração de taxa de transferência do contêiner de origem ou do banco de dados.

• A configuração de taxa de transferência do contêiner ou do banco de dados de destino.

  Gorjeta

  Defina a taxa de transferência do contêiner de destino para pelo menos duas vezes a taxa de transferência do contêiner de origem.

• Instâncias de computação do lado do servidor que são alocadas à conta do Azure Cosmos DB para executar a transferência de dados.

  Importante

  O SKU padrão oferece duas instâncias de 4 vCPU e 16 GB do lado do servidor por conta.

Limitações

Pré-visualizar critérios de elegibilidade

Os trabalhos de cópia de contêiner não funcionam com contas que têm os seguintes recursos habilitados. Desative esses recursos antes de executar trabalhos de cópia de contêiner:

• Desativar autenticação local
• Mesclar partição

Configurações de conta

A configuração TTL (Time to Live) não é ajustada no contêiner de destino. Como resultado, se um documento não tiver expirado no contêiner de origem, ele iniciará sua contagem regressiva novamente no contêiner de destino.

FAQs

Existe um contrato de nível de serviço para trabalhos de cópia de contêiner?

Atualmente, há suporte para trabalhos de cópia de contêiner com base no melhor esforço. Não fornecemos nenhuma garantia de acordo de nível de serviço (SLA) para o tempo que leva para os trabalhos serem concluídos.

Posso criar vários trabalhos de cópia de contêiner em uma conta?

Sim, você pode criar vários trabalhos dentro da mesma conta. Os trabalhos correm consecutivamente. Você pode listar todos os trabalhos criados em uma conta e monitorar seu progresso.

Posso copiar um banco de dados inteiro na conta do Azure Cosmos DB?

Você deve criar um trabalho para cada contêiner no banco de dados.

Tenho uma conta do Azure Cosmos DB com várias regiões. Em qual região o trabalho de cópia de contêiner será executado?

O trabalho de cópia de contêiner é executado na região de gravação. Em uma conta configurada com gravações de várias regiões, o trabalho é executado em uma das regiões na lista de regiões de gravação.

O que acontece com os trabalhos de cópia de contêiner quando a região de gravação da conta é alterada?

A região de gravação da conta pode mudar no cenário raro de uma interrupção de região ou devido a failover manual. Nesse cenário, trabalhos de cópia de contêiner incompletos que foram criados dentro da conta falham. Você precisaria recriar esses empregos fracassados. Em seguida, os trabalhos recriados são executados na nova região de gravação (atual).

Regiões suportadas

Atualmente, a cópia de contêiner é suportada nas seguintes regiões:

Américas	Europa e África	Ásia-Pacífico
Sul do Brasil	França Central	Austrália Central
Canadá Central	Sul de França	Austrália Central 2
Leste do Canadá	Norte da Alemanha	Leste da Austrália
E.U.A. Central	Alemanha Centro-Oeste	Índia Central
E.U.A. Central - EUAP	Europa do Norte	Leste do Japão
E.U.A. Leste	Leste da Noruega	Coreia do Sul Central
E.U.A. Leste 2	Oeste da Noruega	Sudeste Asiático
E.U.A. Leste 2 - EUAP	Norte da Suíça	E.A.U. Central
E.U.A. Centro-Norte	Oeste da Suíça	Oeste da Índia
E.U.A. Centro-Sul	Sul do Reino Unido	Ásia Leste
E.U.A. Centro-Oeste	Oeste do Reino Unido	Malásia Sul
E.U.A. Oeste	Europa Ocidental	Oeste do Japão
E.U.A. Oeste 2	Israel Central	Austrália Sudeste
Não suportado	Norte da África do Sul	Não suportado

Problemas conhecidos e comuns

• Erro - O recurso do proprietário não existe.

  Se a criação do trabalho falhar e exibir o erro O recurso Proprietário não existe (código de erro 404), o contêiner de destino ainda não foi criado ou o nome do contêiner usado para criar o trabalho não corresponde a um nome de contêiner real.

  Verifique se o contêiner de destino foi criado antes de executar o trabalho, conforme especificado na visão geral, e se o nome do contêiner no trabalho corresponde a um nome de contêiner real.

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

• Erro - A solicitação não está autorizada.

  Se a solicitação falhar e exibir o erro Não autorizado (código de erro 401), a autorização local poderá ser desabilitada. Saiba como ativar a autorização local.

  Os trabalhos de cópia de contêiner usam chaves primárias para autenticação. Se a autorização local estiver desativada, a criação de trabalho falhará. A autorização local deve ser habilitada para que os trabalhos de cópia de contêiner funcionem.

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

• Erro - Erro ao obter recursos para o trabalho.

  Este erro pode ocorrer devido a problemas internos do servidor. Para resolver esse problema, contate o Suporte da Microsoft abrindo uma Nova Solicitação de Suporte no portal do Azure. Em Tipo de problema, selecione Migração de dados. Em Subtipo de problema, selecione Cópia de contêiner intra-conta.

  "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
  

Próximos passos

• Saiba como criar, monitorar e gerenciar trabalhos de cópia de contêiner na conta do Azure Cosmos DB usando comandos da CLI.