커스텀 쿼리 실행
이 페이지에서는 커스텀 SQL 쿼리를 실행하는 방법을 설명합니다. 커스텀 쿼리를 실행하려면 다음 개념을 잘 알고 있어야 합니다.
커스텀 쿼리 실행은 커넥터 태스크에서 작업으로 노출됩니다. 조치는 커넥터 인터페이스를 통해 통합에 제공되는 첫 번째 클래스 함수입니다. 조치를 사용하면 항목을 변경할 수 있습니다. 조치는 커넥터마다 다릅니다. 하지만 커넥터가 조치를 지원하지 않을 수 있으며 이 경우 Actions
목록이 비어 있습니다.
다음 커넥터가 커스텀 쿼리를 지원합니다.
- BigQuery
- Cloud SQL - MySQL
- Cloud SQL - PostgreSQL
- Cloud SQL - SQL Server
- Couchbase
- Elasticsearch
- MySQL
- Oracle DB
- PostgreSQL
- Salesforce
- SQL Server
- Snowflake
- Spanner
- Terdata
커스텀 쿼리 만들기
커스텀 쿼리를 만들려면 다음 단계를 수행합니다.
- 자세한 안내에 따라 커넥터 태스크를 추가합니다.
- 커넥터 태스크를 구성할 때 수행할 작업 유형에서 작업을 선택합니다.
- 작업 목록에서 커스텀 쿼리 실행을 선택한 후 완료를 클릭합니다.
- 태스크 입력 섹션을 펼친 후 다음을 수행합니다.
- 다음 이후 시간 초과 필드에 쿼리가 실행될 때까지 대기할 시간(초)을 입력합니다.
기본값:
180
초 - 최대 행 수 필드에 데이터베이스에서 반환될 최대 행 수를 입력합니다.
기본값은
25
입니다. - 커스텀 쿼리를 업데이트하려면 커스텀 스크립트 수정을 클릭합니다. 스크립트 편집기 대화상자가 열립니다.
- 스크립트 편집기 대화상자에서 SQL 쿼리를 입력하고 저장을 클릭합니다.
SQL 문에서 물음표(?)를 사용하여 쿼리 매개변수 목록에 지정해야 하는 단일 매개변수를 나타낼 수 있습니다. 예를 들어 다음 SQL 쿼리는
Employees
테이블에서LastName
열에 지정된 값과 일치하는 모든 행을 선택합니다.SELECT * FROM Employees where LastName=?
- SQL 쿼리에 물음표를 사용한 경우에는 물음표마다 + 매개변수 이름 추가를 클릭하여 매개변수를 추가해야 합니다. 통합을 실행하는 동안 이 매개변수는 SQL 쿼리의 물음표(?)를 순차적으로 대체합니다. 예를 들어 물음표(?) 3개를 추가한 경우 매개변수 3개를 순서대로 추가해야 합니다.
쿼리 매개변수를 추가하려면 다음을 수행합니다.
- 유형 목록에서 매개변수 데이터 유형을 선택합니다.
- 값 필드에 매개변수 값을 입력합니다.
- 여러 매개변수를 추가하려면 + 쿼리 매개변수 추가를 클릭합니다.
- 다음 이후 시간 초과 필드에 쿼리가 실행될 때까지 대기할 시간(초)을 입력합니다.