Compartilhar via


Configurar o MongoDB Atlas em uma atividade de cópia

Este artigo descreve como usar a atividade de cópia no pipeline de dados para copiar dados de e para o MongoDB Atlas.

Configuração com suporte

Para a configuração de cada guia em atividade de cópia, vá para as seções a seguir, respectivamente.

Geral

Consulte as diretrizes de Configurações Geraispara definir a guia Configurações Gerais.

Fonte

Acesse a guia Origem para configurar a origem da atividade de cópia. Consulte o conteúdo a seguir para obter a configuração detalhada.

Screenshot showing source tab and the list of properties.

As seguintes propriedades são necessárias:

  • Tipo de armazenamento de dados: selecione Externo.
  • Conexão: selecione uma conexão do MongoDB Atlas na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão do MongoDB selecionando Nova.
  • Banco de dados: selecione o banco de dados na lista suspensa.
  • Nome da coleção: especifique o nome da coleção no banco de dados do MongoDB Atlas. Você pode selecionar a coleção na lista suspensa ou selecionar Editar para inseri-la manualmente.

Em Avançado, você pode especificar os seguintes campos:

  • Filtro: especifica o filtro de seleção usando operadores de consulta. Para retornar todos os documentos em uma coleção, omita esse parâmetro ou passe um documento vazio ({}).

  • Métodos de cursor: selecione + Novo para especificar a maneira como a consulta subjacente é executada. As maneiras de executar a consulta são:

    • project: especifica os campos a serem retornados nos documentos para projeção. Para retornar todos os campos nos documentos correspondentes, omita este parâmetro.
    • sort: especifica a ordem na qual a consulta retorna documentos correspondentes. Consulte cursor.sort().
    • limit: especifica o número máximo de documentos que o servidor retorna. Consulte cursor.limit().
    • skip: especifica o número de documentos a serem ignorados e de onde o MongoDB Atlas começa a retornar resultados. Consulte cursor.skip().
  • Tamanho do lote: especifica o número de documentos a serem retornados em cada lote da resposta da instância do MongoDB Atlas. Na maioria dos casos, modificar o tamanho do lote não afetará o usuário ou o aplicativo.

  • Colunas adicionais: adicione colunas de dados adicionais para armazenar o caminho relativo ou o valor estático dos arquivos de origem. A expressão tem suporte para o último.

Destino

Acesse a guia Destino para configurar o destino da atividade de cópia. Consulte o conteúdo a seguir para obter a configuração detalhada.

Screenshot showing destination tab and the list of properties.

As seguintes propriedades são necessárias:

  • Tipo de armazenamento de dados: selecione Externo.
  • Conexão: selecione uma conexão do MongoDB Atlas na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão do MongoDB selecionando Nova.
  • Banco de dados: selecione o banco de dados na lista suspensa.
  • Nome da coleção: especifique o nome da coleção no banco de dados do MongoDB Atlas. Você pode selecionar a coleção na lista suspensa ou selecionar Editar para inseri-la manualmente.

Em Avançado, você pode especificar os seguintes campos:

  • Comportamento de gravação: descreve como gravar dados no MongoDB Atlas. Valores permitidos: Insert e Upsert.

    O comportamento de Upsert é substituir o documento se um documento com a mesma _id já existir; caso contrário, insira o documento.

    Observação

    O serviço gera automaticamente uma _id para um documento se uma _id não for especificada no documento original ou no mapeamento de coluna. Isso significa que, para Upsert funcionar conforme esperado, o documento deve ter uma ID.

  • Tempo limite do lote de gravação: Especifique o tempo de espera para que a operação de inserção em lote termine antes de atingir o tempo limite. O valor permitido é timespan.

  • Tamanho do lote de gravação: essa propriedade controle o tamanho dos documentos gravados em cada lote. Você tentar aumentar o valor para melhorar o desempenho e diminuir o valor se o tamanho do documento for grande.

Mapeamento

Para a configuração da guia Mapeamento, acesse Configurar seus mapeamentos na guia mapeamento. Não há suporte para o mapeamento quando a origem e o destino são dados hierárquicos.

Configurações

Para configuração da guia Configurações, acesse Definir suas outras configurações na guia configurações.

Resumo da tabela

A tabela a seguir contém mais informações sobre a atividade de cópia no MongoDB Atlas.

Informações de origem

Nome Descrição Valor Obrigatório Propriedade de script JSON
Tipo de armazenamento de dados Seu tipo de armazenamento de dados. Externo Yes /
Conexão Sua conexão com o armazenamento de dados de origem. < sua conexão do MongoDB Atlas > Sim connection
Backup de banco de dados Seu banco de dados que você usa como origem. <o banco de dados> Sim Banco de Dados
Nome da coleção Nome da coleção no banco de dados MongoDB Atlas. < sua coleção > Sim collection
Filter O filtro de seleção que usa operadores de consulta. Para retornar todos os documentos em uma coleção, omita esse parâmetro ou passe um documento vazio ({}). < seu filtro de seleção > Não filtro
Métodos de cursor A maneira como a consulta subjacente é executada. project
sort
limit
skip
Não cursorMethods:
• project
• sort
• limit
• skip
Tamanho do lote O número de documentos a serem retornados em cada lote da resposta da instância do MongoDB Atlas. <seu tamanho do lote de gravação>
(o padrão é 100)
Não batchSize
Colunas adicionais Adicione colunas de dados adicionais para armazenar o caminho relativo ou o valor estático dos arquivos de origem. A expressão tem suporte para o último. • Nome
• Valor
Não additionalColumns:
• nome
• valor

Informações de destino

Nome Descrição Valor Obrigatório Propriedade de script JSON
Tipo de armazenamento de dados Seu tipo de armazenamento de dados. Externo Yes /
Conexão Sua conexão com o armazenamento de dados de destino. < sua conexão do MongoDB Atlas > Sim connection
Backup de banco de dados O banco de dados que você usa como destino. <o banco de dados> Sim Banco de Dados
Nome da coleção Nome da coleção no banco de dados MongoDB Atlas. < sua coleção > Sim collection
Comportamento de gravação Descreve como gravar dados no MongoDB Atlas. Valores permitidos: Insert e Upsert.

O comportamento de Upsert é substituir o documento se um documento com a mesma _id já existir; caso contrário, insira o documento.

Observação: o serviço gera automaticamente uma _id para um documento se uma _id não for especificada no documento original ou no mapeamento de coluna. Isso significa que, para Upsert funcionar conforme esperado, o documento deve ter uma ID.
Insert (padrão)
Executar upsert
Não writeBehavior:
• insert
• upsert
Tempo limite de gravação em lote O tempo de espera para o lote inserir operação seja concluída antes de expirar. TimeSpan
(o padrão é 30:00:00 - 30 minutos)
Não writeBatchTimeout
Tamanho do lote de gravação Controla o tamanho dos documentos gravados em cada lote. Você pode tentar aumentar esse valor para melhorar o desempenho e diminuir o valor se o tamanho do documento for grande. <seu tamanho do lote de gravação> Não writeBatchSize