Distribua uma instância de banco de dados federado

Faça login no MongoDB Atlas.

Selecione a Data Federation opção na navegação à esquerda.

Crie uma instância do banco de dados federado.

1. Clique no menu suspenso Create New Federated Database.

2. Selecione Feed Downstream Systems.

Clique em Get Started.

Digite um nome para a instância do banco de dados federado no Federated Database Instance Name campo e clique Continue em.

Padrão é FederatedDatabaseInstance[n]. Depois que sua instância do banco de dados federado for criada, você não poderá alterar seu nome.

Especifique suas fontes de dados.

1. Selecione um Atlas cluster para usar como fonte de dados no menu suspenso. Por padrão, o Atlas Data Federation adiciona todas as coleções neste cluster. Para utilizar um subconjunto dos dados, clique em Specific Collections, expanda os bancos de dados e selecione as coleções que você deseja adicionar à sua instância do banco de dados federado.

   Dica

   Para filtrar os bancos de dados e as coleções, insira texto no campo Specific Collections . A caixa de diálogo exibe somente bancos de dados e collections com nomes que correspondem aos seus critérios de pesquisa.

2. Clique em Continue.

Selecione uma função do Amazon Web Services IAM para o Amazon Web Services Atlas.

Você pode selecionar uma função existente do AWS IAM para a qual o Atlas está autorizado na lista suspensa de seleção de funções ou escolher Authorize an AWS IAM Role para autorizar uma nova função.

Se você selecionou uma role existente para a qual o Atlas está autorizado, prossiga para a próxima etapa para listar seus buckets do Amazon Web Services S3 .

Se você estiver autorizando o Atlas para um papel existente ou estiver criando um novo papel, complete as seguintes etapas antes de prosseguir para a próxima etapa:

1. Na lista suspensa, selecione Authorize an AWS IAM Role para autorizar uma nova função ou selecionar uma função existente.

2. Use o Amazon Web Services ARN e o ID externo exclusivo na seção Role Authorization para adicionar o Atlas ao relacionamento de uma função nova ou existente do Amazon Web Services IAM.

   Na interface do usuário do Atlas , clique em uma das seguintes opções:

   • O Create new AWS IAM role mostra como usar o ARN e o ID externo exclusivo para adicionar Atlas às relações de confiança de uma nova função do Amazon Web Services IAM . Siga as etapas na UI do Atlas para criar um novo papel. Para saber mais, consulte Criar nova função com CLI do Amazon Web Services.

     Ao autorizar uma nova função, se você sair do fluxo de trabalho:

     • Antes de validar a função, o Atlas não criará a instância do banco de dados federado. Você pode Go a Atlas Integrations página do para autorizar uma nova função e, em seguida, iniciar o procedimento para implantar uma instância do banco Amazon Web Services de dados federado novamente quando tiver o ARN da função do IAM .

     • Após validar a função, o Atlas não criará a instância do banco de dados federado. No entanto, o papel está disponível no menu suspenso de seleção de papel e pode ser utilizado para criar uma instância do banco de dados federado. Você não precisa autorizar a role novamente.

   • O Use existing AWS IAM role mostra como usar o ARN e o ID externo exclusivo para adicionar o Atlas ao relacionamento de confiança de uma função existente do Amazon Web Services IAM. Siga as etapas na IU do Atlas para adicionar o Atlas ao relacionamento de confiança para uma função existente. Para saber mais, consulte Adicionar relacionamentos de confiança a uma função existente.

   Importante

   Se você modificar o ARN da função personalizada da Amazon Web Services no futuro, verifique se a política de acesso da função inclui o acesso apropriado aos recursos do S3 para a instância do banco de dados federado.

   Para saber mais, consulte Configurar o acesso unificado ao Amazon Web Services e criar uma função de acesso de fornecedor de nuvem.

3. Clique em Validate AWS IAM role.

Atribua uma política de acesso à sua função IAM do Amazon Web Amazon Web Services Services.

1. Insira o nome do seu bucket no S3 .

2. Siga as etapas na interface do usuário do Atlas para atribuir uma política de acesso ao seu papel do Amazon Web Services IAM.

3. Clique em Validate AWS S3 bucket access.

4. Clique em Continue.

Agende suas extrações de dados.

Agende um trigger para copiar continuamente dados do seu Atlas cluster para o seu bucket S3 usando $out na seção Schedule Queries .

1. Especifique com que frequência você deseja extrair dados do seu Atlas cluster usando os menus suspensos Repeat Once By .

2. Opcional. Especifique se o Atlas Data Federation deve executar novamente a mesma query se a tiver perdido por algum motivo. Por padrão, isso está desabilitado para permitir que o Atlas Data Federation execute novamente queries perdidas. Como alternativa, para ignorar as queries perdidas e não recuperar o atraso, ative Skip Catch Up Events.

3. Opcional. Escolha o formato que você deseja para seus dados quando o Atlas Data Federation gravar no seu bucket S3 . O Atlas Data Federation oferece suporte ao Parquet, CSV , BSON e MongoDB Extended JSON.

4. Especifique o Max File Size para limitar o tamanho que cada arquivo que o Atlas Data Federation grava no seu bucket do S3 pode ser. Por exemplo, se você configurar o Max File Size para 100 MB e uma query retornar 1 GB de dados, o Atlas Data Federation gravará a query em seu bucket S3 em 10 arquivos, cada 100 MBs.

5. Insira o prefixo do Amazon Web Services para o bucket S destino.3

6. Insira o nome do campo de data indexada em Date Field e especifique o formato de seu valor usando o menu suspenso. Cada coleção que você deseja copiar para jusante deve ter um campo indexado que armazene um carimbo de data/hora como seu valor.

7. Clique em Continue.

Clique em Create.

Faça login no MongoDB Atlas.

Selecione a Data Federation opção na navegação à esquerda.

Crie uma instância do banco de dados federado.

1. Clique no menu suspenso Create New Federated Database.

2. Selecione Explore with Sample Data.

Clique em Get Started.

Clique em Create.

Faça login no MongoDB Atlas.

Selecione a Data Federation opção na navegação à esquerda.

Crie uma instância do banco de dados federado.

1. Clique no menu suspenso Create New Federated Database.

2. Selecione Query Data Across Clusters.

Clique em Get Started.

Digite um nome para a instância do banco de dados federado no Federated Database Instance Name campo e clique Continue em.

Padrão é FederatedDatabaseInstance[n]. Depois que sua instância do banco de dados federado for criada, você não poderá alterar seu nome.

Especifique os Atlas clusters para utilizar como fontes de dados.

1. Selecione um Atlas cluster para usar como fonte de dados no menu suspenso. O Atlas exibe somente clusters em seu projeto Atlas atual neste menu suspenso.

2. Expanda os bancos de dados e selecione as coleções que você deseja adicionar à sua instância do banco de dados federado.

   Dica

   Para filtrar os bancos de dados e as coleções, insira texto no campo Specific collections . A caixa de diálogo exibe somente bancos de dados e collections com nomes que correspondem aos seus critérios de pesquisa.

3. Opcional. Expanda as configurações do Cluster Read Preference para configurar os seguintes campos.

   Nome do campo	Descrição
   Read Preference Mode	Especifica o membro do conjunto de réplicas para o qual você deseja rotear as solicitações de leitura. Você pode escolher uma das seguintes opções no menu suspenso: primary - para rotear todas as solicitações de leitura para o conjunto de réplicas primário primaryPreferred - para rotear todas as solicitações de leitura do conjunto de réplicas primário e para membros secundários somente se primary não estiver disponível secondary - para rotear todas as solicitações de leitura para os membros secundários do conjunto de réplicas secondaryPreferred - para rotear todas as solicitações de leitura para os membros secundários do conjunto de réplicas e o primary em clusters fragmentados somente se os membros secondary não estiverem disponíveis nearest - para rotear todas as solicitações de leitura para um membro aleatório qualificado do conjunto de réplicas, independentemente de esse membro ser primário ou secundário Se você adicionar um Atlas cluster como um armazenamento, o valor padrão será secondary. Se você não definir nada na configuração de armazenamento da instância do banco de dados federado , o valor padrão será nearest. Para saber mais, consulte modo de read preference.
   TagSets	Especifica a lista de tags ou documentos de especificação de tags que contêm pares de nome e valor para o membro do conjunto de réplicas para o qual você deseja direcionar as solicitações de leitura. Para saber mais, consulte Conjuntos de tags de read preference.
   Maxstaleness Seconds	Especifica o atraso de replicação ou "obsoleto", para leituras de secundários. Para saber mais, consulte Preferência de leitura maxStalenessSeconds.

4. Clique em Add Atlas cluster and collection e repita estas etapas para todos os Atlas clusters que você deseja utilizar como fontes de dados.

5. Após terminar de adicionar clusters, clique em Continue.

Clique em Create.