TipoSTRING

Aplica-se a: SQL do Databricks Runtime do Databricks

O tipo dá suporte a sequências de caracteres de qualquer comprimento maior ou igual a 0.

Sintaxe

STRING

Literais

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

• r ou R

  Aplica-se a: SQL do Databricks Databricks Runtime 10.4 LTS e versões posteriores

  Prefixo opcional que indica 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, backspace;
• \n ->\u000a, linefeed;
• \r ->\u000d, retorno de carro;
• \t ->\u0009, guia horizontal;
• \Z ->\u001A, substituto;
• \% ->\%;
• \_ ->\_;
• \<other char> -><other char>, pule a barra e deixe o caractere como está.

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

Observação

Embora você possa usar aspas duplas (") em vez de aspas simples (') para delimitar um literal de cadeia de caracteres, isso é desincentivado porque não é 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 do SQL. Por exemplo, em um notebook do Databricks, o sinal $ (dólar) introduz um widget e precisa ser escapado com \$ 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

Relacionados

• Função cast