SAP PI/PO JDBC Receiver Adapter에서 SQL Bind Mode 오류 해결 방법

SAP PI/PO 환경에서 JDBC Receiver Adapter의 SQL Bind Mode를 사용할 때 자주 발생하는 에러와 그 원인을 초보자도 이해할 수 있도록 쉽게 설명합니다. 이 글은 “JDBC Adapter Bind Mode 오류”와 관련된 문제 해결을 원하는 분들을 위한 가이드입니다.

---

목차 (Table of Contents)

1. SQL Bind Mode란 무엇인가요?
2. 에러 메시지와 원인 분석
3. SQL Bind Mode에서 기대하는 XML 구조
4. 필드(컬럼) 개수가 다른 경우의 문제점
5. SAP 공식 문서에서 확인된 사실
6. 초보자를 위한 정리와 꿀팁
7. 마무리 및 자주 묻는 질문

---

1. SQL Bind Mode란 무엇인가요?

SQL Bind Mode는 SAP JDBC Receiver Adapter에서 SQL 쿼리를 실행할 때 PreparedStatement 방식으로 쿼리를 처리하는 기능입니다.

쉽게 말하면, 쿼리문을 미리 정의해두고 각 데이터 항목을 “?” 자리에 하나씩 넣는 방식입니다.

이 방식의 장점은 성능 향상과 SQL 인젝션 방지이지만, 구조에 민감하게 작동한다는 단점도 있습니다.

---

2. 에러 메시지와 원인 분석

SQL Bind Mode를 사용할 때 아래와 같은 오류가 발생할 수 있습니다:

java.sql.SQLException: SQL Bind Mode should not be used for this payload.

또는

Column [NAME] does not exist in table [test01]

이런 메시지는 SAP이 전달받은 XML의 구조가 기대한 형식과 다르거나, 컬럼 수가 일관되지 않을 때 발생합니다.

---

3. SQL Bind Mode에서 기대하는 XML 구조

SAP JDBC Adapter는 SQL Bind Mode에서 아래와 같은 형식의 XML을 요구합니다:

<StatementName>
  <dbTableName action="INSERT">
    <table>test01</table>
    <access>
      <ID>1</ID>
      <NAME>John</NAME>
    </access>
    <access>
      <ID>2</ID>
      <NAME>Jane</NAME>
    </access>
  </dbTableName>
</StatementName>

• <access>는 각각 하나의 레코드(row)를 의미합니다.
• 내부에 포함된 필드(ID, NAME)는 모든 access 태그에서 동일해야 합니다.

---

4. 필드(컬럼) 개수가 다른 경우의 문제점

다음과 같이 <access>마다 필드가 다르면 오류가 발생합니다:

<access>
  <ID>1</ID>
</access>
<access>
  <ID>2</ID>
  <NAME>Jane</NAME>
</access>

SAP JDBC Adapter는 첫 번째 <access>만 보고 SQL 구조를 생성합니다. 위 예시에서는 INSERT INTO test01 (ID) VALUES (?) 쿼리가 생성되며, 두 번째 NAME 값은 처리하지 못해 오류가 발생합니다.

요약: 모든 <access>는 동일한 컬럼 구조를 가져야 Bind Mode에서 정상 작동합니다.

 

---

5. SAP 공식 문서에서 확인된 사실

SAP Note 1404778에 따르면 다음과 같은 설명이 나와 있습니다:

"We can use bind variables for those payloads that are similar in modifying/querying the fields. Every action tag for single table has to be exactly similar in modifying/querying column fields..."

 

쉬운 번역:

바인드 변수를 사용하려면 XML 데이터 안에서 모든 레코드가 같은 컬럼을 수정하거나 조회해야 합니다.
비슷해 보여도 컬럼이 하나라도 다르면 바인딩 쿼리는 실패합니다.

---

6. 초보자를 위한 정리와 꿀팁

꿀팁:

• 컬럼이 빠지는 경우에는 빈 태그라도 넣어주세요.

<NAME></NAME>

• 구조가 다양해질 경우에는 sqlBindMode=false로 바꾸고 수동 쿼리 구성하는 게 더 나을 수 있습니다.

---

7. 마무리 및 자주 묻는 질문

Q1. SQL Bind Mode를 꼭 써야 하나요?

아니요. 구조가 유동적인 경우에는 Bind Mode를 끄고 직접 SQL을 구성하는 방식이 더 안정적입니다.

 

Q2. <row>를 사용해야 하나요?

아닙니다. SAP 공식 구조는 <access> 태그를 사용합니다. <row>는 비공식적이거나 커스텀 구조일 수 있습니다.

 

Q3. 어떤 문서에서 이 내용을 확인할 수 있나요?

SAP Help Portal에서 JDBC Adapter 관련 문서 또는 SAP Note 1404778을 참조하세요.

 

---

SAP PI/PO의 JDBC Adapter는 익숙해지면 강력하지만, SQL Bind Mode는 초보자에게 헷갈릴 수 있는 부분입니다. 이 글이 구조를 이해하는 데 도움이 되었길 바랍니다.