Todos os produtos
Search
Central de documentação

:GetMetaDBTableList

Última atualização: Aug 20, 2026

Consulta metatabelas em uma instância de mecanismo de computação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

GetMetaDBTableList

Operação a ser executada. Defina o valor como GetMetaDBTableList.

PageNumber

Integer

Não

1

Número da página.

PageSize

Integer

Não

10

Quantidade de entradas por página. Valores válidos: 1 a 100. Valor padrão: 10.

AppGuid

String

Sim

odps.testProjectName

GUID do projeto MaxCompute. Especifique o GUID no formato odps.{projectName}. Configure este parâmetro se definir DataSourceType como odps.

ClusterId

String

Não

abc

ID do cluster E-MapReduce (EMR). Necessário apenas se DataSourceType for definido como emr.

DatabaseName

String

Não

abc

Nome do metadatabase.

DataSourceType

String

Não

odps

Tipo da source de dados. Valores válidos: odps e emr.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

0bc1ec92159376

ID da solicitação.

Data

Object

Dados comerciais.

PageNumber

Integer

1

Número da página.

PageSize

Integer

10

Quantidade de entradas por página. Valores válidos: 1 a 100. Valor padrão: 10.

TotalCount

Long

20

Total de instâncias de mecanismo de computação retornadas.

TableEntityList

Array of TableEntityList

Lista de metatabelas na instância do mecanismo de computação.

TableName

String

tname

Nome da metatabela.

TableGuid

String

odps.engine_name.tname

GUID da metatabela.

DatabaseName

String

abc

Nome do metadatabase.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=GetMetaDBTableList
&PageNumber=1
&PageSize=10
&AppGuid=odps.testProjectName
&ClusterId=abc
&DatabaseName=abc
&DataSourceType=odps
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<GetMetaDBTableListResponse>
    <RequestId>0bc1ec92159376</RequestId>
    <Data>
        <PageNumber>1</PageNumber>
        <PageSize>10</PageSize>
        <TotalCount>20</TotalCount>
        <TableEntityList>
            <TableName>tname</TableName>
            <TableGuid>odps.engine_name.tname</TableGuid>
            <DatabaseName>abc</DatabaseName>
        </TableEntityList>
    </Data>
</GetMetaDBTableListResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0bc1ec92159376",
  "Data" : {
    "PageNumber" : 1,
    "PageSize" : 10,
    "TotalCount" : 20,
    "TableEntityList" : [ {
      "TableName" : "tname",
      "TableGuid" : "odps.engine_name.tname",
      "DatabaseName" : "abc"
    } ]
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

Invalid.Meta.AppNotExist

The MaxCompute project does not exist.

Projeto MaxCompute não encontrado.

400

InvalidParameter.Meta.CommonError

The specified parameter is invalid.

Um ou mais parâmetros de solicitação têm valores inválidos.

400

InvalidParameter.Meta.Illegal

The app guid parameter is invalid.

Um ou mais parâmetros do aplicativo têm valores inválidos.

400

InvalidParameter.Meta.IllegalPageError

The parameter for paging is invalid.

Valor do parâmetro de paginação inválido.

400

InternalError.UserId.Missing

An internal system error occurred. Try again later.

Erro interno. Tente novamente mais tarde.

400

InternalError.Meta.NoCalcEngine

An error occurred while retrieving the compute engine based on the MaxCompute project.

Projeto especificado pelo usuário inválido.

403

Forbidden.Meta.NoTenant

The user is not the owner of any tenants.

Usuário atual não é proprietário de nenhum tenant.

403

Forbidden.Access

Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.

Sem permissões.

429

Throttling.Api

The request for this resource has exceeded your available limit.

Número de solicitações para o recurso excedeu o limite superior.

429

Throttling.Api.Risk

The request for this resource has exceeded your daily available limit.

Número de solicitações diárias para o recurso excedeu o limite superior.

429

Throttling.System

The DataWorks system is busy. Try again later.

Sistema DataWorks ocupado. Tente novamente mais tarde.

429

Throttling.User

Your request is too frequent. Try again later.

Muitas solicitações enviadas em curto período. Tente novamente mais tarde.

500

InternalError.System

An internal system error occurred. Try again later.

Erro interno. Tente novamente mais tarde.

500

InternalError.Meta.TenantTimeOut

Failed to connect to the interface network.

Impossível conectar à rede.

500

InternalError.Meta.Unknown

An unknown error occurred while processing your request.

Erro desconhecido.

Para obter uma lista de códigos de erro, consulte Códigos de erro do service.

Para obter informações sobre exemplos de uso da operação GetMetaDBTableList, consulte Examples of DataWorks API operations.