文字列関数
文字列操作を行うための関数。
ASCII
概要:
Sql
ASCII(string_exp)
入力:
文字列式。もし null の場合、関数は null を返します。 |
出力: 整数
説明: string_exp
の最も左の文字の ASCII コード値を整数として返します。
Sql
SELECT ASCII('Elastic');
ASCII('Elastic')
----------------
69
BIT_LENGTH
概要:
Sql
BIT_LENGTH(string_exp)
入力:
文字列式。もし null の場合、関数は null を返します。 |
出力: 整数
説明: string_exp
入力式のビット数を返します。
Sql
SELECT BIT_LENGTH('Elastic');
BIT_LENGTH('Elastic')
---------------------
56
CHAR
概要:
Sql
CHAR(code)
入力:
0 と 255 の間の整数式。もし null 、負、または 255 より大きい場合、関数は null を返します。 |
出力: 文字列
説明: 数値入力によって指定された ASCII コード値を持つ文字を返します。
Sql
SELECT CHAR(69);
CHAR(69)
---------------
E
CHAR_LENGTH
概要:
Sql
CHAR_LENGTH(string_exp)
入力:
文字列式。もし null の場合、関数は null を返します。 |
出力: 整数
説明: 入力の文字数を返します。文字列式が文字データ型の場合はその長さを、そうでない場合は文字列式のバイト数の長さを返します(ビット数を 8 で割ったときの最小の整数)。
Sql
SELECT CHAR_LENGTH('Elastic');
CHAR_LENGTH('Elastic')
----------------------
7
CONCAT
概要:
Sql
CONCAT(
string_exp1,
string_exp2)
入力:
文字列式。null を空文字列として扱います。 |
|
文字列式。null を空文字列として扱います。 |
出力: 文字列
説明: string_exp1
を string_exp2
に連結した結果の文字列を返します。
結果の文字列は 1 MB のバイト長を超えることはできません。
Sql
SELECT CONCAT('Elasticsearch', ' SQL');
CONCAT('Elasticsearch', ' SQL')
-------------------------------
Elasticsearch SQL
INSERT
概要:
Sql
INSERT(
source,
start,
length,
replacement)
入力:
文字列式。もし null の場合、関数は null を返します。 |
|
整数式。もし null の場合、関数は null を返します。 |
|
整数式。もし null の場合、関数は null を返します。 |
|
文字列式。もし null の場合、関数は null を返します。 |
出力: 文字列
説明: length
文字が source
から削除され、replacement
が source
に start
から挿入された文字列を返します。
結果の文字列は 1 MB のバイト長を超えることはできません。
Sql
SELECT INSERT('Elastic ', 8, 1, 'search');
INSERT('Elastic ', 8, 1, 'search')
----------------------------------
Elasticsearch
LCASE
概要:
Sql
LCASE(string_exp)
入力:
文字列式。もし null の場合、関数は null を返します。 |
出力: 文字列
説明: string_exp
の内容と同じ文字列を返し、すべての大文字を小文字に変換します。
Sql
SELECT LCASE('Elastic');
LCASE('Elastic')
----------------
elastic
LEFT
概要:
Sql
LEFT(
string_exp,
count)
入力:
文字列式。もし null の場合、関数は null を返します。 |
|
整数式。もし null の場合、関数は null を返します。もし 0 または負の場合、関数は空文字列を返します。 |
出力: 文字列
説明: string_exp
の最も左のカウント文字を返します。
Sql
SELECT LEFT('Elastic',3);
LEFT('Elastic',3)
-----------------
Ela
LENGTH
概要:
Sql
LENGTH(string_exp)
入力:
文字列式。もし null の場合、関数は null を返します。 |
出力: 整数
説明: string_exp
の文字数を返します。末尾の空白は除外されます。
Sql
SELECT LENGTH('Elastic ');
LENGTH('Elastic ')
--------------------
7
LOCATE
概要:
Sql
LOCATE(
pattern,
source
[, start]
)
入力:
文字列式。もし null の場合、関数は null を返します。 |
|
文字列式。もし null の場合、関数は null を返します。 |
|
整数式; オプション。もし null 、0 、1 、負、または指定されていない場合、検索は最初の文字位置から始まります。 |
出力: 整数
説明: source
内の pattern
の最初の出現の開始位置を返します。オプションの start
は検索を開始する文字位置を指定します。もし pattern
が source
内に見つからない場合、関数は 0
を返します。
Sql
SELECT LOCATE('a', 'Elasticsearch');
LOCATE('a', 'Elasticsearch')
----------------------------
3
Sql
SELECT LOCATE('a', 'Elasticsearch', 5);
LOCATE('a', 'Elasticsearch', 5)
-------------------------------
10
LTRIM
概要:
Sql
LTRIM(string_exp)
入力:
文字列式。もし null の場合、関数は null を返します。 |
出力: 文字列
説明: string_exp
の先頭の空白を削除した文字を返します。
Sql
SELECT LTRIM(' Elastic');
LTRIM(' Elastic')
-------------------
Elastic
OCTET_LENGTH
概要:
Sql
OCTET_LENGTH(string_exp)
入力:
文字列式。もし null の場合、関数は null を返します。 |
出力: 整数
説明: string_exp
入力式のバイト数を返します。
Sql
SELECT OCTET_LENGTH('Elastic');
OCTET_LENGTH('Elastic')
-----------------------
7
POSITION
概要:
Sql
POSITION(
string_exp1,
string_exp2)
入力:
文字列式。もし null の場合、関数は null を返します。 |
|
文字列式。もし null の場合、関数は null を返します。 |
出力: 整数
説明: string_exp2
内の string_exp1
の位置を返します。結果は正確な数値です。
Sql
SELECT POSITION('Elastic', 'Elasticsearch');
POSITION('Elastic', 'Elasticsearch')
------------------------------------
1
REPEAT
概要:
Sql
REPEAT(
string_exp,
count)
入力:
文字列式。もし null の場合、関数は null を返します。 |
|
整数式。もし 0 が負または null の場合、関数は null を返します。 |
出力: 文字列
説明: string_exp
を count
回繰り返した文字列を返します。
結果の文字列は 1 MB のバイト長を超えることはできません。
Sql
SELECT REPEAT('La', 3);
REPEAT('La', 3)
----------------
LaLaLa
REPLACE
概要:
Sql
REPLACE(
source,
pattern,
replacement)
入力:
文字列式。もし null の場合、関数は null を返します。 |
|
文字列式。もし null の場合、関数は null を返します。 |
|
文字列式。もし null の場合、関数は null を返します。 |
出力: 文字列
説明: source
で pattern
の出現を検索し、replacement
で置き換えます。
結果の文字列は 1 MB のバイト長を超えることはできません。
Sql
SELECT REPLACE('Elastic','El','Fant');
REPLACE('Elastic','El','Fant')
------------------------------
Fantastic
RIGHT
概要:
Sql
RIGHT(
string_exp,
count)
入力:
文字列式。もし null の場合、関数は null を返します。 |
|
整数式。もし null の場合、関数は null を返します。もし 0 または負の場合、関数は空文字列を返します。 |
出力: 文字列
説明: string_exp
の最も右のカウント文字を返します。
Sql
SELECT RIGHT('Elastic',3);
RIGHT('Elastic',3)
------------------
tic
RTRIM
概要:
Sql
RTRIM(string_exp)
入力:
文字列式。もし null の場合、関数は null を返します。 |
出力: 文字列
説明: string_exp
の末尾の空白を削除した文字を返します。
Sql
SELECT RTRIM('Elastic ');
RTRIM('Elastic ')
-------------------
Elastic
SPACE
概要:
Sql
SPACE(count)
入力:
整数式。もし null または負の場合、関数は null を返します。 |
出力: 文字列
説明: count
個の空白からなる文字列を返します。
結果の文字列は 1 MB のバイト長を超えることはできません。
Sql
SELECT SPACE(3);
SPACE(3)
---------------
STARTS_WITH
概要:
Sql
STARTS_WITH(
source,
pattern)
入力:
文字列式。もし null の場合、関数は null を返します。 |
|
文字列式。もし null の場合、関数は null を返します。 |
出力: ブール値
説明: ソース式が指定されたパターン false
で始まる場合 true
を返し、そうでない場合は返しません。マッチングは大文字と小文字を区別します。
Sql
SELECT STARTS_WITH('Elasticsearch', 'Elastic');
STARTS_WITH('Elasticsearch', 'Elastic')
--------------------------------
true
Sql
SELECT STARTS_WITH('Elasticsearch', 'ELASTIC');
STARTS_WITH('Elasticsearch', 'ELASTIC')
--------------------------------
false
SUBSTRING
概要:
Sql
SUBSTRING(
source,
start,
length)
入力:
文字列式。もし null の場合、関数は null を返します。 |
|
整数式。もし null の場合、関数は null を返します。 |
|
整数式。もし null の場合、関数は null を返します。 |
出力: 文字列
説明: source
から派生した文字列を返し、start
で指定された文字位置から length
文字を取得します。
Sql
SELECT SUBSTRING('Elasticsearch', 0, 7);
SUBSTRING('Elasticsearch', 0, 7)
--------------------------------
Elastic
TRIM
概要:
Sql
TRIM(string_exp)
入力:
文字列式。もし null の場合、関数は null を返します。 |
出力: 文字列
説明: string_exp
の先頭と末尾の空白を削除した文字を返します。
Sql
SELECT TRIM(' Elastic ') AS trimmed;
trimmed
--------------
Elastic
UCASE
概要:
Sql
UCASE(string_exp)
入力:
文字列式。もし null の場合、関数は null を返します。 |
出力: 文字列
説明: 入力の内容と同じ文字列を返し、すべての小文字を大文字に変換します。
Sql
SELECT UCASE('Elastic');
UCASE('Elastic')
----------------
ELASTIC