레퍼런스노드 레퍼런스액션액션데이터데이터
행 조회
조건에 맞는 행을 검색하여 후속 액션에서 사용합니다.
개요
| 항목 | 내용 |
|---|---|
| 카테고리 | 데이터 |
| 대상 | 데이터모델 |
| 출력 | 조회된 행 목록 |
작업 종류
| 작업 | 설명 |
|---|---|
| 조회 (Query) | 조건에 맞는 데이터 조회 |
| 단건 조회 (Get) | ID로 단일 레코드 조회 |
| 집계 (Aggregate) | 집계 쿼리 실행 (sum, count, avg, min, max 등) |
| 개수 (Count) | 조건에 맞는 레코드 수 |
설정 옵션
| 옵션 | 설명 | 필수 |
|---|---|---|
| 데이터모델 | 조회할 데이터모델 | ✅ |
| 작업 | 조회, 단건 조회, 집계, 개수 | ✅ |
| 필터 조건 | JSON 형식 필터 | |
| 정렬 | 결과 정렬 방식 (- 붙이면 내림차순) | |
| 조회 개수 | 최대 조회 개수 (기본 100, 최대 1000) | |
| 건너뛰기 | 건너뛸 레코드 수 (페이지네이션용) | |
| 조회 필드 | 조회할 필드 (비워두면 전체) | |
| 관계 데이터 포함 | 관계된 데이터모델의 데이터도 함께 조회 |
조건 설정
단일 조건
상태 = "진행중"복합 조건
(상태 = "진행중") AND (담당자 = {{trigger.row.담당자}})날짜 조건
마감일 < {{today}}
생성일 >= {{today - 7일}}관계 조건
고객 = {{trigger.row.고객}}정렬 및 제한
정렬
정렬: 생성일 DESC (최신순)
정렬: 우선순위 ASC, 마감일 ASC제한
제한: 10 (최대 10개)
제한: 1 (첫 번째 행만)출력 데이터
{{actions.query.rows}} // 조회된 행 배열
{{actions.query.rows[0]}} // 첫 번째 행
{{actions.query.rows[0].id}} // 첫 번째 행의 ID
{{actions.query.count}} // 조회된 행 개수활용 예시
관련 데이터 조회
트리거: 고객 행 생성
액션 1: 행 조회
├── 데이터모델: 계약
├── 조건: 고객 = {{trigger.row.id}}
└── 정렬: 계약일 DESC
액션 2: 슬랙 메시지
└── 메시지: "이전 계약 {{actions.query.count}}건"미완료 항목 리마인더
트리거: 일정 (매일 오전 9시)
액션 1: 행 조회
├── 데이터모델: 태스크
├── 조건: 상태 = "진행중" AND 마감일 = {{today}}
액션 2: 반복 ({{actions.query.rows}})
액션 3: 슬랙 메시지 (담당자에게 리마인더)리포트 생성
트리거: 일정 (매주 월요일)
액션 1: 행 조회
├── 데이터모델: 매출
├── 조건: 날짜 >= {{지난주 월요일}} AND 날짜 <= {{지난주 일요일}}
액션 2: 코드 (합계 계산)
└── return { total: rows.reduce((sum, r) => sum + r.금액, 0) }
액션 3: 슬랙 메시지
└── 메시지: "지난주 매출: {{actions.code.total}}원"중복 체크
트리거: 웹훅 (외부 주문)
액션 1: 행 조회
├── 데이터모델: 주문
├── 조건: 외부주문번호 = {{trigger.body.orderId}}
└── 제한: 1
액션 2: 조건 분기
├── If: {{actions.query.count}} = 0
│ └── 행 생성 (새 주문)
└── Else: (이미 존재, 스킵)모범 사례
성능 최적화
- 필요한 조건만 사용하여 결과를 좁히세요
- 제한을 설정하여 불필요한 데이터 로드를 피하세요
- 자주 조회하는 조건은 뷰로 만들어 두세요
결과 없음 처리
조회 결과가 없을 수 있으므로 조건 분기로 처리하세요.
If: {{actions.query.count}} > 0
→ 후속 액션 실행
Else:
→ 대체 액션 또는 종료대량 데이터 주의
조회 결과가 많을 경우 반복(Loop) 액션과 함께 사용하세요.