Consulta a linhagem de uma metatabela.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| TableGuid |
string |
Não |
O identificador exclusivo da tabela. |
odps.engine_name.table_name |
| Direction |
string |
Sim |
Especifica a linhagem ancestral ou descendente que você deseja consultar para um campo. Valores válidos: up e down. O valor up indica a linhagem ancestral. O valor down indica a linhagem descendente. |
up |
| NextPrimaryKey |
string |
Não |
A lógica de paginação. Configure este parâmetro com base no valor do parâmetro de resposta NextPrimaryKey quando o valor do parâmetro de resposta HasNext for true na solicitação anterior. |
next_primary_key |
| PageSize |
integer |
Não |
O número de entradas por página. Valor padrão: 10. Valor máximo: 100. |
10 |
| ClusterId |
string |
Não |
O ID do cluster E-MapReduce (EMR). Configure este parâmetro apenas se você deseja consultar a linhagem de uma tabela EMR. |
abc |
| DatabaseName |
string |
Não |
O nome do banco de dados. |
abc |
| TableName |
string |
Não |
O nome da tabela. |
abc |
| DataSourceType |
string |
Não |
O tipo da fonte de dados. Valores válidos: odps e emr. |
emr |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
O resultado retornado. |
||
| 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 de negócio. |
|
| NextPrimaryKey |
string |
A lógica de paginação. Se o valor true for retornado para o parâmetro HasNext e um valor for retornado para o parâmetro NextPrimaryKey na resposta da solicitação anterior, você deve usar o valor do parâmetro NextPrimaryKey para a próxima solicitação. |
odps.tt.2 |
| HasNext |
boolean |
Indica se a próxima página existe. |
true |
| DataEntityList |
array<object> |
As informações sobre a tabela. |
|
|
object |
|||
| TableName |
string |
The name of the table. |
name |
| TableGuid |
string |
The unique identifier of the table. |
odps.tt.name |
| CreateTimestamp |
integer |
The time when the table was created. |
1638720736000 |
| DatabaseName |
string |
The name of the database. |
db1 |
Exemplos
Resposta de sucesso
JSON formato
{
"HttpStatusCode": 200,
"ErrorMessage": "The connection does not exist.",
"RequestId": "0bc1ec92159376",
"Success": true,
"ErrorCode": "Invalid.Tenant.ConnectionNotExists",
"Data": {
"NextPrimaryKey": "odps.tt.2",
"HasNext": true,
"DataEntityList": [
{
"TableName": "name",
"TableGuid": "odps.tt.name",
"CreateTimestamp": 1638720736000,
"DatabaseName": "db1"
}
]
}
}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. | The table does not exist. |
| 400 | InvalidParameter.Meta.CommonError | The specified parameter is invalid. | The request parameter is invalid. |
| 400 | InvalidParameter.Meta.GuidFormat | The GUID format is invalid. | The GUID format 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.UserId.Missing | An internal system error occurred. Try again later. | |
| 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.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.Access | Access is forbidden. Activate DataWorks first. | |
| 403 | ResourceNotAuthorized.Api | You are not authorized to access the resources. | |
| 403 | Forbidden.Meta.NoTenant | The user is not the owner of any tenants. | The user is not the owner of any tenants. |
| 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.