Olá Comunidade!👋
Bem-vindos à segunda parte da série Utilitário IRIS IO. Esta extensão representa minha inscrição para o Concurso "Trazendo Ideias à Realidade" 2025 da InterSystemse oferece uma interface intuitiva e poderosa para importar e exportar dados diretamente no VS Code.
Se você achar esta extensão útil, por favor, considere votar em mim no concurso!
No artigo anterior, cobrimos:
- Visão geral da extensão
- Configuração do driver ODBC
- Recursos de Exportação
Agora é hora de mergulhar no Mecanismo de Importação — projetado para suportar:
- CSV
- TXT(com qualquer delimitador)
- JSON
- XLSX
A extensão apresenta uma camada de inferência inteligente que analisa o arquivo de entrada e sugere automaticamente os formatos de dados ideais para a tabela IRIS, fornecendo modelagem de dados assistida e guiada.
Modos de Importação — Dois Fluxos de Trabalho Distintos
A extensão suporta dois cenários distintos:
- Criar Nova Tabela
- Carregar em Tabela Existente
Opção A — Importar para Nova Tabela
Isso é ideal quando:
- Você está carregando um novo conjunto de dados
- Você deseja um começo limpo, com uma nova tabela e esquema
- Você está em uma fase de prototipagem ou exploração
O que acontece:
- A extensão lê os dados do arquivo e infere os tipos de coluna automaticamente
- Você pode personalizar os tipos, se necessário
- Você escolhe um nome de esquema e tabela
- Você pode definir índices opcionalmente
- Em seguida, os dados são importados — tudo em uma operação atômica e segura
Opção B — Importar para Tabela Existente
Perfeito para:
- Atualizar uma tabela
- Adicionar novas linhas
- Substituir dados desatualizados
Duas ações estão disponíveis:
- Append (Anexar) — simplesmente adiciona novas linhas do arquivo
- Replace (Substituir) — limpa os dados atuais da tabela e os substitui pelos novos dados
Antes de importar, a extensão valida se as colunas do arquivo correspondem à estrutura da tabela de destino. Se houver incompatibilidades, ela irá notificá-lo e abortar — protegendo você contra desvio de esquema ou corrupção de dados.
.png)
Criando uma nova tabela com o Utilitário IRIS IO
Passo 1 — Abra a Visualização de Importação e selecione um arquivo
Após conectar a uma instância IRIS:
- Clique no ícone de nuvem com a seta para cima
- Clique na aba "Create New Table" (Criar Nova Tabela)
- Escolha o arquivo para importar
Os formatos suportados são CSV, JSON, TXT e XLSX..png)
Passo 2 — Análise de Arquivo e Inferência de Tipo
Após carregar um arquivo, o mecanismo de importação automaticamente:
-
Amostra os valores do arquivo para adivinhar os tipos de coluna
-
Determina os tipos SQL mais prováveis
-
Converte-os para tipos SQL IRIS válidos
-
Mostra dados de amostra abaixo de cada coluna
-
Permite que você substitua o tipo manualmente se necessário
Tipos detectados incluem:
- INTEGER
- BIGINT
- NUMERIC
- DOUBLE
- VARCHAR (255 ou 4000 caracteres)
- CLOB
- DATE
- TIMESTAMP
- BIT
O resultado da análise é mostrado na seção "Column Type Mapping" (Mapeamento de Tipo de Coluna) na parte inferior da webview de importação.
Você pode alterar o tipo de dados e visualizar uma amostra dos dados:
.png)
Passo 3 — Crie índices personalizados
A extensão suporta a criação de índice ao criar uma nova tabela.
Para cada coluna, você pode:
- Marcar a caixa "Index" (Índice) se souber que fará consultas ou filtragens frequentes por essa coluna
- Selecionar o tipo de índice. Os tipos disponíveis são:
- INDEX
- BITSLICE
- BITMAP
- COLUMNAR (IRIS Analytics)
- Você pode editar o nome do índice — se deixado em branco, a extensão gera um automaticamente
Passo 4 — Selecionar Esquema
Ao selecionar um esquema para a nova tabela, você pode optar por usar um esquema existente ou criar um novo esquema.
Ao usar um esquema existente:
- Você pode especificar um filtro de esquema (opcional) ou simplesmente clicar no botão "Load Schemas" (Carregar Esquemas) para carregar todos os esquemas disponíveis dentro do namespace selecionado.
.png)
Ao criar um novo esquema:
- Você pode especificar um novo nome de esquema no formato
MeuNomeDeEsquema_SubEsquema
.png)
Passo 5 — Selecionar Nome da Tabela
Uma vez que o esquema tenha sido selecionado, você pode especificar um novo nome de tabela. Se já existir uma tabela com o mesmo esquema e nome de tabela, a importação será abortada para evitar a sobrescrita acidental.
Passo 6 — Criar Tabela e Importar
Clique no botão "Create" (Criar) para criar uma nova tabela e importar dados.
A extensão registra o progresso no painel Output (Saída) e mostra uma notificação pop-up quando concluído.
.png)
Carregando dados em uma tabela existente com o Utilitário IRIS IO
Para injetar novos dados em uma tabela existente:
- Mude para a aba "Load into Existing Table" (Carregar em Tabela Existente)
- Selecione seu arquivo
- Escolha o esquema e o nome da tabela de destino
- Selecione a ação de importação: Append (Anexar) ou Replace (Substituir)
A extensão valida se as colunas do arquivo se alinham com o esquema da tabela existente e aborta se houver incompatibilidades — protegendo a integridade dos seus dados.
.png)
Caso Especial de Arquivos TXT: Defina o delimitador correto
Ao importar arquivos TXT, a extensão permite que você especifique um delimitador personalizado para garantir que o arquivo seja analisado corretamente. Isso é especialmente útil ao trabalhar com separadores não convencionais, como pipes (|), ponto e vírgula (;), tabulações ou delimitadores de múltiplos caracteres. Selecionar o delimitador correto garante a detecção adequada das colunas e evita dados desalinhados ou corrompidos durante o processo de importação.
.png)
.png)
Considerações Finais
O mecanismo de Importação transforma o IRIS IO Utility de um simples ajudante em uma verdadeira ferramenta de engenharia de dados.
Ele lida com:
- Inferência de tipo
- Construção de esquema
- Criação de índice
- Carregamento de dados
- Registro de diagnóstico (logging)
Tudo dentro do VS Code — limpo, detectável e conveniente.
Juntamente com o mecanismo de Exportação, o IRIS IO Utility fornece um fluxo de trabalho de I/O completo, moderno e amigável ao desenvolvedor para o InterSystems IRIS.
Se você gostou deste recurso e achou o IRIS IO Utility útil, por favor, vote nele no Concurso InterSystems!🚀