ADB_PG_SQL ノードでは、文字列関数は柔軟な文字列操作を可能にします。このトピックでは、ADB_PG_SQL ノードでサポートされている文字列関数の構文、パラメーター、および例の概要を示し、開発者の使用を支援します。
AnalyticDB for PostgreSQL は、次の文字列関数をサポートしています。
関数 |
機能 |
文字列のビット数を計算します。 |
|
文字列の文字数を計算します。 |
|
文字列を小文字に変換します。 |
|
文字列のバイト数を計算します。 |
|
文字列内の部分文字列を置き換えます。 |
|
文字列内の部分文字列の位置を検索します。 |
|
文字列から部分文字列を抽出します。 |
|
POSIX 正規表現に一致する部分文字列を抽出します。 |
|
SQL 正規表現に一致する部分文字列を抽出します。 |
|
文字列の先頭と末尾のスペースを削除します。 |
|
文字列を大文字に変換します。 |
bit_length
コマンド形式
bit_length(string)
コマンドの説明: 文字列のビット数を計算します。
パラメーターの説明:
string: 必須。ビット長を計算する文字列を指定します。
戻り値の説明: 指定された文字列のビット長を表す整数を返します。
例:
SELECT bit_length('Dataphin') -- 64 を返します
char_length
コマンド形式
char_length(string) or character_length(string)
コマンドの説明: 文字列の文字数を計算します。
パラメーターの説明:
string: 必須。文字数を計算する文字列を指定します。
戻り値の説明: 指定された文字列の文字数を返します。
例:
SELECT char_length('Dataphin') or character_length('Dataphin') -- 8 を返します
lower
コマンド形式
lower(string)
コマンドの説明: 文字列を小文字に変換します。
パラメーターの説明:
string: 必須。小文字に変換する文字列を指定します。
戻り値の説明: 入力文字列の小文字バージョンを返します。
例:
SELECT lower('DATAPHIN') -- dataphin を返します
octet_length
コマンド形式
octet_length(string)
コマンドの説明: 文字列のバイト数を計算します。
パラメーターの説明:
string: 必須。バイト数を計算する文字列を指定します。
戻り値の説明: 指定された文字列のバイト数を返します。
例:
SELECT octet_length('Dataphin') -- 8 を返します
overlay
コマンド形式
overlay(string placing string from int [for int])
コマンドの説明: 文字列内の部分文字列を置き換えます。
パラメーターの説明:
string: 必須。元の文字列。
string: 必須。挿入する文字列。
int: 必須。置換の開始インデックス。
for int: オプション。置換する文字数。
戻り値の説明: 指定されたインデックスから始まる指定された部分文字列が置換された文字列を返します。
例:
SELECT overlay('Hello Dataphin' PLACING 'Hi' FROM 1 FOR 5) -- Hi Dataphin を返します
position
コマンド形式
position(substring in string)
コマンドの説明: 文字列内の部分文字列の位置を検索します。
パラメーターの説明:
substring: 必須。検索する部分文字列。
string: 必須。部分文字列を検索する文字列。
戻り値の説明: 文字列内の部分文字列の最初の出現の開始インデックスを返します。部分文字列が見つからない場合、関数は 0 を返します。
例:
SELECT position('Dataphin' IN 'hello Dataphin') -- 7 を返します
substring
コマンド形式
substring(string [from int] [for int])
コマンドの説明: 文字列から部分文字列を抽出します。
- パラメーターの説明:
string: 必須。部分文字列を抽出する文字列。
from int: オプション。抽出の開始位置。
for int: オプション。抽出する部分文字列の長さ。
戻り値の説明: 指定された位置から始まり、指定された長さで拡張される、抽出された部分文字列を返します。
例:
SELECT substring('hello Dataphin' FROM 6) -- Dataphin を返します
substring
コマンド形式
substring(string from pattern)
コマンドの説明: POSIX 正規表現に一致する部分文字列を抽出します。
パラメーターの説明:
pattern: 必須。照合する POSIX 正規表現。
戻り値の説明: 指定された POSIX 正規表現に一致する部分文字列を返します。
例:
SELECT substring('hello Dataphin' FROM '^.{6}') -- hello を返します
substring
コマンド形式
substring(string from pattern for escape)
コマンドの説明: SQL 正規表現に一致する部分文字列を抽出します。
パラメーターの説明:
pattern: 必須。照合する SQL 正規表現。
escape: 必須。正規表現のエスケープ文字。
戻り値の説明: エスケープ文字を考慮して、指定された SQL 正規表現に一致する部分文字列を返します。
例:
SELECT substring('hello Dataphin' from '%#"__l#"%' for '#') -- ell を返します
trim
コマンド形式
trim(string)
コマンドの説明: 文字列の先頭と末尾のスペースを削除します。
パラメーターの説明:
string: 必須。スペースを削除する文字列。
戻り値の説明: 先頭と末尾のスペースが削除された文字列を返します。
例:
SELECT trim(' Dataphin ') -- Dataphin を返します
upper
コマンド形式
upper(string)
コマンドの説明: 文字列を大文字に変換します。
パラメーターの説明:
string: 必須。大文字に変換する文字列を指定します。
戻り値の説明: 指定された文字列の大文字バージョンを返します。
例:
SELECT upper('dataphin') -- DATAPHIN を返します