# SQL Querier Tool

# Introducción

<span dir="ltr" role="presentation">Plugin para la monitorización de bases</span> <span dir="ltr" role="presentation">de datos SQL Server mediante consultas </span><span dir="ltr" role="presentation">SQL personalizadas.</span>  
<span dir="ltr" role="presentation">Obtiene como valor para los módulos que lo utilicen</span> <span dir="ltr" role="presentation">el resultado de la consulta SQL </span><span dir="ltr" role="presentation">lanzada.</span>

<span dir="ltr" role="presentation">**Tipo**: Plugin de servidor</span>

# Prerrequisitos

<span dir="ltr" role="presentation">Se requiere:</span>  
<span dir="ltr" role="presentation">●</span> <span dir="ltr" role="presentation">Conexión entre el servidor de Pandora y la base de</span> <span dir="ltr" role="presentation">datos SQL Server.</span>  
<span dir="ltr" role="presentation">●</span> <span dir="ltr" role="presentation">Usuario y contraseña de conexión.</span>  
<span dir="ltr" role="presentation">●</span> <span dir="ltr" role="presentation">El paquete “</span><span dir="ltr" role="presentation">perl DBI SQL server odbc</span><span dir="ltr" role="presentation">” instalado en</span> <span dir="ltr" role="presentation">el servidor de Pandora (solo para </span><span dir="ltr" role="presentation">la versión del plugin en perl).</span>

<span dir="ltr" role="presentation">● Para la versión de python es necesario el driver </span>ODBC Driver 18

# Ejecución versión Perl

```
./msql_query -Q "<sql_query>" -U "<sql_user>" -P "<sql_password>" -H "<sql_host>"
```

  
**<span dir="ltr" role="presentation">&lt;sql\_query&gt;</span>**  
<span dir="ltr" role="presentation">Consulta SQL de la que obtener el valor.  
</span><span dir="ltr" role="presentation">**&lt;sql\_user&gt;**  
</span><span dir="ltr" role="presentation">Usuario de conexión a la base de datos.  
</span>**<span dir="ltr" role="presentation">&lt;sql\_password&gt;</span>**  
<span dir="ltr" role="presentation">Contraseña de conexión a la base de datos.</span>  
**<span dir="ltr" role="presentation">&lt;sql\_host&gt;</span>**  
<span dir="ltr" role="presentation">Host\\Instancia de SQL server a la que conectarse</span> <span dir="ltr" role="presentation">para lanzar la consulta.</span>

  
**<span dir="ltr" role="presentation">Ejemplo:</span>**

```
./msql_query -Q "select * from tdata where value=’monitoring’" -U "artica" -P"pandora" -H "SQLSERVER\INSTANCE1"
```

# Ejecución versión Python

```
./msql_query "<sql_host>" "<sql_port>" "<sql_user>" "<sql_password>" "<sql_database>" "<sql_query>"["<delimiter_character>"]
```

  
**<span dir="ltr" role="presentation">&lt;sql\_host&gt;</span>**  
<span dir="ltr" role="presentation">Host\\Instancia de SQL server a la que conectarse</span> <span dir="ltr" role="presentation">para lanzar la consulta.  
**&lt;sql\_port&gt;**  
Puerto de sql server  
</span>**<span dir="ltr" role="presentation">&lt;sql\_user&gt;</span>**  
<span dir="ltr" role="presentation">Dominio\\Usuario de conexión a la base de datos.</span>  
**<span dir="ltr" role="presentation">&lt;sql\_password&gt;</span>**  
<span dir="ltr" role="presentation">Contraseña de conexión a la base de datos.</span>  
**<span dir="ltr" role="presentation">&lt;sql\_database&gt;</span>**  
<span dir="ltr" role="presentation">Nombre de la base de datos en la que realizar la</span> <span dir="ltr" role="presentation">consulta SQL.</span>  
**<span dir="ltr" role="presentation">&lt;sql\_query&gt;</span>**  
<span dir="ltr" role="presentation">Consulta SQL de la que obtener el valor. Las cadenas</span> <span dir="ltr" role="presentation">de texto en las condiciones </span><span dir="ltr" role="presentation">WHERE deben ir entre comillas simples.  
**&lt;empty&gt;**  
Opcional. Se devuelve como salida en caso de que la query devuelve un resultado vacío. Por defecto "Empty set"  
</span>**<span dir="ltr" role="presentation">&lt;delimiter\_character&gt;</span>**  
<span dir="ltr" role="presentation">Opcional. Carácter delimitador de campos del resultado</span> <span dir="ltr" role="presentation">de la consulta SQL. Por </span><span dir="ltr" role="presentation">defecto utiliza “,”.</span>

<div id="bkmrk-"></div>```
Ejemplo:./msql_query "SQLSERVER\INSTANCE1" "artica" "pandora" "pandora_database" "select * from tdata where value=’monitoring’" "|"
```