적용 대상: Azure Logic Apps(사용량 + 표준)
자동화된 통합 워크플로우가 DB2 데이터베이스의 리소스를 다뤄야 할 때는 DB2 커넥터를 사용해 데이터베이스에 작업을 수행하세요. 예를 들어, 워크플로우는 테이블이나 행을 나열하고, 행을 추가하고, 행을 업데이트하며, 행을 삭제하고, 쿼리를 실행하고, 저장 프로시저를 실행할 수 있습니다. 이러한 작업은 사용할 워크플로의 다른 작업에 대한 데이터베이스의 데이터를 반환할 수 있습니다.
Azure Logic Apps는 다음과 같은 DB2 커넥터 버전을 제공합니다:
- 관리형 커넥터: Consumption 및 Standard 워크플로에서 사용할 수 있습니다. 온프레미스 DB2 서버의 경우, 이 커넥터는 온프레미스 데이터 게이트웨이가 필요합니다.
- 내장 커넥터: 표준 워크플로우에만 사용 가능. 이 커넥터는 Azure Logic Apps 런타임과 함께 프로세스 내에서 실행되며, 온프레미스 데이터 게이트웨이 없이 TCP/IP를 통해 DB2에 직접 연결됩니다.
두 버전 모두 TCP/IP 네트워크를 통해 원격 DB2 서버와 통신합니다. 두 버전 중 어느 버전이든 사용하여 Azure 가상화에서 실행되는 IBM DB2 for Windows와 같은 클라우드 데이터베이스에 액세스할 수 있습니다.
Important
표준 워크플로우를 사용하는 미션 크리티컬 시스템의 경우, 내장 커넥터를 사용하세요. 내장 커넥터는 추가 게이트웨이 의존성을 피하고, Azure Logic Apps 런타임과 함께 프로세스 내에서 실행되는 성능과 처리량 이점을 제공합니다. 관리 커넥터는 특정 작업이 필요하거나 소비 워크플로우를 사용할 때 사용하세요.
이 가이드는 두 커넥터 버전의 동작과 연결 설정을 설명합니다.
지원되는 플랫폼 및 버전
DB2 커넥터는 DRDA(Distributed Relational Database Architecture) SQLAM(SQL Access Manager) 버전 10 및 11을 지원하는 IBM DB2 호환 제품과 함께 다음 IBM DB2 플랫폼 및 버전을 지원합니다.
| 플랫폼 | 버전 |
|---|---|
| z/OS용 IBM DB2 | 12, 11.1, 10.1 |
| i용 IBM DB2 | 7.4, 7.3, 7.2, 7.1 |
| LUW용 IBM/DB2 | 11.5, 11.1, 10.5 |
커넥터 기술 참조
DB2 커넥터는 로직 앱 유형과 호스트 환경에 따라 다양한 버전이 있습니다.
| 논리 앱 | Environment | 연결 버전 |
|---|---|---|
| 소비 | 다중 테넌트 Azure Logic Apps | 관리되는 커넥터는 공유 필터 아래의 커넥터 갤러리에 표시됩니다. 이 커넥터는 작업만 제공하고 트리거를 제공하지 않습니다. 온프레미스 DB2 서버의 경우, 관리 커넥터는 온프레미스 데이터 게이트웨이가 필요합니다. 자세한 내용은 다음 설명서를 참조하세요. - DB2 관리 커넥터 참조 - Azure Logic Apps의 관리형 커넥터 |
| 표준 | 워크플로 서비스 플랜, App Service Environment v3(Windows 플랜 전용 ASE v3), 그리고 Azure Arc 지원 Kubernetes에서의 하이브리드 배포 |
공유 필터 아래의 커넥터 갤러리에 표시되는 관리형 커넥터 및 기본 제공 커넥터는 기본 제공 필터 아래의 커넥터 갤러리에 표시되고 서비스 공급자 기반입니다. 두 버전 모두 트리거가 아닌 행동만 제공합니다. 미션 크리티컬 작업의 경우, 내장 커넥터를 사용하세요. 이 커넥터는 Azure Logic Apps 런타임과 함께 프로세스 내에서 실행되며, 온프레미스 데이터 게이트웨이 없이 TCP/IP를 통해 DB2에 직접 연결됩니다. 자세한 내용은 다음 설명서를 참조하세요. - DB2 관리 커넥터 참조 - DB2 내장 커넥터 참조 - Azure Logic Apps의 기본 제공 커넥터 |
관리형 커넥터 작업
DB2 관리 커넥터는 다음 데이터베이스 작업을 지원하며, 이는 커넥터 내 해당 동작에 매핑됩니다:
| 데이터베이스 작업 | 커넥터 작업 |
|---|---|
| 데이터베이스 테이블 목록 표시 | 테이블 가져오기 |
| SELECT를 사용하여 단일 행 읽기 | 행 가져오기 |
| SELECT를 사용하여 모든 행 읽기 | 행 가져오기 |
| INSERT를 사용하여 단일 행 추가 | 행 삽입 |
| UPDATE를 사용하여 한 행 편집 | 행 업데이트 |
| DELETE를 사용하여 한 행 제거 | 행 삭제 |
관리 커넥터와 이러한 동작에 대한 자세한 내용은 DB2 관리 커넥터 참고 문서를 참조하세요.
내장 커넥터 연산
DB2 내장 커넥터는 다음과 같은 동작을 지원합니다:
| 조치 | 설명 |
|---|---|
| DB2 테이블 | DB2 스키마에서 테이블을 반환합니다. |
| 행 삭제 | 한 행 이상을 삭제하세요. |
| 저장 프로시저 실행 | 저장 프로시저를 실행하고 출력을 반환합니다. |
| 비조회 실행 | 결과 집합을 반환하지 않는 SQL 문장을 실행하세요. |
| 쿼리 실행 | SQL 쿼리를 실행하고 결과 집합을 반환합니다. |
| 행 삽입 | DB2 테이블에 행을 삽입합니다. |
| 행 업데이트하기 | DB2 테이블의 한 행 이상을 업데이트합니다. |
내장 커넥터와 이러한 동작에 대한 자세한 내용은 DB2 내장 커넥터 참고 자료를 참조하세요.
사전 준비 사항
Azure 계정 및 구독 무료 Azure 계정을 가져옵니다.
IBM DB2 데이터베이스(클라우드 기반 또는 온-프레미스)
DB2 데이터베이스에 액세스하려는 논리 앱 리소스 및 워크플로입니다.
DB2 커넥터는 작업만 제공합니다. 빈 워크플로가 있는 경우 먼저 시나리오에 가장 적합한 트리거를 추가 해야 합니다.
이 가이드의 예제에서는 되풀이 트리거를 사용합니다.
자세한 내용은 다음을 참조하세요.
연결 요구사항은 커넥터 버전에 따라 다릅니다:
관리 커넥터: 온프레미스 DB2 데이터베이스에 연결하려면 먼저 온프레미스 데이터 게이트웨이를 설치하고 설정해야 합니다. DB2 서버가 공개되어 있거나 Azure에서 접근 가능할 때는 게이트웨이가 필요하지 않습니다.
내장 커넥터: 온프레미스 데이터 게이트웨이는 필수가 아닙니다. 표준 로직 앱 호스팅 환경은 DB2 서버와 포트에 대한 네트워크 접근이 필요합니다.
DB2 관리 커넥터 액션 추가하기
다음 예시는 DB2 관리 커넥터를 사용하며 Get tables 작업을 추가하는 방법을 보여줍니다. 표준 워크플로우에서 내장 커넥터를 사용하려면 커넥터 갤러리에서 내장(Built-in)을 선택한 후 DB2 테이블과 같은 내장 동작을 선택하세요.
비고
다른 DB2 작업을 추가하는 단계는 사용자가 제공하는 작업의 매개 변수 및 값을 제외하고 유사합니다.
Azure Portal의 디자이너에서 논리 앱 리소스와 워크플로를 엽니다.
일반 단계에 따라 테이블 가져오기라는 DB2 작업을 추가합니다.
DB2 데이터베이스를 연결하는 세부 정보를 제공할 수 있도록 연결 정보 창이 열립니다.
단계에 따라 클라우드 기반 데이터베이스 또는 온-프레미스 데이터베이스에 대한 연결을 만든 다음, 여기로 돌아와 계속합니다.
연결을 성공적으로 만든 후 테이블 가져오기 작업 정보 창이 나타나고 다른 정보가 필요하지 않음을 보여 줍니다.
워크플로를 계속 테스트하고 출력 테이블을 봅니다.
DB2 관리 커넥터용 연결을 설정하세요
클라우드 또는 온-프레미스 DB2 데이터베이스가 있는지 여부에 따라 단계를 수행합니다. 필요한 연결 세부 정보를 제공한 후 새로 만들기를 선택하고 이전 단계로 돌아갑니다.
온프레미스 데이터베이스에 관리 커넥터 연결을 만들기 전에 반드시 온프레미스 데이터 게이트웨이를 설치하고 설정하세요. 이 게이트웨이 요구사항은 내장 커넥터에는 적용되지 않습니다.
| 속성 | 필수 | 설명 |
|---|---|---|
| 온-프레미스 게이트웨이를 통해 연결 | 아니요 | 온-프레미스 연결에만 적용됩니다. |
| 연결 이름 | 예 | 연결 이름(예: DB2 연결)입니다. |
| 서버 | 예 | 예를 들어, DB2 서버의 주소나 별칭, 포트 번호가 myDB2server.example.com:50000. 참고: 이 값은 IPv4 또는 IPv6 형식의 TCP/IP 주소 또는 별칭을 나타내는 문자열이며, 그 뒤에 콜론과 TCP/IP 포트 번호가 이어집니다. |
| 데이터베이스 | 예 | 데이터베이스의 이름입니다. 참고: 이 값은 DRDA 관계형 데이터베이스 이름(RDBNAM)을 나타내는 문자열입니다: - z/OS용 DB2는 데이터베이스가 z/OS 위치에 대한 IBM DB2 라고 하는 16바이트 문자열을 허용합니다. - i용 DB2는 데이터베이스를 i 관계형 데이터베이스용 IBM DB2 라고 하는 18바이트 문자열을 허용합니다. - LUW용 DB2는 8바이트 문자열을 허용합니다. |
| 사용자 이름 | 예 | 데이터베이스의 사용자 이름입니다. 참고: 이 값은 길이가 특정 데이터베이스에 따라 달라지는 문자열입니다: - z/OS용 DB2에는 8바이트 문자열이 허용됩니다. - i용 DB2에는 10바이트 문자열이 허용됩니다. - Linux 또는 UNIX용 DB2에는 8바이트 문자열이 허용됩니다. - Windows용 DB2는 30바이트 문자열을 허용합니다. |
| 암호 | 예 | 데이터베이스에 대한 암호입니다. |
예를 들어:
DB2 내장 커넥터 연결을 설정하세요
미션 크리티컬 표준 워크플로우의 경우, 내장 커넥터를 사용하세요. 내장 커넥터는 Azure Logic Apps 런타임에서 TCP/IP를 통해 DB2 서버에 직접 연결되며, 온프레미스 데이터 게이트웨이를 사용하지 않습니다. Standard Logic App 호스팅 환경이 DB2 서버와 포트에 네트워크 접근 권한을 갖고 있는지 확인하세요.
워크플로우 디자이너에서 Built-in을 선택하고 원하는 DB2 액션을 선택한 후 연결을 생성하세요. DB2 환경에 적용되는 다음 정보를 제공하세요:
| 속성 | 설명 |
|---|---|
| 연결 이름 | 연결의 이름입니다. |
| 서버 이름 | DB2 서버 이름입니다. |
| 포트 번호 | DB2 서버의 데이터베이스 포트 번호입니다. |
| 데이터베이스 | DB2 서버의 데이터베이스 이름입니다. |
| 사용자 이름 | DB2 서버에 접근하는 사용자 이름입니다. |
| 암호 | DB2 사용자 이름의 비밀번호입니다. |
| 패키지 컬렉션 | 소포 수집. 비어 있으면 사용자 이름이 기본값으로 사용됩니다. |
| 기본 스키마 | 스키마 호출의 기본 스키마는 비어 있으면 사용자 이름이 기본값입니다. |
| 호스트 CCSID | DB2 데이터베이스의 호스트 코딩 문자 집합 식별자(CCSID)는 비어 있으면 기본값이 1208입니다. |
| PC 코드 페이지 | DB2 연결에 대한 PC 코드 페이지는 비어 있으면 기본값이 1208입니다. |
| 추가 연결 문자열 키워드 | 선택적 연결 문자열 키워드, 세미콜론으로 구분됨. |
| 연결 문자열 | DB2 연결 문자열이 비어 있지 않으면 나머지 속성들은 무시됩니다. |
워크플로 테스트 및 출력 테이블 보기
다음 예시는 관리 커넥터의 Get tables 동작에서 나온 출력을 보여줍니다. 내장 커넥터 액션을 사용하는 워크플로우도 같은 방식으로 테스트할 수 있습니다. 워크플로를 수동으로 실행하려면 디자이너 도구 모음의 실행 목록에서 실행을 선택합니다. 워크플로가 완료되면 실행의 출력을 볼 수 있습니다.
실행 세부 정보 페이지가 열리지 않으면 논리 앱에 따라 다음 단계를 수행합니다.
소비: 논리 앱 사이드바의 개발 도구에서 논리 앱 디자이너를 선택합니다.
표준: 워크플로 사이드바에서 실행 기록을 선택합니다.
실행 기록 목록에서 최신 워크플로 실행을 선택합니다. 예를 들면 다음과 같습니다.
소비
표준
실행 세부 정보 페이지에서 워크플로의 각 단계에 대한 상태를 검토합니다. 각 단계에 대한 입력 및 출력을 보려면 해당 단계를 선택합니다. 예를 들면 다음과 같습니다.
JSON에서 입력을 보려면 원시 입력 표시를 선택합니다.
JSON에서 출력을 보려면 원시 출력 표시를 선택합니다.
출력에는 다음과 같은 테이블 목록이 포함됩니다.