Todos os produtos
Search
Central de documentação

DataWorks:GetMetaTableListByCategory

Última atualização: Jun 28, 2026

Consulta metatables em uma categoria especificada.

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

PageNumber

integer

Não

O número da página a ser retornada.

1

PageSize

integer

Não

O número de entradas a serem retornadas em cada página. Valor padrão: 10. Valor máximo: 100.

10

CategoryId

integer

Sim

O ID da categoria. Você pode chamar a operação GetMetaCategory para obter o ID da categoria. As categorias permitem organizar e gerenciar tabelas de forma eficiente por categoria. Você pode pesquisar a tabela desejada por categoria.

23

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O resultado retornado.

HttpStatusCode

integer

O código de status HTTP retornado.

200

ErrorMessage

string

A mensagem de erro retornada.

The connection does not exist.

RequestId

string

O ID da solicitação.

0bc1ec92159376

Success

boolean

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

true

ErrorCode

string

O código de erro retornado.

Invalid.Tenant.ConnectionNotExists

Data

object

Os dados de negócio retornados.

PageNumber

integer

O número da página retornada.

1

PageSize

integer

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

10

TotalCount

integer

O número total de metatables.

20

TableGuidList

array

O resultado retornado.

string

A lista de metatables.

odps.engine_name.table_name

Exemplos

Resposta de sucesso

JSON formato

{
  "HttpStatusCode": 200,
  "ErrorMessage": "The connection does not exist.",
  "RequestId": "0bc1ec92159376",
  "Success": true,
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 20,
    "TableGuidList": [
      "odps.engine_name.table_name"
    ]
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 Invalid.Meta.CategoryIllegalDepth A category can contain a maximum of 4 levels. A category can contain a maximum of 4 levels.
400 Invalid.Meta.CategoryNameDuplicate The category name is duplicated at this level. The category name is duplicated at this level.
400 Invalid.Meta.TableNotExist The table does not exist. The table does not exist.
400 InvalidParameter.Meta.CommonError The specified parameter is invalid. The request parameter is invalid.
400 InvalidParameter.Meta.Illegal The app guid parameter is invalid. The app guid parameter is invalid.
400 InvalidParameter.Meta.IllegalDate The date format is invalid. The date format is invalid.
400 InvalidParameter.Meta.IllegalPageError The parameter for paging is invalid. The parameter for paging is invalid.
400 InvalidParameter.Meta.NotExist The object does not exist.
500 InternalError.System An internal system error occurred. Try again later.
500 InternalError.UserId.Missing An internal system error occurred. Try again later.
500 InternalError.Meta.NoCalcEngine An error occurred while retrieving the compute engine based on the MaxCompute project.
500 InternalError.Meta.TenantTimeOut Failed to connect to the interface network. Failed to connect to the interface network.
500 InternalError.Meta.Unknown An unknown error occurred while processing your request. An unknown error occurred while processing your request.
500 Invalid.Meta.CategoryRelationDuplicate" The table is already bound to the category.
403 Forbidden.Meta.NoTenant The user is not the owner of any tenants. The user is not the owner of any tenants.
403 Invalid.Meta.CategoryForbidden Failed to delete the category. The current category is associated with a table and cannot be operated. Failed to delete the category because the table associated with the category does not exist.
403 Invalid.Meta.CategoryIllegalTenant The tenant ID is different in the parent and child categories. The tenant ID is different in the parent and child categories.
403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. No permission, please authorize
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.