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

Cria 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 deve ser criada uma view ou tabela. Valores válidos: 0: Cria uma tabela. 1: Cria uma view.	0
Visibility	integer	Não	Especifica se a tabela ou o workspace está visível. Valores válidos: 0: Tanto a tabela quanto o workspace ficam invisíveis. 1: Tanto a tabela quanto o workspace ficam visíveis. 2: Apenas o workspace fica visível.	1
LifeCycle	integer	Não	O ciclo de vida da tabela. Unidade: dias. Por padrão, este parâmetro é deixado vazio, o que indica que a tabela é armazenada permanentemente.	10
CategoryId	integer	Não	O ID da categoria associada. Você pode chamar a operação GetMetaCategory para consultar os IDs de todas as categorias que podem ser associadas.	101
LogicalLevelId	integer	Não	O ID do nível lógico.	101
PhysicsLevelId	integer	Não	O ID do nível físico.	101
ExternalTableType	string	Não	O tipo de armazenamento da tabela externa. Valores válidos: 0: Object Storage Service (OSS) 1: Tablestore 2: Volume 3: MySQL	0
Location	string	Não	O local de armazenamento da tabela externa.	location
ProjectId	integer	Não	O ID do workspace do DataWorks.	23
TableName	string	Sim	O nome da tabela.	tableName1
Endpoint	string	Não	O endpoint do MaxCompute.	odps://abc
EnvType	integer	Não	O tipo de ambiente do workspace do DataWorks. Valores válidos: 0: ambiente de desenvolvimento 1: ambiente de produção	1
AppGuid	string	Não	O ID do projeto MaxCompute. Especifique o ID no formato odps.{projectName}.	odps.test
Comment	string	Não	O comentário.	Comment
HasPart	integer	Não	Especifica se deve ser criada uma tabela particionada do MaxCompute. Valores válidos: 1 e 0. O valor 1 indica uma tabela particionada. O valor 0 indica uma tabela não particionada. Este parâmetro foi descontinuado. Não use este parâmetro. O parâmetro Column.N.isPartitionCol é usado para especificar se deve ser criada uma tabela particionada do MaxCompute. Se o parâmetro Column.N.isPartitionCol for definido como true, uma tabela particionada do MaxCompute será criada.	0
ClientToken	string	Não	Um parâmetro reservado.	Reserved field
Schema	string	Não	As informações de schema da tabela. Você precisa inserir as informações de schema da tabela se ativar o modelo de três camadas no MaxCompute.	default
Columns	array<object>	Sim	A lista de campos. Há suporte para no máximo 1.000 campos.
	object	Não	O campo.
ColumnNameCn	string	Não	O nome em chinês do campo.	Chinese name
ColumnName	string	Sim	O nome do campo. Você pode configurar no máximo 1.000 campos ao chamar a operação CreateTable para criar uma tabela.	columnName1
Comment	string	Não	O comentário do campo.	Comment
ColumnType	string	Sim	O tipo de dados do campo. Os tipos de campo suportados dependem da edição de tipo de dados usada pelo seu projeto MaxCompute. Para obter informações sobre os tipos de dados suportados por cada edição, consulte Edições de tipo de dados na documentação do MaxCompute.	string
SeqNumber	integer	Não	O número de sequência do campo. Você pode usar este parâmetro para especificar como os campos são classificados em uma tabela. Por padrão, os campos são classificados com base na ordem especificada na solicitação de criação. Se o campo for um campo de partição, este parâmetro não será suportado.	1
Length	integer	Não	O comprimento do campo. Para obter mais informações, consulte Edições de tipo de dados do MaxCompute.	10
IsPartitionCol	boolean	Não	Especifica se o campo é um campo de partição.	true
Themes	array<object>	Não	A lista de temas.
	object	Não	O objeto retornado.
ThemeId	integer	Não	O ID do tema.	101
ThemeLevel	integer	Não	O nível que corresponde ao ID do tema.	101

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	abcdef
TaskInfo	object	As informações sobre a tarefa da solicitação. Depois que uma tarefa de solicitação é enviada, ela é dividida em várias subtarefas que são executadas em sequência. Após a subtarefa atual ser concluída com êxito, 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 abortada devido a um dos seguintes problemas, resolva o problema com base no código de erro e inicie a tarefa de solicitação novamente: A tarefa de solicitação falha ao ser enviada. Depois que a tarefa de solicitação é enviada, uma subtarefa falha ao ser executada.
Status	string	O status da subtarefa atual. Valores válidos: operating: A subtarefa está em execução. success: A subtarefa foi bem-sucedida. 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 atual.	abc
Content	string	Os detalhes sobre o status da subtarefa atual. Se a subtarefa atual for bem-sucedida, success será retornado. Se a subtarefa atual falhar, os detalhes do erro serão exibidos.	success

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "abcdef",
  "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.