MENU
      queries

        queries


        기사 요약

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

        사용자의 Query를 실행합니다.

        요청

        요청 URL

        POST {DATA_QUERY API_URL}/queries
        HTTP

        요청 파라미터

        파라미터명필수 여부타입제약 사항설명
        queryYesString실행할 쿼리문
        projectIdNoIntegerQuery를 실행할 Project의 ID
        timeoutNoint최대값: 60쿼리 최대 수행 시간(단위: 초)
        기본값: 20초
        isReuseNoboolean쿼리 결과 재사용 여부
        기본값: false
        reuseMaxAgeNoint최대값: 10080쿼리 결과를 재사용할 최대 수명(단위: 분)
        "60분"을 입력하면 쿼리 실행 시점으로부터 60분 전에 반환할 수 있는 유효한 결과가 있는 경우 결과를 재사용
        기본값: 60분(1시간)
        dataSourceNoString쿼리를 실행할 기본 Data Source
        databaseNoString쿼리를 실행할 기본 Database

        요청 헤더

        공통 가이드 참조

        요청 예시

        curl -X POST "https://kr.dataquery.naverncp.com/api/v2/queries \
            -H "Content-Type:application/json" \
            -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}"
            -d \
            '{
                "query": "SELECT * FROM public_data.korea_trade_insurance.exchange_rate LIMIT 2",
                "timeout": 20,
                "isReuse": true,
                "reuseMaxAge": 60
            }'
        Bash

        응답

        응답 바디

        항목타입설명
        idStringQuery ID
        columnsColumnColumn 정보
        dataList<List<Object>>Query 응답값
        offsetlong쿼리 offset, 다음 응답값 조회 시 offset 전달 필요
        isFinishedboolean쿼리 결과가 모두 응답되었는지 여부

        Column

        항목타입설명
        nameStringColumn 이름
        typeStringColumn 타입
        typeSignatureClientTypeSignature

        ClientTypeSignature

        항목타입설명
        rawTypeString
        argumentsList<ClientTypeSignatureParameter>

        ClientTypeSignatureParameter

        항목타입설명
        kindStringENUM 값: TYPE, NAMED_TYPE, LONG, VARIABLE
        valueObject

        응답 예시

        HTTP

        HTTP StatusDescription
        200OK

        JSON

        {
          "id":"75b1b1bf-e808-456d-aa45-f74aaff0b0a4",
          "columns":[
            {
              "name":"currency_code",
              "type":"varchar",
              "typeSignature":{
                "rawType":"varchar",
                "arguments":[
                  {
                    "kind":"LONG",
                    "value":2147483647
                  }]
              }
            },
            {
              "name":"date",
              "type":"varchar",
              "typeSignature":{
                "rawType":"varchar",
                "arguments":[
                  {
                    "kind":"LONG",
                    "value":2147483647
                  }]
              }
            },
            {
              "name":"trade_rate",
              "type":"varchar",
              "typeSignature":{
                "rawType":"varchar",
                "arguments":[
                  {
                    "kind":"LONG",
                    "value":2147483647
                  }]
              }
            },
            {
              "name":"us_conversion_rate",
              "type":"varchar",
              "typeSignature":{
                "rawType":"varchar",
                "arguments":[
                  {
                    "kind":"LONG",
                    "value":2147483647
                  }]
              }
            }],
          "data":[
            [
              "CNY",
              "1995.10.25",
              "92.13",
              "0.1203"],
            [
              "CNY",
              "1995.10.24",
              "92.13",
              "0.1203"]],
          "offset":121,
          "isFinished":true
        }
        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.