Todos os produtos
Search
Central de documentação

DataWorks:GetMetaTableColumn

Última atualização: Sep 29, 2026

Consulta as informações dos campos de uma metatabela.

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

Não

O GUID da metatabela. Você pode chamar a operação GetMetaDBTableList para consultar o GUID.

odps.engine_name.table_name

PageNum

integer

Não

O número da página.

1

PageSize

integer

Não

O número de entradas por página. Valor padrão: 10. Valor máximo: 100.

10

ClusterId

string

Não

O ID do cluster E-MapReduce (EMR). Você pode fazer login no console do EMR para obter o ID.

C-010A704DA760****

DatabaseName

string

Não

O nome do metadatabase do cluster EMR. Você pode chamar a operação ListMetaDB para consultar o nome.

abc

TableName

string

Não

O nome da metatabela no cluster EMR. Você pode chamar a operação GetMetaDBTableList para consultar o nome.

abc

DataSourceType

string

Não

O tipo da fonte de dados. Defina o valor como emr.

emr

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

HttpStatusCode

integer

O código de status HTTP.

200

ErrorMessage

string

A mensagem de erro.

The connection does not exist.

RequestId

string

O ID da solicitação. Você pode localizar logs e solucionar problemas com base no ID.

0bc1ec92159376

Success

boolean

Indica se a solicitação foi bem-sucedida.

true

ErrorCode

string

O código de erro.

Invalid.Tenant.ConnectionNotExists

Data

object

Os dados de negócios.

PageNum

integer

O número da página.

1

PageSize

integer

O número de entradas por página. Valor padrão: 10. Valor máximo: 100.

10

TotalCount

integer

O número total de campos.

100

ColumnList

array<object>

As informações sobre os campos.

object

A estrutura retornada.

ColumnGuid

string

O GUID do campo.

odps.engine_name.table_name.name

ColumnName

string

O nome do campo.

name

IsPartitionColumn

boolean

Indica se o campo é um campo de partição. Valores válidos:

  • true

  • false

false

Comment

string

Os comentários do campo.

comment

ColumnType

string

O tipo de dados do campo.

string

IsPrimaryKey

boolean

Indica se o campo é uma chave primária. Valores válidos:

  • true

  • false

false

Position

integer

O número de sequência do campo.

1

Caption

string

A descrição do campo.

data column

IsForeignKey

boolean

Indica se o campo é uma chave estrangeira. Valores válidos:

  • true

  • false

true

RelationCount

integer

A popularidade do campo.

2

Exemplos

Resposta de sucesso

JSON formato

{
  "HttpStatusCode": 200,
  "ErrorMessage": "The connection does not exist.",
  "RequestId": "0bc1ec92159376",
  "Success": true,
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Data": {
    "PageNum": 1,
    "PageSize": 10,
    "TotalCount": 100,
    "ColumnList": [
      {
        "ColumnGuid": "odps.engine_name.table_name.name",
        "ColumnName": "name",
        "IsPartitionColumn": false,
        "Comment": "comment ",
        "ColumnType": "string",
        "IsPrimaryKey": false,
        "Position": 1,
        "Caption": "data column",
        "IsForeignKey": true,
        "RelationCount": 2
      }
    ]
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter.Meta.CommonError The specified parameter is invalid.
400 InvalidParameter.Meta.GuidFormat The GUID format is invalid.
400 InvalidParameter.Meta.Illegal The app guid parameter is invalid.
400 InvalidParameter.Meta.IllegalDate The date format is invalid.
400 InvalidParameter.Meta.IllegalPageError The parameter for paging is invalid.
400 InvalidParameter.Meta.NotExist The object does not exist.
400 InternalError.UserId.Missing An internal system error occurred. Try again later.
400 InternalError.Meta.NoCalcEngine An error occurred while retrieving the compute engine based on the MaxCompute project.
500 InternalError.System An internal system error occurred. Try again later.
500 InternalError.Meta.TenantTimeOut Failed to connect to the interface network.
500 InternalError.Meta.Unknown An unknown error occurred while processing your request.
403 Forbidden.Meta.NoTenant The user is not the owner of any tenants.
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.