Spec-Zone.ru › Elasticsearch 8
›Elasticsearch Guide [8.17] ›SQL ›Функции и операторы

Функции строк

Функции для выполнения операций со строками.

ASCII

Описание:

ASCII(string_exp) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

Выходные данные: целое число

Описание: Возвращает значение кода ASCII самого левого символа string_exp в виде целого числа.

SELECT ASCII('Elastic');

ASCII('Elastic')
----------------
69

BIT_LENGTH

Описание:

BIT_LENGTH(string_exp) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

Выходные данные: целое число

Описание: Возвращает длину в битах string_exp входного выражения.

SELECT BIT_LENGTH('Elastic');

BIT_LENGTH('Elastic')
---------------------
56

CHAR

Описание:

CHAR(code) 

Входные данные:

целочисленное выражение между 0 и 255. Если null, отрицательное или больше, чем 255, функция возвращает null.

Выходные данные: строка

Описание: Возвращает символ, имеющий указанное значение кода ASCII в виде числового ввода.

SELECT CHAR(69);

   CHAR(69)
---------------
E

CHAR_LENGTH

Описание:

CHAR_LENGTH(string_exp) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

Выходные данные: целое число

Описание: Возвращает длину входной строки в символах, если строковое выражение имеет тип данных символов; в противном случае возвращает длину строкового выражения в байтах (наименьшее целое число, не меньшее, чем количество битов, деленное на 8).

SELECT CHAR_LENGTH('Elastic');

CHAR_LENGTH('Elastic')
----------------------
7

CONCAT

Описание:

CONCAT(
    string_exp1, 
    string_exp2) 

Входные данные:

строковое выражение. Считает null пустой строкой.

строковое выражение. Считает null пустой строкой.

Выходные данные: строка

Описание: Возвращает строку, являющуюся результатом конкатенации string_exp1 с string_exp2.

Длина результирующей строки не может превышать 1 МБ.

SELECT CONCAT('Elasticsearch', ' SQL');

CONCAT('Elasticsearch', ' SQL')
-------------------------------
Elasticsearch SQL

INSERT

Описание:

INSERT(
    source,      
    start,       
    length,      
    replacement) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

целочисленное выражение. Если null, функция возвращает null.

целочисленное выражение. Если null, функция возвращает null.

строковое выражение. Если null, функция возвращает null.

Выходные данные: строка

Описание: Возвращает строку, из которой удалены length символов, начиная с source, и в которую вставлена replacement, начиная с source.

Длина результирующей строки не может превышать 1 МБ.

SELECT INSERT('Elastic ', 8, 1, 'search');

INSERT('Elastic ', 8, 1, 'search')
----------------------------------
Elasticsearch

LCASE

Описание:

LCASE(string_exp) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

Выходные данные: строка

Описание: Возвращает строку, равную строке в string_exp, с преобразованием всех заглавных символов в строчные.

SELECT LCASE('Elastic');

LCASE('Elastic')
----------------
elastic

LEFT

Описание:

LEFT(
    string_exp, 
    count)      

Входные данные:

строковое выражение. Если null, функция возвращает null.

целочисленное выражение. Если null, функция возвращает null. Если 0 или отрицательное, функция возвращает пустую строку.

Выходные данные: строка

Описание: Возвращает самые левые count символов из string_exp.

SELECT LEFT('Elastic',3);

LEFT('Elastic',3)
-----------------
Ela

LENGTH

Описание:

LENGTH(string_exp) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

Выходные данные: целое число

Описание: Возвращает количество символов в string_exp, не считая хвостовых пробелов.

SELECT LENGTH('Elastic   ');

LENGTH('Elastic   ')
--------------------
7

LOCATE

Описание:

LOCATE(
    pattern, 
    source   
    [, start]
)

Входные данные:

строковое выражение. Если null, функция возвращает null.

строковое выражение. Если null, функция возвращает null.

целочисленное выражение; необязательно. Если null, 0, 1, отрицательное или не указано, поиск начинается с первой позиции символа.

Выходные данные: целое число

Описание: Возвращает начальную позицию первого вхождения pattern в source. Необязательный параметр start указывает позицию символа для начала поиска. Если pattern не найдено в source, функция возвращает 0.

SELECT LOCATE('a', 'Elasticsearch');

LOCATE('a', 'Elasticsearch')
----------------------------
3
SELECT LOCATE('a', 'Elasticsearch', 5);

LOCATE('a', 'Elasticsearch', 5)
-------------------------------
10

LTRIM

Синопсис:

LTRIM(string_exp) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

Выходные данные: строка

Описание: Возвращает символы string_exp, с удаленными ведущими пробелами.

SELECT LTRIM('   Elastic');

LTRIM('   Elastic')
-------------------
Elastic

OCTET_LENGTH

Синопсис:

OCTET_LENGTH(string_exp) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

Выходные данные: целое число

Описание: Возвращает длину в байтах string_exp входного выражения.

SELECT OCTET_LENGTH('Elastic');

OCTET_LENGTH('Elastic')
-----------------------
7

POSITION

Синопсис:

POSITION(
    string_exp1, 
    string_exp2) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

строковое выражение. Если null, функция возвращает null.

Выходные данные: целое число

Описание: Возвращает позицию string_exp1 в string_exp2. Результат - точное числовое значение.

SELECT POSITION('Elastic', 'Elasticsearch');

POSITION('Elastic', 'Elasticsearch')
------------------------------------
1

REPEAT

Синопсис:

REPEAT(
    string_exp, 
    count)      

Входные данные:

строковое выражение. Если null, функция возвращает null.

целое выражение. Если 0, отрицательное или null, функция возвращает null.

Выходные данные: строка

Описание: Возвращает строку, состоящую из string_exp, повторяющуюся count раз.

Длина результирующей строки не может превышать 1 МБ.

SELECT REPEAT('La', 3);

 REPEAT('La', 3)
----------------
LaLaLa

REPLACE

Синопсис:

REPLACE(
    source,      
    pattern,     
    replacement) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

строковое выражение. Если null, функция возвращает null.

строковое выражение. Если null, функция возвращает null.

Выходные данные: строка

Описание: Поиск в source вхождения pattern и замена на replacement.

Длина результирующей строки не может превышать 1 МБ.

SELECT REPLACE('Elastic','El','Fant');

REPLACE('Elastic','El','Fant')
------------------------------
Fantastic

RIGHT

Синопсис:

RIGHT(
    string_exp, 
    count)      

Входные данные:

строковое выражение. Если null, функция возвращает null.

целое выражение. Если null, функция возвращает null. Если 0 или отрицательное, функция возвращает пустую строку.

Выходные данные: строка

Описание: Возвращает последние count символов string_exp.

SELECT RIGHT('Elastic',3);

RIGHT('Elastic',3)
------------------
tic

RTRIM

Синопсис:

RTRIM(string_exp) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

Выходные данные: строка

Описание: Возвращает символы string_exp с удаленными хвостовыми пробелами.

SELECT RTRIM('Elastic   ');

RTRIM('Elastic   ')
-------------------
Elastic

SPACE

Синопсис:

SPACE(count) 

Входные данные:

целое выражение. Если null или отрицательное, функция возвращает null.

Выходные данные: строка

Описание: Возвращает строку, состоящую из count пробелов.

Длина результирующей строки не может превышать 1 МБ.

SELECT SPACE(3);

   SPACE(3)
---------------

STARTS_WITH

Синопсис:

STARTS_WITH(
    source,   
    pattern)  

Входные данные:

строковое выражение. Если null, функция возвращает null.

строковое выражение. Если null, функция возвращает null.

Выходные данные: булево значение

Описание: Возвращает true, если исходное выражение начинается с указанного шаблона, false в противном случае. Сопоставление регистрозависимое.

SELECT STARTS_WITH('Elasticsearch', 'Elastic');

STARTS_WITH('Elasticsearch', 'Elastic')
--------------------------------
true
SELECT STARTS_WITH('Elasticsearch', 'ELASTIC');

STARTS_WITH('Elasticsearch', 'ELASTIC')
--------------------------------
false

SUBSTRING

Синопсис:

SUBSTRING(
    source, 
    start,  
    length) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

целое выражение. Если null, функция возвращает null.

целое выражение. Если null, функция возвращает null.

Выходные данные: строка

Описание: Возвращает строку, полученную из source, начиная с позиции символа, указанной start, на length символов.

SELECT SUBSTRING('Elasticsearch', 0, 7);

SUBSTRING('Elasticsearch', 0, 7)
--------------------------------
Elastic

TRIM

Краткое описание:

TRIM(string_exp) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

Выходные данные: строка

Описание: Возвращает символы string_exp, удалив ведущие и хвостовые пробелы.

SELECT TRIM('   Elastic   ') AS trimmed;

trimmed
--------------
Elastic

UCASE

Краткое описание:

UCASE(string_exp) 

Входные данные:

строковое выражение. Если null, функция возвращает null.

Выходные данные: строка

Описание: Возвращает строку, равную входовой строке, но с преобразованием всех строчных букв в заглавные.

SELECT UCASE('Elastic');

UCASE('Elastic')
----------------
ELASTIC

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/sql-functions-string.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API