Como conectar a um banco de dados SQL
Antes de começar
- Verifique se o seu banco de dados está funcionando corretamente.
- Certifique-se de que o seu banco de dados é acessível a partir de um endereço IP público.
- Verifique se o seu banco de dados aceita conexões do endereço IP do Octoboard: 173.255.226.233
Para configurar a sua primeira conexão e adicionar um widget, utilize o botão vermelho no canto inferior direito e selecione ADICIONAR WIDGET (se estiver adicionando widgets a um relatório, certifique-se de entrar no modo de EDIÇÃO primeiro).
Ao clicar em ADICIONAR WIDGET, você será levado ao assistente de conexão padrão. Na primeira página, selecione o banco de dados ao qual você deseja se conectar. Role para baixo para localizar o seu banco de dados de escolha. Selecione-o e clique em AVANÇAR.
Será solicitado que você insira os detalhes de conexão do seu banco de dados. Criar uma conexão de banco de dados SQL é um processo muito semelhante para todos os bancos de dados suportados. Neste tutorial, estamos usando o Oracle como exemplo:
Será solicitado que você insira os detalhes de conexão para o seu banco de dados. Clique no botão "TEST CONNECTION". O Octoboard informará se a sua conexão foi bem-sucedida. Clique em APLICAR para finalizar o processo.
Uma vez estabelecida a conexão com o banco de dados, você pode começar a executar consultas SQL e exibir informações nos widgets do banco de dados. Você pode criar declarações SQL complexas, mas seus campos SELECT devem estar em conformidade com os requisitos de cada tipo de widget.
Para prosseguir com a criação de um widget de banco de dados, clique em PRÓXIMO no assistente de conexão.
O processo de adicionar widgets de banco de dados aos seus painéis e relatórios é abordado neste tutorial da Base de Conhecimento.
Existem limites ou requisitos de consulta SQL?
- Apenas declarações SELECT são permitidas.
- Não termine suas consultas com um ponto e vírgula (;).
- Não use comentários em suas consultas SQL.
- As contagens de colunas devem corresponder ao tipo de widget solicitado. Isso é abordado nos parágrafos anteriores deste tutorial.
- Os resultados da consulta são limitados a 1000 linhas. Isso deve ser suficiente para a maioria dos casos. Se você atingir esse limite, tente otimizar sua saída (a) agregando conjuntos de dados retornados (use a declaração GROUPBY) e (b) retornando dados em ordem decrescente (use "SORT BY campo DESC")
- As consultas devem ser executadas em menos de 10 segundos. Após esse período, os widgets serão encerrados. Se isso acontecer, tente simplificar suas consultas.
Primeiro, verifique se seu banco de dados está acessível online. Execute o seguinte comando de um computador público (de um endereço IP público, não em sua rede privada). Substitua seu_db_host e seu_db_port pelo host e porta do seu banco de dados:
f:Sistema Operativo Unix: nc -v your_db_host your_db_port
f:Sistema Operativo Windows: telnet your_db_host your_db_port
Por favor, entre em contato com o administrador do seu banco de dados e certifique-se de que o seu banco de dados aceita conexões do seguinte endereço IP do Octoboard: 173.255.226.233
