Todos os produtos
Search
Central de documentação

MaxCompute:LENGTH

Última atualização: Jun 26, 2026

Calcula o comprimento da string str.

Sintaxe

bigint length(string <str>)

Parâmetros

str: obrigatório. Tipo STRING. Entradas dos tipos BIGINT, DOUBLE, DECIMAL ou DATETIME são convertidas implicitamente para STRING antes do processamento.

Valor de retorno

Retorna um valor do tipo BIGINT conforme as seguintes regras:

  • Se str não for dos tipos STRING, BIGINT, DOUBLE, DECIMAL ou DATETIME, a função retornará um erro.

  • Se str for NULL, o retorno será NULL.

  • Se str não estiver na codificação UTF-8, o retorno será -1.

Exemplos

  • Exemplo 1: calcular o comprimento da string Tech on the net. Execute o seguinte comando:

    --返回15。
    select length('Tech on the net');
  • Exemplo 2: parâmetro de entrada definido como NULL. Execute o seguinte comando:

    --返回NULL。
    select length(null);

Funções relacionadas

A função LENGTH pertence ao conjunto de funções de string. Para obter mais informações sobre funções de busca e conversão de formato de string, consulte Funções de string.