从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 Python UDF 将继续正常运行至 2026 年 6 月 30 日。有关更多信息，请参阅[博客文章](https://www.amazonaws.cn/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` 字符串。

 *格式的日期和时间*。  
输入字符串的格式。不区分大小写的有效值为 `hex`、`binary`、`utf8`（还包括 `utf-8` 和 `utf_8`）和 `base64`。

## 返回类型
<a name="r_TO_VARBYTE-return-type"></a>

`VARBYTE`

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

要将十六进制 `6162` 转换为二进制值，请使用以下示例。结果会自动显示为二进制值的十六进制表示形式。

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

要返回 `4d` 的二进制表示形式，请使用以下示例。“4d”的二进制表示形式是字符串 `01001101`。

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

要将 UTF-8 格式的字符串 `'a'` 转换为二进制值，请使用以下示例。结果会自动显示为二进制值的十六进制表示形式。

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

要将十六进制的字符串 `'4'` 转换为二进制值，请使用以下示例。如果十六进制字符串长度为奇数，则需添加一个 `0`，形成一个有效的十六进制数字。

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