Menu Docs

Página inicial do DocsMongoDB Ops Manager

Construtor de pipeline de agregação

Nesta página

  • Funções obrigatórias
  • Acessar o Criador de Pipeline de Agregação
  • Criar um pipeline de agregação
  • Exportar um pipeline de agregação para o idioma do acionador
  • Configurações do pipeline de agregação

O Data Explorer fornece um construtor depipeline de agregação do para processar seus dados. Os aggregation pipelines transformam seus documentos em resultados agregados com base em estágios de pipeline selecionados.

O construtor de pipeline de agregação do MongoDB Atlas é projetado principalmente para criar pipelines, em vez de executá-los. O construtor de pipeline oferece uma maneira fácil de exportar sua pipeline para ser executada em um driver.

Para interagir com dados na UI do Ops Manager:

  1. Clique em Deployment na navegação à esquerda.

  2. Selecione a implantação do MongoDB desejada.

  3. Selecione a guia Data.

Para criar e executar pipelines de agregação no Data Explorer, você deve ter recebido pelo menos o papel Project Data Access Read Only .

Para utilizar o estágio $out em seu pipeline, você deve ter recebido pelo menos a função Project Data Access Read/Write .

1

O painel principal e Namespaces no lado esquerdo listam as collections na base de dados.

Captura de tela destacando reconhecimento de data center no chave de criptografia de dados (DEK).
2

O painel principal exibe as visualizações Find, Indexes e Aggregation .

3

Quando abre pela primeira vez a vista Aggregation , o Data Explorer exibe um pipeline de agregação vazio.

Visualização inicial do construtor de pipeline de agregação.
clique para ampliar
1

Selecione um estágio de agregação no menu suspenso Select no painel inferior esquerdo.

Captura de tela mostrando a seleção de um estágio de pipeline.
clique para ampliar

O botão à direita do menu suspenso determina se o o estágio está ativado.

2

Preencha seu estágio com os valores apropriados. Se o Modo de Comentário estiver habilitado, o construtor de pipeline fornecerá diretrizes sintáticas para o estágio selecionado.

À medida que você modifica seu estágio, o Data Explorer atualiza os documentos de visualização à direita com base nos resultados do estágio atual.

Captura de tela mostrando um resultado do estágio do pipeline.
clique para ampliar
3

Há duas maneiras de adicionar estágios adicionais ao seu pipeline:

  • Clique no botão Add Stage na parte inferior do pipeline para adicionar um novo estágio no final do pipeline:

  • Clique no botão em um estágio para adicionar um novo estágio diretamente após o estágio em que o botão foi clicado.

Captura de tela destacando o botão Adicionar estágio.

Para excluir uma etapa do pipeline, clique em ícone no estágio desejado.

4

Use o agrupamento para especificar regras específicas do idioma para comparação de cadeias de caracteres, como regras para letras maiúsculas e acentos.

Para especificar um documento de agrupamento, clique em Collation na parte superior do construtor de pipeline.

Um documento de agrupamento tem os seguintes campos:

{
locale: <string>,
caseLevel: <boolean>,
caseFirst: <string>,
strength: <int>,
numericOrdering: <boolean>,
alternate: <string>,
maxVariable: <string>,
backwards: <boolean>
}

O campo locale é obrigatório; todos os outros campos de agrupamento são opcionais. Para obter descrições dos campos, consulte Documento de agrupamento.

Você pode importar pipelines de agregação de texto sem formatação para o construtor de pipelines para modificar e verificar facilmente seus pipelines.

Para importar um pipeline de texto sem formatação:

1
  1. Clique na seta ao lado do ícone de "mais" na parte superior do construtor de pipeline.

  2. Clique em New Pipeline from Text.

    Captura de tela abrindo o novo pipeline a partir da caixa de diálogo de texto.
    clique para ampliar
2

Seu pipeline deve corresponder à sintaxe do parâmetro pipeline do método db.collection.aggregate() .

3
4

Para retornar seu pipeline ao estado inicial em branco, clique no ícone de "mais" na parte superior do construtor de pipeline.

Você pode usar o construtor de pipeline de agregação para exportar seu pipeline finalizado para uma das linguagens de driver compatíveis; Java, Nó, C# e Python 3. Use esse recurso para formatar e exportar pipelines para uso em seus aplicativos.

Para exportar seu aggregation pipeline:

1

Para obter instruções sobre como criar um pipeline de agregação, consulte Criar um pipeline de agregação.

2
3

No menu suspenso Export Pipeline To, selecione o idioma desejado.

O painel My Pipeline à esquerda exibe seu pipeline na sintaxe mongosh .

O painel à direita exibe seu pipeline no idioma selecionado.

4

(Opcional): marque a opção Include Import Statements para incluir as declarações de importação necessárias para o idioma selecionado.

5

Clique no botão Copy no canto superior direito do pipeline para copiar o pipeline para o idioma selecionado na área de transferência. Agora você pode integrar seu pipeline em seu aplicativo.

6

Para modificar as configurações do construtor de pipeline de agregação:

1
Botão de configurações de screenshot destacando pipeline.
2

Você pode modificar as seguintes configurações:

Contexto
Descrição
default
Comment Mode

Quando ativado, o Data Explorer adiciona comentários auxiliares a cada estágio.

Observação

A alteração dessa configuração afeta apenas novos estágios e não modifica os estágios que já foram adicionados ao seu pipeline.

Ligado
Number of Preview Documents
Quantidade de documentos a serem exibidos na visualização de cada estágio.
20
3
← managed índices no chave de criptografia de dados (DEK)