ADX 에뮬레이터에서 KQL 테스트

ADX(Azure Data Explorer) 에뮬레이터는 Azure 구독이 필요하지 않은 로컬 환경에서 KQL을 테스트/학습할 수 있는 좋은 방법입니다. 자세한 내용은 here을 참조하십시오.

전제 조건

에뮬레이터는 도커 이미지로 패키징되며 Windows 컨테이너 형식에서만 지원됩니다.

소프트웨어:

도커 클라이언트

호스트 OS:

윈도우 서버 2022

Windows Server 2019 버전 10.0.17763.2928 이상

윈도우 11

하드웨어:

최소 2GB RAM(4GB 이상 사용 권장)

도커 이미지가 상당히 크므로 고속 네트워크/Wi-Fi를 사용하고 디스크 저장 공간이 충분한지 확인하는 것이 좋습니다.

환경 만들기

에뮬레이터 설치

윈도우 서버

docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest

윈도우 11

docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11

컨테이너를 가져와 실행을 시작한 후 상태를 확인합니다.

curl -Method post -ContentType 'application/json' -Body '{"csl":".show cluster"}' http://localhost:8080/v1/rest/mgmt

데이터를 유지할 수 있도록 -v 옵션을 사용하여 로컬 폴더를 컨테이너 이미지에 마운트할 수도 있습니다.

Kusto Explorer 설치 및 연결

1. Kusto Explorer는 Kusto 엔진을 사용하기 위한 GUI 도구입니다. 에서 설치
https://aka.ms/ke

2. 설치가 완료되면 "연결 추가"를 클릭합니다. "고급: 연결 문자열"을 확장하고 Data Source=http://localhost:8080를 입력합니다.

데이터베이스 및 테이블 생성

1. 다음 명령을 실행하여 지정된 경로에 있는 데이터베이스를 생성합니다.

.create database <YourDatabaseName> persist (
  @"c:\kustodata\dbs\<YourDatabaseName>\md",
  @"c:\kustodata\dbs\<YourDatabaseName>\data"
  )

2. .create table 명령을 사용하여 테이블을 생성합니다.

.create table MyIngestedSample(Name:string, Id:int)

3. 데이터를 테이블에 삽입(수집)합니다. 수집하는 방법에는 여러 가지가 있지만 지금은 인라인 수집을 사용합니다.

.ingest inline into table MyIngestedSample <| 
Chibi,1
May, 2
Kuon, 3

쿼리 데이터

이제 ADX와 거의 동일한 Kusto 쿼리를 실행할 수 있습니다.

다음 단계

이제 Kusto Explorer뿐만 아니라 CLI 및 SDK에서도 연결할 수 있는 로컬 ADX 환경이 있으므로 개발에 활용할 수 있습니다.

자세한 내용은 Data Ingestion section 참조

이해하다 limitations