Cómo conectarse a una base de datos SQL
Antes de comenzar
- Verifique que su base de datos esté funcionando correctamente.
- Asegúrese de que su base de datos sea accesible desde una dirección IP pública.
- Verifique que su base de datos acepte conexiones desde la dirección IP de Octoboard: 173.255.226.233
Para configurar su primera conexión y agregar un widget, utilice el botón rojo en la esquina inferior derecha y seleccione AGREGAR WIDGET (si está agregando widgets a un informe, asegúrese de ingresar al modo de EDICIÓN primero).
Una vez que haga clic en AGREGAR WIDGET, se le llevará al asistente de conexión estándar. En la primera página, seleccione la base de datos a la que desea conectarse. Desplácese hacia abajo para localizar su base de datos de elección. Selecciónela y haga clic en SIGUIENTE.
Se le pedirá que ingrese los detalles de conexión de su base de datos. Crear una conexión de base de datos SQL es un proceso muy similar para todas las bases de datos compatibles. En este tutorial estamos utilizando Oracle como ejemplo:
Se le pedirá que ingrese los detalles de conexión para su base de datos. Haga clic en el botón "TEST CONNECTION". Octoboard le dirá si su conexión es exitosa. Haga clic en APLICAR para finalizar el proceso.
Una vez establecida la conexión a la base de datos, puedes comenzar a ejecutar consultas SQL y mostrar información en los widgets de la base de datos. Puedes crear declaraciones SQL complejas, pero tus campos SELECT deben cumplir con los requisitos de cada tipo de widget.
Para proceder a la creación de un widget de base de datos, haz clic en SIGUIENTE en el asistente de conexión.
El proceso de agregar widgets de base de datos a tus paneles y informes se explica en este tutorial de la Base de Conocimientos.
¿Existen límites o requisitos para las consultas SQL?
- Solo se permiten declaraciones SELECT.
- No termines tus consultas con un punto y coma (;).
- No uses comentarios en tus consultas SQL.
- Las cuentas de columna deben coincidir con el tipo de widget solicitado. Esto se explica en párrafos anteriores de este tutorial.
- Los resultados de la consulta están limitados a 1000 filas. Esto debería ser suficiente para la mayoría de los casos. Si alcanza este límite, intente optimizar su salida (a) agregando conjuntos de datos devueltos (usando la declaración GROUPBY) y (b) devolviendo datos en orden descendente (usando "SORT BY campo DESC").
- Las consultas deben ejecutarse en menos de 10 segundos. Después de ese período, los widgets se agotarán. Si eso sucede, intente simplificar sus consultas.
Primero, asegúrese de que su base de datos sea accesible en línea. Ejecute el siguiente comando desde una computadora pública (desde una dirección IP pública, no en su red privada). Reemplace your_db_host y your_db_port con el host y el puerto de su base de datos:
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, contacte a su administrador de base de datos y asegúrese de que su base de datos acepte conexiones desde la siguiente dirección IP de Octoboard: 173.255.226.233
