Kusto 클라이언트 라이브러리를 사용하도록 개발 환경 설정

Kusto 클라이언트 라이브러리를 사용하도록 환경을 설정하는 방법을 알아봅니다. 이러한 라이브러리를 사용하여 클러스터와 연결하고 쿼리를 실행하거나 데이터를 수집하는 앱을 만들 수 있습니다.

이 문서에서는 기본 설정 언어에 대한 클라이언트 라이브러리 패키지를 설치하는 방법을 알아봅니다.

사전 요구 사항

앱을 만드는 데 사용되는 프로그래밍 언어의 필수 구성 요소를 선택합니다.

참고

Kusto 클라이언트 라이브러리는 JavaScript 및 TypeScript와 호환됩니다. TypeScript 예제를 JavaScript로 변환하려면 변수, 매개 변수 및 반환 값에 사용되는 형식 주석을 제거하면 됩니다.

C#

다음 .NET SDK 프레임워크 중 하나 이상:

• .NET SDK 5.0 이상
• .NET Core 2.1 이상
• .NET Standard 2.1 이상
• .NET Framework 4.7.2 이상

설치 확인: 명령 셸에서 를 실행 dotnet sdk check 하여 설치된 버전이 최소 요구 사항을 충족하는지 검사.

Python

• Python 3.7 이상
  • 실행 파일이 에 python 있는지 확인합니다. PATH
  • 설치 확인: 명령 셸에서 를 실행 python --version 하여 버전이 3.7 이상인지 검사.

Typescript

• ES6을 사용하여 빌드된 노드 16 이상

  • 실행 파일이 에 node 있는지 확인합니다. PATH
  • 설치 확인: 명령 셸에서 를 실행 node --version 하여 버전이 3.7 이상인지 검사.

• Node.js 앱 또는 브라우저 기반 웹앱(예: React 앱)

• 브라우저 기반 웹앱의 경우:

  • 앱에 로그인 환경이 있는 경우 @auzre/ID 라이브러리 를 사용하여 권한 부여 토큰을 발급하고 를 사용하여 withTokenProvider Kusto 클라이언트에 이 토큰을 공급할 수 있습니다.

    const tokenProvider =  () => Promise.resolve("someToken")
    KustoConnectionStringBuilder.withTokenProvider(clusterUri, tokenProvider)
    

  • 앱에 로그인 환경이 없거나 Kusto 클라이언트 라이브러리를 사용하여 인증을 프롬프트하려는 경우 필요한 권한으로 애플리케이션 등록을 설정해야 합니다.

    1. Microsoft Entra 애플리케이션 등록을 만듭니다.
    2. 인증 탭에서 + 플랫폼 추가를 선택합니다. 그런 다음 , 단일 페이지 애플리케이션을 선택합니다.
    3. 원하는 리디렉션 URI를 입력하고 액세스 토큰 및 ID 토큰에 대한 상자를 선택한 다음 구성을 선택합니다. 리디렉션 URI에 대한 자세한 내용은 웹 API를 호출하는 데스크톱 앱을 참조하세요.
    4. 애플리케이션에 대한 위임된 권한을 구성합니다.
    5. 애플리케이션에 Azure Data Explorer 데이터베이스에 대한 액세스 권한을 부여합니다.
    6. 개요 탭에서 애플리케이션(클라이언트) ID를 복사합니다.

    다음 자습서의 예제에서는 Kusto 클라이언트 라이브러리를 사용하여 인증을 프롬프트합니다.

    참고

    organization 속하는 경우 organization 구성에 따른 제한으로 인해 인증을 수행할 수 없습니다. organization 관리자에게 액세스를 요청하거나 개인 계정 다시 시도하세요.

Java

• JDK 8 이상
  • 실행 파일이 에 java 있는지 확인합니다. PATH
  • 설치 확인: 명령 셸에서 를 실행 java -version 하여 버전이 8 이상인지 검사.
• Maven 3.6.3 이상
  • 실행 파일이 에 mvn 있는지 확인합니다. PATH
  • 설치 확인: 명령 셸에서 를 실행 mvn -version 하여 버전이 3.6.3 이상인지 검사.

패키지 설치

이 섹션에서는 사용자 환경에 Kusto 클라이언트 라이브러리를 설치하는 단계를 안내합니다.

다음 표에서는 클라이언트 라이브러리 및 해당 패키지 이름을 나열합니다.

라이브러리 이름	Description
Kusto 데이터 라이브러리	클러스터에 연결하기 위한 클라이언트를 제공합니다. 클라이언트 라이브러리를 사용하여 데이터를 쿼리 하거나 관리 명령을 실행합니다.
Kusto 수집 라이브러리	클러스터에 데이터를 수집하기 위한 클라이언트를 제공합니다. 자세한 내용은 클러스터에 데이터 수집을 참조하세요.

원하는 언어에 대한 Kusto 클라이언트 라이브러리를 프로젝트에 추가하거나 언어에 적합한 패키지 관리자를 사용하여 클라이언트 라이브러리를 설치합니다.

C#

dotnet add package Microsoft.Azure.Kusto.Data --version 11.2.2
dotnet add package Microsoft.Azure.Kusto.Ingest --version 11.2.2

Python

python -m pip install azure-kusto-data
python -m pip install azure-kusto-ingest

Typescript

npm install azure-kusto-data
npm install azure-kusto-ingest

Java

앱을 만들 때 다음과 같이 패키지에 maven-archetype-quickstart Maven 템플릿을 사용합니다.

 mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId==my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

그런 다음, pom.xml 다음 종속성을 추가하여 아티팩트 버전을 kusto-data 및 kusto-ingest용 Maven Central에서 사용할 수 있는 최신 버전으로 바꿉니다.

<dependency>
  <groupId>com.microsoft.azure.kusto</groupId>
  <artifactId>kusto-data</artifactId>
  <version>5.0.0</version>
</dependency>
<dependency>
  <groupId>com.microsoft.azure.kusto</groupId>
  <artifactId>kusto-ingest</artifactId>
  <version>5.0.0</version>
</dependency>

또한 pom.xml maven-compiler-plugin 및 exec-maven-plugin 플러그 인을 추가해야 합니다. 아직 없는 경우 다음과 같이 추가합니다.

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>${maven-compiler-plugin.version}</version>
  <configuration>
    <source>${java.version}</source>
    <target>${java.version}</target>
  </configuration>
</plugin>
<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.1.0</version>
</plugin>

Kusto SDK에는 빠른 시작 샘플 애플리케이션이 포함되어 있습니다. 이러한 애플리케이션은 Kusto 클라이언트 라이브러리를 사용하여 데이터를 인증, 관리, 쿼리 및 수집하는 방법을 보여 줍니다. 코드를 수정하거나 특정 섹션을 프로젝트에 통합하여 애플리케이션의 시작점으로 사용할 수 있습니다.

C#

C# 빠른 시작 앱

Python

Python 빠른 시작 앱

Typescript

• Node.js 빠른 시작 앱
• 브라우저 빠른 시작 앱

Java

Java 빠른 시작 앱

클라이언트 라이브러리를 사용하는 앱을 만드는 방법 알아보기

다음 문서에서는 Kusto 클라이언트 라이브러리를 사용하는 앱을 만드는 방법에 대해 설명합니다.

• 첫 번째 앱 만들기
• 기본 쿼리를 실행하는 앱 만들기
• 관리 명령을 실행하는 앱 만들기
• 큐에 대기된 수집을 사용하여 데이터를 가져오는 앱 만들기

관련 콘텐츠

• KQL 빠른 참조
• 샘플 앱 생성기 마법사