JQL 문법 정리에 대한 고민.

[slowcoders]

• select
  1 안): column list 를 Node 외부에 지정.
  { "starship<name, length>": {} }
  2 안): column list 를 Node 내부에 지정.
  { "starship": { "@select": "name, length" } }
  또는
  { "starship": { "@select": ["name", "length"] } }

• select 문 생략 시 default 처리
  1 안) * (all)
  2 안) @ (compared attributes)
  2 안) !,@ (primary key + compared attributes)

• Foreign Key 칼럼명 출력
  1 안) { "pilot.id" : 1000 }
  2 안) { "pilot" : { "id": 1000 } }

• 외부 Entity 참조키
  1 안) 내부 Property key 와 동일하기 처리.
  2 안) '+' 붙여서 구분. (Join 이 발생함을 명시)
  3 안) Associative Table 을 경유하는 경우 (2중 Join 된 경우만) '+' 붙여서 구분.

[leejh-77]

select 를 2안으로 가면 지금 url 에 정의하고 있는 루트 엔티티의 select 문도 자연스럽게
jql 안으로 통일시킬 수 있을거 같은데 어떠세요?
하나로 합치면 더 직관적일거 같아요

[slowcoders]

그러는 것이 좋을 것 같습니다. 조만만 변경 하도록 하겠습니다.
그리고, select 가 생략되었을 때, default 처리도 고민 좀 해주세요.
Root Node (base table) 은 select * 을 default 값으로 쓰면 좋을 듯 한데, joined node 는 어찌 처리하면 좋을까요?
내가 생각해 본 '자동처리' 방안은

1. 무조건적 Join. 예) "starship": {}
   1-1 안) id 만 포함
   1-2 안) select * 처리
2. PK/FK 를 이용한 Unique Join. 예) "starship": { "id": 3001 }
   1-1 안) select nothing
   1-2 안) "id" 만 포함.
3. 다중값 조인. 예) "starship": { "length@ge": 5 }
   1-1 안) 비교식에 사용된 attribute 만 출력에 포함. 즉 length 만 포함
   1-2 안) 비교식에 사용된 attribute 외에, id 도 포함 -> entity 식별이 가능하도록
4. All or Nothing (select * or nothing 기능만 지원)

문제는 위의 자동 처리 결과가 상황에 따라 달라져서 혼란스러울 것 같네요.
좀 더 좋은 안을 같이 고민해 주시면 좋겠네요.

[slowcoders]

JQL 은 Join 처리가 매우 쉬운 것이 장점이지만, 다단계 Join 을 남발하여 퍼포먼스 문제를 발생시킬 수 있음.
1 안) 되도록 쉬운 문법을 유지하고, 퍼포먼스 문제는 별도의 관리툴을 만들어 해결 (join depth 를 제한할 수 있도록 한다)
2 안) join 처리를 위한 문법을 일부러 좀 어렵게 만든다?

[slowcoders]

@select 연산자를 추가하는 방식은 몇 가지 문제로 포기했습니다.

1. @lt, @gt 등 기존 연산자와 전혀 어울리지 않아서 Parser 구조가 복잡해 집니다.
2. 연산자는 아무 곳에나 붙여 쓸 수 있어서, 제약 조건을 주기가 애매해집니다.

base entity 에 대해서만 아래와 유사한 형태로 적용하는 것에 대해 검토 중에 있습니다.
{
"select": "*",
"where": { "name@like": "Luke%" }
}

[leejh-77]

네 저도 쿼리를 돌려보다 보니 기존이 나을 수 있겠다는 생각이 들었습니다.
jql 자체도 상당히 작성하기 번거로워 지더군요.

1번은 아직 제가 파서구조를 잘 몰라서 파악이 안되지만,
2번은 어떤 의미 일까요?

[leejh-77]

그러는 것이 좋을 것 같습니다. 조만만 변경 하도록 하겠습니다. 그리고, select 가 생략되었을 때, default 처리도 고민 좀 해주세요. Root Node (base table) 은 select * 을 default 값으로 쓰면 좋을 듯 한데, joined node 는 어찌 처리하면 좋을까요? 내가 생각해 본 '자동처리' 방안은

1. 무조건적 Join. 예) "starship": {}
   1-1 안) id 만 포함
   1-2 안) select * 처리
2. PK/FK 를 이용한 Unique Join. 예) "starship": { "id": 3001 }
   1-1 안) select nothing
   1-2 안) "id" 만 포함.
3. 다중값 조인. 예) "starship": { "length@ge": 5 }
   1-1 안) 비교식에 사용된 attribute 만 출력에 포함. 즉 length 만 포함
   1-2 안) 비교식에 사용된 attribute 외에, id 도 포함 -> entity 식별이 가능하도록
4. All or Nothing (select * or nothing 기능만 지원)

문제는 위의 자동 처리 결과가 상황에 따라 달라져서 혼란스러울 것 같네요. 좀 더 좋은 안을 같이 고민해 주시면 좋겠네요.

4번이 어떨까요?

각각의 상황마다 반환되는 프로퍼티들이 달라진다면 조건 선언이 마치 select 문의 역할을 하는 것 같아 혼란이 올 수 있을거 같습니다.
select 와 연산자 선언은 가능한한 구분 짓는 것이 좋지 않을까 해요.

그럼

"starship": { "id": 3001 }

와 같은 선언이 base entity 를 필터링하기 위한 단순 조건으로 취급할거냐, (select nothing)
아님 starship 의 데이터 또한 얻기 위한 쿼리로 취급할거냐 (select all) 의 선택일 것 같네요.

[slowcoders]

1월 16일 현재,
Base entity 에 대한 select 기본 값을 All(*) 로 정하였습니다.
Joined entity 에 대한 select 기본 값은 Auto(@) 로 정해 보았습니다.

Auto select 모드에서는 query 조건문에 사용된 property 들을 자동으로 select 하되, { "id": 3001 } 과 같이 출력값이 고정된 칼럼은 출력에서 제외합니다.

1. 예를 들어 character 테이블에 대한 아래의 Query 는 starship entity 가 출력에 포함되지 않습니다.
   { "starship": { "id": 3001 } }

2. 아래의 Query 는 id 값이 고정값이 아니므로 starship entity 가 출력에 포함됩니다.
   { "starship": { "id@ge": 3001 } }

3. 아래와 같이 "@is" 사용하여 Query 를 작성하면 고정값도 출력에 포함됩니다.
   { "starship": { "id@is": 3001 } }

또한 Auto select 모드에서는 필요에 따라 Primary Key를 자동 선택합니다.

1. 출력 결과가 Array 여서, 각 항목을 구분할 필요가 있는 경우,
2. { "starship": {} } 과 같이 검색 조건이 없는 Joined Entity 의 경우엔 Join 된 Primary Key 를 자동 선택.

p.s. Auto 모드의 장점은 필요한 최소한의 정보를 자동 추출해 주는 것입니다
다만, default 로 Auto 를 사용하는 것이 적당한지는 결정이 쉽지 않네요.
일단 좀 사용해 보고, 다시 한 번 더 검토하도록 하지요.

[slowcoders]

property selection 이 지정되지 않은 경우의 기본값은 상위 node 의 selection 중 alias 를 상속하도록 변경하였습니다.
일단, 상위 entity 와 동일한 정책을 적용하는 것이 가장 자연스러운 것으로 보여집니다.
관련 설명은 tutorial 중 [Joined property selection] 을 참고해 주세요.

[slowcoders]

각 노드 별로 select 를 설정하는 기능은 없에고, 아래와 같이 별도의 select 문으로 명시하도록 함으로써, property 속성 선택과 filter(조건식) 을 명확히 분리하였습니다.
단, select 가 명시되지 않은 경우, 기존처럼 filter 에 사용된 entity 들의 property 들을 자동으로 선택합니다. Auto Select 기능은 초기 개발 시, 쿼리를 테스트 해보는 단순한 용도로 한정하려고 합니다.
이로 인해 문법도 코드도 단순해 졌습니다. 정답에 가까운 답을 찾은 것 같습니다.
jql = {
select : "*, starship.<name, length>", //comma separated property list
sort : "name, -length", // comma separated sort options
limit : 0,
page : 0,
filter: { "starship": { "length@ge" : 10 } }
}

[slowcoders]

select 문법 최종안입니다.
select 구문의 문법을 아래와 같이 계층적 구조를 가지도록 변경하였습니다.

• jql_key = Identifier['.'jql_key]
• jql_selector = '*' | '0' | jql_key
• jql_selector_set = jql_key '.(' jql_selector { ',' jql_selector } ')'
• jql_property_selection = [ (jql_selector | jql_selector_set) [',' jql_property_selection ] ]
  ex)
  '' --> select all internal properties (All table columns except json and foreign key columns)
  '0' --> select all primary keys
  '0, starship_' --> primary keys + all internal properties of starship entity
  '0, starship_.' --> 위와 동일
  '0, starship_.(*)' --> 위와 동일

'name, starship_.(name, pilot.name)'
--> name of base entity + name of starship entity + name of joined entity by pilot of starship

'name, starship_.name, starship_.pilot.name)'
--> 'name, starship_.(name, pilot.name)' 와 동일

'name, friend_.(name, friend_.(name))'
--> make friend name tree nodes in 2 depth.

'name, friend_.(name, friend_.(name, friend_.(name))'
--> make friend name tree nodes in 3 depth.

참고로, reference property (Json column and Joined Entity) 에 대한 logical name 생성시 1:N mapping 즉 List 형인 경우에 column 명 뒤에 '_' 를 추가합니다. 복수형 어미인 's'를 대신하는 용도입니다.