라이믹스/매뉴얼/DB 쿼리 operator

상위 문서: 라이믹스/매뉴얼

1. 개요#

라이믹스 XML 쿼리의 <condition> 요소에서 operation 속성으로 조건 연산자를 지정하는 방법이다. 공식 매뉴얼은 아래 연산자들을 라이믹스 2.0.0 이상에서 지원하는 것으로 안내한다. 문서 제목은 operator이지만 실제 속성명은 operation이다.

2. 연산자 목록#

아래에서 ‘값’은 var 또는 default로 주어지는 비교 대상이다.

operation	SQL 의미	설명
equal	=
more / gte	>=
excess / gt	>
less / lte	<=
below / lt	<
notequal / not_equal	!=
regexp	REGEXP	정규식 일치
notregexp / not_regexp	NOT REGEXP	정규식 불일치
null	IS NULL	NULL인 값
notnull	IS NOT NULL	NULL이 아닌 값
like_prefix / like_head	LIKE '값%'	접두 일치
like_suffix / like_tail	LIKE '%값'	접미 일치
like	LIKE '%값%'	부분 일치
notlike	NOT LIKE '%값%'	부분 일치 제외
notlike_prefix / notlike_head	NOT LIKE '값%'	접두 일치 제외
notlike_suffix / notlike_tail	NOT LIKE '%값'	접미 일치 제외
search	여러 LIKE 조건	검색어를 단어로 분리하여 각각 조건 생성
in	IN	목록에 포함
notin	NOT IN	목록에 포함되지 않음

특히 more는 초과가 아니라 이상, less는 미만이 아니라 이하이다. 이름만 보고 판단하기보다 gte, gt, lte, lt와 대응시켜 확인한다.

3. 조건 작성 예#

다음은 문서 고유값이 지정한 값 이상인 조건이다. column은 실제 테이블 컬럼, var는 쿼리에 전달하는 인자의 이름이다.

<condition operation="gte" column="document_srl" var="start_srl" />

검색어를 포함하는 제목을 찾으려면 다음과 같이 작성한다.

<condition operation="like" column="title" var="keyword" />

이는 조건 요소만을 보여 주는 예제이다. 실제 쿼리는 대상 테이블·컬럼, 쿼리 ID, 인자 및 실행 코드를 함께 구성해야 한다. search는 입력을 여러 단어로 분리하므로 단순 부분 일치인 like와 동일하지 않다.

4. 작성 시 확인#

• null과 notnull은 빈 문자열이나 숫자 0을 검사하는 조건과 다르다.
• in·notin의 입력과 빈 값 처리는 사용 중인 쿼리 파서 및 실제 호출 인자를 확인한다.
• XML 쿼리의 연산자는 사용자에게 임의 SQL을 입력받는 기능이 아니다. 사용자 입력은 쿼리 인자로 전달하고 허용할 검색 조건을 서버에서 제한한다.

5. 같이 보기#

• 라이믹스/매뉴얼/확장 기능 제작
• 라이믹스/매뉴얼/라이믹스 프레임워크 — DB 클래스

6. 출처#

이 문서는 라이믹스 공식 매뉴얼을 바탕으로 설명과 예제를 정리하였다. 공식 매뉴얼은 CC BY-SA 4.0으로 배포된다. 원문의 기여 이력은 rhymix-docs 저장소에서 확인할 수 있다.