Todos los productos
Search
Centro de documentos

:GetMetaDBTableList

Última actualización: Sep 04, 2026

Consulta metatablas en una instancia de motor de cómputo.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action

String

Sí

GetMetaDBTableList

Operación que desea ejecutar. Establezca el valor en GetMetaDBTableList.

PageNumber

Integer

No

1

Número de página.

PageSize

Integer

No

10

Número de entradas por página. Valores válidos: de 1 a 100. Valor predeterminado: 10.

AppGuid

String

Sí

odps.testProjectName

GUID del proyecto de MaxCompute. Especifique el GUID con el formato odps.{projectName}. Este parámetro es obligatorio si establece DataSourceType en odps.

ClusterId

String

No

abc

ID del clúster de E-MapReduce (EMR). Este parámetro es obligatorio solo si establece DataSourceType en emr.

DatabaseName

String

No

abc

Nombre de la metabase de datos.

DataSourceType

String

No

odps

Tipo de origen de datos. Valores válidos: odps y emr.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

0bc1ec92159376

ID de la solicitud.

Data

Object

Datos comerciales.

PageNumber

Integer

1

Número de página.

PageSize

Integer

10

Número de entradas por página. Valores válidos: de 1 a 100. Valor predeterminado: 10.

TotalCount

Long

20

Número total de instancias de motor de cómputo devueltas.

TableEntityList

Array of TableEntityList

Lista de metatablas en la instancia de motor de cómputo.

TableName

String

tname

Nombre de la metatabla.

TableGuid

String

odps.engine_name.tname

GUID de la metatabla.

DatabaseName

String

abc

Nombre de la metabase de datos.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400

Invalid.Meta.AppNotExist

The MaxCompute project does not exist.

No se encontró el proyecto de MaxCompute.

400

InvalidParameter.Meta.CommonError

The specified parameter is invalid.

Los valores especificados para uno o más parámetros de solicitud no son válidos.

400

InvalidParameter.Meta.Illegal

The app guid parameter is invalid.

Los valores especificados para uno o más parámetros de la aplicación no son válidos.

400

InvalidParameter.Meta.IllegalPageError

The parameter for paging is invalid.

El valor del parámetro de paginación no es válido.

400

InternalError.UserId.Missing

An internal system error occurred. Try again later.

Ocurrió un error interno. Inténtelo de nuevo más tarde.

400

InternalError.Meta.NoCalcEngine

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

El proyecto especificado por el usuario no es válido.

403

Forbidden.Meta.NoTenant

The user is not the owner of any tenants.

El usuario actual no es propietario de ningún inquilino.

403

Forbidden.Access

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

Sin permisos.

429

Throttling.Api

The request for this resource has exceeded your available limit.

El número de solicitudes para el recurso ha superado el límite superior.

429

Throttling.Api.Risk

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

El número de solicitudes diarias para el recurso ha superado el límite superior.

429

Throttling.System

The DataWorks system is busy. Try again later.

El sistema de DataWorks está ocupado. Inténtelo de nuevo más tarde.

429

Throttling.User

Your request is too frequent. Try again later.

Se han enviado demasiadas solicitudes en un periodo corto. Inténtelo de nuevo más tarde.

500

InternalError.System

An internal system error occurred. Try again later.

Ocurrió un error interno. Inténtelo de nuevo más tarde.

500

InternalError.Meta.TenantTimeOut

Failed to connect to the interface network.

No se puede establecer conexión con la red.

500

InternalError.Meta.Unknown

An unknown error occurred while processing your request.

Ocurrió un error desconocido.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.

Para obtener información sobre el ejemplo de uso de la operación GetMetaDBTableList, consulte Examples of DataWorks API operations.