Banco de Dados Relacionais GBDS 5

Introdução

Este manual descreve todas as tabelas, esquemas e informações dos bancos de dados relacionais do GBDS. O GBDS utiliza um banco de dados relacional para armazenar metadados sobre pessoas, transações, grupos de notificação, substituições de configurações e exceções.

O documento está dividido em quatro seções que descrevem:

• As tabelas gerais ;

• As tabelas de Latentes Não Resolvidas (UL) ;

• As tabelas de Notificação ;

• As tabelas de configurações do GBDS .

Tabelas gerais

As tabelas gerais são tabelas que armazenam informações vitais para a operação do GBDS, como exceções, informações sobre pessoas, informações sobre transações e outras. Essas tabelas são descritas abaixo.

gbds.people

A peopletabela destina-se a armazenar os índices de todas as pessoas armazenadas no banco de dados GBDS e é descrita da seguinte forma:

Coluna	Tipo	Tamanho	Valor	Informação adicional
id	bigint	20	not null	Chave primária; Chave privada do banco de dados relacional
pguid	varchar	255	not null	UGUID pessoal armazenado no HBase
deleted	tinyint	1	null	Indica se o candidato foi deletado, para que ele não seja incluido quando operações de listagem forem performadas

gbds.people_version

A people_versiontabela destina-se a armazenar as informações sobre as últimas alterações no cadastro de uma pessoa e é descrita da seguinte forma:

Coluna	Tipo	Tamanho	Valor	Informações adicionais
version	int	11	not null	Chave primária; Índice de versão (incremental a partir da primeira alteração)
person_id	bigint	20	not null	Referência à pessoagbds.people.id
_timestamp	datetime	6	null	timestamp de data e hora para a versão atual de uma pessoa
deleted	tinyint	1	null	Indica se o candidato foi excluído para ser executado ao realizar operações de listagem de candidatos
active	tinyint	1	null	Define se uma versão de um povo é elegível para transações de registro mestre

gbds.organization

A tabela organization é responsável por armazenar as informações sobre as organizações registradas no GBDS

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
id	bigint	20	not null	Chave primária; Identifica a organização unicamente
parent_id	bigint	20	null	Identifica a organização responsável, chave;
name	varchar	255	not null	Nome da organização
description	varchar	1000	not null	Descrição

gbds.transactions

A transactionstabela destina-se a armazenar informações sobre a análise de qualidade dos dados biométricos de uma transação.

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
id	bigint	20	not null	Chave primária; Chave privada do banco de dados relacional
tguid	varchar	255	not null	Referência à transaçãotransactions.tguid
pguid	varchar	255	null	UGUID da pessoa armazenada no HBase
active	tinyint	1	not null	Define se uma versão de uma pessoa é elegível para transações do Registro Mestre
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	timestamp de data e hora de criação da transação
updated	datetime	6	null	timestamp de data e hora da última modificação da transação
quality_status	enum	n/a	null	Status da análise de qualidade (como OK, PENDING, APPROVED, e outros)
enroll_status	enum	n/a	null	Status da inscrição (como ENQUEUED, PROCESSING, FAILED, e outros)
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	Tempo decorrido para extrações de modelos
extraction_quality_time	int	11	null	Tempo decorrido para extrações de qualidade
match_time	int	11	null	Tempo de correspondência decorrido para esta transação
post_match_time	int	11	null	Tempo decorrido após a correspondência para esta transação
total_time	int	11	null	Operação total menos tempo de espera na fila
transaction_type	enum	n/a	null	Tipo de transação. enum('ENROLL','UPDATE','VERIFY','IDENTIFY')
latent	tinyint	1	null	Sinaliza se a transação é uma pesquisa latente
ul	tinyint	1	null	Sinaliza se a transação é uma pesquisa UL
num_fingers	int	11	null	O número de impressões digitais na transação
num_faces	int	11	null	O número de imagens de rosto na transação (0 ou 1)
finger_quality_extracted	tinyint	1	null	Falso se as impressões digitais puderem ser extraídas
face_quality_extracted	tinyint	1	null	Falso se o rosto puder ser extraído em segundo plano. Verdadeiro se já tiver sido extraído.
ginger_extractor_type	enum	n/a	null	Tipo de extrator de gengibre utilizado na transação. Enum: GRIAULE_FAST, GRIAULE_BASIC, GRIAULE_2020, GRIAULE_2024, GRIAULE_2018.
finger_global_quality	int	11	null	Pontuação de qualidade global de impressão digital
global_quality	int	11	null	Pontuação de qualidade global do perfil
quality_extraction_api_id	varchar	255	null	ID da API que realizará ou realizou a extração de qualidade
quality_extraction_msg	varchar	512	null	Mensagem referente a extração de qualidade
api_id	varchar	255	null	O ID da instância da API que recebeu a transação
gbds_version	varchar	255	null	Versão do GBDS que processou a transação

gbds.transaction_fields

A transaction_fieldstabela tem como objetivo armazenar as informações sobre as informações de qualidade e vinculá-las às informações não biométricas da fieldstabela.

Coluna	Tipo	Tamanho	Valor	Informações adicionais
id	bigint	20	not null	Chave primária; Chave privada do banco de dados relacional
fkey	varchar	255	null	Chave de campo que descreve as informações contidas (por exemplo, se é um tipo sanguíneo, nome da mãe, data de nascimento, documento, etc.) Referência afields.fkey
type	varchar	255	null	Tipo de informação (pesquisa ou label) Referência afields.type
fvalue	varchar	255	null	Valor efetivo do campo (por exemplo, o número do documento) Referência afields.fvalue
transaction_id	bigint	20	not null	Id da transação. Referência atransaction.id

gbds.transaction_fingerprint_quality

Coluna	Tipo	Tamanho	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

Coluna	Tipo	Tamanho	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

A tabela fields destina-se a armazenar as informações não biométricas de uma pessoa, estando vinculada às transactiontabelas people_version. Ela é descrita da seguinte forma:

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
id	bigint	20	not null	Chave primária; Chave privada do banco de dados relacional
fkey	varchar	255	null	Chave de campo que descreve as informações contidas (por exemplo, se é um tipo sanguíneo, nome da mãe, data de nascimento, documento, etc.)
field_type	varchar	255	null	Tipo de informação (pesquisa ou label)
fvalue	varchar	255	null	Valor efetivo do campo (por exemplo, o número do documento)
person_id	bigint	20	not null	Referência à pessoaperson.id
person_version	int	11	not null	Referência à pessoapeople_version.version

gbds.exceptions

A tabela exceptionsdestina-se a armazenar as informações de qualquer exceção biométrica e seu tratamento. Ela é descrita a seguir:

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
id	bigint	20	not null	Chave primária; Chave privada do banco de dados relacional
aguid	varchar	255	not null	Exceção armazenada do HBase UGUID
comments	varchar	255	null	Quaisquer comentários fornecidos ao tratar a exceção
_timestamp	datetime	6	null	timestamp de data e hora para a criação da exceção
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'); Padrão: BIOMETRIC
priority	tinyint	1	not null	Referencia prioridade da exceção, com valor default 0
user	varchar	255	null	Identificação do usuário responsável pelo tratamento da exceção
transaction_id_50	bigint	20	not null	Chave estrangeira: Referência à transaçãotransactions.id
reference_person_id	bigint	20	not null	Chave estrangeira: Referência à pessoa de referênciapeople.id
trusted_master_record	tinyint	1	null	Flag para uso dos dados da transação em análises futuras
reference_indexes	varchar	1000	null
exception_group_id	int	11	not null	ID do grupo de exceção pertencente
fusion_score	int	11	not null	Armazena o score avaliado na fusão
fusion_decision	enum	n/a	null	Armazena a decisão tomada pelas regras de fusão; enum('HIT','NO_HIT','UNCERTAIN','UNCERTAIN_EXPERT','MISMATCH','ERROR')

gbds.exception_decision

A tabela exception_decisiondestina-se a armazenar as informações das decisões com relação a uma exceção. Ela é descrita a seguir:

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
candidate_id	bigint	20	not null	Identifica o candidato da exceção; Forma chave primária com user
user	varchar	100	not null	Usuário responsável pelo tratamento da exceção
locked_timestamp	datetime	6	not null	Data em que a exceção foi alocada
decision_timestamp	datetime	6	not null	Data em que a decisão foi gerada
decision	enum	n/a	not null	Decisão tomada para a exceção enum('HIT','NO_HIT','UNCERTAIN','UNCERTAIN_EXPERT','ERROR')

gbds.exception_candidates

A tabela exception_candidatesdestina-se a armazenar as informações dos candidatos a uma exceção biométrica. Ela é descrita a seguir:

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
id	bigint	20	not null	Chave primária; Chave privada do banco de dados relacional
exception_id	bigint	20	not null	ID da exceção
reference_transaction_id	bigint	20	null	ID da transação de referência
query_index	int	11	not null	Índice da biometria entrante
reference_index	int	11	not null	Índice da biometria de referência
query_quality	int	11	null	Qualidade da biometria entrante
reference_quality	int	255	null	Qualidade da biometria de referência
score	int	20	null	Pontuação de matching correspondente
locked_user	varchar	20	null	Usuário alocado para tratamento da exceção
locked_timestamp	datetime	20	null	Data em que a exceção foi alocada
locked_timeout	datetime	11	null	Data em que a exceção será desalocada por inatividade
decision	enum	n/a	null	enum(HIT, NO_HIT, UNCERTAIN, UNCERTAIN_EXPERT, ERROR)
minutiae	mediumblob	1	n/a

gbds.exception_group

A tabela exception_groupdestina-se a armazenar as informações dos candidatos a uma exceção biométrica. Ela é descrita a seguir:

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
id	bigint	20	not null	Chave primária; Identifica unicamente o grupo de exceção
gguid	varchar	100	not null	UGUID do grupo de exceção armazenado no HBase
tguid	varchar	100	not null	UGUID da transação armazenada no HBase
target	enum	n/a	not null	Tipo de exceção ao qual o grupo se refere. enum('BIOMETRIC','BIOMETRIC_INCONCLUSIVE','BIOMETRIC_MISMATCH','BIOGRAPHIC')
decision	enum	n/a	null	Decisão tomada para tratamento da exceção enum('APPROVE','REJECT','KEEP')
status	enum	n/a	not null	Status em que se encontra o o processo de tratamento da exceção enum('ANALYSIS','PENDING','READY','PROCESSING','DONE','REFUSED','ERROR')
priority	tinyint	1	not null	Referencia prioridade da exceção, com valor default 0
created	datetime	6	not null	Timestamp de criação do grupo
updated	timestamp	n/a	not null	Timestamp de criação
user	varchar	100	null	Usuário que tratou o grupo
message	varchar	4000	null	Mensagem deixada após o tratamento
comments	varchar	4000	null	Comentários a serem deixados em caso de lights out
locked_user	varchar	100	null	Usuário alocado para tratamento do grupo
locked_timestamp	datetime	6	null	Data em que o grupo de exceção foi alocado
locked_timeout	datetime	6	null	Data em que a alocação irá expirar caso não seja tratada
decision_parameters	varchar	5000	null	Parâmetros de decisão utilizados (id, valores e labels)
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	TGUID novo gerado em caso de REFUSED
lights_out_criteria	varchar	5000	null	Indica o que foi considerado no Lights Out EX: {"matchedBiographics":["nome","data de nascimento","filiação"]}
lights_out_status	enum	n/a	null	enum ('READY','ANALYSING','KEEP','AUTO_TREAT','ERROR')

gbds.exception_group_organizations

A tabela exception_group_organizations destina-se a armazenar informações sobre organizações relacionadas a um grupo de exceções.

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
exception_group_id	bigint	20	not null	ID do grupo de exceção; Forma chave primária com exception_id
exception_id	bigint	20	not null	ID da exceção a que se refere a organização; Forma chave primária com exception_group_id;
organization	varchar	100	not null	Nome da organização
origin	enum	n/a	not null	Referencia o tipo de origem da organização dentro da exceção DEFAULT 'BOTH' enum('ENTRANT','REFERENCE','BOTH')

gbds.exception_group_refused

A tabela exception_group_refused destina-se a armazenar informações sobre os grupos de exceção recusados e os grupos responsáveis pela recusa.

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
exception_group_id	bigint	20	not nuIl	ID do grupo de exceção referência
refused_exception_group_id	bigint	20	not null	ID do grupo de exceção recusado

gbds.key_format

A tabela gbds.key_format destina-se a armazenar as chaves e os formatos para validação de chave.

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
key_id	varchar	255	not null	Chave primária; Define o ID da chave
format_type	enum	6	not null	Padrão ALPHANUMERIC enum('TITULO','CPF','ALPHANUMERIC','NUMERIC','ALPHABETIC','REGEX')
regex	varchar	20	null
min_length	int	20	null	Define o tamanho mínimo da chave
max_length	int	Up to 4Gb	null	Define o tamanho máximo da chave

gbds.operation_log

A tabela gbds.operation_log é utilizada para armazenar logs de operações.

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
id	bigint	20	not null	ID interno de identificação
guid	varchar	100	null	Identificador único universal
user	varchar	100	null	Usuário responsável pela ação
log_timestamp	datetime	-	not null	Data de criação do log
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 da biometria
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	Descrição da operação a que se refere a operação
tguid	varchar	100	null	Identificador único da transação
pguid	varchar	100	null	Identificador único do perfil a que se refere a operação
kept_tguids	varchar	1000	null	TGUIDs a serem mantidos pela operação de KEEP do Lights Out

gbds.apis

O apisé usado pelo GBDS para gerenciar várias APIs ativas ao mesmo tempo.

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
api_id	varchar	255	not null	ID da instância de API exclusiva
hostname	varchar	255	not null	Nome do host do nó onde a API está sendo executada
port	int	11	not null	Porta onde a API está sendo executada
type	varchar	255	null	Tipo de instância da API (LEADER, RUNNER ou nulo)

Na inicialização da API, cada API procurará por si mesma nesta tabela. Se não for encontrada com nome de host/IP e porta, ela se insere na tabela com um GUID como api-id e tipo nulo , o que significa que não está pronta para extração de qualidade. Alterações aplicadas diretamente a esta tabela serão analisadas a cada 15 minutos.

Tabelas latentes não resolvidas (UL)

As tabelas de Latentes Não Resolvidas são usadas para armazenar informações sobre os dados da UL e os candidatos. As tabelas são descritas abaixo.

gbds.ul

A tabela ulfoi projetada para armazenar todos os GBDS UL's e é descrita da seguinte forma:

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
uguid	varchar	255	not null	Chave primária; UGUID armazenado em HBase
ul_status	varchar	255	not null	UNSOLVEDou SOLVED; HBase replica esse status
creation_time	timestamp	4	not null	current_timestamppor padrão
person_pguid	varchar	255	null	PGUID da pessoa correspondente quandoSOLVED
person_tguid	varchar	255	null	TGUID da pessoa correspondente quandoSOLVED
fragment_id	varchar	255	null	ID do fragmento original para o fragmento que gerou o UL
fragment_case_id	varchar	255	null	ID do caso original para o fragmento que gerou o UL
fragment_index	int	11	null	Índice de fragmentos para o UL. Por padrão, o índice é definido como -1(índice desconhecido, qualquer índice)
analysis_user	varchar	255	null	Usuário responsável pela análise UL
analysis_timestamp	timestamp	4	null	timestamp de data e hora da análise
group_guid	varchar	255	not null	GUID de agrupamento (para listar ULs vinculados)

gbds.ul_candidates

A tabela ul_candidates foi projetada para armazenar os candidatos de cada UL que o GBDS mantém após qualquer CORRESPONDÊNCIA LATENTE REVERSA realizada em inscrições que geraram uma correspondência com uma UL, e é descrita da seguinte forma:

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
ul_uguid	varchar	255	not null	Chave primária; UL UGUID
person_pguid	varchar	255	not null	Chave primária; PGUID do candidato
person_tguid	varchar	255	not null	Chave primária; TGUID do candidato
person_index	int	11	not null	Chave primária; Dedo indicador candidato
score	int	11	not null	Pontuação de matching correspondente para o candidato
deleted	tinyint	1	not null	0por padrão, indica se o candidato foi excluído para ser excluído ao realizar operações de listagem de candidatos
minutiae	longblob	Up to 4Gb	null	Serialização JSON contendo as minúcias correspondentes. É uma lista com a seguinte estrutura: - queryIndex, int - referenceIndex,int

Tabelas de notificação

As tabelas de notificação são usadas para armazenar dados para fins de auditoria, como e-mails, pessoas que serão notificadas e grupos.

gbds.notifications

A tabela gbds.notifications foi projetada para armazenar informações relacionadas as notificações de operações do GBDS

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
id	bigint	20	not null	Indice interno autoincrementado; Chave primária;
nguid	varchar	40	not null	Identificador único da notificação
tguid	varchar	40	not null	Identificador único da transação responsável pela notificação
created	datetime	6	not null	Timestamp da data de criação da notificação
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	Status da operação descrita em operation
sender	varchar	255	null	Módulo responsável pela notificação
uguid	varchar	40	null	Identificador do usuário
pguid	varchar	40	null	PGUID a que se refere a operação
new_tguid	varchar	40	null	TGUID novo gerado, por exemplo, quando gera um enroll
enroll_pguid	varchar	40	null	-
treatment	varchar	100	null	Tratamento no caso de análise de Lights Out
_update	tinyint	1	null	Flag de update
trusted	tinyint	1	null	Flag de truted enroll/update
origin	enum	n/a	null	enum('API','GBDS')
additional_data	mediumblob	-	null	Dados adicionais relevantes (GGUID, comentários etc)
external_ids	mediumblob	-	null	IDs externos e seus valores; {"name":"protocol", "key":"000000000"}
related_external_ids	mediumblob	-	null	IDs externos relacionados
kept_tguids	mediumblob	-	null	TGUIDs a serem mantidos em caso de Lights Out

gbds.notify_user

A tabela notify_user foi projetada para armazenar os dados do usuário autenticado pelo gbds.

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
id	bigint	20	not null	Chave primária; ID exclusivo do usuário.
username	varchar	255	not null	nome de usuário gbds autenticado

gbds.notify_group

A tabela notify_groupfoi projetada para armazenar informações dos grupos de notificação.

Column	Type	Size	Value	Additional Information
id	bigint	20	not null	Chave primária;
name	varchar	255	not null	Nome do grupo
enabled	tinyint	1	not null	Define se o grupo estará ativo ou não

gbds.notify_group_email

A tabela notify_group_email foi projetada para armazenar os e-mails de um determinado grupo.

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
notify_group_id	bigint	20	not null	Chave primária; ID do grupo.
email	varchar	255	not null	Chave primária; E-mail que pertence ao grupo

gbds.notify_user_group

A tabela notify_user_group foi projetada para armazenar informações de qual grupo um determinado usuário faz parte.

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
notify_user_id	bigint	20	not null	Chave primária; Referência ao usuárionotify_user.id
notify_group_id	bigint	20	not null	Chave primária; Referência ao gruponotify_group_email.notify_group.id

gbds.people_transparency

A tabela people_transparency foi projetada para armazenar informações sobre uma determinada pessoa e quais ações são tomadas quando essa pessoa é pesquisada.

Coluna	Tipo	Tamanho	Valor	Informações Adicionais
id	bigint	20	not null	Chave primária;
pguid	varchar	255	not null	Referência à pessoapeople.pguid
enabled	tinyint	1	not null	Referência à pessoapeople.pguid
action	varchar	255	null	Ação a ser tomada

gbds.people_transparency_group

A tabela people_transparency_group foi projetada para armazenar informações sobre os grupos aos quais uma pessoa pertence.

Column	Type	Size	Value	Additional Information
people_transparency_id	bigint	20	not null	Chave primária; Referência a people_transparency'speople_transparency.id
notify_group_id	bigint	20	not null	Chave primária; Referência ao gruponotify_group_email.notify_group.id

Tabelas de configurações do GBDS (gbds.settings)

O GBDS utiliza um banco de dados relacional para armazenar algumas configurações da API e do GBDS. A tabela de configurações é uma tabela especial projetada para controlar determinadas configurações do GBDS e da API do GBDS. Essas configurações são armazenadas na gbds.settingstabela. A tabela pode conter configurações presentes na API do GBDS, no GBDS ou em ambos, seguindo o esquema abaixo:

Tipo	Tipo	Tamanho	Valor	Informações Adicionais
skey	varchar	255	not null	Chave primária. Nome da chave de parâmetro.
stype	varchar	50	not null	Local de onde vem o parâmetro. API ou GBDS
svalue	varchar	4096	null	Valor do parâmetro
description	varchar	4096	null	Descrição do parâmetro
stimestamp	datetime	6	not null	Carimbo de data e hora
host	varchar	1024	null	Nome do host de um nó

Todas as configurações encontradas na tabela serão gravadas no respectivo arquivo, gbdsapi.propertiestanto para a API do GBDS quanto application.confpara o GBDS, a cada 15 minutos. Além disso, todas as configurações atualizadas na memória, tanto na API quanto no GBDS, serão propagadas.

O valor do parâmetro definido na gbds.settingstabela será propagado para TODOS os nós.

Este recurso é controlado por um parâmetro de configuração na tabela, gbds.rdbSystemConfiguration.enabled. Este parâmetro permitirá a substituição dos valores de configuração do GBDS e da API. Definir o valor do parâmetro como BOTHfará com que as configurações do GBDS e da API sejam substituídas.

gbds.settings / Chave de configuração de arquivo	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.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

Outras configurações podem ser colocadas na tabela gbds.settingsem rdb e todas serão gravadas na API ou no arquivo GBDS, de acordo com o tipo de configuração. No entanto, as recargas de memória em tempo de execução não serão realizadas para essas novas configurações, somente após a reinicialização da API e/ou do GBDS.