콘텐츠로 이동

DB 쓰기

DB 쓰기 스킬은 데이터베이스에 INSERT 또는 UPDATE를 실행합니다. 트랜잭션을 지원하며 배치 INSERT로 대량 데이터를 효율적으로 처리합니다.


설정 방법

1. 스킬 노드 추가 및 선택

스킬 노드를 추가하고 우측 패널에서 DB 쓰기를 선택합니다.

DB 쓰기 스킬 선택

2. Database 인증 연결

인증 탭에서 데이터베이스 인증 정보를 선택합니다. (DB 조회와 동일한 인증 사용 가능)

Database 인증 정보 연결

3. 파라미터 입력

설정 탭에서 작업 타입(insert/update), 테이블명, 데이터를 입력합니다.

DB 쓰기 파라미터 입력 — operation, table, data 설정


파라미터

파라미터 필수 설명
operation O insert 또는 update
table O 대상 테이블명
data O 데이터 (객체 또는 객체 배열)
where UPDATE용 WHERE 조건 (예: id = :id)
where_params WHERE 바인딩 파라미터
batch_size 배치 크기 (기본: 100)
timeout 타임아웃 초 (기본: 30)

인증 정보

Database 인증이 필요합니다. (DB 조회와 동일)


출력

{
  "success": true,
  "data": {
    "affected_rows": 5,
    "operation": "insert",
    "table": "orders"
  }
}

출력 참조

{{ $('skill_1').data_content.result.affected_rows }}  → 영향받은 행 수
{{ $('skill_1').data_content.result.operation }}       → 실행된 작업

사용 예시

단일 행 INSERT

파라미터
operation insert
table orders
data {"customer": "{{ $('trigger').data_content.name }}", "amount": {{ $('trigger').data_content.amount }}}

배치 INSERT (다중 행)

파라미터
operation insert
table logs
data {{ $('skill_filter').data_content.result.filtered }}

UPDATE

파라미터
operation update
table orders
data {"status": "completed"}
where id = :order_id
where_params {"order_id": {{ $('trigger').data_content.id }}}

참고

  • INSERT는 트랜잭션으로 실행되어 오류 발생 시 전체 롤백됩니다.
  • 대량 INSERT 시 batch_size로 배치 처리 크기를 조절할 수 있습니다.
  • 파라미터 바인딩으로 SQL 인젝션을 방지합니다.