Azure MCP Server를 사용하면 자연어 프롬프트를 사용하여 Azure Data Explorer 리소스를 관리할 수 있습니다. 클러스터를 나열하고, 데이터베이스를 보고, 자연어를 사용하여 데이터를 쿼리할 수 있습니다. 대상 응답에 특정 KQL 쿼리를 사용할 수도 있습니다.
Azure Data Explorer 는 애플리케이션, 웹 사이트, IoT 디바이스 등에서 대량의 데이터 스트리밍에 대한 실시간 분석을 위한 빠르고 완전히 관리되는 데이터 분석 서비스입니다. Azure Data Explorer를 사용하면 웹 사이트, 애플리케이션, IoT 디바이스 등과 같은 모든 데이터 원본에서 대량의 다양한 데이터를 분석할 수 있습니다.
비고
도구 매개 변수: Azure MCP Server 도구는 작업을 완료하는 데 필요한 데이터에 대한 매개 변수를 정의합니다. 이러한 매개 변수 중 일부는 각 도구와 관련이 있으며 아래에 설명되어 있습니다. 다른 매개 변수는 전역이며 모든 도구에서 공유됩니다. 자세한 내용은 도구 매개 변수를 참조하세요.
조건부 매개 변수
일부 Azure Data Explorer 도구에는 대화 컨텍스트 내에서 다음 매개 변수 집합 중 하나가 필요합니다.
- 옵션 1: 클러스터 URI
- 옵션 2: 클러스터 이름 및 구독 모두
충돌하는 입력이 생성되므로 세 매개 변수(클러스터 URI, 클러스터 이름 및 구독)를 모두 함께 제공하지 마세요.
클러스터: 클러스터 나열
Azure MCP Server는 구독의 모든 Azure Data Explorer 클러스터를 나열합니다.
예 프롬프트는 다음과 같습니다.
- 클러스터 나열: "내 구독에 있는 모든 Azure Data Explorer 클러스터 표시."
- 클러스터 보기: "사용 가능한 Azure Data Explorer 클러스터는 무엇인가요?"
- 클러스터 확인: "모든 Azure Data Explorer 클러스터 나열."
- 쿼리 클러스터: "내 Azure Data Explorer 클러스터 조직 표시."
- 클러스터 찾기: "내 Azure 구독에서 모든 ADX 클러스터 가져오기."
파괴: ❌ | Idempotent: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌
클러스터: 클러스터 세부 정보 가져오기
Azure MCP Server는 특정 Azure Data Explorer 클러스터에 대한 세부 정보를 가져옵니다.
예 프롬프트는 다음과 같습니다.
- 세부 정보 가져오기: "내 Azure Data Explorer 클러스터 'analytics-cluster'에 대한 세부 정보를 표시합니다."
- 클러스터 보기: "내 ADX 클러스터 'logs-prod'에 대한 정보를 제공합니다."
- 클러스터 정보: "Azure Data Explorer 클러스터 'data-explorer-dev'의 세부 정보는 무엇인가요?"
- 구성 확인: "내 ADX 클러스터 '원격 분석 클러스터'의 구성 세부 정보를 가져옵니다."
- 클러스터 속성: "구독 'my-sub'에 내 Azure Data Explorer 클러스터의 속성을 표시합니다."
| 매개 변수 | 필수 또는 선택 사항 | 설명 |
|---|---|---|
| 클러스터 | 필수 | Azure Data Explorer 클러스터의 이름입니다. |
파괴: ❌ | Idempotent: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌
데이터베이스: 데이터베이스 나열
Azure MCP Server는 Azure Data Explorer 클러스터의 모든 데이터베이스를 나열합니다.
예 프롬프트는 다음과 같습니다.
- 데이터베이스 나열: "Azure Data Explorer 클러스터 'analytics-cluster'에서 모든 데이터베이스를 표시합니다."
- 데이터베이스 보기: "내 ADX 클러스터 'analytics-cluster'에 있는 데이터베이스는 무엇인가요?"
- 데이터베이스 확인: "Data Explorer 클러스터 'analytics-cluster'의 모든 데이터베이스 나열."
- 쿼리 데이터베이스: "Azure Data Explorer 클러스터 URI ''https://mycluster.westus.kusto.windows.net에 데이터베이스 표시"
- 데이터베이스 찾기: "ADX 클러스터 'analytics-cluster'에서 모든 데이터베이스 가져오기."
| 매개 변수 | 필수 또는 선택 사항 | 설명 |
|---|---|---|
| 클러스터 URI | 조건부 필요 | Azure Data Explorer 클러스터의 URI입니다. |
| 클러스터 | 조건부 필요 | Azure Data Explorer 클러스터의 이름입니다. |
파괴: ❌ | Idempotent: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌
표: 테이블 나열
Azure MCP Server는 특정 Azure Data Explorer 데이터베이스의 모든 테이블을 나열합니다.
예 프롬프트는 다음과 같습니다.
- 테이블 나열: "Azure Data Explorer 클러스터 'analytics-cluster'의 'logs' 데이터베이스에 있는 모든 테이블 표시."
- 테이블 보기: "ADX 클러스터 'analytics-cluster'의 데이터베이스 '원격 분석'에 있는 테이블은 무엇인가요?"
- 테이블 확인: "클러스터 'analytics-cluster'의 Azure Data Explorer 데이터베이스 '분석'에 있는 모든 테이블 나열."
- 쿼리 테이블: "Data Explorer 클러스터 'analytics-cluster'의 '메트릭' 데이터베이스에 테이블 표시."
- 테이블 찾기: "Azure Data Explorer 클러스터 'analytics-cluster'의 '이벤트' 데이터베이스에서 모든 테이블 가져오기."
| 매개 변수 | 필수 또는 선택 사항 | 설명 |
|---|---|---|
| 클러스터 URI | 조건부 필요 | Azure Data Explorer 클러스터의 URI입니다. |
| 클러스터 | 조건부 필요 | Azure Data Explorer 클러스터의 이름입니다. |
| Database | 필수 | Azure Data Explorer 데이터베이스의 이름입니다. |
파괴: ❌ | Idempotent: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌
테이블: 테이블 스키마 가져오기
Azure MCP Server는 Azure Data Explorer 데이터베이스에서 특정 테이블의 스키마를 가져옵니다.
예 프롬프트는 다음과 같습니다.
- 뷰 스키마: "Azure Data Explorer 클러스터 'analytics-cluster'의 데이터베이스 'logs'에서 '이벤트' 테이블의 스키마를 표시합니다."
- 구조 가져오기: "ADX 클러스터 'analytics-cluster'의 데이터베이스 '원격 분석'에 '메트릭' 테이블이 있는 열은 무엇인가요?"
- 스키마 확인: "데이터 탐색기 클러스터 'analytics-cluster'의 데이터베이스 'logs'에서 '로그' 테이블을 설명합니다."
- 열 보기: "Azure Data Explorer 클러스터 'analytics-cluster'의 데이터베이스 'telemetry' 테이블에서 열 및 형식을 표시합니다."
- 검사 테이블: "ADX 클러스터 'analytics-cluster'의 데이터베이스 'logs'에서 'Traces' 테이블의 구조를 가져옵니다."
| 매개 변수 | 필수 또는 선택 사항 | 설명 |
|---|---|---|
| 클러스터 URI | 조건부 필요 | Azure Data Explorer 클러스터의 URI입니다. |
| 클러스터 | 조건부 필요 | Azure Data Explorer 클러스터의 이름입니다. |
| Database | 필수 | Azure Data Explorer 데이터베이스의 이름입니다. |
| 테이블 | 필수 | 테이블의 이름입니다. |
파괴: ❌ | Idempotent: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌
샘플 데이터
Azure MCP Server는 지정된 Azure Data Explorer 테이블에서 데이터 샘플을 검색합니다.
예 프롬프트는 다음과 같습니다.
- 샘플 데이터 가져오기: "Azure Data Explorer 클러스터 'analytics-cluster'의 데이터베이스 '로그'에 있는 '이벤트' 테이블의 데이터 샘플을 표시합니다."
- 미리 보기 테이블: "ADX 클러스터 'analytics-cluster'의 데이터베이스 'logs'에 있는 '로그' 테이블의 레코드 미리 보기를 제공합니다."
- 데이터 예제 보기: "데이터 탐색기 클러스터 'analytics-cluster'의 데이터베이스 '원격 분석'에 '메트릭' 테이블의 샘플 행 표시."
- 데이터 형식 확인: "Azure Data Explorer 클러스터 'analytics-cluster'의 데이터베이스 '원격 분석'에 있는 '원격 분석' 테이블에서 몇 가지 샘플 레코드를 가져와 데이터 구조를 확인합니다."
- 데이터 탐색: "ADX 클러스터 'analytics-cluster'의 데이터베이스 '로그'에 있는 'UserActivity' 테이블에서 10개의 샘플 행을 반환합니다."
| 매개 변수 | 필수 또는 선택 사항 | 설명 |
|---|---|---|
| 클러스터 URI | 조건부 필요 | Azure Data Explorer 클러스터의 URI입니다. |
| 클러스터 | 조건부 필요 | Azure Data Explorer 클러스터의 이름입니다. |
| Database | 필수 | Azure Data Explorer 데이터베이스의 이름입니다. |
| 테이블 | 필수 | 데이터를 샘플링할 테이블의 이름입니다. |
| 한도 | 선택적 | 샘플에서 반환할 최대 행 수입니다. |
파괴: ❌ | Idempotent: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌
Query
Azure MCP 서버는 Azure Data Explorer 데이터베이스에 대해 KQL 쿼리를 실행합니다.
예 프롬프트는 다음과 같습니다.
- 쿼리 실행: "'Logs | where Timestamp > ago(1h) | count' 실행은 Azure Data Explorer 클러스터 'analytics-cluster'의 'logs' 데이터베이스에서 수행됩니다."
- 쿼리 데이터: "KQL 쿼리 'Logs | where Level == "Error" and Timestamp > ago(24h)'를 실행하여 ADX 클러스터 'analytics-cluster'의 데이터베이스 'logs'에서 지난 24시간 동안의 모든 오류를 찾습니다."
- 데이터 가져오기: "쿼리 'Events | take 100'를 사용하여 Data Explorer 클러스터 'analytics-cluster'의 데이터베이스 'logs'에서 최근 이벤트를 가져옵니다."
- 인사이트 추출: 'analytics-cluster' Azure Data Explorer 클러스터의 데이터베이스 'logs'에서 'UserActivity | summarize count() by UserId'를 사용하여 사용자 활동 패턴을 쿼리합니다.
- 로그 분석: "KQL 'Metrics | summarize avg(Duration) by Service' 쿼리를 실행하여 ADX 클러스터 'analytics-cluster'의 데이터베이스 'telemetry'에서 서비스별 성능 메트릭을 요약하십시오."
| 매개 변수 | 필수 또는 선택 사항 | 설명 |
|---|---|---|
| 클러스터 URI | 조건부 필요 | Azure Data Explorer 클러스터의 URI입니다. |
| 클러스터 | 조건부 필요 | Azure Data Explorer 클러스터의 이름입니다. |
| Database | 필수 | Azure Data Explorer 데이터베이스의 이름입니다. |
| 쿼리 | 필수 | 실행할 KQL 쿼리입니다. |
파괴: ❌ | Idempotent: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌