GetMetaTablePartition - - Centro de documentación de Alibaba Cloud

Consulta las particiones de una metatabla.

Esta operación permite consultar únicamente las particiones de una metatabla en una instancia de motor de cómputo de MaxCompute o E-MapReduce (EMR).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda llamar a esta operación desde 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í	GetMetaTablePartition	La operación que se desea ejecutar. Establezca el valor en GetMetaTablePartition.
PageNumber	Integer	No	1	El número de página que se devolverá.
PageSize	Integer	No	10	La cantidad de entradas que se devolverán por página. Valor predeterminado: 10. Valor máximo: 100.
TableGuid	String	Sí	odps.engine_name.table_name	El GUID de la metatabla.
ClusterId	String	No	abc	El ID del clúster de EMR. Este parámetro es obligatorio solo si establece el parámetro DataSourceType en emr. Puede iniciar sesión en la consola de EMR para obtener el ID del clúster de EMR.
DatabaseName	String	No	abc	El nombre de la metabase de datos. Este parámetro es obligatorio solo si establece el parámetro DataSourceType en emr. Puede llamar a la operación ListMetaDB para consultar el nombre de la metabase de datos.
TableName	String	No	abc	El nombre de la metatabla en el clúster de EMR. Este parámetro es obligatorio solo si establece el parámetro DataSourceType en emr. Puede llamar a la operación GetMetaDBTableList para consultar el nombre de la metatabla.
DataSourceType	String	No	emr	El tipo de origen de datos. Valores válidos: odps y emr.
SortCriterion	Object	No		La lógica para ordenar las particiones en la metatabla.
SortField	String	No	name	El campo que se utiliza para ordenar las particiones en la metatabla. Valores válidos: name y modify_time. De forma predeterminada, las particiones de la metatabla se ordenan según su hora de creación.
Order	String	No	desc	El orden en el que se clasifican las particiones de la metatabla. Valores válidos: asc y desc. Valor predeterminado: desc.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
HttpStatusCode	Integer	200	El código de estado HTTP devuelto.
ErrorMessage	String	The connection does not exist.	El mensaje de error devuelto.
RequestId	String	0bc1ec92159376	El ID de la solicitud.
Success	Boolean	true	Indica si la solicitud fue exitosa.
ErrorCode	String	Invalid.Tenant.ConnectionNotExists	El código de error devuelto.
Data	Object		Los datos de negocio devueltos.
PageNumber	Integer	1	El número de la página devuelta.
PageSize	Integer	10	La cantidad de entradas devueltas por página. Valor predeterminado: 10. Valor máximo: 100.
TotalCount	Long	100	El número total de particiones.
DataEntityList	Array of DataEntityList		La lista de particiones.
PartitionPath	String	abc	La ruta de la partición.
DataSize	Long	19	El tamaño de la partición. Unidad: bytes.
PartitionName	String	pt=20170614	El nombre de la partición.
Comment	String	Comment	El comentario.
ModifiedTime	Long	1590032868000	La hora en que se modificó la partición. Este valor es una marca de tiempo UNIX que representa el número de milisegundos transcurridos desde la época (1 de enero de 1970, 00:00:00 UTC).
CreateTime	Long	1590032868000	La hora en que se creó la partición. Este valor es una marca de tiempo UNIX que representa el número de milisegundos transcurridos desde la época (1 de enero de 1970, 00:00:00 UTC).
RecordCount	Long	233	El número de entradas en la partición.
PartitionType	String	abc	El tipo de la partición.
PartitionGuid	String	odps.engine_name.table_name.pt=20170614	El GUID de la partición.
PartitionLocation	String	abc	La ubicación de la partición de Hive.
TableGuid	String	odps.engine_name.table_name	El GUID de la metatabla.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=GetMetaTablePartition
&PageNumber=1
&PageSize=10
&TableGuid=odps.engine_name.table_name
&ClusterId=abc
&DatabaseName=abc
&TableName=abc
&DataSourceType=emr
&SortCriterion={"SortField":"name","Order":"desc"}
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<GetMetaTablePartitionResponse>
    <HttpStatusCode>200</HttpStatusCode>
    <ErrorMessage>The connection does not exist.</ErrorMessage>
    <RequestId>0bc1ec92159376</RequestId>
    <Success>true</Success>
    <ErrorCode>Invalid.Tenant.ConnectionNotExists</ErrorCode>
    <Data>
        <PageNumber>1</PageNumber>
        <PageSize>10</PageSize>
        <TotalCount>100</TotalCount>
        <DataEntityList>
            <PartitionPath>abc</PartitionPath>
            <DataSize>19</DataSize>
            <PartitionName>pt=20170614</PartitionName>
            <Comment>Comment</Comment>
            <ModifiedTime>1590032868000</ModifiedTime>
            <CreateTime>1590032868000</CreateTime>
            <RecordCount>233</RecordCount>
            <PartitionType>abc</PartitionType>
            <PartitionGuid>odps.engine_name.table_name.pt=20170614</PartitionGuid>
            <PartitionLocation>abc</PartitionLocation>
            <TableGuid>odps.engine_name.table_name</TableGuid>
        </DataEntityList>
    </Data>
</GetMetaTablePartitionResponse>

Formato JSON

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

{
  "HttpStatusCode" : 200,
  "ErrorMessage" : "The connection does not exist.",
  "RequestId" : "0bc1ec92159376",
  "Success" : true,
  "ErrorCode" : "Invalid.Tenant.ConnectionNotExists",
  "Data" : {
    "PageNumber" : 1,
    "PageSize" : 10,
    "TotalCount" : 100,
    "DataEntityList" : {
      "PartitionPath" : "abc",
      "DataSize" : 19,
      "PartitionName" : "pt=20170614",
      "Comment" : "Comment",
      "ModifiedTime" : 1590032868000,
      "CreateTime" : 1590032868000,
      "RecordCount" : 233,
      "PartitionType" : "abc",
      "PartitionGuid" : "odps.engine_name.table_name.pt=20170614",
      "PartitionLocation" : "abc",
      "TableGuid" : "odps.engine_name.table_name"
    }
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParameter.Meta.CommonError	The specified parameter is invalid.	Mensaje de error devuelto porque 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.	Mensaje de error devuelto porque los valores especificados para uno o más parámetros de la aplicación no son válidos.
400	InvalidParameter.Meta.IllegalDate	The date format is invalid.	Mensaje de error devuelto porque el formato de fecha no es válido.
400	InvalidParameter.Meta.IllegalPageError	The parameter for paging is invalid.	Mensaje de error devuelto porque el valor del parámetro de paginación no es válido.
400	InvalidParameter.Meta.NotExist	The object does not exist.	Mensaje de error devuelto porque el objeto consultado no existe.
403	Forbidden.Meta.NoTenant	The user is not the owner of any tenants.	Mensaje de error devuelto porque 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.	Mensaje de error devuelto porque no tiene permiso para realizar esta operación. Active DataWorks Enterprise Edition o DataWorks Ultimate Edition.
429	Throttling.Api	The request for this resource has exceeded your available limit.	Mensaje de error devuelto porque 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.	Mensaje de error devuelto porque 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.	Mensaje de error devuelto porque el sistema de DataWorks está ocupado. Inténtelo de nuevo más tarde.
429	Throttling.User	Your request is too frequent. Try again later.	Mensaje de error devuelto porque 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.	Mensaje de error devuelto porque se produjo un error interno. Inténtelo de nuevo más tarde.
500	InternalError.UserId.Missing	An internal system error occurred. Try again later.	Mensaje de error devuelto porque se produjo un error interno. Inténtelo de nuevo más tarde.
500	InternalError.Meta.NoCalcEngine	An error occurred while retrieving the compute engine based on the MaxCompute project.	Mensaje de error devuelto porque el sistema no pudo obtener la instancia del motor de cómputo basada en el proyecto de MaxCompute especificado.
500	InternalError.Meta.TenantTimeOut	Failed to connect to the interface network.	Mensaje de error devuelto porque no se puede establecer la conexión de red.
500	InternalError.Meta.Unknown	An unknown error occurred while processing your request.	Mensaje de error devuelto porque se produjo un error desconocido.

Para obtener una lista de códigos de error, visite el Centro de errores de API.

Para obtener más información sobre ejemplos de uso de la operación GetMetaTablePartition, consulte Ejemplos de operaciones de la API de DataWorks.