DEV Community

Cover image for 📚 Como Integrar ScyllaDB com .NET
Danilo O. Pinheiro, dopme.io
Danilo O. Pinheiro, dopme.io

Posted on

📚 Como Integrar ScyllaDB com .NET

#csharp #dotnet #scylladb

O ScyllaDB é um banco de dados NoSQL distribuído, altamente escalável e compatível com o protocolo do Apache Cassandra, projetado para baixa latência e alto throughput.
Ele é ideal para aplicações que exigem alta disponibilidade e precisam lidar com grandes volumes de dados em tempo real, como:

  • Sistemas de recomendação
  • Monitoramento e IoT
  • Plataformas de jogos online
  • Análises em tempo real
  • APIs com alto volume de requisições

Neste artigo, vamos explorar como integrar o ScyllaDB em aplicações .NET, cobrindo desde a arquitetura, escolha de bibliotecas, boas práticas e um exemplo prático.

🏗️ Arquitetura de Integração

A integração do .NET com ScyllaDB normalmente segue três camadas:

1. Camada de Aplicação (.NET)

  • Implementa APIs REST, gRPC ou serviços de backend.
  • Contém regras de negócio e lógica de persistência isolada via repositórios.
  • Utiliza drivers compatíveis com o protocolo CQL (Cassandra Query Language).

2. Camada de Driver

  • O ScyllaDB é 100% compatível com Cassandra CQL, então usamos o driver DataStax C# (CassandraCSharpDriver).
  • Gerencia pooling, serialização/deserialização e execução de queries.

3. Camada de Banco de Dados (Cluster ScyllaDB)

  • Configurado para replicação e tolerância a falhas.
  • Pode ser hospedado on-premises ou cloud (Scylla Cloud).

📌 Fluxo simplificado:

API .NET → Driver DataStax C# → Cluster ScyllaDB
Enter fullscreen mode Exit fullscreen mode

⚙️ Tecnologias e Dependências

Tecnologia Função
.NET 6+ ou 7+ Backend principal
DataStax C# Driver Conexão com ScyllaDB via CQL
Docker ou Kubernetes Orquestração (opcional para desenvolvimento)
ScyllaDB Banco NoSQL distribuído

📦 Instalação do Driver no .NET

No seu projeto .NET, adicione:

dotnet add package CassandraCSharpDriver
Enter fullscreen mode Exit fullscreen mode

🔌 Configuração de Conexão 

using Cassandra;

class ScyllaDbConnector
{
    private readonly ISession _session;

    public ScyllaDbConnector(string[] contactPoints, string keyspace)
    {
        var cluster = Cluster.Builder()
            .AddContactPoints(contactPoints)
            .WithPort(9042)
            .Build();

        _session = cluster.Connect(keyspace);
    }

    public RowSet Execute(string cql)
    {
        return _session.Execute(cql);
    }
}
Enter fullscreen mode Exit fullscreen mode

Exemplo de uso:

var connector = new ScyllaDbConnector(
    new[] { "127.0.0.1" }, // Endereços dos nós
    "meu_keyspace"
);

connector.Execute("INSERT INTO usuarios (id, nome) VALUES (uuid(), 'Danilo')");
Enter fullscreen mode Exit fullscreen mode

🛠️ Modelagem e CRUD Básico

Criando um Keyspace e Tabela 

CREATE KEYSPACE IF NOT EXISTS meu_keyspace
WITH replication = {'class': 'SimpleStrategy', 'replication_factor' : 1};

CREATE TABLE IF NOT EXISTS usuarios (
    id UUID PRIMARY KEY,
    nome TEXT,
    email TEXT
);
Enter fullscreen mode Exit fullscreen mode

Inserindo dados no .NET 

var insertStatement = "INSERT INTO usuarios (id, nome, email) VALUES (?, ?, ?)";
var prepared = session.Prepare(insertStatement);
var bound = prepared.Bind(Guid.NewGuid(), "João Silva", "joao@email.com");
session.Execute(bound);
Enter fullscreen mode Exit fullscreen mode

Lendo dados 

var rs = session.Execute("SELECT * FROM usuarios");
foreach (var row in rs)
{
    Console.WriteLine($"{row["id"]} - {row["nome"]} - {row["email"]}");
}
Enter fullscreen mode Exit fullscreen mode

🚀 Boas Práticas

  1. Use Prepared Statements
    Melhora performance e reduz parsing repetitivo.

  2. Evite JOINS
    ScyllaDB é orientado a colunas, modele as tabelas para consultas diretas.

  3. Defina Consistency Level
    Ajuste o nível de consistência conforme necessidade de disponibilidade vs. consistência.

  4. Monitoramento e Observabilidade
    Utilize ferramentas como Scylla Monitoring Stack (Prometheus + Grafana).

  5. Particionamento Inteligente
    Escolha corretamente as partition keys para evitar hotspots.

🖥️ Arquitetura de Produção

Em produção, um setup típico pode ser:

  • .NET Backend: REST/gRPC
  • Driver C# DataStax
  • Cluster ScyllaDB: replicação multi-node
  • Load Balancer para APIs
  • Observabilidade com Prometheus/Grafana
  • CI/CD para deploy automatizado

📊 Diagrama (fluxo simplificado):

📚 Recursos Úteis

✅ Conclusão

Integrar o ScyllaDB com .NET é simples, mas exige atenção a modelagem de dados, nível de consistência e boas práticas de cluster para garantir performance e confiabilidade.
O uso de Prepared Statements, monitoramento contínuo e uma arquitetura bem planejada fazem toda a diferença para sistemas de missão crítica.

🤝 Conecte-se Comigo

Se você trabalha com .NET moderno e quer dominar arquitetura, integração, DevOps ou interoperabilidade, vamos conversar:

Ele te cobrirá com as suas penas, e debaixo das suas asas te confiarás; a sua verdade será o teu escudo e broquel.
Salmos 91:4

Top comments (0)