Todos os produtos
Search
Central de documentação

MaxCompute:ADD TABLE

Última atualização: Jun 26, 2026

Registra uma tabela do MaxCompute como recurso para que jobs SQL e MapReduce possam referenciá-la durante a execução.

Esta é uma instrução CMD. Execute-a apenas no cliente MaxCompute (odpscmd).

Limitações

  • Não é possível adicionar tabelas externas como recursos.

  • Tabelas registradas como recursos não suportam evolução de schema. Se o schema da tabela mudar após o registro, remova o recurso e adicione-o novamente.

  • Cada arquivo de recurso pode ter no máximo 2.048 MB.

  • O tamanho total dos recursos referenciados por um único job SQL ou MapReduce não pode exceder 2.048 MB.

Sintaxe

add table <table_name> [partition (<spec>)] [as <alias>] [comment '<comment>'] [-f];

Parâmetros

Parâmetro

Obrigatório

Descrição

table

Sim

Tipo do recurso. Para obter mais informações sobre tipos de recursos, consulte Recurso.

table_name

Sim

Nome da tabela do MaxCompute a registrar como recurso.

spec

Obrigatório para tabelas particionadas

Partição a registrar. O sistema registra apenas a partição especificada, não a tabela inteira. Use o formato partition_column='value', por exemplo, ds='20150602'.

alias

Não

Nome do recurso. Assume o nome do arquivo como padrão se não for especificado. Recursos JAR ou scripts Python não suportam este parâmetro.

comment

Não

Descrição do recurso.

-f

Não

Sobrescreve o recurso existente caso já exista outro com o mesmo nome. Sem esta flag, a adição de um recurso com nome duplicado falha.

Exemplos

Adicionar uma tabela particionada como recurso

Registre uma única partição de sale_detail como um recurso chamado sale.res e force a sobrescrita caso o recurso já exista:

add table sale_detail partition (ds='20150602') as sale.res comment 'sale detail on 20150602' -f;

Saída esperada:

OK: Resource 'sale.res' have been updated.

Próximos passos

Após registrar uma tabela como recurso, referencie-a pelo nome em jobs MapReduce ou UDFs. Para gerenciar seus recursos, use as seguintes instruções:

Instruções ADD relacionadas:

  • ADD ARCHIVE: Adicione um arquivo compactado como recurso.

  • ADD FILE: Adicione um arquivo como recurso.

  • ADD JAR: Adicione um arquivo JAR como recurso.

  • ADD PY: Adicione código Python como recurso.