GetMetaTablePartition - DataWorks: Central de Documentação do Alibaba Cloud

Obtém uma lista de partições de uma tabela.

Descrição da operação

Esta operação suporta apenas tabelas do MaxCompute e do E-MapReduce (EMR). Para o EMR, os tipos de cluster suportados incluem novos clusters de data lake que usam o Data Lake Formation (DLF) para gerenciamento de metadados e clusters Hadoop com versões anteriores à V3.41.0 ou V5.7.0.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

dataworks:*

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
PageNumber	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
TableGuid	string	Não	O identificador exclusivo da tabela.	odps.engine_name.table_name
ClusterId	string	Não	O ID do cluster EMR. Necessário apenas se DataSourceType for EMR. Faça login no console do EMR para obter o ID do cluster.	abc
DatabaseName	string	Não	O nome do banco de dados. Necessário apenas se DataSourceType for EMR. Chame a operação ListMetaDB para consultar o nome do banco de dados.	abc
TableName	string	Não	O nome da tabela EMR. Necessário apenas se DataSourceType for EMR. Chame a operação GetMetaDBTableList para consultar o nome da tabela.	abc
DataSourceType	string	Não	O tipo de fonte de dados. Valores válidos: ODPS e EMR.	emr
SortCriterion	object	Não	A lógica de ordenação de partições.
SortField	string	Não	O campo usado para ordenar as partições. Valores válidos: name e modify_time. Valor padrão: a hora de criação da partição.	name
Order	string	Não	A ordem de classificação. Valores válidos: asc e desc. Valor padrão: desc.	desc

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
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.	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 retornados.
PageNumber	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 partições.	100
DataEntityList	array<object>	A lista de partições.
	object	A estrutura dos dados.
PartitionPath	string	The directory of the partition.	abc
DataSize	integer	The partition size. Unit: bytes.	19
PartitionName	string	The name of the partition.	pt=20170614
Comment	string	The remarks.	Remarks
ModifiedTime	integer	The modification time. Unit: milliseconds.	1590032868000
CreateTime	integer	The creation time. Unit: milliseconds.	1590032868000
RecordCount	integer	The record count.	233
PartitionType	string	The type of the partition.	abc
PartitionGuid	string	The unique identifier of the partition.	odps.engine_name.table_name.pt=20170614
PartitionLocation	string	The location of the Hive partition.	abc
TableGuid	string	The unique identifier of the table.	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": 100,
    "DataEntityList": [
      {
        "PartitionPath": "abc",
        "DataSize": 19,
        "PartitionName": "pt=20170614",
        "Comment": "Remarks",
        "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 erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
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.
400	InternalError.Meta.NoCalcEngine	An error occurred while retrieving the compute engine based on the MaxCompute project.	Incorrect project entered by user
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.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.
403	Forbidden.Meta.NoTenant	The user is not the owner of any tenants.	The user is not the owner of any tenants.
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.