Todos os produtos
Search

Este produto

    MaxCompute:ALIAS

    Central de documentação

    MaxCompute:ALIAS

    Última atualização: Jun 26, 2026

    Crie um alias para um recurso.

    Use ALIAS em códigos MapReduce ou User-Defined Function (UDF) para alternar entre diferentes versões de recursos sem modificar o código. Atribua o mesmo alias a recursos distintos em diferentes jobs e o código lerá automaticamente o recurso apontado pelo alias durante a execução.

    Sintaxe

    alias <alias>=<real>;

    Parâmetros

    Parâmetro

    Descrição

    alias

    Alias a criar para um recurso.

    real

    Nome original do recurso.

    Quando usar ALIAS

    Use ALIAS quando seu código MapReduce ou UDF referenciar um nome de recurso fixo, mas o recurso subjacente mudar entre as execuções — por exemplo, partições diárias de dados carregadas como recursos de tabela separados. Em vez de atualizar o código a cada vez, reatribua o alias antes de cada job.

    Exemplo

    O exemplo a seguir demonstra como alternar um único alias entre dois recursos de tabela particionados por data em dois jobs, mantendo o código JAR inalterado.

    -- Add resources res_20121208 and res_20121209.
add table sale_detail partition (ds='20121208') as res_20121208;
add table sale_detail partition (ds='20121209') as res_20121209;

-- Create the alias resName for the resource res_20121208 and call this resource.
alias resName=res_20121208;
jar -resources resName -libjars work.jar  -classpath ./work.jar com.company.MainClass args ...;

-- Create the alias resName for the resource res_20121209 and call this resource.
alias resName=res_20121209;
jar -resources resName -libjars work.jar  -classpath ./work.jar com.company.MainClass args ...;

    O alias resName aponta para uma tabela de recurso diferente em cada job. O código JAR lê resName sem necessidade de modificações entre as execuções.

    Instruções relacionadas

    Para usar ALIAS, adicione primeiro um recurso com uma das instruções abaixo. Escolha o tipo de recurso conforme a necessidade do seu código:

    • ADD TABLE: Adiciona uma tabela como recurso. Use esta opção quando seu código ler dados estruturados de tabelas do MaxCompute.

    • ADD JAR: Adiciona um arquivo JAR como recurso. Obrigatório quando seu código UDF ou MapReduce depender de uma biblioteca JAR.

    • ADD FILE: Adiciona um arquivo como recurso. Adequado para scripts ou arquivos simples lidos pelo código durante a execução.

    • ADD ARCHIVE: Adiciona um arquivo compactado como recurso.

    • ADD PY: Adiciona um script Python como recurso.

    Para gerencie recursos existentes: