Todos os produtos
Search
Central de documentação

MaxCompute:ListMmsPartitions

Última atualização: Jul 04, 2026

Lista as partições 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:ListMmsPartitions

list

*project

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

Nenhuma Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

sourceId

integer

Sim

O ID da fonte de dados.

200018

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

dbId

integer

Não

O ID do banco de dados.

2

dbName

string

Não

O nome do banco de dados.

d1

updated

boolean

Não

Filtra as partições cujos metadados foram atualizados.

false

tableName

string

Não

O nome da tabela.

t1

tableId

integer

Não

O ID da tabela que contém a partição.

20323

value

string

Não

O valor da partição.

p1=1/p2=abc

status

array

Não

O status da migração.

string

Não

O status da migração.

Valores válidos:

  • INIT :

    Não migrado.

  • DONE :

    Bem-sucedido.

  • DOING :

    Migrando.

  • FAILED :

    Falhou.

["DONE", "FAILED"]

lastDdlTimeStart

string

Não

O valor mínimo de lastDdlTime.

2024-12-17 15:44:42

lastDdlTimeEnd

string

Não

O valor máximo de lastDdlTime.

2024-12-17 19:44:42

pageNum

integer

Não

O número da página a ser retornada.

1

pageSize

integer

Não

O número de entradas a serem retornadas por página.

100

sorter.numRows

string

Não

Classifica pelo número de linhas.

Valores válidos:

  • asc :

    Ascendente.

  • desc :

    Descendente.

desc

sorter.size

string

Não

Classifica pelo tamanho dos dados.

Valores válidos:

  • asc :

    Ascendente.

  • desc :

    Descendente.

asc

sorter.lastDdlTime

string

Não

Classifica por lastDdlTime.

Valores válidos:

  • asc :

    Ascendente.

  • desc :

    Descendente.

desc

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O valor de retorno.

requestId

string

O ID da solicitação.

D9F872FD-5DDE-30A6-8C8A-1B8C6A81059F

data

object

Os dados retornados.

total

integer

O número total de partições.

1000

objectList

array<object>

A lista de partições.

object

O objeto de partição.

id

integer

The partition ID.

2323

dbId

integer

The ID of the database that contains the partition. The term "database" refers to different metadata layers across data sources. For example, it maps to Dataset in BigQuery, Database in Hive, Schema in Databricks, and Schema in MaxCompute.

196

tableId

integer

The table ID.

23

dbName

string

The database name. The term "database" refers to different metadata layers across data sources. For example, it maps to Dataset in BigQuery, Database in Hive, Schema in Databricks, and Schema in MaxCompute.

d1

tableName

string

The table name.

t1

value

string

The partition value.

p1=1/p2=abc

dstProjectName

string

The destination MaxCompute project name.

mms_test

dstSchemaName

string

The destination MaxCompute schema name. This field is empty for MaxCompute projects that do not use schemas.

default

dstTableName

string

The destination MaxCompute table name.

default

dstValue

string

The destination MaxCompute partition value. By default, this matches the source partition value.

p1=1/p2=abc

sourceId

integer

The data source ID.

200018

sourceName

string

The data source name.

demo

size

integer

The data size in bytes.

23223

numRows

integer

The number of rows.

2323

updated

boolean

Indicates whether the metadata has been updated.

false

lastDdlTime

string

The time when the DDL was last changed.

2024-12-17 15:44:42

status

string

The migration status.

Valores válidos:

  • INIT :

    Not migrated.

  • DONE :

    Succeeded.

  • DOING :

    Migrating.

  • FAILED :

    Failed.

DONE

pageNum

integer

O número da página.

1

pageSize

integer

O número de entradas por página.

10

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "D9F872FD-5DDE-30A6-8C8A-1B8C6A81059F",
  "data": {
    "total": 1000,
    "objectList": [
      {
        "id": 2323,
        "dbId": 196,
        "tableId": 23,
        "dbName": "d1",
        "tableName": "t1",
        "value": "p1=1/p2=abc\n",
        "dstProjectName": "mms_test",
        "dstSchemaName": "default",
        "dstTableName": "default",
        "dstValue": "p1=1/p2=abc",
        "sourceId": 200018,
        "sourceName": "demo",
        "size": 23223,
        "numRows": 2323,
        "updated": false,
        "lastDdlTime": "2024-12-17 15:44:42\n",
        "status": "DONE"
      }
    ],
    "pageNum": 1,
    "pageSize": 10
  }
}

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.