연동 및 쿼리

# TiDB Cloud Lake 연결 및 쿼리
---
<!-- markdownlint-disable MD046 -->

**통합 > 외부 데이터 소스**에서 TiDB Cloud Lake를 추가한 후, 메트릭 분석, 대시보드 등 외부 데이터 소스를 지원하는 쿼리 진입점에서 해당 데이터 소스를 선택하고 TiDB Cloud Lake 네이티브 읽기 전용 SQL을 실행할 수 있습니다. 이 연결은 Guance 서버가 TiDB Cloud Lake Driver를 통해 수행하며, DataFlux Func에 의존하지 않습니다.

## 전제 조건

- [Lake DSN 획득](./tidb-cloud-lake-get-dsn.md) 완료
- Lake DSN에 유효한 Database 및 Warehouse 포함
- SQL 사용자에게 대상 데이터에 대한 읽기 전용 쿼리 권한 있음
- 현재 계정에 외부 데이터 소스 구성 권한 있음

## 데이터 소스 추가

1. **통합 > 외부 데이터 소스**로 이동
2. **데이터 소스 추가** 클릭
3. **연결 방식 선택**에서 **TiDB Cloud Lake 직접 연결** 선택
4. 데이터 소스 유형이 읽기 전용 **TiDB Cloud Lake**인지 확인
5. 연결 속성 입력:

| 구성 항목 | 필수 여부 | 설명 |
| --- | --- | --- |
| 이름 | 예 | 외부 데이터 소스 목록 및 쿼리 데이터 소스 선택기에 표시 |
| 설명 | 아니요 | 데이터 범위, 용도 또는 담당자 설명 |
| Lake DSN | 예 | TiDB Cloud Lake Connect 페이지에서 복사한 전체 DSN 붙여넣기 |

TiDB Cloud Lake 직접 연결은 데이터 소스 ID를 입력할 필요가 없습니다. DataFlux Func를 통해 다른 외부 데이터 소스를 연결할 때는 기존 ID 필드와 구성 요구 사항이 그대로 유지됩니다.

위 필드를 완료한 후:

1. **테스트 연결** 클릭 시스템이 DSN, Warehouse, 네트워크 연결 및 SQL 사용자의 쿼리 권한을 확인합니다.
2. **설정 권한**에서 필요에 따라 사용자 정의 작업 권한을 활성화합니다:
    - 비활성화: "외부 데이터 소스" 기본 권한 따름
    - 활성화: 생성자, 관리자 및 지정된 구성원만 해당 데이터 소스를 작업하거나 사용할 수 있음
3. 데이터 소스 저장

???+ warning "연결 정보 보안"

    Lake DSN의 비밀번호는 저장 시에만 암호화되어 전송되며, 목록, 상세 정보 및 쿼리에서 표시되지 않습니다. 쿼리는 서버에서 실행되며, 브라우저는 DSN을 획득하지 않습니다.

## 쿼리에서 사용

다음 단계는 **메트릭 > 메트릭 분석**을 예로 합니다. 대시보드 등 외부 데이터 소스를 지원하는 다른 쿼리 진입점도 동일하게 작동합니다.

1. **메트릭 > 메트릭 분석**으로 이동
2. **데이터 소스 쿼리** 추가
3. 데이터 소스 선택기를 열고 방금 생성한 TiDB Cloud Lake 데이터 소스 선택
4. 데이터 소스 이름 위에 마우스를 올리면 데이터 소스 유형, Database 및 Warehouse 확인 가능
5. 네이티브 읽기 전용 SQL 입력
6. **쿼리 실행** 클릭, 쿼리 결과 확인
7. 필요에 따라 쿼리 결과를 대시보드 또는 기타 지원되는 표시 시나리오에 저장

예:

```sql
SELECT
  service,
  COUNT(*) AS log_count
FROM observability.application
WHERE event_time BETWEEN #{startTime} AND #{endTime}
GROUP BY service
ORDER BY log_count DESC
LIMIT 100;