Todos os produtos
Search
Central de documentação

DataWorks:UpdateTableAddColumn

Última atualização: Nov 03, 2026

Atualiza as informações das colunas de uma tabela do MaxCompute.

Nota

Esta API foi descontinuada sem substituto. Embora o acesso temporário seja mantido, nenhuma atualização ou correção de bugs será fornecida. Para garantir a continuidade da funcionalidade, planeje sua migração e entre em contato com seu gerente de conta para obter suporte.

Descrição da operação

Pré-requisitos: Você deve ativar o DataWorks Enterprise Edition antes de chamar esta operação.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

TableGuid

string

Sim

O identificador exclusivo da tabela do MaxCompute. O formato é odps.projectName.tableName.

odps.engine_name.table_name

Column

array<object>

Sim

A lista de colunas.

object

Não

O objeto da coluna.

ColumnNameCn

string

Não

O nome em chinês da coluna.

中文

ColumnName

string

Sim

O nome da coluna.

abc

Comment

string

Não

O comentário da coluna.

Remarks

ColumnType

string

Sim

O tipo de dados da coluna. Para obter mais informações, consulte os tipos de dados compatíveis com o MaxCompute.

string

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O objeto de resposta.

RequestId

string

O ID da solicitação.

abc

TaskInfo

object

As informações sobre a tarefa da solicitação. Após uma tarefa de solicitação ser enviada com sucesso, ela é dividida em várias subtarefas que são executadas em sequência. A próxima subtarefa é executada somente após a subtarefa atual ser executada com sucesso. A tarefa da solicitação termina quando todas as subtarefas são concluídas. A tarefa da solicitação é encerrada nos seguintes cenários. Você deve solucionar o problema com base no código de erro e reenviar a tarefa da solicitação:

  • A tarefa da solicitação falha ao ser enviada.

  • Uma subtarefa falha ao ser executada após a tarefa da solicitação ser enviada.

Status

string

O status da subtarefa que está sendo executada. Valores válidos:

  • operating: A subtarefa está sendo executada.

  • success: A subtarefa foi executada com sucesso.

  • failure: A subtarefa falhou ao ser executada. Para obter mais informações sobre os detalhes do erro, consulte o parâmetro Content.

success

NextTaskId

string

O ID da próxima subtarefa a ser executada. Se este campo estiver vazio, todas as subtarefas foram concluídas.

abc1

TaskId

string

O ID da subtarefa que está sendo executada.

abc2

Content

string

O status de execução detalhado da subtarefa atual. Os detalhes são os seguintes:

  • Se a subtarefa for executada com sucesso, success será exibido.

  • Se a subtarefa falhar ao ser executada, os detalhes do erro correspondente serão exibidos.

success

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "abc",
  "TaskInfo": {
    "Status": "success",
    "NextTaskId": "abc1",
    "TaskId": "abc2",
    "Content": "success"
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

500 InternalError.System An internal system error occurred. Try again later.
500 InternalError.UserId.Missing An internal system error occurred. Try again later.
403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. Você não tem as permissões necessárias. Conceda as permissões primeiro.
429 Throttling.Api The request for this resource has exceeded your available limit.
429 Throttling.Api.Risk The request for this resource has exceeded your daily available limit.
429 Throttling.System The DataWorks system is busy. Try again later.
429 Throttling.User Your request is too frequent. Try again later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.