SQL

Tipos de servidores disponibles

Con nuestra integración de SQL, puedes mostrar cualquier cosa que se pueda expresar en SQL. Plecto soporta los siguientes tipos de servidores SQL:

• MySQL

• PostgreSQL

• Microsoft SQL Server 2005 o posterior (incluyendo Azure SQL)

• Oracle

• Snowflake

• BigQuery*

• AWS Athena*

• AWS Redshift*

*proceso de configuración específico del servidor

Detalles técnicos

• Frecuencia de actualización: Personalizada (desde cada 1 minuto hasta una vez al día)

• ¿Soporta campos personalizados? Sí

• ¿Soporta registros eliminados? No

Frecuencias de actualización

Nuestro sistema aumentará automáticamente la frecuencia de actualización de SQL de una fuente de datos, dependiendo del tiempo empleado en importar desde tu servidor. Ejemplos:

• Si la frecuencia de actualización se establece en 1 minuto, pero la importación tarda entre 30-120 segundos, Plecto ajustará la frecuencia de actualización a 5 minutos.

• Si la frecuencia de actualización se establece en 1 o 5 minutos, pero la importación tarda entre 120-180 segundos, Plecto ajustará la frecuencia de actualización a 15 minutos.

• Si la frecuencia de actualización se establece en 1, 5 o 15 minutos, pero la importación tarda entre 180-360 segundos, Plecto ajustará la frecuencia de actualización a 1 hora.

Paso 1: Configura tu firewall

Antes de intentar importar datos de tu servidor SQL, asegúrate de configurar tu firewall para permitir solo el tráfico desde la siguiente fuente:

• 51.159.130.44

El 28-29 de junio de 2025, Plecto realizó una migración a un proveedor de alojamiento basado en Europa, por lo que la dirección IP enumerada anteriormente reemplaza las antiguas direcciones IP de Plecto. La dirección anterior está reemplazando las antiguas direcciones IP utilizadas para el tráfico, así que asegúrate de actualizar tu configuración si aún no lo has hecho.

Las siguientes direcciones IP de Plecto se deprecarán después del 28 de junio de 2025:

• 54.76.22.100

• 54.76.22.43

• 52.210.249.227

Paso 2: Conecta tu servidor SQL a Plecto

Recomendamos crear un nuevo nombre de usuario y contraseña que estén específicamente destinados a conectar tu base de datos a Plecto. De esta manera, evitarás compartir la misma contraseña en varias bases de datos. También te permitirá limitar los permisos del usuario creado para tener solo acceso de lectura.

1. Ve a Data sources > New data source y elige tu base de datos.

   Si deseas configurar bases de datos Amazon Athena/Redshift, consulta sus guías de integración específicas.

2. Completa las credenciales. Si tienes acceso a la base de datos, deberías poder recopilar tus credenciales.

   1. Nota sobre Hostname: Debes proporcionar una IP pública. Si agregas una IP local, la conexión no funcionará. Obtén más información.

   2. Nota sobre Username cuando te conectas con Azure: Si estás utilizando SQL Server en Azure, debes agregar username@[hostname] en el campo de nombre de usuario. Por ejemplo, si el nombre de host es plecto.database.windows.net, entonces debes escribir username@plecto.database.windows.net en el campo de nombre de usuario.

   3. Si deseas usar el SSH Tunnel: SSH te permite transportar datos a través de una conexión segura y encriptada. Por favor contacta al personal técnico de tu organización si deseas conectar tu base de datos a Plecto usando un túnel SSH pero no sabes cómo.

      Clave privada RSA. Plecto utiliza una clave privada RSA (formato PEM) para acceder a tu base de datos. Debes generar la clave en el sistema que utilizas, y debe formatearse en Plecto de la siguiente manera:

      -----BEGIN RSA PRIVATE KEY----- *pega la clave aquí *-----END RSA PRIVATE KEY-----

3. Haz clic en Continue y ve al Paso 3 donde tendrás que escribir una declaración SQL.

Paso 3: Escribe una declaración SQL

Una vez que conectes Plecto a la base de datos, debes escribir una declaración SELECT donde incluyas los siguientes campos estándar:

• member_id (requerido para crear el usuario, si no se encuentra la ID)

• member_name (requerido para asignar datos a miembros en Plecto)

• date (fecha requerida asociada con este registro (¡siempre en UTC!))

• reference (identificador único requerido; se puede usar para actualizar registros)

• team_name (opcional; lo haremos con upsert en la fuente de datos de Plecto)

Procedimientos almacenados. Plecto también puede usar procedimientos almacenados en lugar de declaraciones SELECT. Estos deben usarse con una declaración EXEC. Ten en cuenta que los procedimientos almacenados aún deben incluir los campos estándar mencionados anteriormente.

Cómo limitar la declaración SQL

Con cada importación, Plecto importará y actualizará todos los datos, incluidas las filas que ya han sido importadas pero no han cambiado desde la última ejecución de importación. Por lo tanto, ten cuidado con cuántos datos necesitas importar realmente: cuanto más óptima sea tu configuración, más rápido podrá procesar Plecto tus datos.

Para acelerar las actualizaciones y tener una menor carga en tus servidores, limita tu declaración para que solo devuelva los datos más recientemente cambiados. Puedes usar la variable {{ last_update_time }} para filtrar elementos que no fueron importados desde la última ejecución.

• Si tienes un campo de fecha, puedes agregar la siguiente función a la cláusula, y la variable será reemplazada con la fecha y hora más reciente cuando se actualizó la fuente de datos: date field >= {{ last_update_time }}

• También puedes agregar un límite de fecha superior que evite que Plecto importe datos más nuevos que el límite indicado. Usa la siguiente función: date field <= {{ upper_date_limit }}

• También puedes usar un top 100 en la función SELECT. Recuerda ordenar DESC (descendente) para seleccionar los registros más recientes.

last_update_time y upper_date_limit

Cuando escribas una declaración SQL, puedes agregar una fecha de inicio (last_update_time) y una fecha de fin (upper_date_limit) que harán que tu base de datos solo importe datos dentro de ese período.

Puedes ejecutar una consulta de prueba para ver cuántas filas hay durante el período indicado.

Fuente de ID de Miembro

Fuente de ID de Miembro le dice a Plecto qué sistema es el proveedor de datos. La Fuente de ID de Miembro debe ser el mismo nombre del sistema que ves en la columna Data suppliers bajo Settings > Employees. Tanto Fuente de ID de Miembro como Proveedores de datos se refieren al mismo sistema.

Si ambos lugares tienen nombres de sistema diferentes, Plecto creará nuevos empleados con cada importación de datos, lo que puede resultar en perfiles de empleados duplicados. Por lo tanto, recomendamos usar el mismo nombre de Fuente de ID de Miembro que el nombre de tu proveedor de datos.

Importación de datos SQL

• La consulta: Escribe una declaración SQL que devuelva una serie de filas, cada una correspondiendo a un registro en nuestro sistema. Cada fila puede tener cualquier número de columnas que se guardarán en el registro.

• Datos históricos: Plecto puede importar datos históricos una vez. Luego mantenemos los datos actualizados importando cada [x] minutos, pero solo las filas que han cambiado.

• Logs de importación: Puedes ver todos los logs de importación, tanto automáticos como manuales, haciendo clic en el botón View logs en la esquina superior derecha en la configuración de la fuente de datos.

• Datos nuevos: Con cada importación, Plecto importará todos los datos. Si solo deseas ver los datos nuevos/actualizados, puedes limitar tu declaración SQL (lee abajo). Al limitar la declaración, Plecto solo importará filas que han cambiado, por ejemplo, en los últimos 5 minutos.

• Datos sin procesar: Plecto funciona mejor si importas datos sin procesar. Eso significa que una fila debe representar un elemento. No importes métricas ya calculadas. Plecto puede calcular estas métricas a partir de datos sin procesar usando fórmulas.

Límite de importación de registros en SQL

Plecto limita el número de registros que se pueden importar por consulta según la frecuencia de actualización.

Importación manual de datos

A partir de julio de 2022, nuestras integraciones de SQL soportan importación manual de datos.

1. Abre la configuración de la fuente de datos y haz clic en Import historical data.

2. Elige las fechas de inicio y fin y haz clic en Start import.

Ten en cuenta que si deseas importar muchos datos históricos, debes dividir la importación de datos en varias sesiones. Si importas muchos datos antiguos a la vez, es posible que la base de datos no pueda completar la importación.

Las fechas de inicio y fin se incluirán en la declaración. Una vez que elijas las fechas de inicio y fin para la importación manual de datos, se pasarán a last_update_time y upper_date_limit en la plantilla de tu declaración.