TypeSTRING

  • Article

S’applique à : case marquée oui Databricks SQL case marquée oui Databricks Runtime

Le type prend en charge des séquences de caractères de toute longueur supérieure ou égale à 0.

Syntaxe

STRING

Littéraux

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

  • r ou R

    S’applique à : coche marquée oui Databricks SQL oui coché Databricks Runtime 10.4 LTS et versions ultérieures

    Préfixe facultatif indiquant un littéral brut.

  • c

    N’importe quel caractère du jeu de caractères Unicode.

Les séquences d’échappement suivantes sont reconnues dans des littéraux de chaîne réguliers (sans le préfixe r) et remplacées en fonction des règles suivantes :

  • \0 ->\u0000, caractère Unicode avec le code 0 ;
  • \b ->\u0008, retour arrière ;
  • \n ->\u000a, saut de ligne ;
  • \r ->\u000d, retour chariot ;
  • \t ->\u0009, tabulation horizontale ;
  • \Z ->\u001A, substituer ;
  • \% ->\%;
  • \_ ->\_;
  • \<other char> -><other char>, ignorer la barre oblique et laisser le caractère tel quel.

Si la chaîne est précédée de r, il n’y a pas de caractère d’échappement.

Remarque

Bien que vous puissiez utiliser des guillemets doubles (") à la place de guillemets simples (') pour délimiter un littéral de chaîne, cette méthode est déconseillée dans la mesure où elle n’est pas conforme à la norme SQL.

Avertissement

Certaines interfaces clientes effectuent des substitutions de macros sur des chaînes avant de les envoyer à l’analyseur SQL. Par exemple, dans un notebook Databricks, le signe $ (dollar) introduit un widget et doit être placé dans une séquence d’échappement avec \$ pour être conservé dans un littéral de chaîne.

Exemples

> 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