From 02546c26ff3431fcb56125d3ec8d157f4b6b703d Mon Sep 17 00:00:00 2001
From: Luis <lmachucab@helpcom.cl>
Date: Mon, 7 Oct 2024 15:53:02 -0300
Subject: [PATCH] Primer ejemplo

---
 README.md          | 19 +++++++++++++++++++
 ejemplo.ini        |  8 ++++++++
 vistabula.mysql.sh |  5 +++++
 3 files changed, 32 insertions(+)
 create mode 100644 ejemplo.ini
 create mode 100644 vistabula.mysql.sh

diff --git a/README.md b/README.md
index d68be09..3e72cd8 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,22 @@
 # vistabula
 
 Script para exportar una vista en formato tabulado de MySQL.
+
+# Ejecutar
+
+* Crear un archivo basado en [ejemplo.ini] y guardarlo en una ruta por ejemplo como [archivo.ini].
+* Dar permiso de ejecución a ``vistabula.mysql.sh``.
+* Invocar con ``vistabula.mysql.sh /ruta/a/archivo.ini``.
+
+Agregar a un crontab es trivial con el formato de subshell:
+
+```
+0 *  * * *  (vistabula/vistabula.mysql.sh ~/bdd.ini)
+```
+
+Convertir el archivo a un CSV impotable por LibreOffice se puede hacer fácilmente con csvtool:
+
+```
+csvtool -t TAB -u COMMA cat miarchivo.tab > miarchivo.csv
+```
+
diff --git a/ejemplo.ini b/ejemplo.ini
new file mode 100644
index 0000000..d604349
--- /dev/null
+++ b/ejemplo.ini
@@ -0,0 +1,8 @@
+HOST=127.0.0.1
+PORT=3307
+USER=usuario
+PASS=password1234
+DB=my_db
+VISTA=vw_vista_empleados
+NAME=empleados.tab
+
diff --git a/vistabula.mysql.sh b/vistabula.mysql.sh
new file mode 100644
index 0000000..a725cdf
--- /dev/null
+++ b/vistabula.mysql.sh
@@ -0,0 +1,5 @@
+#!/bin/sh
+. .${1}
+shift
+mysql -h ${HOST} --port ${PORT} -u ${USER} -p${PASS} -B -r -e "SELECT * FROM ${VISTA};" > ${NAME}
+