getTableSchemaVersions

Prev Next

VPC環境で利用できます。

テーブルのスキーマバージョンリストを照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
GET /api/v1/catalogs/{catalogId}/databases/{databaseName}/tables/{tableName}/schema-versions

リクエストヘッダ

Data Catalog APIで共通して使用されるヘッダの詳細は、Data Catalogのリクエストヘッダをご参照ください。

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
catalogId Integer Required カタログ ID
databaseName String Required データベース名
tableName String Required テーブル名

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
pageNo Integer Optional ページ番号
  • 1~N (デフォルト: 1)
pageSize Integer Optional ページの出力数
  • 1~200 (デフォルト: 20)

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET 'https://datacatalog.apigw.ntruss.com/api/v1/catalogs/4**/databases/log_database/tables/log_table_1/schema-versions?pageNo=1&pageSize=20' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
pageNo Integer - ページ番号
pageSize Integer - ページ表示数
totalCount Integer - レスポンス結果数
requestId String - リクエスト ID
  • UUID形式
schemaVersions Array - スキーマバージョンリスト

schemaVersions

schemaVersionsの説明は次の通りです。

フィールド タイプ 必須の有無 説明
version Integer - スキーマのバージョン
createTime String - バージョンの作成日時
  • ISO 8601形式

レスポンスステータスコード

Data Catalog APIで共通して使用されるレスポンスステータスコードの詳細は、Data Catalogのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "pageNo": 1,
    "pageSize": 20,
    "totalCount": 4,
    "requestId": "ef7ec938-****-****-****-d87a045b9a7e",
    "schemaVersions": [
        {
            "version": 4,
            "createTime": "2025-03-19T09:50:49+0900"
        },
        {
            "version": 3,
            "createTime": "2025-03-19T09:08:35+0900"
        },
        {
            "version": 2,
            "createTime": "2025-03-18T10:09:31+0900"
        },
        {
            "version": 1,
            "createTime": "2025-03-18T10:05:59+0900"
        }
    ]
}