Azure MCP Server를 사용하면 자연어 프롬프트를 사용하여 Azure Data Explorer 리소스를 관리할 수 있습니다. 복잡한 KQL(Kusto Query Language) 구문을 기억하지 않고 클러스터를 나열하고, 데이터베이스를 보고, 데이터를 쿼리할 수 있습니다.
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 클러스터 가져오기."
클러스터: 클러스터 세부 정보 가져오기
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 클러스터의 이름입니다. |
데이터베이스: 데이터베이스 나열
Azure MCP Server는 Azure Data Explorer 클러스터의 모든 데이터베이스를 나열할 수 있습니다.
예 프롬프트는 다음과 같습니다.
- 데이터베이스 나열: "내 Azure Data Explorer 클러스터에 모든 데이터베이스 표시."
- 데이터베이스 보기: "내 ADX 클러스터 'analytics-cluster'에 있는 데이터베이스는 무엇인가요?"
- 데이터베이스 확인: "내 데이터 탐색기 클러스터의 모든 데이터베이스 나열."
- 쿼리 데이터베이스: "Azure Data Explorer 클러스터 URI ''https://mycluster.westus.kusto.windows.net에 데이터베이스 표시"
- 데이터베이스 찾기: "내 ADX 인스턴스에서 모든 데이터베이스 가져오기."
매개 변수 | 필수 또는 선택 사항 | 설명 |
---|---|---|
클러스터 URI | 조건부 필요 | Azure Data Explorer 클러스터의 URI입니다. |
클러스터 | 조건부 필요 | Azure Data Explorer 클러스터의 이름입니다. |
표: 테이블 나열
Azure MCP Server는 특정 Azure Data Explorer 데이터베이스의 모든 테이블을 나열할 수 있습니다.
예 프롬프트는 다음과 같습니다.
- 테이블 나열: "내 Azure Data Explorer 클러스터의 '로그' 데이터베이스에 있는 모든 테이블 표시."
- 테이블 보기: "ADX 클러스터의 데이터베이스 '원격 분석'에 있는 테이블은 무엇인가요?"
- 테이블 확인: "Azure Data Explorer 데이터베이스 '분석'의 모든 테이블 나열."
- 쿼리 테이블: "내 데이터 탐색기 클러스터의 '메트릭' 데이터베이스에 테이블 표시."
- 테이블 찾기: "내 Azure Data Explorer 인스턴스의 '이벤트' 데이터베이스에서 모든 테이블 가져오기."
매개 변수 | 필수 또는 선택 사항 | 설명 |
---|---|---|
클러스터 URI | 조건부 필요 | Azure Data Explorer 클러스터의 URI입니다. |
클러스터 | 조건부 필요 | Azure Data Explorer 클러스터의 이름입니다. |
Database | 필수 | Azure Data Explorer 데이터베이스의 이름입니다. |
테이블: 테이블 스키마 가져오기
Azure MCP Server는 Azure Data Explorer 데이터베이스에서 특정 테이블의 스키마를 가져올 수 있습니다.
예 프롬프트는 다음과 같습니다.
- 뷰 스키마: "내 Azure Data Explorer 데이터베이스에서 '이벤트' 테이블의 스키마를 표시합니다."
- 구조 가져오기: "내 ADX 데이터베이스에 '메트릭' 테이블이 있는 열은 무엇인가요?"
- 스키마 확인: "내 데이터 탐색기 데이터베이스의 '로그' 테이블 설명."
- 열 보기: "Azure Data Explorer에서 '원격 분석' 테이블의 열 및 형식 표시."
- 테이블 검사: "내 ADX 데이터베이스에서 'Traces' 테이블의 구조를 가져옵니다."
매개 변수 | 필수 또는 선택 사항 | 설명 |
---|---|---|
클러스터 URI | 조건부 필요 | Azure Data Explorer 클러스터의 URI입니다. |
클러스터 | 조건부 필요 | Azure Data Explorer 클러스터의 이름입니다. |
Database | 필수 | Azure Data Explorer 데이터베이스의 이름입니다. |
테이블 | 필수 | 테이블의 이름입니다. |
데이터베이스: 쿼리 실행
Azure MCP 서버는 Azure Data Explorer 데이터베이스에 대해 KQL 쿼리를 실행할 수 있습니다.
예 프롬프트는 다음과 같습니다.
- 쿼리 실행: "'로그 실행 | where Timestamp > ago(1h) | count' in my Azure Data Explorer 데이터베이스."
- 쿼리 데이터: "KQL 쿼리를 실행하여 내 ADX 데이터베이스에서 지난 24시간 동안의 모든 오류를 찾습니다."
- 데이터 가져오기: "쿼리를 사용하여 내 Data Explorer 데이터베이스에서 최근 이벤트 가져오기."
- 인사이트 추출: "내 Azure Data Explorer 데이터베이스에서 사용자 활동 패턴 쿼리."
- 로그 분석: "KQL을 실행하여 ADX 데이터베이스의 서비스별 성능 메트릭 요약."
매개 변수 | 필수 또는 선택 사항 | 설명 |
---|---|---|
클러스터 URI | 조건부 필요 | Azure Data Explorer 클러스터의 URI입니다. |
클러스터 | 조건부 필요 | Azure Data Explorer 클러스터의 이름입니다. |
Database | 필수 | Azure Data Explorer 데이터베이스의 이름입니다. |
쿼리 | 필수 | 실행할 KQL 쿼리입니다. |
표: 샘플 테이블 데이터
Azure MCP Server는 지정된 Azure Data Explorer 테이블에서 데이터 샘플을 검색할 수 있습니다.
예 프롬프트는 다음과 같습니다.
- 샘플 데이터 가져오기: "내 Azure Data Explorer 데이터베이스의 '이벤트' 테이블에서 데이터 샘플을 표시합니다."
- 미리 보기 테이블: "내 ADX 데이터베이스의 '로그' 테이블에서 레코드 미리 보기를 제공합니다."
- 데이터 예제 보기: "내 데이터 탐색기 데이터베이스에 '메트릭' 테이블의 샘플 행 표시."
- 데이터 형식 확인: "Azure Data Explorer의 '원격 분석' 테이블에서 데이터 구조를 보려면 몇 가지 샘플 레코드를 가져옵니다."
- 데이터 탐색: "내 ADX 클러스터의 'UserActivity' 테이블에서 10개의 샘플 행을 반환합니다."
매개 변수 | 필수 또는 선택 사항 | 설명 |
---|---|---|
클러스터 URI | 조건부 필요 | Azure Data Explorer 클러스터의 URI입니다. |
클러스터 | 조건부 필요 | Azure Data Explorer 클러스터의 이름입니다. |
Database | 필수 | Azure Data Explorer 데이터베이스의 이름입니다. |
테이블 | 필수 | 데이터를 샘플링할 테이블의 이름입니다. |
한도 | 선택적 | 샘플에서 반환할 최대 행 수입니다. |