翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon QLDB のサブストリング関数
<a name="ql-functions.substring"></a>

**重要**  
サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了まで Amazon QLDB を使用できます。詳細については、[「Amazon QLDB 台帳を Amazon Aurora PostgreSQL に移行する](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)」を参照してください。

Amazon QLDB では、特定の文字列から部分文字列を返すには、`SUBSTRING` 関数を使用します。部分文字列は、指定された開始インデックスから始まり、文字列の最後の文字または指定された長さで終了します。

## 構文
<a name="ql-functions.substring.syntax"></a>

```
SUBSTRING ( string, start-index [, length ] )
```

## 引数
<a name="ql-functions.substring.arguments"></a>

*string*  
部分文字列を抽出するフィールド名または `string` データ型の式。

*start-index*  
抽出を開始する *string* 内の開始位置。負の数を指定することもできます。  
*string* の最初の文字のインデックスは 1 です。

*length*  
(オプション) *string* から抽出する文字数 (コードポイント)。*start-index* から始まり、(*start-index* \$1 *length*) - 1 で終わります。つまり、部分文字列の長さです。負の数を指定することはできません。  
このパラメータを指定しない場合、関数は *string* の最後まで続行されます。

## 戻り型
<a name="ql-functions.substring.return-type"></a>

`string`

## 例
<a name="ql-functions.substring.examples"></a>

```
SUBSTRING('123456789', 0)      -- '123456789'
SUBSTRING('123456789', 1)      -- '123456789'
SUBSTRING('123456789', 2)      -- '23456789'
SUBSTRING('123456789', -4)     -- '123456789'
SUBSTRING('123456789', 0, 999) -- '123456789'
SUBSTRING('123456789', 0, 2)   -- '1'
SUBSTRING('123456789', 1, 999) -- '123456789'
SUBSTRING('123456789', 1, 2)   -- '12'
SUBSTRING('1', 1, 0)           -- ''
SUBSTRING('1', 1, 0)           -- ''
SUBSTRING('1', -4, 0)          -- ''
SUBSTRING('1234', 10, 10)      -- ''

-- Runnable statements
SELECT SUBSTRING('123456789', 1) FROM << 0 >>    -- "123456789"
SELECT SUBSTRING('123456789', 1, 2) FROM << 0 >> -- "12"
```

## 関連関数
<a name="ql-functions.substring.related"></a>
+ [CHAR\$1LENGTH](ql-functions.char_length.md)
+ [LOWER](ql-functions.lower.md)
+ [TRIM](ql-functions.trim.md)
+ [UPPER](ql-functions.upper.md)