Todos os produtos
Search
Central de documentação

MaxCompute:URL_ENCODE

Última atualização: Sep 22, 2026

Codifica uma string de entrada no formato application/x-www-form-urlencoded MIME e retorna a string codificada.

Sintaxe

string url_encode(string <input>[, string <encoding>])

Descrição

Codifica uma string de entrada no formato application/x-www-form-urlencoded MIME. O formato de codificação deve obedecer às seguintes regras:

  • Todas as letras permanecem inalteradas.

  • Pontos (.), hífens (-), asteriscos (*) e sublinhados (_) permanecem inalterados.

  • Os espaços são convertidos em sinais de mais (+).

  • Os demais caracteres são convertidos em valores de byte com base no formato especificado em encoding. Cada valor de byte assume o formato %xy, em que xy é a representação hexadecimal do valor do caractere.

Parâmetros

  • input: obrigatório. Valor do tipo STRING. Este parâmetro especifica a string que você deseja inserir.

  • encoding: opcional. Especifica o formato de codificação, que pode ser GBK ou UTF-8. Se você não especificar este parâmetro, a função usará o valor padrão UTF-8.

Valor de retorno

Retorna um valor do tipo STRING. Se o valor de input ou encoding for nulo, a função retornará nulo.

Exemplos

-- The return value is %E7%A4%BA%E4%BE%8Bfor+url_encode%3A%2F%2F+%28fdsf%29. 
select url_encode('Example for url_encode:// (fdsf)');
-- The return value is Example+for+url_encode+%3A%2F%2F+dsf%28fasfs%29. 
select url_encode('Example for url_encode:// dsf(fasfs)', 'GBK');

Funções relacionadas

URL_ENCODE é uma função de string. Para obter mais informações sobre funções relacionadas à pesquisa e à conversão de strings, consulte String functions.