MongoDB C# - Dados Semiestruturados e Subdocumentos

Neste tutorial, vamos explorar como lidar com dados semiestruturados e📊 Behavior-Driven Development: Testes que Todo Mundo Entende!📊 Behavior-Driven Development: Testes que Todo Mundo Entende!Descubra como o BDD transforma testes em linguagens acessíveis. Aprenda a usar SpecFlow em C# para criar testes claros, colaborativos e sem ambiguidades. documentosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025. aninhados no MongoDBO que é MongoDB e por que utilizá-lo com C# em 2025O que é MongoDB e por que utilizá-lo com C# em 2025Descubra como MongoDB e C# unem flexibilidade e escalabilidade para criar soluções modernas e eficientes em um cenário NoSQL inovador em 2025., usando C# como linguagem de apoio. O objetivo é mostrar como aproveitar a flexibilidade do MongoDBO que é MongoDB e por que utilizá-lo com C# em 2025O que é MongoDB e por que utilizá-lo com C# em 2025Descubra como MongoDB e C# unem flexibilidade e escalabilidade para criar soluções modernas e eficientes em um cenário NoSQL inovador em 2025. para armazenar estruturas complexas, sem perder a clareza e a eficiência⏱️ Testes de Performance: Garanta Velocidade Além da Funcionalidade!⏱️ Testes de Performance: Garanta Velocidade Além da Funcionalidade!Descubra como medir, diagnosticar e otimizar performance em aplicações .NET com dicas práticas e ferramentas essenciais para devs. no acesso ou manipulação dos dados.

Entendendo dados semiestruturados em MongoDB🔗

O MongoDBO que é MongoDB e por que utilizá-lo com C# em 2025O que é MongoDB e por que utilizá-lo com C# em 2025Descubra como MongoDB e C# unem flexibilidade e escalabilidade para criar soluções modernas e eficientes em um cenário NoSQL inovador em 2025. lida muito bem com informações semiestruturadas, pois seus documentosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025. (armazenados em formato semelhante a JSON) suportam:

A principal vantagem em lidar com semiestruturados é a facilidade de adaptar os dados ao longo do ciclo de vida🧠 Variáveis em C#: Onde os Dados Ganham Vida (e Nome!)🧠 Variáveis em C#: Onde os Dados Ganham Vida (e Nome!)Descubra como as variáveis em C# funcionam, com exemplos do mundo real, boas práticas de nomeação e dicas para otimizar seu código. da aplicação, sem a necessidade de grandes migrações de schema ou reestruturações complexas.

Documentos aninhados: um recurso poderoso🔗

Em MongoDBO que é MongoDB e por que utilizá-lo com C# em 2025O que é MongoDB e por que utilizá-lo com C# em 2025Descubra como MongoDB e C# unem flexibilidade e escalabilidade para criar soluções modernas e eficientes em um cenário NoSQL inovador em 2025., documentosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025. aninhados (ou subdocumentos) permitem organizar informações relacionadas dentro de um único registroEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025.. Isso pode eliminar a necessidade de relacionamentos externos em muitos casos, simplificando a estrutura. Abaixo, um exemplo de documentoEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025. aninhado em MongoDB (exibido em JSON simplificado):

{
  "_id": "63e46f...",
  "nome": "Maria Silva",
  "idade": 29,
  "endereco": {
    "rua": "Av. Brasil",
    "numero": 100,
    "cidade": "São Paulo"
  },
  "telefones": [
    { "tipo": "celular", "numero": "9999-8888" },
    { "tipo": "fixo", "numero": "011-3333-2222" }
  ]
}

Observe que o campo endereco armazena um documentoEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025. dentro do documentoEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025. principal, e📊 Behavior-Driven Development: Testes que Todo Mundo Entende!📊 Behavior-Driven Development: Testes que Todo Mundo Entende!Descubra como o BDD transforma testes em linguagens acessíveis. Aprenda a usar SpecFlow em C# para criar testes claros, colaborativos e sem ambiguidades. telefones é um array de documentosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025..

Mapeando documentos no C#🔗

Para manipular estes documentosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025. aninhados em C#, você pode definir classes🏗️ Classes vs. Structs: Quando Usar Cada Uma (e Não Quebrar a Cabeça)!🏗️ Classes vs. Structs: Quando Usar Cada Uma (e Não Quebrar a Cabeça)!Descubra como escolher entre classes e structs em C#. Aprenda sobre alocação de memória, passagem por valor e referência, e performance nesta explicação clara. que reflitam essa estrutura de dados. O driver oficial do MongoDB para .NET faz o mapeamento automático🌍 Projeto: API de E-Commerce com ASP.NET Core e SQL Server!🌍 Projeto: API de E-Commerce com ASP.NET Core e SQL Server!Aprenda a construir uma API robusta para e-commerce com ASP.NET Core, EF Core, JWT e Swagger, validando suas habilidades em um projeto prático real. entre classes e documentos BSON. Veja um exemplo:

using MongoDB.Bson;
using MongoDB.Bson.Serialization.Attributes;
using System.Collections.Generic;
public class Pessoa
{
    [BsonId]
    public ObjectId Id { get; set; }
    public string Nome { get; set; }
    public int Idade { get; set; }
    public Endereco Endereco { get; set; }
    public List<Telefone> Telefones { get; set; }
}
public class Endereco
{
    public string Rua { get; set; }
    public int Numero { get; set; }
    public string Cidade { get; set; }
}
public class Telefone
{
    public string Tipo { get; set; }
    public string Numero { get; set; }
}

Observações importantes

1. Use [BsonId] para indicar ao MongoDB qual propriedade⚡ Propriedades: Get e Set com Elegância (e sem Campos Privados Bagunçados)!⚡ Propriedades: Get e Set com Elegância (e sem Campos Privados Bagunçados)!Aprenda como utilizar propriedades em C# para encapsular dados, validar informações e manter um código organizado, seguro e de fácil manutenção. representa o _id.

2. As propriedades⚡ Propriedades: Get e Set com Elegância (e sem Campos Privados Bagunçados)!⚡ Propriedades: Get e Set com Elegância (e sem Campos Privados Bagunçados)!Aprenda como utilizar propriedades em C# para encapsular dados, validar informações e manter um código organizado, seguro e de fácil manutenção. simples (como Nome, Idade) são gravadas diretamente no documentoEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025..

3. As propriedades⚡ Propriedades: Get e Set com Elegância (e sem Campos Privados Bagunçados)!⚡ Propriedades: Get e Set com Elegância (e sem Campos Privados Bagunçados)!Aprenda como utilizar propriedades em C# para encapsular dados, validar informações e manter um código organizado, seguro e de fácil manutenção. complexas (Endereco e📊 Behavior-Driven Development: Testes que Todo Mundo Entende!📊 Behavior-Driven Development: Testes que Todo Mundo Entende!Descubra como o BDD transforma testes em linguagens acessíveis. Aprenda a usar SpecFlow em C# para criar testes claros, colaborativos e sem ambiguidades. Telefones) são convertidas em subdocumentos e📊 Behavior-Driven Development: Testes que Todo Mundo Entende!📊 Behavior-Driven Development: Testes que Todo Mundo Entende!Descubra como o BDD transforma testes em linguagens acessíveis. Aprenda a usar SpecFlow em C# para criar testes claros, colaborativos e sem ambiguidades. arrays📦 Arrays: Armazene Dados como um Chef Organiza Panelas!📦 Arrays: Armazene Dados como um Chef Organiza Panelas!Aprenda como arrays em C# organizam dados com a precisão de uma cozinha profissional. Descubra métodos, boas práticas e dicas essenciais para seu código. de subdocumentos, respectivamente.

Inserindo e consultando documentos com dados aninhados🔗

Com a classe🏗️ Classes vs. Structs: Quando Usar Cada Uma (e Não Quebrar a Cabeça)!🏗️ Classes vs. Structs: Quando Usar Cada Uma (e Não Quebrar a Cabeça)!Descubra como escolher entre classes e structs em C#. Aprenda sobre alocação de memória, passagem por valor e referência, e performance nesta explicação clara. definida, é simples inserir objetos com dados aninhados no MongoDBO que é MongoDB e por que utilizá-lo com C# em 2025O que é MongoDB e por que utilizá-lo com C# em 2025Descubra como MongoDB e C# unem flexibilidade e escalabilidade para criar soluções modernas e eficientes em um cenário NoSQL inovador em 2025.:

using MongoDB.Driver;
// Supondo que já exista uma conexão e um database selecionado
var collection = database.GetCollection<Pessoa>("pessoas");
var novaPessoa = new Pessoa
{
    Nome = "Carlos de Souza",
    Idade = 31,
    Endereco = new Endereco
    {
        Rua = "Rua das Flores",
        Numero = 12,
        Cidade = "Curitiba"
    },
    Telefones = new List<Telefone>
    {
        new Telefone { Tipo = "celular", Numero = "9898-7777" },
        new Telefone { Tipo = "fixo", Numero = "041-3535-4545" }
    }
};
await collection.InsertOneAsync(novaPessoa);

Ao consultar documentosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025., podemos fazer filtros🎲 Desafio: Analise Dados de Vendas com LINQ e Coleções!🎲 Desafio: Analise Dados de Vendas com LINQ e Coleções!Aprenda a usar coleções e LINQ em C# para analisar vendas, filtrar dados e extrair insights estratégicos que otimizem decisões e impulsionem seu negócio. diretamente nos campos aninhados:

// Exemplo: encontrar pessoas de determinada cidade
var filtro = Builders<Pessoa>.Filter.Eq(p => p.Endereco.Cidade, "Curitiba");
var pessoasEmCuritiba = await collection.Find(filtro).ToListAsync();

Lidando com arrays e subdocumentos🔗

Ao trabalhar com arrays📦 Arrays: Armazene Dados como um Chef Organiza Panelas!📦 Arrays: Armazene Dados como um Chef Organiza Panelas!Aprenda como arrays em C# organizam dados com a precisão de uma cozinha profissional. Descubra métodos, boas práticas e dicas essenciais para seu código. de subdocumentos, você pode efetuar buscas específicas dentro desses arrays📦 Arrays: Armazene Dados como um Chef Organiza Panelas!📦 Arrays: Armazene Dados como um Chef Organiza Panelas!Aprenda como arrays em C# organizam dados com a precisão de uma cozinha profissional. Descubra métodos, boas práticas e dicas essenciais para seu código. usando operadores do MongoDBO que é MongoDB e por que utilizá-lo com C# em 2025O que é MongoDB e por que utilizá-lo com C# em 2025Descubra como MongoDB e C# unem flexibilidade e escalabilidade para criar soluções modernas e eficientes em um cenário NoSQL inovador em 2025.. Por exemplo, para buscar pessoas com um telefone do tipo🧠 Variáveis em C#: Onde os Dados Ganham Vida (e Nome!)🧠 Variáveis em C#: Onde os Dados Ganham Vida (e Nome!)Descubra como as variáveis em C# funcionam, com exemplos do mundo real, boas práticas de nomeação e dicas para otimizar seu código. “celular”:

var filtroTelefone = Builders<Pessoa>.Filter.ElemMatch(
    p => p.Telefones,
    t => t.Tipo == "celular"
);
var pessoasComCelular = await collection.Find(filtroTelefone).ToListAsync();

Outras operações comuns em arrays

Você pode atualizar📡 RESTful 101: Princípios que Todo Dev API Precisa Saber!📡 RESTful 101: Princípios que Todo Dev API Precisa Saber!Descubra os fundamentos do REST e boas práticas para criar APIs simples, escaláveis e eficientes. Domine métodos HTTP e status codes com exemplos práticos. a lista📦 List<T>: Dinamismo além dos Arrays!📦 List<T>: Dinamismo além dos Arrays!Descubra como utilizar List<T> em C# de forma eficiente. Aprenda a criar, manipular e otimizar listas para diferentes cenários com exemplos práticos. Telefones sem substituir📡 RESTful 101: Princípios que Todo Dev API Precisa Saber!📡 RESTful 101: Princípios que Todo Dev API Precisa Saber!Descubra os fundamentos do REST e boas práticas para criar APIs simples, escaláveis e eficientes. Domine métodos HTTP e status codes com exemplos práticos. todo o documento:

var updateAddTelefone = Builders<Pessoa>.Update.Push(p => p.Telefones,
    new Telefone { Tipo = "fax", Numero = "041-4002-8922" }
);
await collection.UpdateOneAsync(filtroTelefone, updateAddTelefone);
  • Remoção de elementos:

Use o operador Pull para remover📡 RESTful 101: Princípios que Todo Dev API Precisa Saber!📡 RESTful 101: Princípios que Todo Dev API Precisa Saber!Descubra os fundamentos do REST e boas práticas para criar APIs simples, escaláveis e eficientes. Domine métodos HTTP e status codes com exemplos práticos. um subdocumento de um array.

Desafios e boas práticas🔗

1. Profundidade do aninhamento: documentosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025. excessivamente aninhados podem dificultar leituras e📊 Behavior-Driven Development: Testes que Todo Mundo Entende!📊 Behavior-Driven Development: Testes que Todo Mundo Entende!Descubra como o BDD transforma testes em linguagens acessíveis. Aprenda a usar SpecFlow em C# para criar testes claros, colaborativos e sem ambiguidades. atualizações. Avalie se é vantajoso normalizar certos dados ou manter tudo aninhado.

2. ValidaçãoComo Assegurar Validação e Cobertura de Código em Projetos LINQComo Assegurar Validação e Cobertura de Código em Projetos LINQAprenda estratégias avançadas para testar consultas LINQ, garantindo cobertura de código e confiabilidade com ferramentas e práticas recomendadas. de schema: mesmo que o MongoDBO que é MongoDB e por que utilizá-lo com C# em 2025O que é MongoDB e por que utilizá-lo com C# em 2025Descubra como MongoDB e C# unem flexibilidade e escalabilidade para criar soluções modernas e eficientes em um cenário NoSQL inovador em 2025. seja flexível, é aconselhável validar a estrutura ao salvar os dados para🔄 Loops em C#: Repita Tarefas sem Enlouquecer (Com for e while!)🔄 Loops em C#: Repita Tarefas sem Enlouquecer (Com for e while!)Descubra como automatizar repetições em C# utilizando loops for e while com exemplos práticos que evitam erros e otimizam seu código. Aprenda mais! evitar inconsistências.

3. Índices: se algumas propriedades⚡ Propriedades: Get e Set com Elegância (e sem Campos Privados Bagunçados)!⚡ Propriedades: Get e Set com Elegância (e sem Campos Privados Bagunçados)!Aprenda como utilizar propriedades em C# para encapsular dados, validar informações e manter um código organizado, seguro e de fácil manutenção. de subdocumentos forem muito consultadas, considere criar índices para🔄 Loops em C#: Repita Tarefas sem Enlouquecer (Com for e while!)🔄 Loops em C#: Repita Tarefas sem Enlouquecer (Com for e while!)Descubra como automatizar repetições em C# utilizando loops for e while com exemplos práticos que evitam erros e otimizam seu código. Aprenda mais! acelerar as pesquisas.

Boa PráticaVantagem
Usar classes de C# para subdocumentosCódigo organizado e tipado
Validar dados antes de inserirEvita dados inconsistentes e divergentes
Monitorar profundidade de aninhamentoSimplifica a manutenção e leitura dos dados
Criar índices em campos aninhadosMelhora o desempenho em pesquisas frequentes

Conclusão🔗

A capacidade de armazenar dados semiestruturados e📊 Behavior-Driven Development: Testes que Todo Mundo Entende!📊 Behavior-Driven Development: Testes que Todo Mundo Entende!Descubra como o BDD transforma testes em linguagens acessíveis. Aprenda a usar SpecFlow em C# para criar testes claros, colaborativos e sem ambiguidades. manipular documentosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosEntendendo a arquitetura do MongoDB: documentos, coleções e bancos de dadosExplore os pilares da arquitetura MongoDB, integrando bancos de dados, coleções e documentos para impulsionar seu desenvolvimento em C# até 2025. aninhados faz do MongoDBO que é MongoDB e por que utilizá-lo com C# em 2025O que é MongoDB e por que utilizá-lo com C# em 2025Descubra como MongoDB e C# unem flexibilidade e escalabilidade para criar soluções modernas e eficientes em um cenário NoSQL inovador em 2025. uma escolha poderosa para cenários📊 Behavior-Driven Development: Testes que Todo Mundo Entende!📊 Behavior-Driven Development: Testes que Todo Mundo Entende!Descubra como o BDD transforma testes em linguagens acessíveis. Aprenda a usar SpecFlow em C# para criar testes claros, colaborativos e sem ambiguidades. em que a flexibilidade e📊 Behavior-Driven Development: Testes que Todo Mundo Entende!📊 Behavior-Driven Development: Testes que Todo Mundo Entende!Descubra como o BDD transforma testes em linguagens acessíveis. Aprenda a usar SpecFlow em C# para criar testes claros, colaborativos e sem ambiguidades. a evolução constante do schema são essenciais. Em conjunto com C#, é possível mapear facilmente estruturas complexas, mantendo um código claro e alinhado às boas práticas🔢 Operadores Aritméticos: Faça Cálculos como uma Calculadora Humana!🔢 Operadores Aritméticos: Faça Cálculos como uma Calculadora Humana!Aprenda a dominar operadores aritméticos em C# com exemplos práticos, técnicas de cálculo e dicas para evitar erros e maximizar resultados. do ecossistema .NET.

À medida que suas aplicações crescem, tenha em mente a importância de avaliar a profundidade de aninhamento, criar📡 RESTful 101: Princípios que Todo Dev API Precisa Saber!📡 RESTful 101: Princípios que Todo Dev API Precisa Saber!Descubra os fundamentos do REST e boas práticas para criar APIs simples, escaláveis e eficientes. Domine métodos HTTP e status codes com exemplos práticos. índices adequados e📊 Behavior-Driven Development: Testes que Todo Mundo Entende!📊 Behavior-Driven Development: Testes que Todo Mundo Entende!Descubra como o BDD transforma testes em linguagens acessíveis. Aprenda a usar SpecFlow em C# para criar testes claros, colaborativos e sem ambiguidades. monitorar o desempenho⏱️ Testes de Performance: Garanta Velocidade Além da Funcionalidade!⏱️ Testes de Performance: Garanta Velocidade Além da Funcionalidade!Descubra como medir, diagnosticar e otimizar performance em aplicações .NET com dicas práticas e ferramentas essenciais para devs. das queries. Desta forma, você garante que o uso de dados semiestruturados não apenas ofereça flexibilidade, mas📊 Behavior-Driven Development: Testes que Todo Mundo Entende!📊 Behavior-Driven Development: Testes que Todo Mundo Entende!Descubra como o BDD transforma testes em linguagens acessíveis. Aprenda a usar SpecFlow em C# para criar testes claros, colaborativos e sem ambiguidades. também robustez e📊 Behavior-Driven Development: Testes que Todo Mundo Entende!📊 Behavior-Driven Development: Testes que Todo Mundo Entende!Descubra como o BDD transforma testes em linguagens acessíveis. Aprenda a usar SpecFlow em C# para criar testes claros, colaborativos e sem ambiguidades. eficiência⏱️ Testes de Performance: Garanta Velocidade Além da Funcionalidade!⏱️ Testes de Performance: Garanta Velocidade Além da Funcionalidade!Descubra como medir, diagnosticar e otimizar performance em aplicações .NET com dicas práticas e ferramentas essenciais para devs. em produção.

Autor: Marcelo V. Souza - Engenheiro de Sistemas e Entusiasta em IoT e Desenvolvimento de Software, com foco em inovação tecnológica.

Referências🔗

Compartilhar artigo