Todos os produtos
Search

Este produto

    MaxCompute:FROM_CHARSET

    Central de documentação

    MaxCompute:FROM_CHARSET

    Última atualização: Jun 26, 2026

    Converte dados binários em um formato de codificação especificado para uma string codificada em UTF-8, permitindo cálculos subsequentes. Este tópico descreve a sintaxe e os parâmetros da função FROM_CHARSET e fornece exemplos de uso.

    Sintaxe

    STRING FROM_CHARSET(binary <source>, string <source_charset>, [string <mode>])

    Parâmetros

    • source: obrigatório. Valor do tipo BINARY. Especifica os dados binários a serem convertidos.

    • source_charset: obrigatório. Valor do tipo STRING. Define o formato de codificação original dos dados binários indicados por source. Valores válidos: UTF-8, UTF-16, UTF-16LE, UTF-16BE, ISO-8859-1, US-ASCII, GB2312, GBK e GB18030.

    • mode: opcional. Valor do tipo STRING. Determina o modo de processamento caso um caractere não possa ser convertido durante a transformação dos dados binários de source em uma string no formato de codificação especificado pela função FROM_CHARSET. Valores válidos:

      • NONE: relata um erro. Nenhum processamento é realizado. Este é o valor padrão.

      • TRANSLIT: substitui o caractere por outro similar no formato de codificação especificado.

      • IGNORE: ignora o erro e continua a execução do comando.

    Valor de retorno

    Retorna um valor do tipo STRING no formato de codificação UTF-8. Se um parâmetro de entrada for nulo ou uma string vazia, o valor de retorno segue as regras abaixo:

    • Se um parâmetro de entrada for nulo, o retorno será null.

    • Caso um parâmetro de entrada seja uma string vazia, a função retornará um erro.

    Exemplos

    • Exemplo 1: Converter dados binários codificados em UTF-8 para uma string codificada em UTF-8.

      SELECT FROM_CHARSET(unhex('e58aa0e6b2b9e9949fe696a4e68bb70a'),'UTF-8', 'TRANSLIT');

    • Exemplo 2: Converter dados binários codificados em GBK para uma string codificada em UTF-8.

      SELECT FROM_CHARSET(unhex('b9feb9febac3a4ce'), 'GBK');

    • Exemplo 3: Retornar null quando um parâmetro de entrada for nulo.

      SELECT FROM_CHARSET(unhex('b9feb9febac3a4ce'), null);

      O resultado retornado é:

      +------------+
| _c0        |
+------------+
| NULL       |
+------------+
    Nota

    A função UNHEX retorna uma string representada por uma cadeia hexadecimal. Para mais informações, consulte UNHEX.

    Referências