类别：

半结构化和结构化数据函数 （类型谓词）

IS_BINARY

如果其 VARIANT 实参包含 二进制字符串 值，则返回 TRUE。

另请参阅：

IS_<object_type>

语法

IS_BINARY( <variant_expr> )

实参

variant_expr

VARIANT 类型值计算的表达式。

返回

返回 BOOLEAN 值或 NULL。

  • 如果 VARIANT 值包含 BINARY 值，则返回 TRUE。否则返回 FALSE。

  • 如果输入为 NULL，则返回 NULL，不报错。

示例

返回 VARIANT 列中的所有 BINARY 值。

备注

使用 BINARY_OUTPUT_FORMAT 参数设置 BINARY 值的输出格式。默认设置为 HEX。

在 VARIANT 列中创建并加载具有 BINARY 值的表：

CREATE OR REPLACE TABLE varbin (v VARIANT);

INSERT INTO varbin SELECT TO_VARIANT(TO_BINARY('snow', 'utf-8'));

在 WHERE 子句中使用 IS_BINARY 函数来显示数据中的 BINARY 值：

SELECT v AS hex_encoded_binary_value
  FROM varbin
  WHERE IS_BINARY(v);

+--------------------------+
| HEX_ENCODED_BINARY_VALUE |
|--------------------------|
| "736E6F77"               |
+--------------------------+