조회 실행 활동

조회 실행 활동은 런타임 동안 select SQL문을 실행합니다.

조회 실행 활동은 매개변수화된 조회(입력 또는 입력 및 출력 매개변수가 포함되는 조회)를 지원합니다. 조회에 입력 매개변수가 지정되면 런타임에 매개변수값이 제공됩니다. 다음 예제 select 문의 ? 문자는 하나의 입력 매개변수가 있는 것으로 지정합니다.

select * from myUserSchema.mySourceTable where myUserSchema.mySourceTable.myColumn=?

이전 select 문에서 * 문자는 조회 시 mySourceTable 테이블에 있는 하나 이상의 열을 하나 이상의 출력 매개변수로 리턴하는 것으로 지정합니다. 예를 들어, mySource 테이블에 각각 CHAR와 VARCHAR 유형의 두 열이 있는 경우 조회 실행 활동은 각각 CHAR와 VARCHAR 유형의 두 출력 매개변수를 리턴합니다.
주: 조회 실행 활동에는 select SQL문만 지원됩니다. insert SQL문은 조회 실행 활동에서 지원되지 않습니다.

오케스트레이션에서 조회 실행 추가

  1. 오케스트레이션을 작성하거나 여십시오. 오케스트레이션이 그래픽으로 표시됩니다.
  2. 활동 탭을 선택하고 데이터베이스 폴더를 펼치십시오.
  3. 조회 실행 활동을 오케스트레이션에 끌어오십시오.
  4. 조회 실행 활동을 선택하십시오.

데이터베이스 엔드포인트 작성, 선택 또는 편집

  1. 점검 목록에서 엔드포인트 선택 태스크를 클릭하고 다음 조치 중 하나를 선택하십시오.
    • 기존 엔드포인트를 선택하십시오.
      1. 찾아보기를 선택하십시오. 프로젝트 탐색기가 열립니다.
      2. 기존 엔드포인트를 선택하고 확인을 클릭하십시오. 조회 SQL문 지정 프로시저로 건너뛰십시오.
    • 기존 엔드포인트를 선택하고 편집하십시오.
      1. 찾아보기를 선택하십시오. 프로젝트 탐색기가 열립니다.
      2. 기존 엔드포인트를 선택하고 확인을 클릭하십시오.
      3. 편집을 클릭하십시오. 엔드포인트 편집 분할창이 열립니다.
    • 엔드포인트 작성: 새로 작성을 선택하십시오. 엔드포인트 작성 분할창이 열립니다.
  2. 데이터베이스 엔드포인트 작성 또는 편집을 수행하십시오.

조회 SQL문 지정

  1. 점검 목록에서 조회 입력 태스크를 선택하십시오. 조회 입력 분할창이 열립니다.
  2. 분할창에 표시된 공백에 조회를 입력하십시오. 조회 끝에 세미콜론을 사용하지 마십시오.
  3. 열 보기를 클릭하여, 올바른 테이블 이름과 열을 입력하여 SQL문을 빌드하는 데 유용한 선택한 테이블의 열 세부사항을 검토하십시오.
  4. 원하는 인코딩이 데이터베이스의 기본 인코딩과 다른 경우 다음 옵션 중 하나를 사용하여 입력 및 출력 매개변수에 대체 문자 인코딩 설정을 선택하십시오.
    • 인코딩 목록에서 기본 인코딩 유형 중 하나를 선택하십시오.
    • 인코딩 필드를 클릭하여 직접 인코딩 유형을 입력하십시오.
    주: 일부 2바이트 문자는 SHIFT-JIS 인코딩을 사용하여 변환되지 않습니다. 자세한 정보는 Shift-JIS 인코딩 사용을 참조하십시오.
  5. 조회 유효성 검증을 클릭하십시오. 이 조치는 조회가 올바른지 여부를 확인하고 입력 맵핑출력 맵핑 태스크에 입력 및 출력 매개변수를 채웁니다.
  6. MaxRows 필드에 값을 입력하십시오. MaxRows 필드는 런타임 동안 조회에서 리턴할 최대 행 수를 지정합니다.
주: 동일한 데이터에 대해 동일한 조회가 여러 번 시작되면 동일한 행 세트가 리턴됩니다. 예를 들어, MaxRows가 1이면 조회가 시작될 때마다 항상 동일한 행(첫 번째 행)이 리턴되며 행 세트를 반복하지 않습니다.

조회에 대한 입력 매개변수 구성

  1. 점검 목록에서 설정 입력 매개변수 태스크를 선택하십시오. 설정 입력 매개변수 분할창에 조회의 하나 이상의 입력 매개변수가 표시됩니다.
  2. 열 보기를 클릭하여, 올바른 테이블 이름과 열을 입력하여 SQL문을 빌드하는 데 유용한 선택한 테이블의 열 세부사항을 검토하십시오.
  3. 열의 표제를 클릭하여 열 값으로 행을 정렬하십시오. 예를 들어, 행을 열 이름으로 정렬하려면 열의 열 이름 표제를 클릭하십시오. 열 헤더 이름 오른쪽에 화살표가 표시됩니다. 위로 화살표는 열이 a부터 시작하여 z까지 영문자 순서로 정렬됨을 의미합니다. 아래로 화살표는 열이 z부터 시작하여 a까지 영문자 반대 순서로 정렬됨을 의미합니다. 화살표를 클릭하면 영문자 순서가 바뀝니다.
  4. 필요한 경우, 각 조회 입력 매개변수의 데이터 유형, 인코딩 또는 널 입력 가능 값에 대한 설정을 변경하십시오. 새로 선택하려면 필드를 클릭하십시오.
    • 매개변수 이름 - 기본 이름을 보다 의미 있는 이름으로 변경할 수 있습니다. 매개변수는 조회에 지정된 순서대로 나열됩니다.
    • 데이터 유형 - 이 매개변수의 데이터 유형을 선택하십시오.
      주: (MONEY 및 XMLTYPE 데이터 유형의 경우) Oracle 데이터베이스의 XMLTYPE 데이터 유형과 SQL Server 데이터베이스의 MONEY 데이터 유형의 경우에는 Studio가 올바른 데이터 유형을 자동으로 연관시키지 않으므로 적합한 데이터 유형을 수동으로 선택해야 합니다.
    • 인코딩 - 필요한 인코딩이 데이터베이스의 기본 인코딩과 다른 경우에는 매개변수에 대체 문자 인코딩 설정을 선택하십시오.
    • 크기 - 테이블에 정의된 열의 크기입니다. 이 크기는 데이터베이스 테이블에서 검색하며 구성할 수 없습니다.
  5. 값 재설정을 클릭하여 데이터베이스를 검색하고 데이터베이스에서 데이터 유형 및 크기를 가져오십시오. 이렇게 하면 분할창에서 수동으로 설정된 데이터 유형 및 크기가 대체됩니다.

출력 매개변수 구성

  1. 점검 목록에서 결과 세트 설정 태스크를 선택하십시오. 결과 세트 설정 분할창이 열리고 조회의 하나 이상의 출력 매개변수의 기본값이 나열됩니다.
  2. 열 보기를 클릭하여, 올바른 테이블 이름과 열을 입력하여 SQL문을 빌드하는 데 유용한 선택한 테이블의 열 세부사항을 검토하십시오.
  3. 필요한 경우, 각 조회 출력 매개변수의 데이터 유형, 인코딩 또는 널 입력 가능 값에 대한 설정을 변경하십시오.
    • 매개변수 이름 - 기본 이름을 보다 의미 있는 이름으로 변경할 수 있습니다. 매개변수는 조회에 지정된 순서대로 나열됩니다.
    • 데이터 유형 - 이 매개변수의 데이터 유형을 선택하십시오.
    • 인코딩 - 필요한 인코딩이 데이터베이스의 기본 인코딩과 다른 경우에는 매개변수의 대체 문자 인코딩 설정을 선택하십시오.
    • 크기 - 테이블에 정의된 열의 크기입니다. 이 크기는 데이터베이스 테이블에서 검색하며 구성할 수 없습니다.
  4. 값 재설정을 클릭하여 데이터베이스를 검색하고 데이터베이스에서 데이터 유형 및 크기를 가져오십시오. 이렇게 하면 분할창에서 수동으로 설정된 데이터 유형 및 크기가 대체됩니다.

조회에 대한 재시도 옵션 지정

조회에 대한 재시도 옵션을 지정하려면 다음을 수행하십시오.
  1. 재시도 옵션을 구성하십시오.
    주: 데이터베이스 조회 실행 활동의 경우, 재시도 옵션을 0으로 설정하면 통합 어플라이언스가 연결을 무한정 재시도합니다.

활동의 입력 맵핑

  1. 점검 목록에서 입력 맵핑 태스크를 선택하십시오. 조회에 지정된 입력 매개변수는 활동의 입력 매개변수입니다. 활동의 입력 매개변수는 활동으로 분할창에서 매개변수 요소 아래에 표시됩니다.
  2. 활동의 모든 입력 매개변수를 맵핑해야 합니다. 맵핑에 대한 지시사항은 맵핑 작성을 참조하십시오.

활동의 출력 맵핑

  1. 점검 목록에서 출력 맵핑 태스크를 선택하십시오. select문으로 리턴되는 열은 활동에서 분할창에서 rows/row 요소 아래에 표시되는 요소입니다.
  2. 활동의 출력 매개변수는 맵핑하지 않아도 됩니다. 맵핑에 대한 지시사항은 맵핑 작성을 참조하십시오.