MENU
      getTablePartitions

        getTablePartitions


        기사 요약

        VPC 환경에서 이용 가능합니다.

        사용자 catalog의 database/table 이름으로 특정 table의 partition key/value 조회

        요청

        요청 URL

        GET {DATA_CATALOG API_URL}/catalogs/{catalog-id}/databases/{database-name}/tables/{table-name}/partitions
        HTTP

        요청 파라미터

        파라미터명필수 여부타입제약 사항설명
        catalogIdYesStringcatalog 고유 id
        (ref: getCatalogs)
        databaseNameYesStringdatabase 이름
        tableNameYesStringtable 이름
        pageNoNoint페이지 번호기본값: 1
        pageSizeNoint최대값: 200결과 목록 크기기본값: 20

        요청 헤더

        공통 가이드 참조

        요청 예시

        curl -X GET "https://datacatalog.apigw.ntruss.com/api/v1/catalogs/{catalog-id}/databases/{database-name}/tables/{table-name}/partitions?pageNo=1&pageSize=20" \
            -H "x-ncp-apigw-timestamp: {x-ncp-apigw-timestamp}" \
            -H "x-ncp-iam-access-key: {x-ncp-iam-access-key}"  \
            -H "x-ncp-apigw-signature-v2: {x-ncp-apigw-signature-v2}"
        Bash

        응답

        응답 바디

        • partitionList: 사용자 table의 partition 리스트
        항목타입설명
        partitionKey.nameStringpartition key 이름
        partitionValue.valueList[]Stringpartition value 이름

        응답 예시

        HTTP

        HTTP StatusDescription
        200OK

        JSON

        {
          "requestId": "d8a6ad30-2d95-4c4d-872a-523cde8356b6",
          "totalCount": 3,
          "partitionList": [
            {
              "partitionKey": {
                "name": "partition_0"
              },
              "partitionValue": {
                "valueList": [
                  "test01",
                  "test01"
                ]
              }
            },
            {
              "partitionKey": {
                "name": "partition_1"
              },
              "partitionValue": {
                "valueList": [
                  "sales",
                  "sales"
                ]
              }
            },
            {
              "partitionKey": {
                "name": "partition_2"
              },
              "partitionValue": {
                "valueList": [
                  "2021",
                  "2022"
                ]
              }
            }
          ]
        }
        JSON

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.