Cadastrar armazenamento

Visão geral

Armazenamentos materializam dados para consumo por consultas, agendamentos e assistentes.

Destino	Significado
Interno	Stage gerenciado na EasyAPI (área intermediária — o “STG” operacional)
Externo	Destino já alcançado por uma conexão (banco, storage ou engine)

Como acessar

Menu Armazenamentos → /armazenamentos → Novo.

Pré-requisitos

• Domínio com storage interno configurado (aba Armazenamento em Domínio), para destino interno.
• Conexão cadastrada, para destino externo.
• Token de usuário.
• Perfil com Acesso (e Importação, se for importar).

Passo a passo — interno (stage)

1. Destino = Interno
2. Tipo:
   • MongoDB
   • SQL Server
     (CosmosDB existe no catálogo de tipos, mas fica filtrado no select da tela)
3. Armazenamento: nome só com letras, números e _ (a tela sanitiza o restante)
4. Descrição, Token Usuário, Ativo
5. Opcional: Habilita Importação
6. Salvar

Passo a passo — externo

1. Destino = Externo
2. Tipo Conexão e Conexão permitidos: SQL Server, Oracle, MySQL, PostgreSQL, Conexão Local, Azure Blob, S3, Azure Data Lake Gen2, Databricks, Fabric
3. Campos extras:
   • Databricks: Tipo arquivo = Arquivo (A), Parquet (P) ou Tabela (T)
   • Fabric: tipo arquivo fica Tabela
   • ADLS Gen2: Caminho relativo arquivo quando a tela exigir
4. Token usuário → Salvar

Campos do formulário

Campo	Quando	Obrigatório	Descrição
Armazenamento	Sempre	Sim	Nome sanitizado
Destino	Sempre	Sim	Interno / Externo
Tipo	Interno	Sim	MongoDB ou SQL Server
Tipo Conexão / Conexão	Externo	Sim	Destino externo
Descrição	Sempre	Não	Texto livre
Tipo arquivo	Databricks/Fabric	Condicional	A / P / T
Caminho relativo	ADLS Gen2	Condicional	Path no storage
Token Usuário	Sempre	Sim	Execução e links
Ativo	Sempre	—	Situação
Habilita Importação	Só interno	Não	Libera importação

Operações após o cadastro

Ação	Quando	Resultado
Abrir Dados	Geral	Grade com conteúdo
Filtrar Dados	Menu do item	Pré-filtro antes de abrir
Schema	Domínio com Config JSON	Criar/editar/limpar estrutura
Importar Dados	Flag + tipo elegível	Carga de arquivo
Exportar Dados	Domínio com exportação	Arquivo + histórico
Métricas	Menu	Tamanho, linhas, colunas

Filtrar Dados

Monte condições com E/Ou, Coluna, Operação e Valor (com busca de distintos quando disponível). Depois a grade abre já filtrada.

Schema

1. Abra Schema.
2. Gere automaticamente ou crie vazio.
3. Ajuste Coluna e Tipo (em Mongo/externo a edição de tipo pode ficar somente leitura).
4. Salve. Se necessário, limpe a collection/tabela.

Importação

Disponível quando:

• armazenamento interno com Habilita Importação (cenário SQL), ou
• provider de storage elegível;

e não quando o tipo de arquivo é Tabela (T).

Perfil comum precisa da permissão de Importação.

Exportação

1. Abra Exportar Dados.
2. Configure tipo de arquivo / schema.
3. Opcional: Script de exportação → Validar / Salvar.
4. Exportar e baixe em arquivos gerados.

Métricas

Métrica	Significado
Tamanho	Volume
Qtd. Linha	Registros
Qtd. Coluna	Colunas

Permissões

Controle no perfil	Efeito
Acesso	Ver/usar o armazenamento
Importação	Carregar arquivos (quando a flag do cadastro permitir)

Erros comuns

Problema	Verifique
Nome rejeitado	Use só a-z, 0-9 e _
Não importa	Flag, permissão de perfil, tipo arquivo Tabela
Schema indisponível	Configuração JSON no Domínio
Exportação ausente	Configuração Exportação no Domínio

Boas práticas

1. Use stage interno para consolidar antes de mandar a produção.
2. Evite renomear com frequência (pode implicar rename de tabela/collection).
3. Monitore métricas em volumes grandes.
4. Combine com agendamento Armazenamento para cargas recorrentes.

Veja também

• Cadastrar conexões
• Cadastrar consultas
• Agendamentos
• Administração