すべてのプロダクト
Search

このプロダクト

    MaxCompute:GetTableInfo

    ドキュメントセンター

    MaxCompute:GetTableInfo

    最終更新日:Dec 18, 2025

    MaxCompute の内部テーブル、ビュー、外部テーブル、クラスター化テーブル、またはトランザクションテーブルに関する情報を表示します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    odps:GetTableInfo

    get

    *Project

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

    		 なし なし

    リクエスト構文

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

    パスパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    projectName

    string

    必須

    テーブルまたはビューが属するプロジェクトの名前です。

    projectA
    tableName

    string

    必須

    表示したいテーブルまたはビューの名前です。

    sale_detail

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    schemaName

    string

    任意

    テーブルまたはビューが属するスキーマの名前です。

    default
    type

    string

    任意

    表示したいテーブルまたはビューのタイプです。有効な値は次のとおりです：

    internal

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーターです。

    requestId

    string

    リクエスト ID です。

    0a06dd4516687375802853481ec9fd
    data

    object

    返されるデータです。

    name

    string

    テーブルまたはビューの名前です。

    sale_detail
    owner

    string

    テーブルまたはビューのオーナーのアカウント情報です。

    188785396123****
    type

    string

    テーブルまたはビューのタイプです。有効な値は次のとおりです：

    internal
    schema

    string

    テーブルまたはビューが属するスキーマの名前です。

    default
    creationTime

    integer

    作成時間です。

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

    string

    ビューを生成する文です。このレスポンスパラメーターは、type が view に設定されている場合に返されます。

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

    string

    表示名です。

    project_name.schema_name.table_name
    projectName

    string

    テーブルまたはビューが属するプロジェクトの名前です。

    projectA
    lastDDLTime

    integer

    テーブルまたはビューのデータ定義言語 (DDL) 文が最後に変更された時間です。

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

    integer

    テーブルまたはビューのデータが最後に変更された時間です。

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

    integer

    テーブルまたはビューのデータが最後にアクセスされた時間です。

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

    string

    ライフサイクルです。単位は日です。

    -1
    isExternalTable

    boolean

    テーブルが外部テーブルであるかどうかを示します。このレスポンスパラメーターは、type が external に設定されている場合に返されます。

    false
    size

    integer

    非パーティションテーブルのデータサイズです。テーブルがパーティションテーブルの場合、システムはこのデータサイズを計算しません。その場合、このパラメーターの値は NULL となります。パーティションテーブル内の各パーティションのデータサイズは、PARTITIONS ビューに含まれています。単位はバイトです。

    5372
    comment

    string

    テーブルのコメントです。

    sale_detail
    tableLabel

    string

    テーブルの秘密度レベルのラベルです。詳細については、「ラベルベースのアクセスの制御」をご参照ください。

    0
    createTableDDL

    string

    テーブルを作成するための DDL 文です。

    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>

    フィールド情報です。

    object

    フィールド情報です。

    name

    string

    列名です。

    shop_name
    type

    string

    列のタイプです。

    STRING
    label

    string

    列の秘密度レベルのラベルです。詳細については、「ラベルベースのアクセスの制御」をご参照ください。

    0
    comment

    string

    列のコメントです。

    The name of shop.
    partitionColumns

    array<object>

    パーティションキー列に関する情報です。このレスポンスパラメーターは、パーティションテーブルの場合にのみ返されます。

    object

    パーティションキー列に関する情報です。

    name

    string

    パーティション名です。

    sale_date
    type

    string

    パーティション列のタイプです。

    STRING
    label

    string

    列の秘密度レベルのラベルです。詳細については、「ラベルベースのアクセスの制御」をご参照ください。

    0
    comment

    string

    パーティションキー列のコメントです。

    Sale date.
    materializedView

    boolean

    テーブルまたはビューがマテリアライズドビューであるかどうかを示します。

    false
    rewriteEnabled

    boolean

    マテリアライズドビューを使用してクエリの再書き込み操作を実行できるかどうかを示します。このレスポンスパラメーターは、type が materializedView に設定されている場合に返されます。

    false
    autoRefreshEnabled

    boolean

    マテリアライズドビューが自動的にリフレッシュされるかどうかを示します。このレスポンスパラメーターは、type が materializedView に設定されている場合に返されます。

    false
    isOutdated

    boolean

    ソーステーブルのデータの変更により、マテリアライズドビューのデータが無効になったかどうかを示します。このレスポンスパラメーターは、type が materializedView に設定されている場合に返されます。

    false
    physicalSize

    integer

    テーブルの物理サイズです。

    2763
    fileNum

    integer

    テーブルのファイル数です。

    200
    storageHandler

    string

    外部テーブルのストレージハンドラです。このレスポンスパラメーターは、type が external に設定されている場合に返されます。

    com.aliyun.odps.CsvStorageHandler
    location

    string

    外部テーブルのパスです。このレスポンスパラメーターは、type が external に設定されている場合に返されます。

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

    string

    Resource Access Management (RAM) の AliyunODPSDefaultRole ロールの Alibaba Cloud リソースネーム (ARN) です。このレスポンスパラメーターは、type が external に設定されている場合に返されます。

    acs:ram::xxxxx:role/aliyunodpsdefaultrole
    tablestoreColumnsMapping

    string

    アクセスする Tablestore テーブルの列 (プライマリキー列と属性列を含む) です。このレスポンスパラメーターは、type が external に設定されている場合に返されます。

    :o_orderkey,:o_orderdate,o_custkey,o_orderstatus,o_totalprice
    tablesotreTableName

    string

    アクセスする Tablestore テーブルの名前です。このレスポンスパラメーターは、type が external に設定されている場合に返されます。

    ots_tpch_orders
    odpsSqlTextOptionFlushHeader

    boolean

    テーブルヘッダーを無視するかどうかを示します。このレスポンスパラメーターは、type が external に設定されている場合に返されます。

    true
    odpsTextOptionHeaderLinesCount

    integer

    テーブルヘッダーで無視された最初の N 行です。このレスポンスパラメーターは、type が external に設定されている場合に返されます。

    1
    clusterInfo

    object

    クラスタリング属性です。このレスポンスパラメーターは、テーブルがクラスター化テーブルの場合に返されます。

    clusterType

    string

    テーブルのクラスタリングタイプです。MaxCompute はハッシュクラスタリングと

    レンジクラスタリングをサポートしています。

    Hash
    clusterCols

    array

    クラスターキーです。

    string

    クラスターキーです。

    col_1
    sortCols

    array<object>

    結果のソート条件です。

    object

    結果のソート条件です。

    name

    string

    ソートフィールドの名前です。

    col_2
    order

    string

    ソート順です。

    DESC
    bucketNum

    integer

    任意。クラスター化テーブルのバケット数です。値 0 は、ジョブの実行中にバケット数が動的に変化することを示します。

    1024

    例

    成功レスポンス

    JSONJSON

    {
  "requestId": "0a06dd4516687375802853481ec9fd",
  "data": {
    "name": "sale_detail",
    "owner": "188785396123****",
    "type": "internal",
    "schema": "default",
    "creationTime": 0,
    "viewText": "select shop_name, sum(total_price) from sale_detail group by shop_name",
    "displayName": "project_name.schema_name.table_name",
    "projectName": "projectA",
    "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": "The name of shop."
      }
    ],
    "partitionColumns": [
      {
        "name": "sale_date",
        "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
    }
  }
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。