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

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 também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	GetMetaDBInfo	Operação a ser executada. Defina o valor como GetMetaDBInfo.
AppGuid	String	Não	odps.some_engine_name	ID da instância do mecanismo de computação. Especifique o ID no formato Tipo do mecanismo.Nome do mecanismo.
ClusterId	String	Não	abc	ID do cluster E-MapReduce (EMR). Necessário apenas se o parâmetro DataSourceType for definido como emr.
DatabaseName	String	Não	abc	Nome do metabanco de dados do cluster EMR. Necessário apenas se o parâmetro DataSourceType for definido como emr.
DataSourceType	String	Não	emr	Tipo da fonte de dados. Valores válidos: odps e emr.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	0bc1411515937****	ID da solicitação.
Data	Object		Dados comerciais.
Type	String	hive	Tipo do metabanco de dados.
Comment	String	Comment	Comentário.
CreateTime	Long	1541576644000	Momento de criação da instância do mecanismo de computação.
ProjectId	Long	22	ID do workspace.
ProjectName	String	test	Nome do workspace.
AppGuid	String	odps.engine_name	ID da instância do mecanismo de computação, no formato Tipo do mecanismo.Nome do mecanismo.
OwnerName	String	my_name	Nome do proprietário do workspace.
OwnerId	String	userId	ID da conta Alibaba Cloud do proprietário do workspace.
EnvType	Integer	1	Tipo de ambiente. Valores válidos: 0 e 1. O valor 0 indica o ambiente de desenvolvimento; o valor 1, o ambiente de produção.
ProjectNameCn	String	Test project	Nome de exibição do workspace.
Endpoint	String	http://service.odpsstg.aliyun-inc.com/	Endpoint do service.
ClusterBizId	String	abc	ID do cluster EMR. Retornado apenas para instâncias de mecanismo de computação EMR.
Name	String	abc	Nome do metabanco de dados.
Location	String	hdfs://	Caminho de armazenamento do metabanco de dados do cluster EMR.
TenantId	Long	233	ID do locatário.
ModifyTime	Long	1541576644000	Momento da última modificação da instância do mecanismo de computação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=GetMetaDBInfo
&AppGuid=odps.some_engine_name
&ClusterId=abc
&DatabaseName=abc
&DataSourceType=emr
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<GetMetaDBInfoResponse>
    <RequestId>0bc1411515937****</RequestId>
    <Data>
        <Type>hive</Type>
        <Comment>Comment</Comment>
        <CreateTime>1541576644000</CreateTime>
        <ProjectId>22</ProjectId>
        <ProjectName>test</ProjectName>
        <AppGuid>odps.engine_name</AppGuid>
        <OwnerName>323</OwnerName>
        <OwnerId>23</OwnerId>
        <EnvType>1</EnvType>
        <ProjectNameCn>Test project</ProjectNameCn>
        <Endpoint>http://service.odpsstg.aliyun-inc.com/</Endpoint>
        <ClusterBizId>abc</ClusterBizId>
        <Name>abc</Name>
        <Location>hdfs://</Location>
        <TenantId>233</TenantId>
        <ModifyTime>1541576644000</ModifyTime>
    </Data>
</GetMetaDBInfoResponse>

Formato JSON

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

{
  "RequestId" : "0bc1411515937****",
  "Data" : {
    "Type" : "hive",
    "Comment" : "Comment",
    "CreateTime" : 1541576644000,
    "ProjectId" : 22,
    "ProjectName" : "test",
    "AppGuid" : "odps.engine_name",
    "OwnerName" : "323",
    "OwnerId" : "23",
    "EnvType" : 1,
    "ProjectNameCn" : "Test project",
    "Endpoint" : "http://service.odpsstg.aliyun-inc.com/",
    "ClusterBizId" : "abc",
    "Name" : "abc",
    "Location" : "hdfs://",
    "TenantId" : 233,
    "ModifyTime" : 1541576644000
  }
}

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 da 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.IllegalDate	The date format is invalid.	Formato de data inválido.
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.	Falha ao obter a instância do mecanismo de computação com base no projeto MaxCompute {0}.
400	InvalidParameter.Meta.NotExist	The data does not exist.	Dados consultados não encontrados.
403	Forbidden.Meta.NoTenant	The user is not the owner of any tenants.	O usuário atual não é proprietário de nenhum locatário.
429	Throttling.Api	The request for this resource has exceeded your available limit.	O 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.	O 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.	Não foi possí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 alibabacloud.

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