Pular para o conteúdo principal

bech32Decode

Introduzido em: v25.6.0 Decodifica uma string de endereço Bech32 gerada pelos algoritmos bech32 ou bech32m.
Ao contrário da função de codificação, bech32Decode lida automaticamente com FixedStrings preenchidas.
Sintaxe
Argumentos
  • address — Uma string Bech32 a ser decodificada. String ou FixedString
  • mode — Opcional. Passe 'raw' para decodificar sem remover o primeiro byte como versão witness. Use essa opção para endereços não SegWit (por exemplo, Cosmos SDK). String
Valor retornado Retorna uma tupla formada por (hrp, data) usada para codificar a string. Os dados estão em formato binário. Tuple(String, String) Exemplos Decodificar endereço
Query
Response
Endereço da rede de teste
Query
Response

bech32Encode

Introduzido em: v25.6.0 Codifica uma string de dados binários, juntamente com uma parte legível para humanos (HRP), usando os algoritmos Bech32 ou Bech32m.
Ao usar o tipo de dados FixedString, se um valor não preencher completamente a linha, ele será completado com caracteres nulos. Embora a função bech32Encode trate isso automaticamente para o argumento hrp, no caso do argumento data os valores não devem ser completados. Por esse motivo, não é recomendável usar o tipo de dados FixedString para seus valores de dados, a menos que você tenha certeza de que todos eles têm o mesmo comprimento e garanta que sua coluna FixedString também esteja definida com esse comprimento.
Sintaxe
Argumentos
  • hrp — Uma String de 1 - 83 caracteres minúsculos que especifica a “parte legível por humanos” do código. Geralmente ‘bc’ ou ‘tb’. String ou FixedString
  • data — Uma String de dados binários para codificação. String ou FixedString
  • witver_or_variant — Opcional. Pode ser uma versão witness UInt* (padrão = 1, 0 para Bech32, 1+ para Bech32m) ou uma variante de codificação String: 'bech32' (BIP173) ou 'bech32m' (BIP350). Quando uma variante String é usada, nenhum byte de versão witness é prefixado — isso é necessário para endereços não SegWit, como os do Cosmos SDK. UInt* ou String
Valor retornado Retorna uma string de endereço Bech32, composta pela parte legível por humanos, um caractere separador que é sempre ‘1’ e uma parte de dados. O comprimento da string nunca excederá 90 caracteres. Se o algoritmo não conseguir gerar um endereço válido a partir da entrada, retornará uma string vazia. String Exemplos Bech32m padrão
Query
Response
Algoritmo Bech32
Query
Response
HRP personalizado
Query
Response
Endereço do Cosmos SDK (BIP173, sem witness version)
Query
Response

bin

Introduzido em: v21.8.0 Retorna uma string contendo a representação binária do argumento, de acordo com a lógica a seguir para diferentes tipos: Sintaxe
Argumentos Valor retornado Retorna uma string com a representação binária do argumento. String Exemplos Inteiro simples
Query
Response
Números do tipo Float32
Query
Response
Números Float64
Query
Response
Conversão de UUID
Query
Response

bitPositionsToArray

Introduzido em: v21.7.0 Esta função retorna as posições (em ordem crescente) dos bits definidos como 1 na representação binária de um inteiro sem sinal. Inteiros de entrada com sinal são primeiro convertidos em um inteiro sem sinal. Sintaxe
Argumentos
  • arg — Um valor inteiro. (U)Int*
Valor retornado Retorna um array com as posições, em ordem crescente, dos bits com valor 1 na representação binária do valor de entrada. Array(UInt64) Exemplos Um único bit ativado
Query
Response
Todos os bits ativados
Query
Response

bitmaskToArray

Introduzido em: v1.1.0 Esta função decompõe um inteiro em uma soma de potências de dois. As potências de dois são retornadas em um array ordenado em ordem crescente. Sintaxe
Argumentos
  • num — Um valor inteiro. (U)Int*
Valor retornado Retorna um array com as potências de dois em ordem crescente cuja soma corresponde ao número de entrada. Array(UInt64) Exemplos Exemplo básico
Query
Response
Uma única potência de 2
Query
Response

bitmaskToList

Introduzido em: v1.1.0 Semelhante a bitmaskToArray, mas retorna as potências de dois como uma string separada por vírgula. Sintaxe
Argumentos
  • num — Um valor inteiro. (U)Int*
Valor retornado Retorna uma string com potências de dois separadas por vírgulas. String Exemplos Exemplo básico
Query
Response

char

Introduzido em: v20.1.0 Retorna uma string com comprimento igual ao número de argumentos passados, em que cada byte tem o valor do argumento correspondente. Aceita vários argumentos de tipos numéricos. Se o valor do argumento estiver fora do intervalo do tipo de dado UInt8, ele será convertido para UInt8, com possível arredondamento e estouro. Sintaxe
Argumentos Valor retornado Retorna uma string a partir dos bytes fornecidos. String Exemplos Exemplo básico
Query
Response
Criando codificações arbitrárias
Query
Response

hex

Introduzido em: v1.1.0 Retorna uma string contendo a representação hexadecimal do argumento de acordo com a lógica a seguir para diferentes tipos: A função usa letras maiúsculas A-F e não usa prefixos (como 0x) nem sufixos (como h). Sintaxe
Argumentos Valor retornado Retorna uma string contendo a representação hexadecimal do argumento. String Exemplos Inteiro simples
Query
Response
Números de ponto flutuante Float32
Query
Response
Números Float64
Query
Response
Conversão de UUID
Query
Response

hilbertDecode

Introduzido em: v24.6.0 Decodifica um índice da curva de Hilbert novamente em uma tupla de inteiros sem sinal, representando coordenadas em um espaço multidimensional. Assim como a função hilbertEncode, esta função tem dois modos de operação:
  • Simples
  • Expandido
Modo simples Aceita até 2 inteiros sem sinal como argumentos e gera um código UInt64. Modo expandido Aceita uma máscara de intervalo (tupla) como primeiro argumento e até 2 inteiros sem sinal como outros argumentos. Cada número na máscara configura o número de bits pelos quais o argumento correspondente será deslocado à esquerda, escalando efetivamente o argumento dentro do seu intervalo. A expansão de intervalo pode ser útil quando você precisa de uma distribuição semelhante para argumentos com intervalos (ou cardinalidade) muito diferentes entre si. Por exemplo: ‘endereço IP’ (0...FFFFFFFF) e ‘código do país’ (0...FF). Assim como na função de codificação, isso é limitado a 8 números no máximo. Sintaxe
Argumentos Valor retornado Retorna uma tupla do tamanho especificado. Tuple(UInt64) Exemplos Modo simples
Query
Response
Argumento único
Query
Response
Modo expandido
Query
Response
Uso de coluna
Query
Response

hilbertEncode

Introduzido em: v24.6.0 Calcula o código da Curva de Hilbert para uma lista de inteiros sem sinal. A função tem dois modos de operação:
  • Simples
  • Expandido
Modo simples Aceita até 2 inteiros sem sinal como argumentos e gera um código UInt64. Modo expandido Aceita uma máscara de intervalo (tupla) como primeiro argumento e até 2 inteiros sem sinal como argumentos adicionais. Cada número na máscara configura o número de bits em que o argumento correspondente será deslocado para a esquerda, escalando efetivamente o argumento dentro do seu intervalo. Sintaxe
Argumentos
  • args — Até dois valores UInt ou colunas do tipo UInt. UInt8/16/32/64
  • range_mask — No modo expandido, até dois valores UInt ou colunas do tipo UInt. UInt8/16/32/64
Valor retornado Retorna um código UInt64. UInt64 Exemplos Modo simples
Query
Response
Modo expandido
Query
Response
Argumento único
Query
Response
Argumento único expandido
Query
Response
Uso de coluna
Query
Response

mortonDecode

Introduzido em: v24.6.0 Decodifica uma codificação Morton (ZCurve) na tupla correspondente de inteiros sem sinal. Assim como a função mortonEncode, esta função tem dois modos de operação:
  • Simples
  • Expandido
Modo simples Aceita o tamanho da tupla resultante como primeiro argumento e o código como segundo argumento. Modo expandido Aceita uma máscara de intervalo (tupla) como primeiro argumento e o código como segundo argumento. Cada número na máscara configura o grau de redução do intervalo:
  • 1 - sem redução
  • 2 - redução de 2x
  • 3 - redução de 3x ⋮
  • Até 8x de redução.
A expansão do intervalo pode ser útil quando você precisa de uma distribuição semelhante para argumentos com intervalos muito diferentes (ou cardinalidade). Por exemplo: ‘Endereço IP’ (0...FFFFFFFF) e ‘Código do país’ (0...FF). Assim como na função de codificação, isso é limitado a no máximo 8 números. Sintaxe
Argumentos
  • tuple_size — Valor inteiro de no máximo 8. UInt8/16/32/64
  • range_mask — No modo expandido, a máscara para cada argumento. A máscara é uma tupla de inteiros sem sinal. Cada número na máscara configura o grau de redução do intervalo. Tuple(UInt8/16/32/64)
  • code — Código UInt64. UInt64
Valor retornado Retorna uma tupla do tamanho especificado. Tuple(UInt64) Exemplos Modo simples
Query
Response
Argumento único
Query
Response
Modo expandido, com redução de um argumento
Query
Response
Uso da coluna
Query
Response

mortonEncode

Introduzido em: v24.6.0 Calcula a codificação Morton (ZCurve) para uma lista de inteiros sem sinal. A função tem dois modos de operação:
  • Simples
  • Expandido*
Modo simples Aceita até 8 inteiros sem sinal como argumentos e gera um código UInt64. Modo expandido Aceita uma máscara de intervalo (tupla) como primeiro argumento e até 8 inteiros sem sinal nos demais argumentos. Cada número na máscara configura o fator de expansão do intervalo:
  • 1 - sem expansão
  • 2 - expansão de 2x
  • 3 - expansão de 3x ⋮
  • Até 8x de expansão.
Sintaxe
Argumentos
  • args — Até 8 inteiros sem sinal ou colunas do tipo mencionado acima. UInt8/16/32/64
  • range_mask — No modo expandido, a máscara de cada argumento. A máscara é uma tupla de inteiros sem sinal de 1 a 8. Cada número na máscara configura o grau de redução do intervalo. Tuple(UInt8/16/32/64)
Valor retornado Retorna um código UInt64. UInt64 Exemplos Modo simples
Query
Response
Modo expandido
Query
Response
Argumento único
Query
Response
Argumento único expandido
Query
Response
Uso da coluna
Query
Response

sqidDecode

Introduzido em: v24.1.0 Transforma um sqid novamente em um array de números. Sintaxe
Argumentos
  • sqid — O sqid a ser decodificado. String
Valor retornado Retorna um array de números a partir de sqid. Array(UInt64) Exemplos Exemplo de uso
Query
Response

sqidEncode

Introduzido em: v24.1.0 Transforma números em um sqid, uma sequência de caracteres de ID semelhante à do YouTube. Sintaxe
Aliases: sqid Argumentos
  • n1[, n2, ...] — Quantos números forem necessários. UInt8/16/32/64
Valor retornado Retorna um ID de hash String Exemplos Exemplo de uso
Query
Response

unbin

Introduzido em: v21.8.0 Interpreta cada par de dígitos binários (no argumento) como um número e o converte no byte representado por esse número. A função executa a operação oposta à de bin. Para um argumento numérico, unbin() não retorna o inverso de bin(). Se você quiser converter o resultado em um número, pode usar as funções reverse e reinterpretAs<Type>.
Se unbin for chamado de dentro do clickhouse-client, as strings binárias serão exibidas usando UTF-8.
Aceita os dígitos binários 0 e 1. A quantidade de dígitos binários não precisa ser múltipla de oito. Se a string do argumento contiver qualquer coisa além de dígitos binários, o resultado será indefinido (nenhuma exceção é lançada). Sintaxe
Argumentos
  • arg — Uma string que contém qualquer número de dígitos binários. String
Valor retornado Retorna uma string binária (BLOB). String Exemplos Uso básico
Query
Response
Converter para número
Query
Response

unhex

Introduzido em: v1.1.0 Executa a operação inversa de hex. Interpreta cada par de dígitos hexadecimais (no argumento) como um número e o converte no byte representado por esse número. O valor retornado é uma string binária (BLOB). Se você quiser converter o resultado em um número, pode usar as funções reverse e reinterpretAs<Type>.
clickhouse-client interpreta strings como UTF-8. Isso pode fazer com que os valores retornados por hex sejam exibidos de forma inesperada.
Aceita letras A-F, tanto maiúsculas quanto minúsculas. A quantidade de dígitos hexadecimais não precisa ser par. Se for ímpar, o último dígito será interpretado como a metade menos significativa do byte 00-0F. Se a string do argumento contiver qualquer caractere que não seja um dígito hexadecimal, será retornado algum resultado definido pela implementação (nenhuma exceção é lançada). Para um argumento numérico, unhex() não executa o inverso de hex(N). Sintaxe
Argumentos
  • arg — Uma sequência de caracteres contendo qualquer quantidade de dígitos hexadecimais. String ou FixedString
Valor retornado Retorna uma sequência binária de caracteres (BLOB). String Exemplos Uso básico
Query
Response
Converter para número
Query
Response
Última modificação em 2 de julho de 2026