ListMmsTables - MaxCompute: Central de Documentação do Alibaba Cloud

Lista as tabelas em uma fonte de dados do MaxCompute Migration Assist (MMA).

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

odps:ListMmsTables

list

*project

acs:odps:{#regionId}:{#accountId}:mmsdatasource/{#sourceId}

Nenhuma

Sintaxe da solicitação

GET /api/v1/mms/datasources/{sourceId}/tables HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
sourceId	integer	Sim	O ID da fonte de dados.	2000015

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
onlyName	boolean	Não	Especifica se apenas os nomes das tabelas devem ser retornados.	false
dbId	integer	Não	O ID do banco de dados.	197
dbName	string	Não	O nome do banco de dados.	mms_test
name	string	Não	O nome da tabela.	test
dstProjectName	string	Não	O nome do projeto MaxCompute de destino.	mms_test
dstSchemaName	string	Não	O nome do schema MaxCompute de destino. Este parâmetro é nulo se o projeto MaxCompute de destino não tiver uma camada de schema.	default
dstName	string	Não	O nome da tabela MaxCompute de destino.	test
type	string	Não	O tipo de tabela.	MANAGED_TABLE
hasPartitions	boolean	Não	A tabela particionada.	true
status	array	Não	O status da migração.	test
	string	Não	O status da migração. Valores válidos: PART_DONE : A migração foi parcialmente bem-sucedida. INIT : A migração não foi iniciada. DONE : A migração foi bem-sucedida. DOING : A migração está em andamento. FAILED : A migração falhou.	["DONE", "FAILED"]
lastDdlTimeStart	string	Não	O início do intervalo de tempo para lastDdlTime.	2024-12-17 15:44:42
lastDdlTimeEnd	string	Não	O fim do intervalo de tempo para lastDdlTime.	2024-12-19 15:44:42
pageNum	integer	Não	O número da página.	1
pageSize	integer	Não	O número de entradas a serem retornadas em cada página.	10
sorter.numRows	string	Não	A ordem de classificação para o número de linhas. Valores válidos: asc : Ordem ascendente. desc : Ordem descendente.	desc
sorter.size	string	Não	A ordem de classificação para o tamanho dos dados. Valores válidos: asc : Ordem ascendente. desc : Ordem descendente.	asc
sorter.lastDdlTime	string	Não	A ordem de classificação para lastDdlTime. Valores válidos: asc : Ordem ascendente. desc : Ordem descendente.	desc

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O valor de retorno.
requestId	string	O ID da solicitação.	E7FB14F1-4ACD-5C73-A755-B302D70AB9AD
data	object	Os dados retornados.
total	integer	O número total de registros.	100
objectList	array<object>	A lista de tabelas.
	array<object>	As informações da tabela.
id	integer	The table ID.	1003476
dbId	integer	The database ID.	196
dbName	string	The database name.	demo
name	string	The table name.	test
dstProjectName	string	The name of the destination MaxCompute project.	mms_test
dstSchemaName	string	The name of the destination MaxCompute schema. This parameter is null if the destination MaxCompute project does not have a schema layer.	default
dstName	string	The name of the destination MaxCompute table. By default, this name is the same as the source table name.	test
type	string	The table type.	MANAGED_TABLE
hasPartitions	boolean	Indicates whether the table is a partitioned table.	true
schema	object	The table schema.
name	string	The table name.	test
comment	string	The comment on the table.	for mms test
columns	array<object>	All non-partition key columns of the table.
	object	A non-partition key column.
name	string	The column name.	user_id
type	string	The column type.	bigint
comment	string	The comment on the column.	user id
defaultValue	string	The default value of the column.	""
nullable	boolean	Indicates whether the column can be null.	false
partitions	array<object>	All partition key columns.
	object	A partition key column.
name	string	The column name.	p1
type	string	The column type.	string
comment	string	The comment on the column.	第一分区
defaultValue	string	The default value of the column.	abc
nullable	boolean	Indicates whether the column can be null.	false
owner	string	The owner of the table.	Hive
location	string	The storage location of the table.	\| hdfs://master-1-1.c-c127cd184bb029ea.cn-zhangjiakou.emr.aliyuncs.com:9000/user/hive/warehouse/demo
inputFormat	string	The input format.	org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat
outputFormat	string	The output format.	org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat
serde	string	The serializer/deserializer (SerDe).	org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe
extra	string	Other information stored in JSON format.	{"mapkey.delim":":","collection.delim":",","serialization.format":"\|","field.delim":"\|"}
partitions	integer	The number of partitions.	100
partitionsDoing	integer	The number of partitions that are being migrated.	20
partitionsDone	integer	The number of partitions that are migrated.	60
partitionsFailed	integer	The number of partitions that failed to be migrated.	40
sourceId	integer	The ID of the data source.	2000028
sourceName	string	The name of the data source.	demo
size	integer	The data size in bytes.	2985028
numRows	integer	The number of rows.	232323
updated	boolean	Indicates whether the metadata is updated.	true
lastDdlTime	string	The last DDL time.	2024-12-17 15:44:42
status	string	The migration status. Valores válidos: PART_DONE : The migration is partially successful. INIT : The migration has not started. DONE : The migration is successful. DOING : The migration is in progress. FAILED : The migration failed.	DONE
pageNum	integer	O número da página.	1
pageSize	integer	O número de entradas por página.	20

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "E7FB14F1-4ACD-5C73-A755-B302D70AB9AD",
  "data": {
    "total": 100,
    "objectList": [
      {
        "id": 1003476,
        "dbId": 196,
        "dbName": "demo",
        "name": "test",
        "dstProjectName": "mms_test",
        "dstSchemaName": "default",
        "dstName": "test",
        "type": "MANAGED_TABLE",
        "hasPartitions": true,
        "schema": {
          "name": "test",
          "comment": "for mms test",
          "columns": [
            {
              "name": "user_id",
              "type": "bigint",
              "comment": "user id",
              "defaultValue": "\"\"",
              "nullable": false
            }
          ],
          "partitions": [
            {
              "name": "p1",
              "type": "string",
              "comment": "第一分区",
              "defaultValue": "abc",
              "nullable": false
            }
          ]
        },
        "owner": "Hive",
        "location": "| hdfs://master-1-1.c-c127cd184bb029ea.cn-zhangjiakou.emr.aliyuncs.com:9000/user/hive/warehouse/demo",
        "inputFormat": "org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat ",
        "outputFormat": "org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat",
        "serde": "org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe",
        "extra": "{\"mapkey.delim\":\":\",\"collection.delim\":\",\",\"serialization.format\":\"|\",\"field.delim\":\"|\"}   ",
        "partitions": 100,
        "partitionsDoing": 20,
        "partitionsDone": 60,
        "partitionsFailed": 40,
        "sourceId": 2000028,
        "sourceName": "demo ",
        "size": 2985028,
        "numRows": 232323,
        "updated": true,
        "lastDdlTime": "2024-12-17 15:44:42\n",
        "status": "DONE"
      }
    ],
    "pageNum": 1,
    "pageSize": 20
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.