Partilhar via


Tipo STRING

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime

O tipo suporta sequências de caracteres de qualquer comprimento maior ou igual a 0.

Sintaxe

STRING

Literais

[r|R]'c [ ... ]'
  • r ou R

    Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime 10.4 LTS e superior

    Prefixo opcional denotando um literal bruto.

  • c

    Qualquer caractere do conjunto de caracteres Unicode.

As seguintes sequências de escape são reconhecidas em literais de cadeia de caracteres regulares (sem o prefixo r ) e substituídas de acordo com as seguintes regras:

  • \0 ->\u0000, caractere unicode com o código 0;
  • \b ->\u0008, espaço traseiro;
  • \n ->\u000a, alimentação de linha;
  • \r ->\u000d, retorno de carro;
  • \t ->\u0009, guia horizontal;
  • \Z ->\u001A, suplente;
  • \% ->\%;
  • \_ ->\_;
  • \<other char> -><other char>, pule a barra e deixe o personagem como está.

Se a cadeia de caracteres for prefixada com r não há nenhum caractere de escape.

A ordenação inerente de um tipo STRING é UTF8_BINARY.

Para agrupamento que ignora espaços à direita, use a cláusula COLLATE UTF8_BINARY_RTRIM.

Consulte as regras de precedência de agrupamento para obter mais informações.

Nota

Embora você possa usar aspas duplas (") em vez de aspas simples (') para delimitar uma cadeia de caracteres literal, isso é desencorajado, pois não é SQL padrão.

Aviso

Algumas interfaces de cliente executam substituições de macro em cadeias de caracteres antes de enviá-las para o analisador SQL. Por exemplo, em um bloco de anotações Databricks, o $ sinal (dólar) introduz um widget e precisa ser escapado para \$ ser preservado em um literal de cadeia de caracteres.

Exemplos

> SELECT 'Spark';
  Spark

> SELECT CAST(5 AS STRING);
  5

> SELECT 'O\'Connell'
  O'Connell

> SELECT 'Some\nText'
  Some
  Text

> SELECT r'Some\nText'
  Some\nText

> SELECT '서울시'
  서울시

> SELECT ''

> SELECT '\\'
  \

> SELECT r'\\'
  \\

-- From a notbook cell (without a widget 'e' being defined)
> SELECT 'Hou$e', 'Hou\$e', r'Hou$e', r'Hou\$e'
  Hou  Hou$e  Hou  Hou$e

> SELECT COLLATION(‘hello’);
  UTF8_BINARY