Partekatu bidez

STRING tipo

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí 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:casilla marcada como sí Databricks SQL casilla marcada como Sí 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.

Cadena de literales

Se aplica a:marcado con un check en sí Databricks Runtime 18.0 y versiones posteriores

Puede encadenar literales de cadena directamente sin necesidad de usar una función concat o un operador ||. Esto es conveniente para:

  • dividir literales largos en varias líneas
  • combine literales de cadena y marcadores de parámetros de cadena en los que no se pueden usar expresiones, como en una cláusula de tabla LOCATION, OPTIONSo COMMENT . Por ejemplo, una tabla LOCATION, OPTIONS o COMMENT cláusula.

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

> EXECUTE IMMEDIATE 'SELECT \'Hello \' :loc \'!\'' USING 'world' AS loc;
  Hello World!

> EXECUTE IMMEDIATE
    'SELECT '
        '1 AS one,'
        '2 AS two';
  1 2
  • Last updated on