HarborDB

Exportando Dados no HarborDB

Guides
•Última atualização: 16 de fevereiro de 2026

O HarborDB fornece recursos poderosos de exportação para salvar seus resultados de consulta em vários formatos. Se você precisa compartilhar dados com colegas, importar para outros aplicativos ou arquivar resultados para análise posterior, este guia aborda tudo o que você precisa saber sobre exportação de dados de forma eficiente e segura.

Visão Geral dos Formatos de Exportação

O HarborDB suporta vários formatos de exportação, cada um adequado para diferentes casos de uso:

CSV (Valores Separados por Vírgula)

  • Melhor para: Planilhas (Excel, Google Sheets), importação/exportação de dados, troca básica de dados
  • Recursos: Delimitadores personalizados, cabeçalhos, qualificadores de texto, opções de codificação
  • Limitações: Sem suporte para dados hierárquicos, preservação limitada de tipos de dados

JSON (JavaScript Object Notation)

  • Melhor para: Aplicações web, APIs, bancos de dados NoSQL, intercâmbio de dados
  • Recursos: Impressão formatada, formatação compacta, preservação de tipos de dados
  • Limitações: Tamanho maior de arquivo, não ideal para planilhas

Excel (Em Breve)

  • Melhor para: Relatórios de negócios, planilhas formatadas, apresentação de dados complexos
  • Recursos: Múltiplas planilhas, fórmulas, formatação, gráficos
  • Status: Planejado para lançamento futuro

Processo Básico de Exportação

Passo 1: Prepare Seus Dados

  1. Execute uma consulta ou selecione uma tabela na barra lateral
  2. Revise os resultados para garantir que contenham os dados que você deseja exportar
  3. Considere filtrar se você só precisa de linhas ou colunas específicas

Passo 2: Inicie a Exportação

Existem várias maneiras de iniciar uma exportação:

A partir de Resultados de Consulta

  1. Clique no botão Exportar (📤) na barra de ferramentas de resultados
  2. Ou clique com o botão direito em qualquer lugar da grade de resultados
  3. Selecione "Exportar Resultados" no menu de contexto

A partir da Navegação de Tabela

  1. Clique com o botão direito em uma tabela na barra lateral
  2. Selecione "Exportar Dados"
  3. Escolha o escopo da exportação:
    • Tabela inteira: Todos os dados (use com cautela em tabelas grandes)
    • Primeiras N linhas: Amostra limitada (recomendado para testes)
    • Consulta personalizada: Escreva uma instrução SELECT específica

Atalhos de Teclado

  • ⌘ + E: Diálogo de exportação rápida
  • ⌘ + Shift + E: Exportar com as últimas configurações usadas

Passo 3: Configure as Configurações de Exportação

O diálogo de exportação fornece opções de configuração:

Configurações Gerais

  • Nome do Arquivo: Gerado automaticamente ou nome personalizado
  • Local de Salvamento: Escolha a pasta de destino
  • Incluir Cabeçalhos: Nomes das colunas como primeira linha (CSV)
  • Codificação: UTF-8 (recomendado), Latin-1 ou padrão do sistema

Opções Específicas do CSV

  • Delimitador: Vírgula, ponto e vírgula, tabulação, pipe ou caractere personalizado
  • Qualificador de Texto: Aspas simples, aspas duplas ou nenhum
  • Terminadores de Linha: macOS/Linux (LF), Windows (CRLF) ou padrão do sistema
  • Representação de Nulo: String vazia, "NULL" ou texto personalizado

Opções Específicas do JSON

  • Formato: Formatado (legível) ou Compacto (minimizado)
  • Formato de Array: Array de objetos ou objeto com propriedade de dados
  • Incluir Metadados: Informações de execução da consulta, tipos de coluna, timestamps

Passo 4: Execute e Verifique

  1. Clique em "Exportar" para salvar o arquivo
  2. Monitore o progresso para exportações grandes
  3. Verifique o tamanho do arquivo e o conteúdo
  4. Abra o arquivo exportado para confirmar a formatação

Técnicas Avançadas de Exportação

Exportando Subconjuntos de Dados Específicos

Seleção de Colunas

Exporte apenas colunas específicas modificando sua consulta:

-- Em vez de SELECT *
SELECT customer_id, email, last_purchase_date
FROM customers
WHERE active = true;

Filtragem de Linhas

Use cláusulas WHERE para limitar dados exportados:

-- Exporte apenas dados recentes
SELECT * FROM orders
WHERE order_date >= CURRENT_DATE - INTERVAL '30 days';

Dados Agregados

Exporte resultados resumidos:

-- Exporte totais de vendas diárias
SELECT
    DATE(order_date) as day,
    COUNT(*) as order_count,
    SUM(total_amount) as daily_revenue
FROM orders
GROUP BY DATE(order_date)
ORDER BY day DESC;

Exportação em Lote

Para grandes conjuntos de dados que excedem os limites de memória:

Exportações em Partes

-- Exporte em lotes de 10.000 linhas
SELECT * FROM large_table
ORDER BY id
LIMIT 10000 OFFSET 0;

-- Em seguida, incremente OFFSET para o próximo lote
SELECT * FROM large_table
ORDER BY id
LIMIT 10000 OFFSET 10000;

Cursors no Lado do Servidor

Ative cursors no lado do servidor em Preferências → Desempenho para transmitir grandes conjuntos de resultados sem problemas de memória.

Exportações Agendadas (Avançado)

Embora o HarborDB não tenha agendamento incorporado, você pode:

  1. Salvar consultas de exportação como arquivos
  2. Usar macOS Automator para executar exportações
  3. Agendar com cron ou launchd (usuários avançados)
  4. Exportar para pastas monitoradas para processamento automatizado

Orientação Específica por Formato

Melhores Práticas de Exportação CSV

Preparação de Dados

  1. Limpe caracteres especiais que possam quebrar a análise CSV:
-- Remova ou escape vírgulas em campos de texto
SELECT
    id,
    REPLACE(description, ',', ';') as description,
    amount
FROM products;
  1. Lide com quebras de linha em campos de texto:
-- Substitua novas linhas por espaços
SELECT
    id,
    REPLACE(REPLACE(notes, CHR(10), ' '), CHR(13), ' ') as notes_clean
FROM customer_notes;

Configurações CSV Amigáveis para Importação

Para máxima compatibilidade com outros aplicativos:

| Aplicativo | Configurações Recomendadas | | ------------------ | ------------------------------------------------------------- | | Excel | Delimitador vírgula, Qualificador aspas duplas, Codificação UTF-8 | | Google Sheets | Delimitador vírgula, Codificação padrão | | Python/R Pandas| Delimitador vírgula, Sem qualificador de texto | | PostgreSQL COPY| Delimitador vírgula, Cabeçalho CSV, Aspas duplas |

Melhores Práticas de Exportação JSON

Exportação de Dados Estruturados

-- Exporte dados hierárquicos
SELECT
    order_id,
    order_date,
    JSON_BUILD_OBJECT(
        'customer_id', c.customer_id,
        'name', c.name,
        'email', c.email
    ) as customer,
    JSON_AGG(
        JSON_BUILD_OBJECT(
            'product_id', p.product_id,
            'name', p.name,
            'quantity', oi.quantity,
            'price', oi.price
        )
    ) as items
FROM orders o
JOIN customers c ON o.customer_id = c.customer_id
JOIN order_items oi ON o.order_id = oi.order_id
JOIN products p ON oi.product_id = p.product_id
GROUP BY o.order_id, o.order_date, c.customer_id, c.name, c.email;

Considerações de Schema JSON

  • Estrutura consistente: Certifique-se de que todas as linhas tenham as mesmas chaves
  • Tipos de dados: JSON preserva strings, números, booleanos, null
  • Profundidade de aninhamento: Considere achatamento para algumas aplicações

Otimização de Desempenho

Exportações de Grandes Conjuntos de Dados

Gerenciamento de Memória

  1. Ative o modo de streaming em Preferências → Desempenho
  2. Aumente o tamanho do chunk para exportações mais rápidas (se RAM suficiente)
  3. Feche outros aplicativos para liberar recursos do sistema
  4. Monitore o Monitor de Atividade para uso de memória

Considerações de Rede

Para exportações de banco de dados remoto:

  1. Exporte no servidor se possível (use SSH ou área de trabalho remota)
  2. Comprima exportações (HarborDB comprime automaticamente JSON grande)
  3. Agende horários fora de pico para bancos de dados de produção
  4. Use cláusulas WHERE para limitar transferência de dados

Dicas de Velocidade de Exportação

  1. Selecione apenas colunas necessárias (não SELECT *)
  2. Evite cálculos caros em consultas de exportação
  3. Use colunas indexadas em cláusulas WHERE
  4. Exporte para SSD para E/S de disco mais rápida
  5. Desative varredura antivírus em tempo real na pasta de exportação (temporariamente)

Segurança e Privacidade

Manipulação de Dados Sensíveis

Redação de Dados

-- Exporte sem informações sensíveis
SELECT
    user_id,
    LEFT(email, 3) || '***@***' as email_masked,
    '***' as password_hash,
    created_at
FROM users;

Considerações de Conformidade

  1. GDPR/CCPA: Remova informações de identificação pessoal (PII)
  2. HIPAA: Desidentifique informações de saúde protegidas (PHI)
  3. PCI DSS: Nunca exporte números completos de cartão de crédito
  4. Políticas internas: Siga as regras de manipulação de dados da sua organização

Práticas de Exportação Segura

  1. Criptografe exportações sensíveis usando macOS FileVault ou ferramentas de terceiros
  2. Use métodos de transferência seguros para arquivos exportados (SFTP, e-mail criptografado)
  3. Defina permissões de arquivo apropriadas (chmod 600 para arquivos sensíveis)
  4. Exclua automaticamente arquivos de exportação temporários
  5. Audite logs de exportação (disponível em Preferências → Logs)

Solução de Problemas Comuns

Problemas com CSV

"Colunas desalinhadas no Excel"

  • Causa: Vírgulas ou quebras de linha incorporadas nos dados
  • Solução: Use qualificadores de texto ou limpe os dados antes da exportação

"Problemas de codificação de caracteres"

  • Causa: Caracteres não UTF-8 nos dados
  • Solução: Exporte com codificação UTF-8 com BOM para Excel

"Erros de importação de arquivo grande"

  • Causa: Limites de linha/coluna do Excel (1.048.576 linhas, 16.384 colunas)
  • Solução: Divida os dados ou use ferramentas CSV sem limites

Problemas com JSON

"Sintaxe JSON inválida"

  • Causa: Caracteres especiais não escapados adequadamente
  • Solução: Use funções JSON do PostgreSQL para sanitizar dados

"Erros de memória em exportações grandes"

  • Causa: Tentativa de carregar todo o conjunto de dados na memória
  • Solução: Ative exportação em streaming ou exporte em partes

"Dados aninhados muito complexos"

  • Causa: JSON profundamente aninhado difícil de analisar
  • Solução: Achate a estrutura ou simplifique a consulta

Problemas Gerais

"Exportação muito lenta"

  • Possíveis causas: Latência de rede, velocidade do disco, desempenho da consulta
  • Etapas de depuração:
    1. Teste primeiro com pequeno conjunto de dados
    2. Verifique conectividade de rede
    3. Confirme que o disco tem espaço livre
    4. Otimize consulta do banco de dados

"Dados faltando na exportação"

  • Verifique: Filtros de cláusula WHERE, seleção de coluna, tratamento de NULL
  • Confirme: Contagem de linhas corresponde às expectativas, todas as colunas incluídas

"Erros de permissão negada"

  • Solução:
    1. Escolha local de salvamento diferente
    2. Verifique permissões da pasta
    3. Execute HarborDB com privilégios apropriados
    4. Desative software de segurança temporariamente

Integração com Outras Ferramentas

Automação com Scripts

Exemplo de Script Shell

#!/bin/bash
# Exporte relatório diário e envie por e-mail
EXPORT_FILE="/Users/$(whoami)/Exports/daily_sales_$(date +%Y%m%d).csv"

# Você precisaria escrever ações do HarborDB aqui
# Considere usar ferramentas de linha de comando PostgreSQL para automação
pg_dump -t sales -c --inserts your_database > "$EXPORT_FILE"

# Comprima e envie por e-mail
gzip "$EXPORT_FILE"
echo "Exportação diária de vendas anexada" | mail -s "Relatório Diário de Vendas" \
  -a "$EXPORT_FILE.gz" team@example.com

Importação para Outros Aplicativos

Excel/Google Sheets

  1. CSV: Importação direta via Dados → De Texto/CSV
  2. JSON: Use Power Query (Excel) ou Apps Script (Sheets)

Sistemas de Banco de Dados

-- Comando COPY do PostgreSQL (de CSV exportado)
COPY customers FROM '/caminho/para/export.csv' DELIMITER ',' CSV HEADER;

-- LOAD DATA do MySQL
LOAD DATA LOCAL INFILE '/caminho/para/export.csv'
INTO TABLE customers
FIELDS TERMINATED BY ','
ENCLOSED BY '"'
LINES TERMINATED BY '\n'
IGNORE 1 ROWS;

Linguagens de Programação

# Exemplo Python pandas
import pandas as pd

# Leia exportação CSV do HarborDB
df = pd.read_csv('export.csv', encoding='utf-8')
print(f"Importado {len(df)} linhas")

# Ou exportação JSON
df_json = pd.read_json('export.json', orient='records')

Resumo das Melhores Práticas

Antes de Exportar

  1. Teste com pequeno conjunto de dados primeiro
  2. Verifique se os resultados da consulta correspondem às expectativas
  3. Verifique espaço disponível em disco
  4. Considere sensibilidade dos dados e requisitos de conformidade

Durante a Exportação

  1. Escolha formato apropriado para seu caso de uso
  2. Use nomes de arquivo descritivos com datas
  3. Inclua cabeçalhos/metadados para clareza
  4. Monitore o progresso para exportações grandes

Após Exportar

  1. Verifique integridade do arquivo (abra e verifique amostra)
  2. Proteja arquivos sensíveis (criptografe se necessário)
  3. Limpe arquivos temporários
  4. Documente a exportação para reprodutibilidade

Próximos Passos

Agora que você pode exportar dados efetivamente:

  1. Noções Básicas de Consultas - Domine a escrita de consultas SQL
  2. Navegação no Banco de Dados - Explore a estrutura do banco de dados
  3. Otimização de Desempenho - Otimize velocidade de exportação
  4. Integração com macOS - Use recursos nativos do macOS

Obtendo Ajuda

Se encontrar problemas de exportação:

  1. Verifique nosso Guia de Suporte para solução de problemas
  2. Visite o FAQ para perguntas comuns
  3. Entre em Contato com o Suporte para assistência personalizada
Voltar para categoriaVoltar para Documentação

Isso foi útil?

Ajude-nos a melhorar esta documentação fornecendo feedback.

Reportar problemaContatar suporteEdit this page