类别:

半结构化和结构化数据函数 (类型谓词)

IS_BINARY

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

另请参阅:

IS_<object_type>

语法

IS_BINARY( <variant_expr> )
Copy

实参

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'));
Copy

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

SELECT v AS hex_encoded_binary_value
  FROM varbin
  WHERE IS_BINARY(v);
Copy
+--------------------------+
| HEX_ENCODED_BINARY_VALUE |
|--------------------------|
| "736E6F77"               |
+--------------------------+
语言: 中文