Pular para o conteúdo

Campo de Relacionamento

O campo Relacionamento (Relationship) é usado para criar conexões entre duas tabelas. Ao contrário dos campos de dados padrão (como Texto ou Número), este campo não armazena um valor simples; em vez disso, ele armazena uma referência (link) para um registro em outra tabela.

Criar um relacionamento permite consultar dados relacionados em uma única solicitação (por exemplo, “Obter este Autor e todos os seus Livros”).

Ao configurar um campo de Relacionamento, as configurações definem a Cardinalidade (quantos registros podem ser vinculados):

  • Name: O nome do campo como aparecerá na API (por exemplo, author, orders, profile).
  • Related Table: A tabela de destino para a qual você deseja vincular. (por exemplo, se você estiver na tabela Comentários, poderá selecionar a tabela Usuários).
  • Type (Cardinalidade): Esta seção define as regras do relacionamento usando botões de opção. O texto aqui muda dinamicamente com base nas tabelas selecionadas, mas geralmente oferece dois caminhos:
    • Allow multiple [Current Table] per [Related Table]: Selecione isso para criar um relacionamento Um-para-Muitos (por exemplo, Um Autor pode ter muitos Livros).
    • Allow one [Related Table] per [Current Table]: Selecione isso para impor um relacionamento Um-para-Um ou limitar estritamente a conexão (por exemplo, Um Usuário tem exatamente um Perfil).
  • Description: Uma nota opcional explicando a natureza do relacionamento.
  • Mandatory: Se ativado, o registro não pode ser salvo a menos que esteja vinculado a um registro na tabela relacionada.
  • Unique: Se ativado, garante que um registro específico da tabela relacionada só possa ser vinculado uma vez.
RelacionamentoDescriçãoExemplo
Um-para-UmO registro A vincula-se a apenas um registro B e vice-versa.Usuário <-> Perfil
Um-para-MuitosO registro A está vinculado a muitos registros B, mas o registro B está vinculado a apenas um registro A.Autor <-> Livros

Nota: Ao criar um campo de relacionamento em uma tabela, o sistema cria automaticamente o campo “inverso” correspondente na tabela relacionada para garantir que a conexão funcione em ambas as direções.