• Português

      • Snowflake ID

      Introdução

      No NocoBase, Snowflake ID (Snowflake ID) é usado para gerar identificadores exclusivos.

      Snowflake ID é um tipo de chave primária comumente usado no campo de ID padrão das tabelas comuns do NocoBase. Ele é adequado como identificador exclusivo interno dos registros.

      Se precisar de um número legível por sistemas externos, use a sequência ou um campo de número de negócio.

      Cenários aplicáveis

      Snowflake ID é adequado para estes cenários de negócio:

      • Chave primária padrão de tabelas comuns
      • ID de registros internos
      • Tabelas de negócio que precisam gerar IDs exclusivos com alto desempenho
      • Identificadores exclusivos que não precisam ser reconhecidos manualmente

      Configuração de criação

      Na página «Configure fields» da tabela de dados, clique em «Add field» e selecione «Snowflake ID» para criar um campo Snowflake ID.

      20251209204217

      ConfiguraçãoDescrição
      Field interfaceTipo de interface do campo. Snowflake ID corresponde a snowflakeId, determinando como os dados são inseridos e exibidos na página.
      Field display nameNome exibido do campo na interface, como «ID», «ID do registro» ou «ID interno». Recomenda-se usar um nome que os usuários de negócio possam entender diretamente.
      Field nameNome identificador do campo, usado para referências internas em API, campos de relacionamento, permissões, fluxos de trabalho etc. Normalmente não é alterado após a criação; aceita apenas letras, números e sublinhados e deve começar com uma letra.
      Field typeTipo do campo na camada de dados. Snowflake ID normalmente usa bigInt.
      Default valueValor padrão. Ao adicionar um registro, se o usuário não preencher o campo, o valor padrão poderá ser preenchido automaticamente.
      Validation rulesNormalmente geradas automaticamente pelo sistema, sem necessidade de validação manual.
      DescriptionDescrição do campo. É adequado registrar o significado do campo, os requisitos de preenchimento, a origem dos dados ou o responsável pela manutenção.
      Atenção

      Após a criação, o nome do campo será referenciado por blocos de página, permissões, fluxos de trabalho e APIs. Confirme o nome antes da criação para evitar custos de ajuste de configuração posteriormente.

      Características do campo

      O comportamento padrão do campo Snowflake ID é o seguinte:

      CaracterísticaDescrição
      Field interface padrãosnowflakeId.
      Field type padrãobigInt.
      Field type opcionalbigInt.
      Componente da páginaNormalmente gerado automaticamente, sem necessidade de inserção manual.
      FiltragemPermite consultas exatas por ID.
      OrdenaçãoPermite ordenar.
      ValidaçãoNormalmente gerada automaticamente e mantida como exclusiva.

      Editar configuração

      Após a criação, clique em «Edit» à direita do campo para editar a configuração do campo Snowflake ID. A edição do campo é usada principalmente para ajustar a forma como ele é exibido e utilizado no NocoBase, por exemplo, alterando o nome de exibição, a descrição, o valor padrão, as regras de validação ou as configurações específicas do campo.

      Se o campo vier de uma tabela já sincronizada no banco de dados principal, a edição normalmente consiste em fazer o mapeamento do campo — mapear o campo do banco de dados para o Field type e o Field interface do NocoBase.

      ConfiguraçãoPode ser editadaDescrição
      Field display nameSimAltera o nome exibido do campo na interface, sem alterar o nome identificador do campo.
      Field nameNãoO nome identificador do campo normalmente não pode ser alterado no formulário de edição após a criação.
      Field interfaceSuporte condicionalCampos do banco de dados principal ou campos sincronizados podem ser ajustados durante o mapeamento. O ajuste afetará a forma de entrada, exibição e validação na página.
      Field typeSuporte condicionalCampos do banco de dados principal ou campos sincronizados podem ser ajustados durante o mapeamento. Antes do ajuste, é necessário confirmar se os dados existentes podem ser usados com o novo tipo.
      Default valueSimAjusta o valor padrão ao adicionar novos registros.
      Validation rulesSimAjusta as regras de validação do campo.
      DescriptionSimComplementa o significado do campo, os requisitos de preenchimento, a origem dos dados ou o responsável pela manutenção.
      Atenção

      Alternar o Field type ou o Field interface não equivale a simplesmente alterar um nome de exibição. Isso afeta a forma de armazenamento do campo, o componente de entrada, as regras de validação, as condições de filtragem e a forma de uso das variáveis em fluxos de trabalho. Quando houver muitos dados existentes, confirme primeiro se o formato dos dados é compatível.

      Excluir campo

      Clique em «Delete» à direita do campo para excluir o campo Snowflake ID. No banco de dados principal, também é possível selecionar vários campos e excluí-los em lote.

      Ao excluir um campo Snowflake ID criado no banco de dados principal, normalmente a coluna real correspondente e os dados existentes nessa coluna também são excluídos do banco de dados. Ao excluir um campo sincronizado de um banco de dados ou mapeado de uma fonte de dados externa, o impacto depende da fonte de dados e da origem do campo correspondente.

      Aviso

      A exclusão de um campo pode afetar blocos de página, formulários, filtros, permissões, fluxos de trabalho, APIs, importações, exportações e dados existentes. Antes de excluir, confirme se o campo ainda é referenciado por alguma configuração de negócio.

      Uso na configuração de páginas

      O campo Snowflake ID é adequado como chave primária e identificador exclusivo interno. 20260710145423

      CenárioUso
      Criar tabelaUsado como campo de ID padrão.
      Campo de relacionamentoUsado como identificador exclusivo do registro relacionado.
      APIUsado para localizar um único registro.
      Permissões e fluxos de trabalhoParticipa do processamento interno como identificador exclusivo do registro.
      • Campo — Entenda a função, a classificação e a lógica de mapeamento dos campos
      • Tabela comum — Crie e gerencie campos em tabelas comuns
      • UUID — Use UUID como identificador exclusivo
      • Nano ID — Use IDs curtos
      • Sequência — Gere números de negócio