DataFlux Func를 통한 연동¶
DataFlux Func는 스크립트 개발 및 실행 플랫폼입니다. 외부 데이터 소스는 배포된 Func 및 해당 커넥터를 통해 데이터에 액세스한 다음, 결과를 Guance에 전달하여 쿼리 및 표시합니다.
이 방식은 Func가 이미 있는 환경에 적합하며, 스크립트 가공, 서드파티 API 호출 또는 사용자 정의 차트 데이터 구조가 필요한 사용 사례에도 적합합니다. QueryHub와 달리 Func의 연결 설정과 스크립트는 Func 플랫폼에서 관리합니다. 기존 Func 데이터 소스는 기존 ID와 쿼리 방식을 계속 사용합니다.
준비 사항¶
- 대상 워크스페이스에 배포 및 연동된 DataFlux Func. 아직 배포하지 않은 경우 Func 빠른 시작을 참고합니다.
- Func가 위치한 환경에서 대상 데이터 소스에 액세스할 수 있어야 하며, 사용하는 계정에 필요한 쿼리 권한이 있어야 합니다.
콘솔에서 데이터 소스 추가¶
- 통합 > 외부 데이터 소스로 이동하여 데이터 소스 추가를 클릭합니다.
- DataFlux Func를 통한 연동을 선택합니다.
- 목록에서 연동된 DataFlux Func를 선택합니다.
- 데이터 소스 유형을 선택한 후 연결 정보를 입력합니다.
| 설정 항목 | 의미 및 입력 방식 |
|---|---|
| DataFlux Func | 대상 데이터 소스 연결을 담당하는 Func 인스턴스로, 네트워크 접근이 가능하고 현재 워크스페이스에 연결된 인스턴스를 선택해야 합니다 |
| 데이터 소스 유형 | 대상 데이터베이스 또는 서비스의 실제 유형이며, 선택 가능한 항목은 선택한 Func의 커넥터 기능에 따릅니다 |
| 데이터 소스 ID | 해당 연동 설정을 식별하는 데 사용됩니다. 페이지 요구 사항에 따라 설정하며, 기존 Func 커넥터를 재사용할 때는 해당 커넥터 ID와 일치시키고 데이터베이스 이름이나 API Key로 대체하지 않습니다 |
| 제목 | 목록 및 쿼리 선택기에서 데이터 소스에 표시되는 이름 |
| 호스트 주소, 포트 | 데이터 소스의 실제 연결 주소로, 데이터베이스 또는 서비스 관리자가 제공합니다. 관리 콘솔 URL은 입력하지 않습니다 |
| 데이터베이스 | 관계형 데이터베이스 연결 시 액세스할 데이터베이스 이름이며 테이블 이름이 아닙니다 |
| 사용자 이름, 비밀번호 | 대상 데이터베이스 또는 서비스의 액세스 자격 증명이며 워크스페이스 로그인 계정이 아닙니다 |
커넥터마다 필드가 다를 수 있습니다. 페이지에 표시된 대로 현재 유형에 필요한 정보를 입력하고, 완료 후 연결을 테스트하고 저장합니다. 작업 권한을 구성할 때는 워크스페이스 및 외부 데이터 소스의 권한 규칙을 따릅니다.
쿼리에서 사용¶
- 메트릭 분석 또는 차트에서 데이터 소스 쿼리를 추가합니다.
- Func를 통해 연동된 데이터 소스를 선택합니다.
- 해당 커넥터에서 지원하는 네이티브 쿼리 문을 입력하고 쿼리를 실행하거나 결과를 새로 고칩니다.
- 반환 구조에 따라 표시 방식을 선택합니다.
예를 들어 MySQL 테이블 orders에 id, total, status가 포함된 경우 결제된 주문을 쿼리할 수 있습니다:
여기서는 선택한 Func 커넥터에서 지원하는 구문을 사용하며, 쿼리 텍스트를 수정하여 QueryHub로 전환하지 않습니다.
스크립트 처리가 필요한 경우¶
직접 쿼리로 요구 사항을 충족할 수 없는 경우 Func에서 해당 유형의 커넥터를 생성하고, 커넥터 ID를 통해 객체를 가져온 뒤 사용자 정의 함수를 작성하여 결과를 처리할 수 있습니다:
여기서 mysql은 Func의 MySQL 커넥터 ID이며, 데이터 소스 유형 이름, 테이블 이름 또는 워크스페이스 ID가 아닙니다.
- 외부 MySQL을 쿼리할 때는 MySQL 유형의 커넥터를 생성하여 사용합니다.
- 스크립트에서 Guance API도 호출해야 하는 경우 필요에 따라 해당 커넥터를 생성하고 워크스페이스 API Key를 구성합니다.
API Key는 관리 > API Key 관리에서 생성할 수 있으며, 자세한 내용은 API Key 관리를 참고합니다. 워크스페이스 API Key를 데이터베이스 비밀번호 필드에 입력하지 마십시오.
전체 단계와 반환 형식은 사용자 정의 쿼리 함수를 참고합니다.
관리 및 유지보수¶
통합 > 외부 데이터 소스에서 데이터 소스 유형, ID, 연결된 Func 및 상태를 확인하고, 권한에 따라 설정을 편집하거나 삭제합니다.
- 기존 데이터 소스의 ID와 쿼리 참조는 기존 규칙을 유지하며, QueryHub 진입점이 추가되어도 자동으로 마이그레이션되지 않습니다.
- 데이터베이스 비밀번호 또는 네트워크가 변경된 후에는 실제 사용 중인 Func 연결 설정을 업데이트하고 쿼리를 다시 검증합니다.
- 연결을 삭제하기 전에 관련 차트 및 스크립트의 참조 관계를 확인합니다. 삭제 후에는 기존 참조가 더 이상 쿼리되지 않을 수 있습니다.
기존 TiDB Cloud Lake 전용 연동은 계속 해당 가이드를 참고하며, Func 커넥터로 변경할 필요가 없습니다.
