Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、[ブログ記事](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)を参照してください。

# TO\$1VARBYTE 関数
<a name="r_TO_VARBYTE"></a>

TO\$1VARBYTE は、文字列の形式を指定して、その文字列をバイナリ値に変換します。

## 構文
<a name="r_TO_VARBYTE-synopsis"></a>

```
TO_VARBYTE(string, format)
```

## 引数
<a name="r_TO_VARBYTE-arguments"></a>

 *string*   
`CHAR` または `VARCHAR` 文字列。

 *format*   
入力文字列の形式。大文字と小文字を区別しない有効な値は `hex`、`binary`、`utf8` (`utf-8` と `utf_8` も) および `base64` です。

## 戻り型
<a name="r_TO_VARBYTE-return-type"></a>

`VARBYTE`

## 例
<a name="r_TO_VARBYTE-examples"></a>

16 進数 `6162` をバイナリ値に変換するには、次の例を使用します。結果は、バイナリ値の 16 進数表現として自動的に出力されます。

```
SELECT TO_VARBYTE('6162', 'hex');
               
+------------+
| to_varbyte |
+------------+
|       6162 |
+------------+
```

`4d` のバイナリ表現を返すには、次の例を使用します。'4d'のバイナリ表現は `01001101` です。

```
SELECT TO_VARBYTE('01001101', 'binary');
               
+------------+
| to_varbyte |
+------------+
|         4d |
+------------+
```

UTF-8 の文字列 `'a'` をバイナリ値に変換するには、次の例を使用します。結果は、バイナリ値の 16 進数表現として自動的に出力されます。

```
SELECT TO_VARBYTE('a', 'utf8');
               
+------------+
| to_varbyte |
+------------+
|         61 |
+------------+
```

16 進数値の文字列 `'4'` をバイナリ値に変換するには、次の例を使用します。16 進数の文字列の長さが奇数の場合、`0` が先頭に追加され有効な 16 進数が形成されます。

```
SELECT TO_VARBYTE('4', 'hex');
               
+------------+
| to_varbyte |
+------------+
|         04 |
+------------+
```