SearchMetaTables - : Central de Documentação do Alibaba Cloud

Esta operação consulta apenas metatabelas em uma instância de mecanismo de computação MaxCompute ou E-MapReduce (EMR).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	SearchMetaTables	A operação a ser executada. Defina o valor como SearchMetaTables.
PageNumber	Integer	Não	1	O número da página a retornar.
PageSize	Integer	Não	10	A quantidade de entradas por página. Valor padrão: 10. Valor máximo: 100.
AppGuid	String	Sim	odps.engine_name	O GUID do workspace onde as metatabelas residem.
Keyword	String	Sim	test	A palavra-chave usada para consultar as metatabelas.
EntityType	Integer	Não	0	O tipo das metatabelas. Valores válidos: 0 e 1. O valor 0 indica consulta de tabelas. O valor 1 indica consulta de views. Se você não configurar este parâmetro, todos os tipos de metatabelas serão consultados.
RegionId	String	Sim	cn-shanghai	O ID da região. Por exemplo, o ID da região China (Shanghai) é cn-shanghai, e o da região China (Zhangjiakou) é cn-zhangjiakou. O sistema determina o valor deste parâmetro com base no endpoint usado para chamar a operação.
ClusterId	String	Não	abc	O ID do cluster EMR. Este parâmetro é necessário apenas se você definir o parâmetro DataSourceType como emr. Acesse o console EMR para obter o ID do cluster EMR.
DataSourceType	String	Sim	emr	O tipo da fonte de dados. Valores válidos: odps e emr.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
HttpStatusCode	Integer	200	O código de status HTTP.
ErrorMessage	String	The specified parameters are invalid.	A mensagem de erro.
RequestId	String	0bc1ec92159376****	O ID da solicitação.
Success	Boolean	true	Indica se a solicitação foi bem-sucedida.
ErrorCode	String	1031203110005	O código de erro.
Data	Object		Os dados comerciais retornados.
PageNumber	Integer	1	O número da página retornada.
PageSize	Integer	10	A quantidade de entradas retornadas por página.
TotalCount	Long	100	O número total de metatabelas.
DataEntityList	Array of DataEntityList		A lista de metatabelas.
TableName	String	table_name	O nome da metatabela.
DatabaseName	String	abc	O nome do metadatabase.
EntityType	Integer	0	O tipo da metatabela. Valores válidos: 0: tabela 1: view
ProjectName	String	test	O nome do workspace.
ProjectId	Long	323	O ID do workspace.
TableGuid	String	odps.engine_name.table_name	O GUID da metatabela.
OwnerId	String	123	O ID da conta Alibaba Cloud usada pelo proprietário do workspace.
ClusterId	String	abc	O ID do cluster EMR.
EnvType	Integer	1	O tipo de ambiente. Valores válidos: 1: ambiente de produção 0: ambiente de desenvolvimento
TenantId	Long	12345	O ID do tenant.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=SearchMetaTables
&PageNumber=1
&PageSize=10
&AppGuid=odps.engine_name
&Keyword=test
&EntityType=0
&ClusterId=abc
&DataSourceType=emr
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<SearchMetaTablesResponse>
    <HttpStatusCode>200</HttpStatusCode>
    <ErrorMessage>The specified parameters are invalid.</ErrorMessage>
    <RequestId>0bc1ec92159376****</RequestId>
    <Success>true</Success>
    <ErrorCode>1031203110005</ErrorCode>
    <Data>
        <PageNumber>1</PageNumber>
        <PageSize>10</PageSize>
        <TotalCount>100</TotalCount>
        <DataEntityList>
            <TableName>table_name</TableName>
            <DatabaseName>abc</DatabaseName>
            <EntityType>0</EntityType>
            <ProjectName>test</ProjectName>
            <ProjectId>323</ProjectId>
            <TableGuid>odps.engine_name.table_name</TableGuid>
            <OwnerId>123</OwnerId>
            <ClusterId>abc</ClusterId>
            <EnvType>1</EnvType>
            <TenantId>12345</TenantId>
        </DataEntityList>
    </Data>
</SearchMetaTablesResponse>

Formato JSON

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

{
  "HttpStatusCode" : 200,
  "ErrorMessage" : "The specified parameters are invalid.",
  "RequestId" : "0bc1ec92159376****",
  "Success" : true,
  "ErrorCode" : 1031203110005,
  "Data" : {
    "PageNumber" : 1,
    "PageSize" : 10,
    "TotalCount" : 100,
    "DataEntityList" : {
      "TableName" : "table_name",
      "DatabaseName" : "abc",
      "EntityType" : 0,
      "ProjectName" : "test",
      "ProjectId" : 323,
      "TableGuid" : "odps.engine_name.table_name",
      "OwnerId" : 123,
      "ClusterId" : "abc",
      "EnvType" : 1,
      "TenantId" : 12345
    }
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Invalid.Meta.TableNotExist	The table does not exist.	Mensagem retornada quando a metatabela não existe.
400	InvalidParameter.Meta.CommonError	The specified parameter is invalid.	Indica que um ou mais parâmetros da solicitação possuem valores inválidos.
400	InvalidParameter.Meta.Illegal	The app guid parameter is invalid.	Retornada caso os valores especificados para parâmetros da aplicação sejam inválidos.
400	InvalidParameter.Meta.IllegalDate	The date format is invalid.	O formato da data fornecido é inválido.
400	InvalidParameter.Meta.IllegalPageError	The parameter for paging is invalid.	O valor do parâmetro de paginação está incorreto.
400	InvalidParameter.Meta.NotExist	The object does not exist.	O objeto consultado não foi encontrado.
400	InternalError.UserId.Missing	An internal system error occurred. Try again later.	Ocorreu um erro interno no sistema. Tente novamente mais tarde.
400	InternalError.Meta.NoCalcEngine	An error occurred while retrieving the compute engine based on the MaxCompute project.	Falha ao obter a instância do mecanismo de computação com base no projeto MaxCompute especificado.
403	ResourceNotAuthorized.Api	You are not authorized to access the resources.	Você não tem autorização para acessar estes recursos.
403	Forbidden.Meta.NoTenant	The user is not the owner of any tenants.	O 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.	Operação não permitida. Ative o DataWorks Enterprise Edition ou DataWorks Ultimate Edition.
429	Throttling.Api	The request for this resource has exceeded your available limit.	A quantidade de solicitações para este recurso excedeu o limite permitido.
429	Throttling.Api.Risk	The request for this resource has exceeded your daily available limit.	O número diário de solicitações para o recurso ultrapassou o limite máximo.
429	Throttling.System	The DataWorks system is busy. Try again later.	O sistema DataWorks está ocupado. Tente novamente em alguns instantes.
429	Throttling.User	Your request is too frequent. Try again later.	Muitas solicitações foram enviadas em um curto período. Aguarde antes de tentar novamente.
500	InternalError.System	An internal system error occurred. Try again later.	Erro interno do sistema. Tente novamente mais tarde.
500	InternalError.Meta.TenantTimeOut	Failed to connect to the interface network.	Não foi possível estabelecer conexão com a rede.
500	InternalError.Meta.Unknown	An unknown error occurred while processing your request.	Um erro desconhecido ocorreu durante o processamento da solicitação.

Para obter uma lista completa de códigos de erro, visite o Centro de Erros de API.

Para mais detalhes sobre como usar a operação SearchMetaTables, consulte Exemplos de operações da API do DataWorks.