すべてのプロダクト
Search
ドキュメントセンター

MaxCompute:SAFE_CONVERT_BYTES_TO_STRING

最終更新日:Oct 24, 2025

バイナリデータを文字列に変換します。

構文

STRING SAFE_CONVERT_BYTES_TO_STRING(BINARY <value>)

パラメーター

value: 必須。 変換する BINARY 値です。

戻り値

STRING 型の値を返します。 次のルールが適用されます:

  • 入力が STRING の場合、元の文字列が返されます。

  • 入力パラメーターが NULL の場合、エラーが返されます。

  • 入力に無効な UTF-8 文字が含まれている場合、NULL が返されます。

例

-- alibaba を返します
SELECT SAFE_CONVERT_BYTES_TO_STRING(CAST ('alibaba' AS BINARY));

-- abc を返します
SELECT SAFE_CONVERT_BYTES_TO_STRING(X'616263');

-- abc を返します
SELECT SAFE_CONVERT_BYTES_TO_STRING(UNHEX('616263'));

-- 010101 を返します
SELECT SAFE_CONVERT_BYTES_TO_STRING('010101');

-- エラーが返されます。 FAILED: ODPS-0130071:[1,8] Semantic analysis exception - function SAFE_CONVERT_BYTES_TO_STRING is ambiguous with (VOID), candidates are STRING SAFE_CONVERT_BYTES_TO_STRING(BINARY arg0); STRING SAFE_CONVERT_BYTES_TO_STRING(STRING arg0)
SELECT SAFE_CONVERT_BYTES_TO_STRING(null);

-- 入力パラメーターに無効な UTF-8 文字が含まれています。 NULL が返されます。
SELECT SAFE_CONVERT_BYTES_TO_STRING(UNHEX('\xc2'));

関連関数

SAFE_CONVERT_BYTES_TO_STRING は文字列関数です。 文字列を検索したり、文字列のフォーマットを変換したりする関数の詳細については、「文字列関数」をご参照ください。