Tipos de dados de cadeia de caracteres e binários¶

VARCHAR¶

VARCHAR contém caracteres Unicode UTF-8.

Quando você declara uma coluna do tipo VARCHAR, você pode especificar um parâmetro opcional (N), que é o número máximo de caracteres a armazenar. Por exemplo:

CREATE TABLE t1 (v VARCHAR(16777216));

Se nenhum comprimento for especificado, o padrão é o comprimento máximo permitido (16.777.216).

Embora o comprimento máximo de um valor VARCHAR seja especificado em caracteres, um valor VARCHAR também é limitado a um número máximo de bytes (16.777.216 (16 MB)). O número máximo de caracteres Unicode que podem ser armazenados em uma coluna VARCHAR é mostrado abaixo:

Um byte:

16.777.216.

Múltiplos bytes:

Entre 8.388.608 (2 bytes por caractere) e 4.194.304 (4 bytes por caractere).

Por exemplo, se você declarar uma coluna como VARCHAR(16777216), a coluna pode conter um máximo de 8.388.608 de caracteres Unicode de 2 bytes, mesmo que você tenha especificado um comprimento máximo de 16777216.

Ao escolher o comprimento máximo para uma coluna VARCHAR, considere o seguinte:

• Armazenamento: Uma coluna consome o armazenamento apenas para a quantidade de dados reais armazenados. Por exemplo, uma cadeia de 1 caractere em uma coluna VARCHAR(16777216) consome apenas um caractere.

• Desempenho: não há diferença de desempenho entre usar a instrução VARCHAR de comprimento total VARCHAR(16777216) e um comprimento menor.

  Em qualquer banco de dados relacional, as instruções SELECT em que uma cláusula WHERE se refere a colunas VARCHAR, ou a colunas de cadeia de caracteres, não são tão rápidas quanto as instruções SELECT filtradas usando uma condição de coluna numérica ou de data.

• Ferramentas para trabalhar com dados: Algumas ferramentas BI/ETL definem o tamanho máximo dos dados VARCHAR no armazenamento ou na memória. Se você souber o tamanho máximo de uma coluna, você pode limitar o tamanho ao adicionar a coluna.

• Agrupamento: Quando você especifica um agrupamento para uma coluna VARCHAR, o número de caracteres que são permitidos varia, dependendo do número de bytes que cada caractere recebe e da especificação de agrupamento da coluna.

  Ao comparar valores em uma coluna agrupada, o Snowflake segue o algoritmo de agrupamento Unicode (UCA, Unicode Collation Algorithm). Esse algoritmo afeta o número máximo de caracteres permitido. Atualmente, cerca de 1,5 milhões a 8 milhões de caracteres são permitidos em uma coluna VARCHAR que é definida com um tamanho máximo e uma especificação de agrupamento.

  Como exemplo, a tabela a seguir mostra como o número máximo de caracteres pode variar para uma coluna VARCHAR(16777216), dependendo do número de bytes por caractere e da especificação de agrupamento utilizada:

  Número de bytes por caractere	Especificação de agrupamento	Número máximo de caracteres permitidos (aproximado)
  1 byte	en-ci ou en-ci-pi-ai	Cerca de 7 milhões de caracteres
  1 byte	en	Cerca de 4 milhões de caracteres
  2 bytes	en-ci-pi-ai	Cerca de 8 milhões de caracteres
  2 bytes	en-ci ou en-ci-pi	Cerca de 2,7 milhões de caracteres
  2 bytes	en	Cerca de 1,5 milhão de caracteres

CHAR, CHARACTER, NCHAR¶

Sinônimo de VARCHAR, exceto que, se o comprimento não for especificado, CHAR(1) é o padrão.

STRING, TEXT, NVARCHAR, NVARCHAR2, CHAR VARYING, NCHAR VARYING¶

Sinônimo de VARCHAR.

Exemplos de cadeias de caracteres nas colunas da tabela¶

CREATE OR REPLACE TABLE test_text(
  v VARCHAR,
  v50 VARCHAR(50),
  c CHAR,
  c10 CHAR(10),
  s STRING,
  s20 STRING(20),
  t TEXT,
  t30 TEXT(30));

DESC TABLE test_text;

+------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+
| name | type              | kind   | null? | default | primary key | unique key | check | expression | comment |
|------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------|
| V    | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| V50  | VARCHAR(50)       | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| C    | VARCHAR(1)        | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| C10  | VARCHAR(10)       | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| S    | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| S20  | VARCHAR(20)       | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| T    | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| T30  | VARCHAR(30)       | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
+------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+

BINARY¶

O comprimento máximo é de 8 MB (8.388.608 bytes). Ao contrário do VARCHAR, o tipo de dados BINARY não tem noção dos caracteres Unicode, portanto, o comprimento é sempre medido em termos de bytes.

Valores BINARY são limitados a 8 MB para que caibam dentro de 16 MB quando convertidos em cadeias de caracteres hexadecimais, por exemplo, via TO_CHAR(<binary_expression>, 'HEX').

Se um comprimento não for especificado, o padrão é o comprimento máximo.

VARBINARY¶

VARBINARY é sinônimo de BINARY.

Representação interna¶

O tipo de dados BINARY contém uma sequência de bytes de 8 bits.

Quando o Snowflake exibe valores de dados BINARY, o Snowflake costuma representar cada byte como 2 caracteres hexadecimais. Por exemplo, a palavra HELP pode ser exibida como 48454C50, onde 48 é o equivalente hexadecimal da letra ASCII (Unicode) H, 45 é a representação hexadecimal da letra E etc.

Para obter mais informações sobre a entrada e exibição de dados BINARY, consulte: Entrada e saída de binários.

Exemplos binários nas colunas da tabela¶

CREATE OR REPLACE TABLE test_binary(
  b BINARY,
  b100 BINARY(100),
  vb VARBINARY);

DESC TABLE test_binary;

+------+-----------------+--------+-------+---------+-------------+------------+-------+------------+---------+
| name | type            | kind   | null? | default | primary key | unique key | check | expression | comment |
|------+-----------------+--------+-------+---------+-------------+------------+-------+------------+---------|
| B    | BINARY(8388608) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| B100 | BINARY(100)     | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| VB   | BINARY(8388608) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
+------+-----------------+--------+-------+---------+-------------+------------+-------+------------+---------+

Constantes de cadeias de caracteres entre aspas simples¶

Uma constante de cadeia de caracteres pode ser disposta entre delimitadores de aspas simples (por exemplo, 'This is a string'). Para incluir um caractere de aspas simples dentro de uma constante de cadeia de caracteres, digite duas aspas simples adjacentes (por exemplo, '').

Por exemplo:

SELECT 'Today''s sales projections', '-''''-';

+------------------------------+----------+
| 'TODAY''S SALES PROJECTIONS' | '-''''-' |
|------------------------------+----------|
| Today's sales projections    | -''-     |
+------------------------------+----------+

Constantes de cadeias de caracteres entre cifrões¶

Em alguns casos, talvez seja necessário especificar uma constante de cadeia de caracteres que contém:

• Caracteres de aspas simples.

• Caracteres de barra invertida (por exemplo, em uma expressão regular).

• Caracteres de nova linha (por exemplo, no corpo de um procedimento armazenado ou função que você especifica em CREATE PROCEDURE ou CREATE FUNCTION).

Nestes casos, você pode evitar o escape desses caracteres usando um par de cifrões ($$) em vez de aspas simples (') para delimitar o início e o fim da cadeia de caracteres.

Em uma constante de cadeia de caracteres entre cifrões, você pode incluir aspas, barras invertidas, caracteres de nova linha e qualquer outro caractere especial (exceto cifrões duplos) sem usar o escape para esses caracteres. O conteúdo de uma constante de cadeia de caracteres entre cifrões é sempre interpretado literalmente.

Os exemplos a seguir são formas equivalentes de especificar constantes de cadeias de caracteres:

'string with a \' character'

$$string with a ' character$$

'regular expression with \\ characters: \\d{2}-\\d{3}-\\d{4}'

$$regular expression with \ characters: \d{2}-\d{3}-\d{4}$$

'string with a newline\ncharacter'

$$string with a newline
character$$

O exemplo a seguir usa uma constante de cadeia de caracteres entre cifrões que contém caracteres de nova linha e várias sequências de escape.

SELECT $1, $2 FROM VALUES ('row1', $$a
                                      ' \ \t
                                      \x21 z $ $$);

+------+-------------------------------------------------------+
| $1   | $2                                                    |
|------+-------------------------------------------------------|
| row1 | a                                                     |
|      |                                           ' \ \t      |
|      |                                           \x21 z $    |
+------+-------------------------------------------------------+

Nesse exemplo, as sequências de escape são interpretadas como caracteres individuais (por exemplo, uma barra invertida seguida de um “t”), e não como sequências de escape.