MENU
      getTablePartitions

        getTablePartitions


        Article summary

        Available in VPC

        Searches for the partition key/value of a specific table with the database/table name of the user's catalog.

        Requests

        Request URL

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

        Request parameters

        Parameter nameRequirement statusTypeRestrictionsDescription
        catalogIdYesStringUnique catalog ID
        (ref: getCatalogs)
        databaseNameYesStringDatabase name
        tableNameYesStringTable name
        pageNoNoint Default of the page number: 1
        pageSizeNointMaximum: 200Default of the result list size: 20

        Request header

        See common guide.

        Request examples

        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

        Responses

        Response bodies

        • partitionList: list of partitions for the user’s table
        ItemTypeDescription
        partitionKey.nameStringName of the partition key
        partitionValue.valueList[]StringName of the partition value

        Response examples

        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

        Was this article helpful?

        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.