O que é Sqids?

Sqids é uma biblioteca de código aberto que permite gerar identificadores únicos curtos a partir de números. Esses IDs são seguros para URLs, podem codificar vários números e não contêm palavras de baixo calão comuns. Leia mais .

Assim é como eles se parecem:

https://example.com/Lqj8a0

Exemplo rápido de codificação e decodificação:

select sqids.encode(array[1, 2, 3], 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789', 0); -- 86Rf07
select sqids.decode('86Rf07', 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'); -- {1,2,3}

Se os IDs forem muito curtos, você pode preenchê-los até um certo comprimento:

select sqids.encode(array[1, 2, 3], 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789', 10); -- 86Rf07xd4z
select sqids.decode('86Rf07xd4z', 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'); -- {1,2,3}

Crie IDs únicos embaralhando o alfabeto:

select sqids.encode(array[1, 2, 3], 'k3G7QAe51FCsPW92uEOyq4Bg6Sp8YzVTmnU0liwDdHXLajZrfxNhobJIRcMvKt', 0); -- XRKUdQ
select sqids.decode('XRKUdQ', 'k3G7QAe51FCsPW92uEOyq4Bg6Sp8YzVTmnU0liwDdHXLajZrfxNhobJIRcMvKt'); -- {1,2,3}

A documentação completa está em https://github.com/sqids/sqids-plpgsql

Se você está procurando pelo Hashids PLpgSQL original, você pode encontrá-lo aqui: https://github.com/array-analytics/plpg_hashids

Casos de Uso

O principal uso de Sqids é puramente visual. Se você deseja usar IDs em vez de números em seu projeto, Sqids pode ser uma boa escolha.

Bom Para

  • Codificação de Chaves Primárias Se estiver usando um banco de dados relacional
  • Economizando consultas ao banco de dados Codificando vários objetos
  • Tokens temporários de login Livre de palavrões e seguro para URLs

Não É Bom Para

  • Dados Sensíveis Esta não é uma biblioteca de criptografia
  • IDs de Usuário Pode revelar a contagem de usuários se alguém descobrir o alfabeto de codificação

Recursos

  • 🆔 Gerar IDs curtos a partir de números não negativos
  • Codificação e decodificação fáceis
  • 🫣 IDs autogerados não contêm palavrões comuns
  • 🎲 Suporte para IDs personalizados através de um alfabeto embaralhado
  • 🥳 45 integrações (84% usam um novo design)
  • 📌 Cada versão produz os mesmos IDs
  • 🍻 Biblioteca pequena com uma licença permissiva

Exemplo / Playground