Tipo diSTRING

  • Articolo

Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime

Il tipo supporta sequenze di caratteri di qualsiasi lunghezza maggiore o uguale a 0.

Sintassi

STRING

Valori letterali

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

  • r oppure R

    Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 10.4 LTS e versioni successive

    Prefisso facoltativo che indica un valore letterale non elaborato.

  • c

    Qualsiasi carattere del set di caratteri Unicode.

Le sequenze di escape seguenti vengono riconosciute nei valori letterali stringa regolari (senza il r prefisso) e sostituite in base alle regole seguenti:

  • \0 ->\u0000, carattere Unicode con il codice 0;
  • \b ->\u0008, backspace;
  • \n ->\u000a, avanzamento riga;
  • \r ->\u000d, ritorno a capo;
  • \t ->\u0009, scheda orizzontale;
  • \Z ->\u001A, sostituire;
  • \% ->\%;
  • \_ ->\_;
  • \<other char> -><other char>, ignorare la barra e lasciare invariato il carattere.

Se la stringa è preceduta da r un prefisso senza carattere di escape.

Nota

Anche se è possibile usare virgolette doppie (") anziché virgolette singole (') per delimitare un valore letterale stringa, ciò è sconsigliato perché non è SQL standard.

Avviso

Alcune interfacce client eseguono sostituzioni di macro sulle stringhe prima di inviarle al parser SQL. Ad esempio, in un notebook di Databricks il $ segno (dollaro) introduce un widget e deve essere preceduto da un carattere di escape con \$ per essere mantenuto in un valore letterale stringa.

Esempi

> 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