SQL 문 생성 API

최근 업데이트 2026. 10. 03.

호출 방법은 Open API 문서의 호출 방법 설명을 참고하십시오.

1. 유저 조회용 SQL 문 생성

인터페이스 URL

/open/get-sql-for-user-search?token=xxx&projectId=377

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름	예시 값	파라미터 타입	필수 여부	파라미터 설명
token	xxx	String	예	조회 키
projectId	0	Integer	예	프로젝트 ID

요청 Body 파라미터

{
  "filter": {
      "filterType": "COMPOUND",
      "relation": "and",
      "filts": [
        {
          "filterType": "SIMPLE",
          "tableType": "user",
          "columnName": "city",
          "comparator": "equal",
          "ftv": [
            "상하이시"
          ]
        },
        {
          "filterType": "SIMPLE",
          "tableType": "user",
          "columnName": "companynature",
          "comparator": "equal",
          "ftv": [
            "민영"
          ]
        }
      ]
  },
  "selectAllColumns": false,
  "selectColumns": [
     "#account_id", "#distinct_id"
  ]
}

파라미터 이름	예시 값	파라미터 타입	필수 여부	파라미터 설명
selectAllColumns	false	Boolean	아니요	모든 필드 조회 여부, 기본값 false
selectColumns	["#account_id", "#distinct_id"]	List	아니요	조회할 필드 이름 리스트
filter	-	Object	예	속성 필터
filter.filterType	COMPOUND	String	아니요	필터 COMPOUND: 복합 타입 SIMPLE: 단순 타입
filter.relation	and	String	아니요	필터 논리 관계
filter.filts	-	List	아니요	필터 객체 리스트
filter.filts.filterType	SIMPLE	String	아니요	필터 COMPOUND: 복합 타입 SIMPLE: 단순 타입
filter.filts.tableType	user	String	아니요	user: 유저 속성
filter.filts.columnName	city	String	예	필드 이름
filter.filts.comparator	equal	String	아니요	비교 연산자
filter.filts.ftv	["민영"]	List	아니요	필터 값 리스트

성공 응답 예시

{
  "data": {
    "sql": "select \"#user_id\", \"#account_id\", \"#distinct_id\" from (v_user_377) where (\"city\" IN ('상하이시')) and (\"companynature\" IN ('민영'))"
  },
  "return_code": 0,
  "return_message": "success"
}

파라미터 이름	예시 값	파라미터 타입	파라미터 설명
data	-	Object	반환 결과
data.sql	"select \"#user_id\", \"#account_id\", \"#distinct_id\" from (v_user_377) where (\"city\" IN ('상하이시')) and (\"companynature\" IN ('민영'))"	String	SQL 문
return_code	0	Integer	반환 코드
return_message	success	String	반환 정보

오류 응답 예시

{
    "return_code": -1008,
    "return_message": "오류 설명"
}

파라미터 이름	예시 값	파라미터 타입	파라미터 설명
return_code	-1008	Integer	반환 코드
return_message	오류 설명	String	반환 정보