STRING tipo

Se aplica a: Databricks SQL Databricks Runtime

El tipo admite secuencias de caracteres cualquier longitud mayor o igual que 0.

Sintaxis

STRING

Literales

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

• r o R

  Se aplica a: Databricks SQL Databricks Runtime 10.4 LTS y versiones posteriores

  Prefijo opcional que indica un literal sin formato.

• c

  Cualquier carácter del juego de caracteres Unicode.

Las siguientes secuencias de escape se reconocen en literales de cadena normales (sin el prefijo r) y se reemplazan según las reglas siguientes:

• \0 ->\u0000, carácter Unicode con el código 0;
• \b ->\u0008, retroceso;
• \n ->\u000a, avance de línea;
• \r ->\u000d, retorno de carro;
• \t ->\u0009, tabulación horizontal;
• \Z ->\u001A, sustitución;
• \% ->\%;
• \_ ->\_;
• \<other char> -><other char>, omita la barra diagonal y deje el carácter como está.

Si la cadena tiene el prefijo r, no hay ningún carácter de escape.

La intercalación inherente de un tipo STRING se hereda del contexto en el que se usa:

• Las cadenas producidas por las funciones derivan la ordenación de los argumentos de entrada de la función.
• Dentro de un CREATE o un ALTER de un TABLE, un VIEW o un FUNCTION, la intercalación predeterminada coincide con la intercalación predeterminada de ese TABLE, VIEW o FUNCTION.
• Dentro del contexto de un UPDATE de nivel superior, DELETE, INSERT, MERGE o instrucción de consulta, la intercalación predeterminada es UTF8_BINARY.

Para la intercalación que omite los espacios finales, use la cláusula COLLATE UTF8_BINARY_RTRIM.

Consulte las reglas de precedencia de intercalación para obtener más información.

Nota:

Aunque puede usar comillas dobles (") en lugar de comillas simples (') para delimitar un literal de cadena, esto no se recomienda porque no es SQL estándar.

Advertencia

Algunas interfaces de cliente realizan sustituciones de macros en cadenas antes de enviarlos al analizador de SQL. Por ejemplo, en un cuaderno de Databricks el signo $ (dólar) introduce un widget y debe escaparse con \$ para conservarse en un literal de cadena.

Ejemplos

> 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

> CREATE TEMPORARY VIEW v DEFAULT COLLATION UNICODE_CI
  AS SELECT 'hello' AS c1;
> SELECT COLLATION FOR(c1) FROM v;
  UNICODE_CI

Temas relacionados

• cast Función