Spec-Zone.ru › Elasticsearch 7
›Elasticsearch Guide [7.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, начиная с start, и где replacement была вставлена в source, начиная с start.

Результирующая строка не может превышать длину в байтах 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/7.17/sql-functions-string.html

Spec-Zone.ru

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