8.4. Tipos de dado binários

O tipo de dado bytea permite o armazenamento de cadeias binárias; consulte a Tabela 8-6.

A cadeia binária é uma seqüência de octetos (ou bytes). As cadeias binárias se distinguem das cadeias de caracteres por duas características: Em primeiro lugar, as cadeias binárias permitem especificamente o armazenamento de octetos com o valor zero e outros octetos "não-imprimíveis" (geralmente octetos fora da faixa 32 a 126), enquanto as cadeias de caracteres não permitem o octeto com valor zero, e também não permitem outros valores de octeto e seqüências de valores de octeto inválidos para o conjunto de caracteres da codificação selecionada para o banco de dados. Em segundo lugar, as operações nas cadeias binárias processam os bytes como estão armazenados, enquanto o processamento das cadeias de caracteres depende do idioma definido. Resumindo, as cadeias binárias são apropriadas para armazenar dados que os programadores imaginam como "bytes brutos" (raw bytes [1] ), enquanto as cadeias de caracteres são apropriadas para armazenar texto.

Ao se entrar com valores para bytea, os octetos com certos valores devem ser colocados em uma seqüência de escape (porém, todos os valores de octeto podem ser colocados em uma seqüência de escape), quando utilizados como parte de um literal cadeia de bytes em uma declaração SQL. Em geral, para construir a seqüência de escape de um octeto o mesmo é convertido em um número octal de três dígitos equivalente ao valor decimal do octeto, e precedido por duas contrabarras. A Tabela 8-7 mostra os caracteres que devem ser colocados em uma seqüência de escape, e fornece seqüências de escape alternativas onde aplicável.

A necessidade de colocar os octetos "não-imprimíveis" em uma seqüência de escape varia conforme o idioma definido. Em certas circunstâncias podem ser deixados fora de uma seqüência de escape. Deve ser observado que o resultado de todos os exemplos da Tabela 8-7 têm exatamente um octeto de comprimento, muito embora a representação de saída do octeto zero e da contrabarra possuam mais de um caractere.

=> \!chcp 1252
Active code page: 1252
=> SELECT cast('aàáâã' AS bytea);

       bytea
-------------------
 a\340\341\342\343
(1 linha)

O motivo pelo qual é necessário escrever tantas contrabarras, conforme mostrado na Tabela 8-7, é que uma cadeia de caracteres de entrada escrita como um literal cadeia de caracteres deve passar por duas fases de análise no servidor PostgreSQL. A primeira contrabarra de cada par é interpretada como um caractere de escape pelo analisador de literais cadeias de caracteres e portanto consumida, deixando a segunda contrabarra do par. A contrabarra remanescente é então reconhecida pela função de entrada de bytea como o início de um valor octal de três dígitos ou como escape de outra contrabarra. Por exemplo, o literal cadeia de caracteres passado para o servidor como '\\001' se torna '\001' após passar pelo analisador de literais cadeias de caracteres. O '\001' é então enviado para a função de entrada de bytea, onde é convertido em um único octeto com valor decimal igual a 1. Deve ser observado que o caractere apóstrofo não recebe tratamento especial por bytea e, portanto, segue as regras usuais para literais cadeias de caracteres (Consulte também a Seção 4.1.2.1.)

Os octetos bytea também são transformados em seqüências de escape na saída. De uma maneira geral, cada octeto "não-imprimível" é convertido em seu valor octal equivalente de três dígitos, e precedido por uma contrabarra. Os octetos "imprimíveis" são, em sua maioria, representados através de sua representação padrão no conjunto de caracteres do cliente. O octeto com valor decimal 92 (contrabarra) possui uma representação de saída alternativa especial. Os detalhes podem ser vistos na Tabela 8-8.

Dependendo do programa cliente do PostgreSQL utilizado, pode haver trabalho adicional a ser realizado em relação a colocar e retirar escapes das cadeias bytea. Por exemplo, pode ser necessário colocar escapes para os caracteres de nova-linha e retorno-de-carro se a interface realizar a tradução automática destes caracteres.

O padrão SQL define um tipo de cadeia binária diferente, chamado BLOB ou BINARY LARGE OBJECT (objeto binário grande). O formato de entrada é diferente se comparado com bytea, mas as funções e operadores fornecidos são praticamente os mesmos.