SQL 편집기

SQL ID 페이지의 SQL 편집 기능에 대해 설명합니다.

1. 기본 SQL

테이블을 선택하여 구문 유형에 맞는 SQL을 생성할 수 있습니다.

테이블 선택
  1. 기본 SQL 버튼을 클릭합니다.

  2. 기본 SQL 대화창에서 사용할 커넥션, 스키마, 테이블 이름 등의 조건을 설정합니다.

  3. 검색 되는 테이블 목록에서 사용할 테이블을 선택합니다.

  4. 생성할 SQL 의 구문 유형을 선택합니다.

  5. OK 버튼을 클릭합니다.

생성된 SQL 을 확인합니다.

SQL 확인

2. Alias

SELECT 구문의 컬럼에 Alias가 지정 되지 않은 경우 자동으로 Alias를 추가할 수 있습니다.

Alias 지정
  1. Alias 버튼을 클릭합니다.

  2. Alias 대화창에서 적용된 내용을 확인하고 OK 버튼을 클릭합니다.

적용된 Alias 를 확인합니다.

Alias 적용 확인

3. 페이징

SELECT 구문의 SQL을 페이징 처리용 SQL로 만들 수 있습니다.

3.1. Top-N

Top-N 방식의 SQL은 페이지 번호와 페이지 당 개수를 입력하여 페이지 단위의 데이터를 수집하는 방식입니다. Top-N 방식은 오라클 등 일부 DBMS만 지원합니다.

Top-N
  1. 페이징 버튼을 클릭합니다.

  2. 페이징 대화창에서 Top-N 을 선택 하고 OK 버튼을 클릭합니다.

생성된 Top-N 방식의 페이징 SQL 확인

작성된 SQL의 위아래로 Top-N 방식의 페이징 처리를 위한 SQL이 추가됩니다.

Top-N 방식의 페이징 SQL 에서는 입력 파라미터로 int 타입의 pageNum, pageCount 가 자동으로 추가됩니다. 기존의 파라미터가 이름이 없는 경우에는 파라미터 이름을 지정해야 합니다. 또한 출력 타입도 List 로 지정되어야 합니다.

3.2. Next Key

Next-Key 방식은 조회 조건 값을 입력하여 일정 건수의 데이터를 수집하는 방식입니다. 어플리케이션에서 직접 Next-Key 정보를 입/출력 타입에 설정해주는 별도의 작업이 필요합니다. Order Key 입력란은 ORDER BY절의 Key 필드들을 입력해야 합니다.

Next Key
  1. 페이징 버튼을 클릭합니다.

  2. 페이징 대화창에서 Next-Key 을 선택 하고 OK 버튼을 클릭합니다.

생성된 Next-Key 방식의 페이징 SQL 확인

작성된 SQL 의 위아래로 Next-Key 방식의 페이징 처리를 위한 SQL 이 추가됩니다.

Next-Key 방식의 페이징 SQL 에서는 입력 파라미터로 사용된 타입이 next 이름으로 자동으로 추가됩니다. 기존의 파라미터가 이름이 없는 경우에는 파라미터 이름을 지정해야 합니다. 또한 출력 타입도 List 로 지정되어야 합니다. 다음 페이지 조회를 위해서는 자동으로 추가된 next 파라미터에 Next-Key 정보를 어플리케이션에서 설정해주는 작업을 해야 합니다.

4. JDBC 타입

작성된 SQL에 포함된 mybatis 바인딩 변수에 JDBC Type 을 일괄 적용/해제 할 수 있습니다.
SQL의 바인딩 변수에 null 값을 전달하기 위해서는 각 변수마다 #{feduEmpNm, jdbcType=VARCHAR} 과 같이 JDBC Type 을 명시해야 합니다. 이러한 JDBC Type을 일괄 적용/해제 할 수 있습니다.

JDBC Type 적용
  1. JDBC 타입 버튼을 클릭합니다.

  2. SQL 에 작성된 바인딩 변수가 대화창에 목록으로 나타납니다.

  3. 버튼을 클릭하여 바인딩 변수에 JDBC Type 을 적용합니다.

    • 선택 항목 적용: 선택된 항목에 대해 JDBC Type을 적용할 수 있습니다.

    • 선택 항목 해제: 선택된 항목에 대해 JDBC Type을 해제할 수 있습니다.

    • 모든 항목 적용: 모든 항목에 대해 JDBC Type을 적용할 수 있습니다.

    • 모든 항목 적용 해제: 모든 항목에 대해 JDBC Type을 해제할 수 있습니다.

  4. OK 버튼을 클릭하면 변경사항이 SQL 에 반영됩니다.

JDBC Type 적용 결과

5. 실행 계획

작성한 SQL의 실행 계획을 확인할 수 있습니다.

실행 계획
  1. 실행 계획 버튼을 클릭합니다.

작성된 SQL의 실행 계획을 실행 계획 뷰어에서 확인할 수 있습니다.

6. SQL→IO

작성한 SQL의 실행 결과로 입출력 IO를 생성할 수 있습니다.

SQL→IO
  1. SQL 을 작성하고 SQL→IO 버튼을 클릭합니다.

SQL→IO
  1. 테스트할 SQL 을 확인합니다. 테스트할 SQL 에 myBatis 에서 사용하는 동적 쿼리가 있는 경우에는 정상적으로 테스트가 되지 않을 수 있습니다.

  2. SQL 테스트 버튼을 클릭하면 SQL 을 테스트할 수 있습니다.

SQL→IO

SQL 에 바인딩 변수가 있는 경우에 바인딩 변수의 타입과 값을 입력하는 대화창이 열립니다. 여기에서 입력하는 값은 SQL ID의 입력으로 사용됩니다.

  1. 바인딩 변수의 타입을 선택합니다.

  2. 바인딩 변수의 값을 입력합니다.

  3. OK 버튼을 클릭합니다.

SQL 바인딩 변수값 입력

대화창에서 아래 옵션을 선택합니다.

  1. 입력 타입을 IO 로 생성할 경우 체크 합니다. 해제된 경우에는 IO 로 생성하지 않습니다.

  2. 입력 IO 의 패키지와 타입의 이름을 지정합니다.

  3. 입력 IO 에 포함할 필드를 체크합니다. 체크된 항목만 필드로 생성됩니다.

  4. 생성한 IO 를 SQL ID 의 입력 타입으로 사용할지 여부를 선택합니다. 해제된 경우에는 IO는 생성 되지만 입력 타입에는 추가되지 않습니다.

  5. 입력 타입의 파라미터 이름이 필요한 경우 이름을 지정합니다.

  6. 출력 타입으로 생성될 IO 의 패키지와 타입의 이름을 지정합니다.

  7. 출력 IO 의 패키지와 타입의 이름을 지정합니다.

  8. Finish 버튼을 클릭하여 완료합니다.

자원 생성

Yes 를 선택하면 생성되는 IO 와 동일한 위치에 자원이 있는 경우 기존의 파일을 덮어 쓰게 됩니다. 덮어쓰지 않으려면 No 를 선택합니다.

입출력 타입 적용 확인

입력/출력에 생성된 IO가 적용된 것을 확인할 수 있습니다.

생성된 IO 확인

생성된 IO 파일을 확인합니다.

7. SQL 테스트

작성한 SQL을 실행하고 결과를 확인할 수 있습니다.

SQL 테스트
Figure 1. SQL 테스트
  1. 입력 파라미터의 테스트 값을 클릭하면 테스트 값을 입력할 수 있습니다.

  2. SQL 테스트 버튼을 클릭하여 테스트를 수행합니다.

SQL 테스트 수행 결과

SQL 테스트 수행 결과 뷰어에서 테스트 결과를 확인합니다.

8. 코드 어시스트

SQL 편집기는 코드 어시스트를 지원 합니다. Ctrl+Space 키를 입력하면 지원되는 코드 어시스트가 목록에 나타납니다.

코드 어시스트

9. 편집기에 마이바티스 바인딩 추가

입력 파라미터를 Drag&Drop 하거나 컨텍스트 메뉴를 통해 SQL 편집기에 바인딩 변수를 추가할 수 있습니다.

  • Drag&Drop 으로 추가하기

    Drag&Drop
    1. 추가할 파라미터 또는 파라미터의 필드를 선택합니다.

    2. 선택한 필드를 마우스로 끌어서 원하는 위치로 이동 합니다.

    3. 원하는 위치에서 마우스를 놓습니다.

      확인

추가된 바인딩 변수를 확인할 수 있습니다.

  • 컨텍스트 메뉴로 추가하기

    컨텍스트 메뉴
    1. 추가할 파라미터 또는 파라미터의 필드를 선택합니다.

    2. 마우스를 오른쪽 클릭하고 편집기에 마이바티스 바인딩 추가 메뉴를 선택합니다.

    3. 하위의 메뉴중 하나를 선택합니다.

      • 이름만. 예시) #{name} : #{name} 형태로 바인딩 변수를 추가합니다.

      • JDBC 타입 포함. 예시) #{name,jdbcType=VARCHAR} : #{name,jdbcType=VARCHAR} 형태로 바인딩 변수를 추가합니다.

        예시 : JDBC 타입 포함. 예시) #{name

        JDBC 타입 포함. 예시) #{name,jdbcType=VARCHAR}로 추가한 경우에는 선택한 필드의 타입과 매핑되는 jdbcType 이 추가됩니다.

IO를 직접 선택하여 추가하는 경우에는 다음처럼 모든 필드가 한번에 추가됩니다.

IO를 바인딩 변수로 추가 하기

10. 변수 치환

SQL 에 작성된 바인딩 변수는 myBatis 에서 사용하는 형태로 #{name} 의 형태를 갖고 있습니다. SqlPlus 나 DBeaver 등의 외부 툴에서 사용하려면 :name 형태로 변경을 해야 합니다. 변수 치환 기능을 사용하면 SQL 을 다른 편집기로 복사할 때 #{name} 형태의 변수가 :name 로 치환됩니다. 반대로 다른 편집기에 작성된 SQL 을 SQL 편집기로 복사할 때는 :name 형태의 변수가 #{name} 으로 치환됩니다.

변수 치환
SWLab Bankware Global
  • 전체
  • BXM
  • BXCM
  • BXCP
  • BXI
제품 선택 시 더 정확한 매뉴얼 가이드를 제공해드립니다.

Copyright© Bankwareglobal All Rights Reserved.