UpdateTable - DataWorks: Central de Documentação do Alibaba Cloud

Atualiza 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.

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
IsView	integer	Não	Especifica se a tabela é uma view. Valores válidos: 0 e 1. O valor 0 indica que a tabela não é uma view. O valor 1 indica que a tabela é uma view. Este parâmetro foi descontinuado. Não use este parâmetro.	0
Visibility	integer	Não	O escopo no qual a tabela é visível. Valores válidos: 0, 1 e 2. O valor 0 indica que a tabela é invisível para todos os membros. O valor 1 indica que a tabela é visível para todos os membros. O valor 2 indica que a tabela é visível para os membros do workspace.	1
LifeCycle	integer	Não	O ciclo de vida da tabela. Unidade: dias. Se este parâmetro for deixado em branco, a tabela será armazenada permanentemente.	10
CategoryId	integer	Não	O ID da categoria associada.	101
LogicalLevelId	integer	Não	O ID do nível lógico.	101
PhysicsLevelId	integer	Não	O ID da camada física.	101
ExternalTableType	string	Não	O tipo da tabela externa. Valores válidos: 0, 1, 2 e 3. O valor 0 indica que a tabela externa é uma tabela externa do OSS. O valor 1 indica que a tabela externa é uma tabela externa do Tablestore. O valor 2 indica que a tabela externa é uma tabela externa de volume. O valor 3 indica que a tabela externa é uma tabela externa do MySQL. Este parâmetro foi descontinuado. Não use este parâmetro.	1
Location	string	Não	O local de armazenamento da tabela externa. Este parâmetro foi descontinuado. Não use este parâmetro.	location
ProjectId	integer	Não	O ID do workspace do DataWorks. Você pode fazer login no console do DataWorks para obter o ID do workspace do DataWorks.	101
TableName	string	Sim	O nome da tabela do MaxCompute.	abc
Endpoint	string	Não	O endpoint do MaxCompute. Se você não especificar este parâmetro, o endpoint do projeto do MaxCompute será usado.	odps://
EnvType	integer	Não	O ambiente do workspace do DataWorks. Valores válidos: 0 e 1. O valor 0 indica o ambiente de desenvolvimento. O valor 1 indica o ambiente de produção.	1
AppGuid	string	Não	O identificador exclusivo do projeto do MaxCompute. Especifique o GUID no formato odps.{projectName}.	odps.test
CreateIfNotExists	boolean	Não	Especifica se a tabela existe. Valores válidos:\n\n- true: A tabela existe.\n\n- false: A tabela não existe.\n\nEste parâmetro foi descontinuado. Não use este parâmetro.	true
HasPart	integer	Não	Especifica se a tabela que você deseja atualizar é uma tabela particionada. Valores válidos: 0 e 1. O valor 0 indica que a tabela não é uma tabela particionada. O valor 1 indica que a tabela é uma tabela particionada. Este parâmetro foi descontinuado. Não use este parâmetro. O parâmetro Column.N.isPartitionCol é usado no lugar do parâmetro HasPart para especificar se a tabela do MaxCompute é uma tabela particionada. Se o parâmetro Column.N.isPartitionCol estiver definido como 1, a tabela do MaxCompute será uma tabela particionada.	0
Comment	string	Não	O comentário.	Comment
Schema	string	Não	As informações de schema da tabela. Você precisa inserir as informações de schema da tabela se ativar o schema da tabela no MaxCompute.	default
Columns	array<object>	Não	A lista de campos.
	object	Não	O objeto retornado.
ColumnNameCn	string	Não	O nome de exibição do campo.	Chinese name
ColumnName	string	Sim	O nome do campo.	abc
Comment	string	Não	O comentário do campo.	Comment
ColumnType	string	Sim	O tipo do campo. Para obter mais informações, consulte os tipos de campo do MaxCompute.	string
SeqNumber	integer	Não	O número de sequência do campo. Se o campo for um campo de partição, este parâmetro não é suportado.	1
Length	integer	Não	O comprimento do campo.	10
IsPartitionCol	boolean	Não	Especifica se o campo é um campo de partição. Valores válidos: 0 e 1. O valor 0 indica que o campo não é um campo de partição. O valor 1 indica que o campo é um campo de partição.	0
Themes	array<object>	Não	A lista de campos.
	object	Não	O objeto retornado.
ThemeId	integer	Não	O ID do tópico associado.	101
ThemeLevel	integer	Não	O nível que corresponde ao ID do tópico.	101

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O resultado retornado.
RequestId	string	O ID da solicitação.	abcde
TaskInfo	object	As informações sobre a tarefa da solicitação. Após o envio de uma tarefa de solicitação, ela é dividida em várias subtarefas que são executadas em sequência. Após a conclusão bem-sucedida da subtarefa atual, a próxima subtarefa começa a ser executada. Depois que todas as subtarefas forem concluídas, a tarefa da solicitação estará concluída. Se uma tarefa de solicitação for encerrada devido a um dos seguintes problemas, resolva o problema com base no código de erro e inicie a tarefa de solicitação novamente:\n\n\n\n\n- Falha no envio da tarefa de solicitação.\n- Após o envio da tarefa de solicitação, ocorre falha na execução de uma subtarefa.
Status	string	O status da subtarefa atual. Valores válidos:\n\n- operating: A subtarefa está em execução.\n\n- success: A subtarefa foi bem-sucedida.\n\n- 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. Você pode usar este ID para consultar o status da subtarefa correspondente chamando GetDDLJobStatus.	abc1
TaskId	string	O ID da subtarefa atual.	abc
Content	string	Os detalhes sobre o status da subtarefa atual. Valores válidos:\n\n- Se a subtarefa atual for bem-sucedida, success será retornado.\n\n- Se a subtarefa atual falhar, os detalhes do erro serão exibidos.	success

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
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.
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.