すべてのプロダクト
Search
ドキュメントセンター

Dataphin:文字列関数

最終更新日:Feb 06, 2025

ADB_PG_SQL ノードでは、文字列関数は柔軟な文字列操作を可能にします。このトピックでは、ADB_PG_SQL ノードでサポートされている文字列関数の構文、パラメーター、および例の概要を示し、開発者の使用を支援します。

AnalyticDB for PostgreSQL は、次の文字列関数をサポートしています。

関数

機能

bit_length

文字列のビット数を計算します。

char_length

文字列の文字数を計算します。

lower

文字列を小文字に変換します。

octet_length

文字列のバイト数を計算します。

overlay

文字列内の部分文字列を置き換えます。

position

文字列内の部分文字列の位置を検索します。

substring

文字列から部分文字列を抽出します。

substring

POSIX 正規表現に一致する部分文字列を抽出します。

substring

SQL 正規表現に一致する部分文字列を抽出します。

trim

文字列の先頭と末尾のスペースを削除します。

upper

文字列を大文字に変換します。

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 を返します