Páginas filhas
  • Campos UUID no Protheus

No Protheus, um campo UUID é utilizado como um identificador único para uma linha específica em uma tabela. Esse identificador é composto por 16 bytes (128 bits), nativos do Banco de Dados, e é empregado para identificar um registro específico, permitindo a manutenção de sua identificação única desde a criação. Essa funcionalidade é possível através da opção de campos reservados do SIGACFG.

É possível criar vários campos do tipo 'uniqueidentifier' para armazenar identificadores únicos globais (GUIDs - Globally Unique Identifiers) com o objetivo de garantir a unicidade dos valores. No entanto, apenas um campo do tipo 'uniqueidentifier' pode ser designado como chave primária (PK - Primary Key) com o nome '_MSUID', e este será inicializado com um valor UUID. Os demais campos do tipo 'uniqueidentifier' serão tratados como campos de relacionamento (FK - Foreign Key) e aceitarão valores UUID provenientes da chave primária de origem.


O campo 'uniqueidentifier' como chave primária (PK - Primary Key) com o nome '_MSUID' está disponível a partir do TOTVS | DBAccess Build 20210202, versão 21.1.1.4 ou superior.

Os demais campos do tipo 'uniqueidentifier', como campos de relacionamento (FK - Foreign Key) estará disponível a partir da release 12.1.2410 ou superior.


Os campos UUID são criados através da opção de campos reservados, veja como criar um campo UUID:

- Acesse o SIGACFG;
- No menu lateral clique sob Base de Dados / Dicionário / Base de Dados (CFGX031);
- Clique sob Dicionário de Dados;
- Clique sob uma tabela e após em Editar;




- Clique em Campos / Campos Reservados, selecione Campo UUID e clique em Finalizar;




- Clique novamente em Campos Reservados, selecione Campo UUID - Relacionamento e clique em Finalizar;




- Será aberto uma modal, digite o nome para o novo campo UUID e após clique em confirmar;
 

Poderá ser digitado qualquer nome, mas lembre-se deve manter o mesmo padrão Tabela_Nome com no máximo 10 caracteres. Exemplo: A00_REL001.

Lembre-se de que apenas um campo com o nome 'MSUUID' pode ser cadastrado. Se houver tentativa de cadastrar mais de um, será exibido um aviso informando que o campo já foi cadastrado.


Campo UUID - Relacionamento poderá ser cadastrado quantos desejar, respeitando o limite da tabela, que é 350. Maiores informações: https://tdn.totvs.com/display/public/framework/Limite+de+campos+por+tabela


- Clique em Sair, caso esteja certo que queira criar o(s) campo(os) UUID;




- Clique em Salvar e Avançar para todas etapas;




 - Clique em Finalizar para concluir a criação do(s) campo(os) UUID.




- Veja o processo completo de como criar campo UUID.



É necessário acesso exclusivo para criar um campo reservado.



Documentação de referência de como o campo UUID é criado pelo DBAccess no link abaixo:
Campos UUID no DBAccess - TOTVSTEC - TDN