Todos os produtos
Search
Central de documentação

MaxCompute:ADD FILE

Última atualização: Jun 26, 2026

Adiciona um arquivo como recurso a um projeto do MaxCompute.

Funcionamento

O comando ADD FILE registra um arquivo local no projeto atual do MaxCompute para que jobs SQL ou MapReduce o referenciem pelo nome do recurso durante a execução. Use este comando para tipos gerais de arquivos, como arquivos de dados ou scripts de transformação. Para adicionar um arquivo compactado, um pacote JAR ou uma tabela, consulte Comandos relacionados.

Sintaxe

add file <local_file> [as <alias>] [comment '<comment>'] [-f];

Parâmetros

Parâmetro

Obrigatório

Descrição

file (tipo de recurso)

Sim

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

local_file

Sim

Caminho do arquivo local a adicionar. O nome do arquivo serve como nome do recurso e o identifica exclusivamente no projeto.

alias

Não

Nome personalizado do recurso. Se não especificado, o sistema usa o nome do arquivo. Pacotes JAR e arquivos de script Python usados como recursos não aceitam este parâmetro.

comment

Não

Comentário do recurso.

-f

Não

Substitui o recurso se já existir outro com o mesmo nome. Se omitido e houver duplicidade de nome, o comando falha.

Limitações

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

  • Cada arquivo de recurso tem limite de 2048 MB.

  • Use o cliente do MaxCompute (odpscmd) versão 0.37.5 ou posterior.

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

  • Este é um comando CMD executável apenas no cliente do MaxCompute (odpscmd).

Exemplos

Adicione um arquivo chamado banking.txt como recurso:

add file banking.txt;

Saída esperada:

OK: Resource 'banking.txt' have been created.

Para confirmar a adição do recurso, execute list resources;.

Comandos relacionados