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 |
|
|
Sim |
Tipo do recurso. Para obter mais informações sobre tipos de recursos, consulte Recurso. |
|
|
Sim |
Nome da tabela do MaxCompute a registrar como recurso. |
|
|
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 |
|
|
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. |
|
|
Não |
Descrição do recurso. |
|
|
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:
DESC RESOURCE: Visualize detalhes de um recurso.
LIST RESOURCES: Liste todos os recursos do projeto.
ALIAS: Crie um alias para um recurso.
GET RESOURCE: Baixe um recurso.
DROP RESOURCE: Exclua um recurso.
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.