Base de datos relacional GBDS 5

Introducción

Este manual describe todas las tablas, esquemas e informaciones de las bases de datos relacionales de GBDS. GBDS utiliza una base de datos relacional para almacenar metadatos sobre personas, transacciones, grupos de notificación, sustituciones de configuraciones y excepciones.

El documento está dividido en cuatro secciones que describen:

• Las tablas generales ;

• Las tablas de Latentes No Resueltas (UL) ;

• Las tablas de Notificación ;

• Las tablas de configuraciones de GBDS .

Tablas generales

Las tablas generales son tablas que almacenan información vital para la operación de GBDS, como excepciones, información sobre personas, información sobre transacciones y otras. Estas tablas se describen a continuación.

gbds.people

La peopletabla se destina a almacenar los índices de todas las personas almacenadas en la base de datos GBDS y se describe de la siguiente forma:

Columna	Tipo	Tamaño	Valor	Información adicional
id	bigint	20	not null	Clave primaria; Clave privada de la base de datos relacional
pguid	varchar	255	not null	UGUID personal almacenado en HBase
deleted	tinyint	1	null	Indica si el candidato fue eliminado, para que no se incluya cuando se realicen operaciones de listado

gbds.people_version

La people_versiontabla se destina a almacenar la información sobre los últimos cambios en el registro de una persona y se describe de la siguiente forma:

Columna	Tipo	Tamaño	Valor	Información adicional
version	int	11	not null	Clave primaria; Índice de versión (incremental a partir del primer cambio)
person_id	bigint	20	not null	Referencia a la personagbds.people.id
_timestamp	datetime	6	null	marca de tiempo de fecha y hora para la versión actual de una persona
deleted	tinyint	1	null	Indica si el candidato fue excluido para ser ejecutado al realizar operaciones de listado de candidatos
active	tinyint	1	null	Define si una versión de una persona es elegible para transacciones de registro maestro

gbds.organization

La tabla organization es responsable de almacenar la información sobre las organizaciones registradas en GBDS

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
id	bigint	20	not null	Clave primaria; Identifica la organización de forma única
parent_id	bigint	20	null	Identifica la organización responsable, clave;
name	varchar	255	not null	Nombre de la organización
description	varchar	1000	not null	Descripción

gbds.transactions

La transactionstabla se destina a almacenar información sobre el análisis de calidad de los datos biométricos de una transacción.

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
id	bigint	20	not null	Clave primaria; Clave privada de la base de datos relacional
tguid	varchar	255	not null	Referencia a la transaccióntransactions.tguid
pguid	varchar	255	null	UGUID de la persona almacenada en HBase
active	tinyint	1	not null	Define si una versión de una persona es elegible para transacciones del Registro Maestro
priority	enum	n/a	null	enum('GOD_PRIORITY','HIGHEST_PRIORITY','HIGHER_PRIORITY','HIGH_PRIORITY','DEFAULT_PRIORITY','LOW_PRIORITY','LOWER_PRIORITY','LOWEST_PRIORITY')
created	datetime	6	null	marca de tiempo de fecha y hora de creación de la transacción
updated	datetime	6	null	marca de tiempo de fecha y hora de la última modificación de la transacción
quality_status	enum	n/a	null	Estado del análisis de calidad (como OK, PENDING, APPROVED, y otros)
enroll_status	enum	n/a	null	Estado de inscripción (como ENQUEUED, PROCESSING, FAILED, y otros)
search_status	enum	n/a	null	enum('ENQUEUED','PREPARED','PROCESSING','MATCH','NOT_MATCH','UNCERTAIN','MISMATCH','FAILED','PENDING','PERSON_NOT_FOUND','NONE','UL_NOT_FOUND','REFUSED','RESENT_ENROLL')
extraction_time	int	11	null	Tiempo transcurrido para extracciones de modelos
extraction_quality_time	int	11	null	Tiempo transcurrido para extracciones de calidad
match_time	int	11	null	Tiempo de coincidencia transcurrido para esta transacción
post_match_time	int	11	null	Tiempo transcurrido después de la coincidencia para esta transacción
total_time	int	11	null	Operación total menos tiempo de espera en cola
transaction_type	enum	n/a	null	Tipo de transacción. enum('ENROLL','UPDATE','VERIFY','IDENTIFY')
latent	tinyint	1	null	Indica si la transacción es una búsqueda latente
ul	tinyint	1	null	Indica si la transacción es una búsqueda UL
num_fingers	int	11	null	El número de huellas digitales en la transacción
num_faces	int	11	null	El número de imágenes de rostro en la transacción (0 o 1)
finger_quality_extracted	tinyint	1	null	Falso si las huellas digitales pueden ser extraídas
face_quality_extracted	tinyint	1	null	Falso si el rostro puede ser extraído en segundo plano. Verdadero si ya ha sido extraído.
ginger_extractor_type	enum	n/a	null	Tipo de extractor de jengibre utilizado en la transacción. Enum: GRIAULE_FAST, GRIAULE_BASIC, GRIAULE_2020, GRIAULE_2024, GRIAULE_2018.
finger_global_quality	int	11	null	Puntuación de calidad global de huella digital
global_quality	int	11	null	Puntuación de calidad global del perfil
quality_extraction_api_id	varchar	255	null	ID de la API que realizará o realizó la extracción de calidad
quality_extraction_msg	varchar	512	null	Mensaje referente a la extracción de calidad
api_id	varchar	255	null	El ID de la instancia de la API que recibió la transacción
gbds_version	varchar	255	null	Versión de GBDS que procesó la transacción

gbds.transaction_fields

La transaction_fieldstabla tiene como objetivo almacenar la información sobre las informaciones de calidad y vincularlas a las informaciones no biométricas de la fieldstabla.

Columna	Tipo	Tamaño	Valor	Información adicional
id	bigint	20	not null	Clave primaria; Clave privada de la base de datos relacional
fkey	varchar	255	null	Clave de campo que describe la información contenida (por ejemplo, si es un tipo de sangre, nombre de la madre, fecha de nacimiento, documento, etc.) Referencia afields.fkey
type	varchar	255	null	Tipo de información (búsqueda o label) Referencia afields.type
fvalue	varchar	255	null	Valor efectivo del campo (por ejemplo, el número del documento) Referencia afields.fvalue
transaction_id	bigint	20	not null	Id de la transacción. Referencia atransaction.id

gbds.transaction_fingerprint_quality

Columna	Tipo	Tamaño	Valor
transaction_id	bigint	20	not null
idx	int	11	not null
image_quality	int	11	null
template_quality	int	11	null
minutiae_count	int	11	null
blank	varchar	100	null
contrast	varchar	100	null
fingerArea	varchar	100	null
fingerCenterX	varchar	100	null
fingerCenterY	varchar	100	null
fingerExtentX	varchar	100	null
fingerExtentY	varchar	100	null
hasjoint	varchar	100	null
__index	varchar	100	null
marginBiteEast	varchar	100	null
marginBiteNorth	varchar	100	null
marginBiteSouth	varchar	100	null
marginBiteWest	varchar	100	null
nfiq	varchar	100	null
orientation	varchar	100	null
sizeX	varchar	100	null
sizeY	varchar	100	null

gbds.transaction_face_quality

Columna	Tipo	Tamaño	Valor
transaction_id	bigint	20	not null
idx	int	11	not null
image_quality	int	11	null
template_quality	int	11	null
autoBrightness	varchar	100	null
bgBelowPictureQuality	varchar	100	null
bgBlueStandardDeviation	varchar	100	null
bgDarknessQuality	varchar	100	null
bgGreenStandardDeviation	varchar	100	null
bgRedStandardDeviation	varchar	100	null
bgUniformityQuality	varchar	100	null
blurCompliance	varchar	100	null
busyBackground	varchar	100	null
busyBackgroundInCropped	varchar	100	null
cropContainmentError	varchar	100	null
eyesLookDown	varchar	100	null
eyesLookLeft	varchar	100	null
eyesLookRight	varchar	100	null
eyesLookUp	varchar	100	null
eyesObstruction	varchar	100	null
eyesTooClosed	varchar	100	null
eyesTooOpen	varchar	100	null
faceDown	varchar	100	null
faceLeft	varchar	100	null
faceObstruction	varchar	100	null
faceOrientationPitchCompliance	varchar	100	null
faceOrientationRollAngle	varchar	100	null
faceOrientationYawCompliance	varchar	100	null
faceRight	varchar	100	null
faceUp	varchar	100	null
glasses	varchar	100	null
grayscaleSpan	varchar	100	null
hat	varchar	100	null
heavyGlasses	varchar	100	null
icaoCompliance	varchar	100	null
leftEyeX	varchar	100	null
leftEyeY	varchar	100	null
mouthObstruction	varchar	100	null
mouthOpen	varchar	100	null
obstruction	varchar	100	null
openMouth	varchar	100	null
pictureHeight	varchar	100	null
pictureWidth	varchar	100	null
pixelated	varchar	100	null
redEye	varchar	100	null
result	varchar	100	null
rightEyeX	varchar	100	null
rightEyeY	varchar	100	null
saturated	varchar	100	null
saturationGrayscaleDistribGrade	varchar	100	null
saturationNumGrayTones	varchar	100	null
saturationOverExposure	varchar	100	null
shadows	varchar	100	null
skinColorCompliance	varchar	100	null
smile	varchar	100	null
smilingMouth	varchar	100	null
spoof	varchar	100	null
spoofGrade	varchar	100	null
tiltAngle	varchar	100	null
tooDark	varchar	100	null
unnaturalSkinColor	varchar	100	null
visibleTeeth	varchar	100	null
wrongFacePose	varchar	100	null
wrongShoulderPoseLeft	varchar	100	null
wrongShoulderPoseRight	varchar	100	null

gbds.fields

La tabla fields se destina a almacenar la información no biométrica de una persona, estando vinculada a las transactiontablas people_version. Se describe de la siguiente forma:

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
id	bigint	20	not null	Clave primaria; Clave privada de la base de datos relacional
fkey	varchar	255	null	Clave de campo que describe la información contenida (por ejemplo, si es un tipo de sangre, nombre de la madre, fecha de nacimiento, documento, etc.)
field_type	varchar	255	null	Tipo de información (búsqueda o label)
fvalue	varchar	255	null	Valor efectivo del campo (por ejemplo, el número del documento)
person_id	bigint	20	not null	Referencia a la personaperson.id
person_version	int	11	not null	Referencia a la personapeople_version.version

gbds.exceptions

La tabla exceptionsse destina a almacenar la información de cualquier excepción biométrica y su tratamiento. Se describe a continuación:

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
id	bigint	20	not null	Clave primaria; Clave privada de la base de datos relacional
aguid	varchar	255	not null	Excepción almacenada del HBase UGUID
comments	varchar	255	null	Cualquier comentario proporcionado al tratar la excepción
_timestamp	datetime	6	null	marca de tiempo de fecha y hora para la creación de la excepción
exception_status	enum	n/a	not null	enum ('ANALYSIS', 'DIFFERENT_FINGERS', 'SAME_FINGERS', 'INCORRECT_ENROLL', 'RECOLLECT', 'MERGE_TRANSACTIONS', 'APPROVE', 'REJECT', 'ERROR', 'REFUSED')
target	enum	n/a	not null	enum('BIOMETRIC','BIOMETRIC_INCONCLUSIVE','BIOMETRIC_MISMATCH','BIOGRAPHIC'); Predeterminado: BIOMETRIC
priority	tinyint	1	not null	Referencia a la prioridad de la excepción, con valor predeterminado 0
user	varchar	255	null	Identificación del usuario responsable del tratamiento de la excepción
transaction_id_50	bigint	20	not null	Clave foránea: Referencia a la transaccióntransactions.id
reference_person_id	bigint	20	not null	Clave foránea: Referencia a la persona de referenciapeople.id
trusted_master_record	tinyint	1	null	Bandera para el uso de los datos de la transacción en análisis futuros
reference_indexes	varchar	1000	null
exception_group_id	int	11	not null	ID del grupo de excepción al que pertenece
fusion_score	int	11	not null	Almacena la puntuación evaluada en la fusión
fusion_decision	enum	n/a	null	Almacena la decisión tomada por las reglas de fusión; enum('HIT','NO_HIT','UNCERTAIN','UNCERTAIN_EXPERT','MISMATCH','ERROR')

gbds.exception_decision

La tabla exception_decisionse destina a almacenar la información de las decisiones con respecto a una excepción. Se describe a continuación:

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
candidate_id	bigint	20	not null	Identifica al candidato de la excepción; Forma clave primaria con user
user	varchar	100	not null	Usuario responsable del tratamiento de la excepción
locked_timestamp	datetime	6	not null	Fecha en que la excepción fue asignada
decision_timestamp	datetime	6	not null	Fecha en que se generó la decisión
decision	enum	n/a	not null	Decisión tomada para la excepción enum('HIT','NO_HIT','UNCERTAIN','UNCERTAIN_EXPERT','ERROR')

gbds.exception_candidates

La tabla exception_candidatesse destina a almacenar la información de los candidatos a una excepción biométrica. Se describe a continuación:

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
id	bigint	20	not null	Clave primaria; Clave privada de la base de datos relacional
exception_id	bigint	20	not null	ID de la excepción
reference_transaction_id	bigint	20	null	ID de la transacción de referencia
query_index	int	11	not null	Índice de la biometría entrante
reference_index	int	11	not null	Índice de la biometría de referencia
query_quality	int	11	null	Calidad de la biometría entrante
reference_quality	int	255	null	Calidad de la biometría de referencia
score	int	20	null	Puntuación de matching correspondiente
locked_user	varchar	20	null	Usuario asignado para el tratamiento de la excepción
locked_timestamp	datetime	20	null	Fecha en que la excepción fue asignada
locked_timeout	datetime	11	null	Fecha en que la excepción será desasignada por inactividad
decision	enum	n/a	null	enum(HIT, NO_HIT, UNCERTAIN, UNCERTAIN_EXPERT, ERROR)
minutiae	mediumblob	1	n/a

gbds.exception_group

La tabla exception_groupse destina a almacenar la información de los candidatos a una excepción biométrica. Se describe a continuación:

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
id	bigint	20	not null	Clave primaria; Identifica de forma única el grupo de excepción
gguid	varchar	100	not null	UGUID del grupo de excepción almacenado en HBase
tguid	varchar	100	not null	UGUID de la transacción almacenada en HBase
target	enum	n/a	not null	Tipo de excepción al que se refiere el grupo. enum('BIOMETRIC','BIOMETRIC_INCONCLUSIVE','BIOMETRIC_MISMATCH','BIOGRAPHIC')
decision	enum	n/a	null	Decisión tomada para el tratamiento de la excepción enum('APPROVE','REJECT','KEEP')
status	enum	n/a	not null	Estado en que se encuentra el proceso de tratamiento de la excepción enum('ANALYSIS','PENDING','READY','PROCESSING','DONE','REFUSED','ERROR')
priority	tinyint	1	not null	Referencia a la prioridad de la excepción, con valor predeterminado 0
created	datetime	6	not null	Timestamp de creación del grupo
updated	timestamp	n/a	not null	Timestamp de creación
user	varchar	100	null	Usuario que trató el grupo
message	varchar	4000	null	Mensaje dejado después del tratamiento
comments	varchar	4000	null	Comentarios que deben dejarse en caso de lights out
locked_user	varchar	100	null	Usuario asignado para el tratamiento del grupo
locked_timestamp	datetime	6	null	Fecha en que el grupo de excepción fue asignado
locked_timeout	datetime	6	null	Fecha en que la asignación expirará si no se trata
decision_parameters	varchar	5000	null	Parámetros de decisión utilizados (id, valores y etiquetas)
new_tguid	varchar	100	null
refused_status	enum	n/a	null	enum('CREATED','REMOVED','READY_TO_RESEND','SENDING','SENT','ERROR')
refused_new_tguid	varchar	100	null	Nuevo TGUID generado en caso de REFUSED
lights_out_criteria	varchar	5000	null	Indica lo que se consideró en Lights Out Ej.: {"matchedBiographics":["nombre","fecha de nacimiento","filiación"]}
lights_out_status	enum	n/a	null	enum ('READY','ANALYSING','KEEP','AUTO_TREAT','ERROR')

gbds.exception_group_organizations

La tabla exception_group_organizations se destina a almacenar información sobre organizaciones relacionadas con un grupo de excepciones.

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
exception_group_id	bigint	20	not null	ID del grupo de excepción; Forma clave primaria con exception_id
exception_id	bigint	20	not null	ID de la excepción a la que se refiere la organización; Forma clave primaria con exception_group_id;
organization	varchar	100	not null	Nombre de la organización
origin	enum	n/a	not null	Refiere al tipo de origen de la organización dentro de la excepción DEFAULT 'BOTH' enum('ENTRANT','REFERENCE','BOTH')

gbds.exception_group_refused

La tabla exception_group_refused se destina a almacenar información sobre los grupos de excepción rechazados y los grupos responsables del rechazo.

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
exception_group_id	bigint	20	not nuIl	ID del grupo de excepción de referencia
refused_exception_group_id	bigint	20	not null	ID del grupo de excepción rechazado

gbds.key_format

La tabla gbds.key_format se destina a almacenar las claves y los formatos para la validación de claves.

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
key_id	varchar	255	not null	Clave primaria; Define el ID de la clave
format_type	enum	6	not null	Predeterminado ALPHANUMERIC enum('TITULO','CPF','ALPHANUMERIC','NUMERIC','ALPHABETIC','REGEX')
regex	varchar	20	null
min_length	int	20	null	Define el tamaño mínimo de la clave
max_length	int	Up to 4Gb	null	Define el tamaño máximo de la clave

gbds.operation_log

La tabla gbds.operation_log se utiliza para almacenar registros de operaciones.

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
id	bigint	20	not null	ID interno de identificación
guid	varchar	100	null	Identificador único universal
user	varchar	100	null	Usuario responsable de la acción
log_timestamp	datetime	-	not null	Fecha de creación del registro
log_type	enum	n/a	not null	enum('EXCEPTION','EXCEPTION_BIOMETRIC','EXCEPTION_GROUP','TRANSACTION)
operation	enum	n/a	not null	enum('UNKNOWN','CONNECT','DISCONNECT','AUTHENTICATE','ENROLL','EXTERNAL_AUTHENTICATE','BATCH_ENROLL','REGISTER_SEARCH','SEARCH','DELETE','GET_RESULT','CLOSE_SESSION','FILTER','COUNT_ANOMALIES','FIND_ANOMALIES','GET_ANOMALY','ASSIGN_ANOMALY','UNASSIGN_ANOMALY','TRUST_ENROLL','GET_TRANSACTION','CHANGE_PRIORITY','ADD_TO_REFERENCE','REMOVE_FROM_REFERENCE','REMOVE_KEYS','GET_PEOPLE_TRANSACTIONS','ANOMALY_ENROLL','GET_EXCEPTION_RESULT','QUALITY_ANALYSIS','REGISTER_ENROLL','STOP_SERVICE','REGISTER_UL_BIOMETRIC','REMOVE_UL_BIOMETRIC','UPDATE_PERSON_BIOMETRIC','DISABLE_PERSON_TRANSACTION','CREATE_EXCEPTION','CREATE_EXCEPTION_GROUP','PRIORITY_EXCEPTION','PRIORITY_EXCEPTION_GROUP','TREAT_EXCEPTION','TREAT_EXCEPTION_BIOMETRIC','TREAT_EXCEPTION_GROUP','CHANGE_REFUSED_STATUS','RESEND_REFUSED','LIGHTS_OUT')
status	enum	n/a	null	enum('ANALYSIS','READY','PROCESSING','DONE','REFUSED','PENDING','ERROR','ENQUEUED','OK','NOT_FINAL','BIOMETRIC','BIOMETRIC_INCONCLUSIVE','BIOMETRIC_MISMATCH','BIOGRAPHIC','APPROVE','REJECT','LIGHTS_OUT')
bio_index	int	11	null	Índice de la biometría
decision	enum	n/a	null	enum('UNCERTAIN','UNCERTAIN_EXPERT','NO_HIT','HIT','MISMATCH','ERROR','APPROVE','REJECT','KEEP','CREATED','REMOVED','READY_TO_RESEND')
message	varchar	1000	null	Descripción de la operación a la que se refiere la operación
tguid	varchar	100	null	Identificador único de la transacción
pguid	varchar	100	null	Identificador único del perfil al que se refiere la operación
kept_tguids	varchar	1000	null	TGUIDs que se mantendrán mediante la operación KEEP de Lights Out

gbds.apis

El apises usado por GBDS para gestionar varias APIs activas al mismo tiempo.

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
api_id	varchar	255	not null	ID exclusivo de instancia de API
hostname	varchar	255	not null	Nombre del host del nodo donde se está ejecutando la API
port	int	11	not null	Puerto donde se está ejecutando la API
type	varchar	255	null	Tipo de instancia de la API (LEADER, RUNNER o nulo)

Al iniciar la API, cada API buscará su propia entrada en esta tabla. Si no se encuentra por nombre de host/IP y puerto, se inserta en la tabla con un GUID como api-id y tipo nulo , lo que significa que no está lista para la extracción de calidad. Los cambios aplicados directamente a esta tabla se analizarán cada 15 minutos.

Tablas latentes no resueltas (UL)

Las tablas de Latentes No Resueltos se usan para almacenar información sobre los datos de la UL y los candidatos. Las tablas se describen a continuación.

gbds.ul

La tabla ulestá diseñada para almacenar todas las UL de GBDS y se describe de la siguiente manera:

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
uguid	varchar	255	not null	Clave primaria; UGUID almacenado en HBase
ul_status	varchar	255	not null	UNSOLVEDo SOLVED; HBase replica este estado
creation_time	timestamp	4	not null	current_timestamppor defecto
person_pguid	varchar	255	null	PGUID de la persona correspondiente cuandoSOLVED
person_tguid	varchar	255	null	TGUID de la persona correspondiente cuandoSOLVED
fragment_id	varchar	255	null	ID del fragmento original para el fragmento que generó la UL
fragment_case_id	varchar	255	null	ID del caso original para el fragmento que generó la UL
fragment_index	int	11	null	Índice de fragmentos para la UL. Por defecto, el índice se define como -1(índice desconocido, cualquier índice)
analysis_user	varchar	255	null	Usuario responsable del análisis de la UL
analysis_timestamp	timestamp	4	null	marca de tiempo del análisis
group_guid	varchar	255	not null	GUID de agrupación (para listar UL vinculadas)

gbds.ul_candidates

La tabla ul_candidates está diseñada para almacenar los candidatos de cada UL que GBDS mantiene después de cualquier CORRESPONDENCIA LATENTE INVERSA realizada en inscripciones que generaron una correspondencia con una UL, y se describe de la siguiente manera:

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
ul_uguid	varchar	255	not null	Clave primaria; UGUID de la UL
person_pguid	varchar	255	not null	Clave primaria; PGUID del candidato
person_tguid	varchar	255	not null	Clave primaria; TGUID del candidato
person_index	int	11	not null	Clave primaria; índice del candidato
score	int	11	not null	Puntuación de matching correspondiente para el candidato
deleted	tinyint	1	not null	0por defecto, indica si el candidato fue excluido para excluirse al realizar operaciones de listado de candidatos
minutiae	longblob	Up to 4Gb	null	Serialización JSON que contiene las minucias correspondientes. Es una lista con la siguiente estructura: - queryIndex, int - referenceIndex,int

Tablas de notificación

Las tablas de notificación se usan para almacenar datos con fines de auditoría, como correos electrónicos, personas que serán notificadas y grupos.

gbds.notifications

La tabla gbds.notifications está diseñada para almacenar información relacionada con las notificaciones de operaciones de GBDS

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
id	bigint	20	not null	Índice interno autoincremental; Clave primaria;
nguid	varchar	40	not null	Identificador único de la notificación
tguid	varchar	40	not null	Identificador único de la transacción responsable de la notificación
created	datetime	6	not null	Marca de tiempo de la creación de la notificación
operation	enum	n/a	null	enum('UNKNOWN','CONNECT','DISCONNECT','AUTHENTICATE','ENROLL','EXTERNAL_AUTHENTICATE','BATCH_ENROLL','REGISTER_SEARCH','SEARCH','DELETE','GET_RESULT','CLOSE_SESSION','FILTER','COUNT_ANOMALIES','FIND_ANOMALIES','GET_ANOMALY','ASSIGN_ANOMALY','UNASSIGN_ANOMALY','TRUST_ENROLL','GET_TRANSACTION','CHANGE_PRIORITY','ADD_TO_REFERENCE','REMOVE_FROM_REFERENCE','REMOVE_KEYS','GET_PEOPLE_TRANSACTIONS','ANOMALY_ENROLL','GET_EXCEPTION_RESULT','QUALITY_ANALYSIS','REGISTER_ENROLL','STOP_SERVICE','REGISTER_UL_BIOMETRIC','REMOVE_UL_BIOMETRIC','UPDATE_PERSON_BIOMETRIC','DISABLE_PERSON_TRANSACTION','CREATE_EXCEPTION','CREATE_EXCEPTION_GROUP','PRIORITY_EXCEPTION','PRIORITY_EXCEPTION_GROUP','TREAT_EXCEPTION','TREAT_EXCEPTION_BIOMETRIC','TREAT_EXCEPTION_GROUP','CHANGE_REFUSED_STATUS','RESEND_REFUSED','LIGHTS_OUT')
status	varchar	255	null	Estado de la operación descrita en operation
sender	varchar	255	null	Módulo responsable de la notificación
uguid	varchar	40	null	Identificador del usuario
pguid	varchar	40	null	PGUID al que se refiere la operación
new_tguid	varchar	40	null	Nuevo TGUID generado, por ejemplo, cuando genera un enroll
enroll_pguid	varchar	40	null	-
treatment	varchar	100	null	Tratamiento en el caso de análisis de Lights Out
_update	tinyint	1	null	Flag de actualización
trusted	tinyint	1	null	Flag de truted enroll/update
origin	enum	n/a	null	enum('API','GBDS')
additional_data	mediumblob	-	null	Datos adicionales relevantes (GGUID, comentarios, etc.)
external_ids	mediumblob	-	null	IDs externos y sus valores; {"name":"protocol", "key":"000000000"}
related_external_ids	mediumblob	-	null	IDs externos relacionados
kept_tguids	mediumblob	-	null	TGUID que se mantendrán en caso de Lights Out

gbds.notify_user

La tabla notify_user está diseñada para almacenar los datos del usuario autenticado por gbds.

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
id	bigint	20	not null	Clave primaria; ID exclusivo del usuario.
username	varchar	255	not null	nombre de usuario autenticado de gbds

gbds.notify_group

La tabla notify_groupestá diseñada para almacenar información de los grupos de notificación.

Column	Type	Size	Value	Additional Information
id	bigint	20	not null	Clave primaria;
name	varchar	255	not null	Nombre del grupo
enabled	tinyint	1	not null	Define si el grupo estará activo o no

gbds.notify_group_email

La tabla notify_group_email está diseñada para almacenar los correos electrónicos de un grupo determinado.

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
notify_group_id	bigint	20	not null	Clave primaria; ID del grupo.
email	varchar	255	not null	Clave primaria; Correo electrónico que pertenece al grupo

gbds.notify_user_group

La tabla notify_user_group está diseñada para almacenar información de a qué grupo pertenece un determinado usuario.

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
notify_user_id	bigint	20	not null	Clave primaria; Referencia al usuarionotify_user.id
notify_group_id	bigint	20	not null	Clave primaria; Referencia al gruponotify_group_email.notify_group.id

gbds.people_transparency

La tabla people_transparency está diseñada para almacenar información sobre una determinada persona y qué acciones se toman cuando se busca a esa persona.

Columna	Tipo	Tamaño	Valor	Informaciones Adicionales
id	bigint	20	not null	Clave primaria;
pguid	varchar	255	not null	Referencia a la personapeople.pguid
enabled	tinyint	1	not null	Referencia a la personapeople.pguid
action	varchar	255	null	Acción a tomar

gbds.people_transparency_group

La tabla people_transparency_group está diseñada para almacenar información sobre los grupos a los que pertenece una persona.

Column	Type	Size	Value	Additional Information
people_transparency_id	bigint	20	not null	Clave primaria; Referencia a people_transparency'speople_transparency.id
notify_group_id	bigint	20	not null	Clave primaria; Referencia al gruponotify_group_email.notify_group.id

Tablas de configuración de GBDS (gbds.settings)

GBDS utiliza una base de datos relacional para almacenar algunas configuraciones de la API y de GBDS. La tabla de configuración es una tabla especial diseñada para controlar determinadas configuraciones de GBDS y de la API de GBDS. Estas configuraciones se almacenan en la gbds.settingstabla. La tabla puede contener configuraciones presentes en la API de GBDS, en GBDS o en ambos, siguiendo el esquema siguiente:

Tipo	Tipo	Tamaño	Valor	Informaciones Adicionales
skey	varchar	255	not null	Clave primaria. Nombre de la clave del parámetro.
stype	varchar	50	not null	Lugar de donde proviene el parámetro. API o GBDS
svalue	varchar	4096	null	Valor del parámetro
description	varchar	4096	null	Descripción del parámetro
stimestamp	datetime	6	not null	Marca de tiempo
host	varchar	1024	null	Nombre del host de un nodo

Todas las configuraciones encontradas en la tabla se escribirán en el archivo correspondiente, gbdsapi.propertiestanto para la API de GBDS como application.confpara GBDS, cada 15 minutos. Además, todas las configuraciones actualizadas en memoria, tanto en la API como en GBDS, se propagarán.

El valor del parámetro definido en la gbds.settingstabla se propagará a TODOS los nodos.

Esta funcionalidad está controlada por un parámetro de configuración en la tabla, gbds.rdbSystemConfiguration.enabled. Este parámetro permitirá la sustitución de los valores de configuración de GBDS y de la API. Establecer el valor del parámetro como BOTHhará que se sustituyan las configuraciones de GBDS y de la API.

gbds.settings / Clave de configuración de archivo	Tipo
gbscluster.min.quality	API
gbds.enroll.fingerprints.min-nr-template	API
gbds.enroll.face.min-nr-template	API
gbds.enroll.iris.min-nr-template	API
gbds.enroll.palmprint.min-nr-template	API
gbds.enroll.newborn-palmprint.min-nr-template	API
gbscluster.enroll.fingerprints.verify.matchthreshold	API
gbscluster.update.min.quality	API
gbds.transparency.search.identify.request.notify.enabled	API
gbds.transparency.search.identify.result.actions.enabled	API
gbds.api.logLevel	API
gbds.extraction.service	API
gbds.extraction.service.face.count	API
gbds.extraction.service.ginger.count	API
gbds.extraction.service.girl.count	API
gbds.extraction.service.hostname	API
gbds.extraction.service.initialPort	API
gbds.extraction.service.logLevel	API
gbds.extraction.service.maxTries	API
gbds.extraction.service.linkLibSegfault	API
gbds.extraction.quality.service	API
gbds.extraction.quality.service.fillTransactionQualityPropertiesTable	API
gbds.faces.extraction.quality.api	API
gbds.faces.extraction.quality.background	API
gbds.fingerprints.extraction.quality.api	API
gbds.fingerprints.extraction.quality.background	API
gbds.extraction.quality.service.finger.count	API
gbds.extraction.quality.service.face.count	API
gbds.extraction.quality.service.initialPort	API
gbds.extraction.quality.service.logLevel	API
gbds.extraction.quality.service.timeout	API
gbds.extraction.quality.service.hostname	API
gbds.extraction.quality.service.maxTries	API
gbds.extraction.quality.service.linkLibSegfault	API
gbds.extraction.quality.service.rows-on-select	API
gbds.extraction.quality.service.submitted-queue-factor	API
gbds.enroll.face.min.quality	API
gbds.update.face.min.quality	API
gbds.monitor.url	API
gbds.template.face.multiplicity	API
gbds.biographicBase.enabled	API
gbds.biographicBase.endpoints	API
gbds.biographicBase.get.timeout.ms	API
gbds.biographicBase.list.timeout.ms	API
gbds.biographicBase.logLevel	API
gbds.biographicBase.clientID	API
gbds.biographicBase.clientSecret	API
gbds.biographicBase.lookAllServers	API
gbscluster.fingerprints.extraction.enroll.type	API
gbscluster.fingerprints.extraction.verify.type	API
gbds.update.exception.reextract	API
gbds.update.exception.reextract.save	API
gbds.biographicBase.autoUpdate	API
gbds.biographicBase.sendPguidAsKey	API
gbds.biographicBase.sendTguidAsKey	API
gbds.log.diagnose	GBDS
gbds.ul.boot.scan.enabled	GBDS
gbds.boot.scan.ignoreErrorsOnRegion	GBDS
gbds.boot.matcher.creation.sleepTime.ms	GBDS
gbds.biometric.fingerprint.identify.threshold	GBDS
gbds.biometric.fingerprint.exception.threshold	GBDS
gbds.biometric.fingerprint.exception.enabled	GBDS
gbds.biometric.fingerprint.exception.enroll.min-matches-for-exception	GBDS
gbds.biometric.face.identify.threshold	GBDS
gbds.biometric.face.exception.threshold	GBDS
gbds.peopleList.countFromRDB	GBDS
gbds.biometric.face.enabled.threshold	GBDS
gbds.driver.logLevel	GBDS
gbds.log.loadUnload	GBDS
gbds.template.memory.format	GBDS
gbds.match.service.enabled	GBDS
gbds.match.service.initialPort	GBDS
gbds.match.service.logLevel	GBDS
gbds.match.service.timeout	GBDS
gbds.match.service.templateSend.parallelByModality	GBDS
gbds.match.service.linkLibSegfault	GBDS
gbds.match.service.maxTries	GBDS
gbds.match.service.maxConnectionErrors	GBDS
gbds.memory-monitor	GBDS
gbds.watchdog.interval	GBDS
gbds.watchdog.log.mode	GBDS
gbds.watchdog.log.level	GBDS
gbds.verifyPostMatch.enabled	GBDS
gbds.transparency.search.identify.result.notify.enabled	BOTH
gbds.transparency.email-notifier.url	BOTH
gbds.transparency.email-notifier.log-level	BOTH
gbds.transparency.email-notifier.timeout	BOTH
gbscluster.update.consider.fingerprints	BOTH
gbscluster.update.consider.faces	BOTH
gbscluster.update.consider.faces.beforeFingerprints	BOTH
gbscluster.update.faces.verify.matchthreshold	BOTH
gbscluster.update.minimum.fingers	BOTH
gbds.search.verify.adjust-resolution	BOTH

Otras configuraciones pueden colocarse en la tabla gbds.settingsen rdb y todas se escribirán en la API o en el archivo GBDS, de acuerdo con el tipo de configuración. Sin embargo, las recargas de memoria en tiempo de ejecución no se realizarán para estas nuevas configuraciones, solo después de reiniciar la API y/o GBDS.