Conexões do BI
v2/bi/conexoes
4 min de leitura
Conexões adicionais de banco de dados (MariaDB/MySQL) que os datasets do BI podem usar no lugar do banco do próprio SNDesk, como uma réplica de leitura. A maioria das instalações não precisa de nenhuma.
Transcrição do vídeo
Neste vídeo, você vai ver os bastidores dos Relatórios BI: os datasets, os envios por e-mail, os alertas de KPI, o histórico de execuções e as conexões.
A aba Datasets é de quem implanta o BI. O SNDesk já traz datasets prontos para chamados, agendamentos, estouro de SLA, orçamentos e avaliações, cada um com o modo, a conexão e os campos.
O SQL usa códigos de tabela, como tb1 e tb2, e o catálogo de tabelas mostra o que cada código guarda. O quadro do assistente manda esse mapa para a base da IA.
No lápis, o formulário abre acima da lista. A conexão padrão é o banco do próprio SNDesk. DirectQuery consulta a fonte a cada execução; Materializado guarda uma cópia e atualiza na recorrência. O SQL aceita só SELECT.
Validar e pré-visualizar roda a consulta, confere que é só leitura e mostra as primeiras linhas. Depois, classifique cada coluna: dimensão ou medida, o tipo do dado e a agregação.
A segurança em nível de linha restringe o que cada usuário vê, por exemplo, pelos departamentos dele. E os campos calculados criam contas com fórmula.
Em Agendamentos, cada linha envia um relatório por e-mail, em Excel ou CSV, com a recorrência por extenso. Ativo pausa o envio sem perder a configuração, e Executar agora manda na hora.
No novo agendamento, escolha o relatório, o formato e a recorrência: diária, semanal, mensal ou cron. Os destinatários vão separados por vírgula, e podem ser de fora da empresa.
O dia do mês vai até vinte e oito, para nenhum mês ficar sem envio. Salvar agendamento grava, e cada envio aparece na aba Execuções.
Um alerta de KPI vigia o total de uma medida e avisa por e-mail quando passa do limite. Aqui, a nota média dos técnicos caiu abaixo de oito: o estado é Violado, com o último valor e a data do aviso.
No novo alerta, escolha o relatório, a medida, a condição, o limite e a frequência. O e-mail sai só na virada para Violado, não a cada avaliação.
Execuções é o histórico do que o BI gerou em arquivo: exportações e envios agendados. Na linha concluída, o botão baixa o arquivo. Na que falhou, o erro aparece abaixo, e o botão ao lado tenta de novo.
Conexões não tem aba: abre pelo endereço v2, bi, conexões. Serve para um banco MySQL ou MariaDB extra, como uma réplica. A maioria das instalações não precisa de nenhuma.
Em Nova conexão, informe o host, a porta, o banco e um usuário só de leitura. Testar conexão confirma o acesso antes de salvar.
Cada aba tem o seu guia, com exemplos, na documentação do SNDesk. Até o próximo vídeo!
Antes de começar
| O que | Depende de |
|---|---|
| Ver e cadastrar conexões | parâmetro habilitar_bi = S e permissão Relatórios BI - Datasets e Conexões, gerenciar |
Onde fica
Endereço: v2/bi/conexoes (sem item no menu nem aba).

A tabela mostra Nome, Host (com a porta), Banco, Datasets (quantos usam a conexão), Ativa, Testada em e Ações (editar, ativar/desativar, excluir).
Cadastrar uma conexão
Nova conexão.

- Nome, ex.: "Réplica de leitura".
- Host e Porta (3306 é o padrão do MySQL/MariaDB).
- Banco de dados.
- Usuário (somente-leitura) e Senha. Na edição, deixar a senha em branco mantém a atual.
- Testar conexão confirma o acesso antes de salvar.
- Ativa ligada e Salvar.
Depois, a conexão aparece no campo Conexão do formulário do dataset.
SELECT, mas um usuário com permissão de escrita é um risco desnecessário.Perguntas frequentes
A senha aparece depois de salva? Não. Ela é guardada cifrada e nunca é exibida de novo.
Posso conectar SQL Server, Postgres ou uma planilha? Não. O BI aceita só MariaDB/MySQL.
Limites e comportamentos que não são defeito
- Uma conexão inativa some da lista de conexões do formulário de dataset.
- Não dá para excluir uma conexão em uso: "Não é possível excluir: N dataset(s) usam esta conexão.".