Visão geral

A configuração adequada do DataSnap é essencial para maximizar a eficiência do processamento de dados e garantir uma integração robusta com suas aplicações.
Todas as configurações são gerenciadas através da API ou do dashboard administrativo. Entre em contato com o suporte para configurações avançadas.

Configurações de autenticação

Tokens de acesso

Configure seus tokens de acesso para integração com a API:
# Variáveis de ambiente recomendadas
DATASNAP_TOKEN=seu_token_aqui
DATASNAP_ENVIRONMENT=production
DATASNAP_BASE_URL=https://api.datasnap.com.br

Configuração por ambiente

Mantenha configurações separadas para diferentes ambientes:
# config.py
import os

class Config:
    DATASNAP_TOKEN = os.getenv("DATASNAP_TOKEN")
    DATASNAP_ENVIRONMENT = os.getenv("DATASNAP_ENV", "production")

    @property
    def base_url(self):
        return {
            "production": "https://api.datasnap.com.br"
        }.get(self.DATASNAP_ENVIRONMENT, "https://api.datasnap.com.br")

Configurações de processamento

Métodos de processamento

Configure como seus dados devem ser processados:

Manual

Controle total sobre quando processar os dados

Por upload

Processamento imediato a cada arquivo enviado

Por volume

Processamento quando acumular determinado tamanho

Programado

Processamento em intervalos regulares definidos

Configuração de webhooks

Configure endpoints para receber notificações de processamento:
{
  "webhooks": [
    {
      "url": "https://sua-aplicacao.com/webhooks/datasnap",
      "events": ["processing.started", "processing.completed", "processing.failed"],
      "secret": "seu_secret_de_webhook"
    }
  ]
}

Configurações de schema

Definição de schemas

Configure os schemas para seus tipos de dados:
{
  "schema": {
    "name": "vendas",
    "version": "1.0.0",
    "fields": {
      "id": "integer",
      "produto": "string",
      "valor": "decimal",
      "data_venda": "datetime"
    }
  }
}

Validação de dados

Configure regras de validação personalizadas:
  • Tipos de campo: String, Integer, Decimal, DateTime, Boolean
  • Validações: Required, Min/Max length, Format patterns
  • Transformações: Uppercase, Lowercase, Trim, Date formatting

Configurações de performance

Limites de upload

Configure limites adequados para suas necessidades:
ConfiguraçãoLimite padrãoLimite máximo
Tamanho por arquivo100 MB1 GB
Arquivos simultâneos10100
Taxa de upload50 req/min500 req/min

Otimizações de consulta

Configure índices e otimizações para consultas frequentes:
{
  "indexes": [
    {
      "fields": ["data_venda"],
      "type": "datetime_range"
    },
    {
      "fields": ["produto", "categoria"],
      "type": "composite"
    }
  ]
}

Configurações de segurança

Controle de acesso

Configure permissões granulares:
  • Leitura: Consultas e listagem de dados
  • Escrita: Upload e modificação de arquivos
  • Processamento: Iniciar e monitorar processamentos
  • Administração: Configurações e gerenciamento de usuários

Auditoria

Configure logs de auditoria para compliance:
{
  "audit": {
    "enabled": true,
    "events": ["upload", "process", "query", "delete"],
    "retention_days": 90
  }
}

Monitoramento

Métricas importantes

Configure alertas para métricas críticas:
  • Taxa de sucesso de uploads ( Acima de 95%)
  • Tempo de processamento ( inferior a 5 minutos)
  • Taxa de erro de consultas ( inferior a 1%)
  • Utilização de storage (inferior a 80% da quota)

Notificações

Configure notificações para eventos importantes:
{
  "notifications": {
    "email": ["admin@empresa.com"],
    "webhook": "https://sua-aplicacao.com/alerts",
    "events": ["quota_exceeded", "processing_failed", "security_alert"]
  }
}

Próximos passos