Todos os produtos
Search

Este produto

    MaxCompute:GetTableInfo

    Central de documentação

    MaxCompute:GetTableInfo

    Última atualização: Oct 14, 2026

    Consulta as informações sobre tabelas internas, visualizações, tabelas externas, tabelas clusterizadas ou tabelas transacionais do MaxCompute.

    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:GetTableInfo

    get

    *Projeto.

    acs:odps:{#regionId}:{#accountId}:projects/{#ProjectName}

    		 Nenhuma Nenhuma

    Sintaxe da solicitação

    GET /api/v1/projects/{projectName}/tables/{tableName} HTTP/1.1

    Parâmetros de caminho

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    projectName

    string

    Sim

    O nome do projeto ao qual a tabela ou visualização a ser consultada pertence.

    odps_project
    tableName

    string

    Sim

    O nome da tabela ou visualização a ser consultada.

    sale_detail

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    schemaName

    string

    Não

    O nome do esquema ao qual a tabela ou visualização a ser consultada pertence.

    default
    type

    string

    Não

    O tipo da tabela ou visualização a ser consultada. Valores válidos:

    internal

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Os parâmetros de resposta.

    requestId

    string

    O ID da solicitação.

    0a06dd4516687375802853481ec9fd
    data

    object

    O resultado da resposta.

    name

    string

    O nome da tabela ou visualização.

    sale_detail
    owner

    string

    As informações da conta do proprietário da tabela ou visualização.

    ALIYUN$odps****@aliyunid.com
    type

    string

    O tipo da tabela ou visualização. Valores válidos:

    internal
    schema

    string

    O nome do esquema ao qual a tabela ou visualização pertence.

    default
    creationTime

    integer

    A hora de criação. O horário está no formato ISO 8601 e no fuso horário UTC.

    2022-01-17T07:07:47Z
    viewText

    string

    A instrução usada para criar a visualização. Este parâmetro é retornado apenas quando o tipo é view.

    select shop_name, sum(total_price) from sale_detail group by shop_name
    displayName

    string

    O nome de exibição.

    odps_project.default.sale_detail
    projectName

    string

    O nome do projeto ao qual a tabela ou visualização pertence.

    odps_project
    lastDDLTime

    integer

    A hora em que a instrução DDL da tabela ou visualização foi modificada pela última vez.

    2023-11-21T02:05:56Z
    lastModifiedTime

    integer

    A hora em que os dados da tabela ou visualização foram modificados pela última vez. O horário está no formato ISO 8601 e no fuso horário UTC.

    2023-11-21T02:05:56Z
    lastAccessTime

    integer

    A hora em que os dados da tabela ou visualização foram acessados pela última vez. Este parâmetro é retornado apenas quando a tabela é uma tabela não particionada.

    Nota

    Esses dados têm sido coletados gradualmente desde julho de 2023. Se a tabela não tiver sido acessada após a atualização, ou se for acessada por meio de jobs ALGO ou leitura direta do Hologres, o last_access_time não poderá ser coletado.

    2023-11-21T02:05:56Z
    lifecycle

    string

    O ciclo de vida em dias.

    -1
    isExternalTable

    boolean

    Indica se a tabela é uma tabela externa. Este parâmetro é retornado apenas quando o tipo é table.

    false
    size

    integer

    O tamanho dos dados da tabela. Se a tabela for uma tabela não particionada, o valor será o tamanho dos dados da tabela. Se a tabela for uma tabela particionada, o sistema não calculará o tamanho dos dados da tabela e o valor será NULL. A visualização PARTITIONS contém o tamanho dos dados de cada partição na tabela particionada. Unidade: bytes.

    5372
    comment

    string

    O comentário da tabela.

    sale_detail
    tableLabel

    string

    O rótulo de nível de sensibilidade da tabela. Para mais informações, consulte Controle de acesso baseado em rótulos.

    0
    createTableDDL

    string

    A instrução DDL usada para criar a tabela.

    create table if not exists sale_detail( shop_name STRING, customer_id STRING, total_price DOUBLE) partitioned by (sale_date STRING, region STRING);
    nativeColumns

    array<object>

    As informações da coluna.

    object

    As informações da coluna.

    name

    string

    O nome da coluna.

    shop_name
    type

    string

    O tipo de dados.

    STRING
    label

    string

    O rótulo de nível de sensibilidade da coluna. Para mais informações, consulte Controle de acesso baseado em rótulos.

    0
    comment

    string

    O comentário da coluna.

    Store name
    partitionColumns

    array<object>

    As informações da coluna de partição. Este parâmetro é retornado apenas para tabelas particionadas.

    object

    As informações da coluna de partição.

    name

    string

    O nome da partição.

    ds='20190130'
    type

    string

    O tipo de dados.

    STRING
    label

    string

    O rótulo de nível de sensibilidade da coluna. Para mais informações, consulte Controle de acesso baseado em rótulos.

    0
    comment

    string

    O comentário da coluna de partição.

    Sale date
    materializedView

    boolean

    Indica se a tabela é uma visualização materializada.

    false
    rewriteEnabled

    boolean

    Indica se a reescrita de consulta por meio da visualização materializada é permitida. Este parâmetro é retornado apenas quando o tipo é materialized view.

    false
    autoRefreshEnabled

    boolean

    Indica se a atualização automática da visualização materializada está ativada. Este parâmetro é retornado apenas quando o tipo é materialized view.

    false
    isOutdated

    boolean

    Indica se os dados na visualização materializada são inválidos devido a alterações nos dados da tabela de origem. Este parâmetro é retornado apenas quando o tipo é materialized view.

    false
    physicalSize

    integer

    O tamanho físico.

    2763
    fileNum

    integer

    O número de arquivos.

    200
    storageHandler

    string

    O analisador de tabela externa. Este parâmetro é retornado apenas quando o tipo é external table.

    com.aliyun.odps.CsvStorageHandler
    location

    string

    A localização da tabela externa. Este parâmetro é retornado apenas quando o tipo é external table.

    oss://oss-cn-hangzhou-internal.aliyuncs.com/oss-mc-test/Demo1/
    odpsPropertiesRolearn

    string

    O ARN do AliyunODPSDefaultRole no RAM. Este parâmetro é retornado apenas quando o tipo é external table.

    acs:ram::xxxxx:role/aliyunodpsdefaultrole
    tablestoreColumnsMapping

    string

    As colunas da tabela do Tablestore a serem acessadas pelo MaxCompute, incluindo as colunas de chave primária e as colunas de atributo. Este parâmetro é retornado apenas quando o tipo é external table.

    o_orderkey,o_orderdate,o_custkey,o_orderstatus,o_totalprice
    tablesotreTableName

    string

    O nome da tabela do Tablestore a ser acessada. Este parâmetro é retornado apenas quando o tipo é external table.

    ots_tpch_orders
    odpsSqlTextOptionFlushHeader

    boolean

    Indica se o cabeçalho deve ser ignorado. Este parâmetro é retornado apenas quando o tipo é external table.

    true
    odpsTextOptionHeaderLinesCount

    integer

    O número de linhas de cabeçalho a serem ignoradas. Este parâmetro é retornado apenas quando o tipo é external table.

    1
    clusterInfo

    object

    As propriedades de clusterização. Este parâmetro é retornado apenas quando o tipo de tabela é clustered table.

    clusterType

    string

    O tipo de clusterização da tabela. Atualmente, o MaxCompute suporta Hash Clustering e Range Clustering.

    Hash
    clusterCols

    array

    A chave de cluster.

    string

    A chave de cluster.

    col_1
    sortCols

    array<object>

    As colunas de classificação.

    object

    As colunas de classificação.

    name

    string

    O nome da coluna de classificação.

    col_2
    order

    string

    A ordem de classificação.

    DESC
    bucketNum

    integer

    O número de buckets na tabela clusterizada. Este é um campo opcional. Um valor de 0 indica que o número de buckets é determinado dinamicamente durante a execução do job.

    1024

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "requestId": "0a06dd4516687375802853481ec9fd",
  "data": {
    "name": "sale_detail",
    "owner": "ALIYUN$odps****@aliyunid.com",
    "type": "internal",
    "schema": "default",
    "creationTime": 0,
    "viewText": "select shop_name, sum(total_price) from sale_detail group by shop_name",
    "displayName": "odps_project.default.sale_detail",
    "projectName": "odps_project",
    "lastDDLTime": 0,
    "lastModifiedTime": 0,
    "lastAccessTime": 0,
    "lifecycle": "-1",
    "isExternalTable": false,
    "size": 5372,
    "comment": "sale_detail",
    "tableLabel": "0",
    "createTableDDL": "create table if not exists sale_detail( shop_name STRING, customer_id STRING, total_price DOUBLE) partitioned by (sale_date STRING, region STRING);",
    "nativeColumns": [
      {
        "name": "shop_name",
        "type": "STRING",
        "label": "0",
        "comment": "Store name"
      }
    ],
    "partitionColumns": [
      {
        "name": "ds='20190130'",
        "type": "STRING",
        "label": "0",
        "comment": "Sale date"
      }
    ],
    "materializedView": false,
    "rewriteEnabled": false,
    "autoRefreshEnabled": false,
    "isOutdated": false,
    "physicalSize": 2763,
    "fileNum": 200,
    "storageHandler": "com.aliyun.odps.CsvStorageHandler",
    "location": "oss://oss-cn-hangzhou-internal.aliyuncs.com/oss-mc-test/Demo1/",
    "odpsPropertiesRolearn": "acs:ram::xxxxx:role/aliyunodpsdefaultrole",
    "tablestoreColumnsMapping": "o_orderkey,o_orderdate,o_custkey,o_orderstatus,o_totalprice",
    "tablesotreTableName": "ots_tpch_orders",
    "odpsSqlTextOptionFlushHeader": true,
    "odpsTextOptionHeaderLinesCount": 1,
    "clusterInfo": {
      "clusterType": "Hash",
      "clusterCols": [
        "col_1"
      ],
      "sortCols": [
        {
          "name": "col_2",
          "order": "DESC"
        }
      ],
      "bucketNum": 1024
    }
  }
}

    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.