Tipo VARBYTE - Amazon Redshift
Limitações

Tipo VARBYTE

Use uma coluna VARBYTE, VARBINARY ou BINARY VARYING para armazenar valores binários de tamanho variável com limite fixo. 

varbyte [ (n) ]

O número máximo de bytes (n) pode variar de 1 a 16.777.216. O padrão é 64.000.

Estes são alguns exemplos em que convém usar um tipo de dados VARBYTE:

  • Unir tabelas em colunas VARBYTE.

  • Criar visões materializadas que contenham colunas VARBYTE. Há suporte para a atualização incremental de visões materializadas que contêm colunas VARBYTE. Porém, funções agregadas que não sejam COUNT, MIN e MAX e GROUP BY nas colunas VARBYTE não são compatíveis com atualização incremental.

Para garantir que todos os bytes sejam caracteres imprimíveis, o Amazon Redshift usa o formato hexadecimal para imprimir valores VARBYTE. Por exemplo, o seguinte SQL converte a cadeia de caracteres hexadecimal 6162 em um valor binário. Mesmo que o valor retornado seja um valor binário, os resultados são impressos como hexadecimais 6162.

select from_hex('6162');
                      
 from_hex
----------
 6162

O Amazon Redshift é compatível com a conversão entre VARBYTE e os seguintes tipos de dados:

  • CHAR

  • VARCHAR

  • SMALLINT

  • INTEGER

  • BIGINT

Ao converter CHAR e VARCHAR, utiliza-se o formato UTF-8. Para obter mais informações sobre o formato do UTF-8, consulte TO_VARBYTE. Ao converter SMALLINT, INTEGER e BIGINT, mantém-se o número de bytes do tipo de dados original. São dois bytes para SMALLINT, quatro bytes para INTEGER e oito bytes para BIGINT.

A instrução SQL a seguir converte uma cadeia de caracteres VARCHAR para VARBYTE. Mesmo que o valor retornado seja um valor binário, os resultados são impressos como hexadecimais 616263.

select 'abc'::varbyte;
                      
 varbyte
---------
 616263

A instrução SQL a seguir converte um valor CHAR em uma coluna para VARBYTE. Este exemplo cria uma tabela com uma coluna (c) CHAR(10), insere valores de caracteres menores que o comprimento de 10. A conversão resultante insere o resultado com caracteres de espaço (hex'20') para o tamanho de coluna definido. Mesmo que o valor retornado seja um valor binário, os resultados são impressos como hexadecimais.

create table t (c char(10));
insert into t values ('aa'), ('abc');                 
select c::varbyte from t;
          c
----------------------
 61612020202020202020
 61626320202020202020

A instrução SQL a seguir converte uma cadeia de caracteres SMALLINT para VARBYTE. Mesmo que o valor retornado seja um valor binário, os resultados são impressos como hexadecimais 0005, que são caracteres hexadecimais de dois ou quatro bytes.

select 5::smallint::varbyte;
                  
 varbyte
---------
 0005

A instrução SQL a seguir converte um INTEGER para VARBYTE. Mesmo que o valor retornado seja um valor binário, os resultados são impressos como hexadecimais 00000005, que são caracteres hexadecimais de quatro ou oito bytes.

select 5::int::varbyte;
                  
 varbyte
----------
 00000005

A instrução SQL a seguir converte um BIGINT para VARBYTE. Mesmo que o valor retornado seja um valor binário, os resultados são impressos como hexadecimais 0000000000000005, que são caracteres hexadecimais de oito ou 16 bytes.

select 5::bigint::varbyte;
                  
     varbyte
------------------
 0000000000000005

Os recursos do Amazon Redshift compatíveis com o tipo de dados VARBYTE incluem:

Limitações ao usar dados do tipo VARBYTE com o Amazon Redshift

Estas são as limitações ao usar dados do tipo VARBYTE com o Amazon Redshift:

  • O Amazon Redshift Spectrum é compatível com o tipo de dado VARBYTE somente para arquivos Parquet e ORC.

  • O editor de consultas do Amazon Redshift e o editor de consultas do Amazon Redshift v2 ainda não são totalmente compatíveis com o tipo de dados VARBYTE. Portanto, use um cliente SQL diferente ao trabalhar com expressões VARBYTE.

    Como uma solução alternativa para usar o editor de consultas, se o comprimento dos dados estiver abaixo de 64 KB e o conteúdo for caracteres UTF-8 válidos, você poderá converter os valores VARBYTE para VARCHAR, por exemplo:

    select to_varbyte('6162', 'hex')::varchar;

  • Não é possível usar tipos de dados VARBYTE com funções definidas pelo usuário (UDFs) em Python ou Lambda.

  • Não é possível criar uma coluna HLLSKETCH a partir de uma coluna VARBYTE ou usar APPROXIMATE COUNT DISTINCT em uma coluna VARBYTE.

  • Valores de VARBYTE maiores que 1 MB só podem ser ingeridos nos seguintes formatos de arquivo:

    • Parquet

    • Texto

    • Valores separados por vírgula (CSV)