Crear datasets desde Google Sheets / Google Drive

Datawarehouse
, ,
1

Este instructivo tiene como objetivo explicar cómo crear un dataset de tipo Google Drive en Datawarehouse y qué condiciones debe cumplir la planilla para que el sistema la procese correctamente.

:timer_clock: 3 min

¿Para qué sirve?

Permite conectar una hoja de cálculo de Google Sheets a Datawarehouse para que su contenido quede disponible como dataset en herramientas de BI o en Finni Dashboard. En cada actualización, el sistema lee la primera hoja de la planilla y reemplaza los datos del dataset con la información vigente.

Antes de empezar

  • Tener disponible el link de la planilla de Google Sheets que se quiere conectar.
  • Compartir el archivo con la cuenta de servicio de Finnegans indicada en la pantalla (permiso de lectura es suficiente). Sin este paso, el sistema no puede acceder a la planilla al momento de ejecutarla.

:backhand_index_pointing_right: Si la planilla tiene acceso público (“cualquier persona con el link puede ver”), no es necesario compartirla con la cuenta de servicio.

Modo de uso

:round_pushpin: Datawarehouse → Datasets → Crear Dataset

  1. Completar los datos generales del dataset:
  • Nombre (*): nombre descriptivo. El sistema genera el código automáticamente a partir de este valor.
  • Descripción (*): descripción del contenido o propósito del dataset.
  • Tipo (*): seleccionar GOOGLE DRIVE.

  1. En el campo Link (*), pegar la URL de la hoja de cálculo de Google.

    Formato aceptado: https://docs.google.com/spreadsheets/d/<id>. También se aceptan variantes como https://docs.google.com/spreadsheets/u/0/d/<id>/edit#gid=0.

    Si la URL no corresponde a una hoja de cálculo de Google, el sistema muestra un error de validación y no permite guardar.

  2. Seleccionar Guardar o Guardar y Activar.

Nota aclaratoria: Los campos marcados con un asterisco (*) son de carácter obligatorio.

Condiciones del archivo de Google Sheets

Para que el dataset se procese correctamente, la planilla debe cumplir con lo siguiente:

  • Acceso habilitado: el archivo debe estar compartido con la cuenta de servicio, o tener acceso público activado.
  • Primera fila como encabezado: la fila 1 de la hoja debe contener los nombres de las columnas. Esos nombres se usan directamente como campos del dataset.
  • Encabezados sin espacios ni caracteres especiales: los nombres de columna no pueden tener espacios, tildes, ñ ni símbolos. Se recomienda usar guiones bajos (_) como separador.
  • Solo se lee la primera hoja: aunque el link incluya un parámetro de hoja (gid=...), el sistema siempre procesa la primera hoja del archivo, independientemente de cuál esté referenciada en la URL.

Qué hace y qué no hace

  • Sí: lee la primera hoja de la planilla y reemplaza los datos del dataset en cada actualización.
  • Sí: valida que el link sea una URL válida de Google Sheets al momento de guardar.
  • No: procesa hojas adicionales del archivo; solo toma la primera.
  • No: acumula datos entre actualizaciones; cada ejecución reemplaza el contenido anterior.
  • Cuidado: si los nombres de columna de la planilla cambian entre actualizaciones, el esquema del dataset cambia. Esto puede afectar consultas o tableros que ya usen esos campos.

:round_pushpin: Ver también: Crear Datasets