Proyectos

El proyecto es el espacio de trabajo del usuario. Desde aquí puedes gestionar:

Conexiones a bases de datos
Crear listas de datos.
Gestionar etiquetas de clasificación.
Crear reglas de transformación.
Gestionar claves API.
Cambiar la configuración del proyecto

Bases de datos

En esta área puedes gestionar tus conexiones a bases de datos y tus entornos. Consulta la documentación de bases de datos para más información.

Listas de datos

Puedes agregar listas de datos del proyecto para usarlas en las operaciones de una regla. Puedes crear dos tipos de listas de datos:

TXT: Agrega una lista de datos en texto plano separando los valores por comas.
CSV: Puedes crear una lista de datos adjuntando un archivo CSV y seleccionando el delimitador y si el archivo contiene encabezados.

Estas listas de datos pueden ser utilizadas para operaciones de anonimización y síntesis de datos.

Variables

Puedes definir dos tipos de variables, texto o contraseña, que serán encriptadas y solo serán visibles durante el proceso de creación de la variable.

Estas variables pueden ser invocadas desde:

Funciones: Cualquier variable definida aquí puede ser invocada desde cualquier función personalizada.
Reglas: Es posible usar estas variables para Anonimizar, Sintetizar o, en general, en cualquier campo de texto donde Gigantics permita al usuario ingresar un texto.

En ambos casos, la variable será invocada usando:

Es posible crear funciones personalizadas para usarlas en las transformaciones de datos dentro del modelo.
Al igual que otros elementos de configuración, estas funciones quedan disponibles para todos los modelos del proyecto.

Para saber cómo crear una función, consulta Funciones personalizadas.

Etiquetas

Las etiquetas se utilizan para categorizar los campos analizados durante la fase de Discover dentro de un Modelo.

Gigantics ofrece un conjunto de etiquetas internas, pero el usuario puede habilitarlas o deshabilitarlas de forma individual, así como crear nuevas etiquetas personalizadas (custom/).

Etiquetas personalizadas

Para crear una nueva etiqueta y que pueda usarse en cualquier modelo del proyecto es necesario indicar una pista para que Gigantics pueda asignar la etiqueta a un campo.

En el campo type se especifica qué tipo de pista se ofrece:

Metadata hint: coincide con el nombre de la entidad o del campo para aplicar la etiqueta.
Data matchers: coincide con el valor del registro para aplicar la etiqueta.

Puedes marcar la etiqueta como Dato PII y asignarle una severidad, que se mostrará en la etapa discover de cualquier modelo del proyecto.

En la fase de Masking es posible asignar una función de transformación a la etiqueta. Esa función debe estar definida en la sección Funciones.

Por ejemplo, si queremos crear la etiqueta user/gender, marcarla como dato sensible y que solo se aplique a ciertas entidades que encajen con una expresión regular:

Name: user/gender
Type: Metadata hint
 
Entity (regex): ^employ.*
Field (of the entities that match the regex) (regex): ^gender
 
Entity (text): customers
Field (text): gender

En caso de utilizar el tipo Data Matcher, la aplicación recorrerá todos los valores y asignará la etiqueta a aquellos campos:

Name: user/gender
Type: Data Matcher
 
Include (regex): ^(M|F)$
Include (text): M

Con esta configuración, Gigantics asignará la etiqueta user/gender a todos los campos que contengan el valor M o M or F.

API

En Gigantics las claves de API se utilizan para invocar datasets, pipelines y jobs desde sistemas externos (CI/CD, scripts, etc.).
A continuación se explica el flujo actualizado:

Creación de una API Key

Accede a la sección de proyecto.
Pulsa Crear clave API y escribe un propósito que la identifique.
Se mostrará la clave y la URL base. Copia la clave y guárdala en un lugar seguro (no volverá a mostrarse).
Desde la lista de claves podrás ver el propósito, parte del identificador, fecha /hora y número de invocaciones.
Allí mismo puedes revocar, editar o eliminar la clave.

Autenticación

Cada petición a la API debe incluir la clave mediante uno de estos métodos:

Cabecera HTTP
Authorization: Bearer <API_KEY>
Parámetro de URL
<GIGANTICS_ENDPOINT>?api_key=<API_KEY>

Ejemplos con `curl`

Cabecera

curl -X POST "<GIGANTICS_PIPELINE_ENDPOINT>" \
     -H "Authorization: Bearer <API_KEY>"

Parámetro de URL

curl -X POST "<GIGANTICS_PIPELINE_ENDPOINT>?api_key=<API_KEY>"

Guarda la clave en una variable de entorno o gestor de secretos de tu plataforma CI/CD para evitar exponerla.

Endpoints

Las URL completas (incluyendo organización, proyecto, modelo y recurso) se muestran en la interfaz de Gigantics cuando asignas la clave API.
Solo necesitas conocer la clave API y pegar la URL proporcionada.

Recurso	Método	Acción
Dataset	`GET`	Devuelve el archivo SQL/CSV del dataset
Pipeline	`POST`	Ejecuta el pipeline configurado
Job	`GET`	Consulta el estado de un job (no requiere API Key)

Respuesta al ejecutar un pipeline

Cuando se inicia un pipeline, Gigantics responde con:

{
  "job_id": "64c8c45b8a5f1e001a3db9aa",
  "job_url": "https://<host>/api/job/64c8c45b8a5f1e001a3db9aa"
}

job_id: identificador interno del job.
job_url: URL para consultar su estado.
Cuando el job termine (status = completed) y el pipeline genere un dataset, en esta misma URL aparecerá el enlace al dataset resultante.

Tabla de Contenidos