Todos los productos
Search
Centro de documentos

DataWorks:UpdateTableAddColumn

Última actualización: Oct 09, 2026

Actualiza la información de las columnas de una tabla de MaxCompute.

Nota

Esta API se marcó como obsoleta y no cuenta con un reemplazo. Aunque el acceso temporal sigue disponible, no se proporcionarán más actualizaciones ni correcciones de bugs. Para garantizar la continuidad operativa, planifique su migración y póngase en contacto con su gerente de cuenta para obtener asistencia.

Descripción de la operación

Antes de comenzar: Debe activar DataWorks Enterprise Edition o Ultimate Edition antes de llamar a esta operación. Si no se cumplen los requisitos de edición, la operación devuelve 403 Forbidden.Access.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

TableGuid

string

Sí

El identificador único de la tabla de MaxCompute. El formato es odps.projectName.tableName.

odps.engine_name.table_name

Column

array<object>

Sí

La lista de columnas.

object

No

El objeto de columna.

ColumnNameCn

string

No

El nombre en chino de la columna.

中文

ColumnName

string

Sí

El nombre de la columna.

abc

Comment

string

No

El comentario de la columna.

Remarks

ColumnType

string

Sí

El tipo de datos de la columna. Para obtener más información, consulte los tipos de datos admitidos por MaxCompute.

string

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

El objeto de respuesta.

RequestId

string

El ID de la solicitud.

abc

TaskInfo

object

La información sobre la tarea de solicitud. Una vez enviada una tarea de solicitud, se divide en varias subtareas que se ejecutan en secuencia. La siguiente subtarea se ejecuta solo después de que la subtarea actual se ejecute correctamente. La tarea de solicitud finaliza cuando se completan todas las subtareas. La tarea de solicitud se interrumpe en los siguientes escenarios. Debe solucionar el problema según el código de error y volver a enviar la tarea de solicitud:

  • La tarea de solicitud no se puede enviar.

  • Después de enviar la tarea de solicitud, una subtarea falla.

Status

string

El estado de la subtarea actual. Valores válidos:

  • operating: La subtarea se está ejecutando.

  • success: La subtarea se ejecutó.

  • failure: La subtarea falla. Para obtener más información sobre los detalles del error, consulte el parámetro Content.

success

NextTaskId

string

El ID de la siguiente subtarea que se ejecutará. Si este campo está vacío, todas las subtareas se han completado.

abc1

TaskId

string

El ID de la subtarea actual.

abc2

Content

string

El estado de ejecución detallado de la subtarea actual.

  • Si la ejecución se realiza correctamente, se muestra success.

  • Si la ejecución falla, se muestran los detalles del error correspondiente.

success

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

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. No tiene los permisos requeridos. Conceda los permisos primero.
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 error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.