샘플 앱 생성기 마법사를 사용하여 데이터를 수집하고 쿼리하는 코드를 만듭니다.

샘플 앱 생성기 마법사는 기본 프로그래밍 언어로 데이터를 수집하고 쿼리하는 작업 앱을 만들 수 있는 도구입니다. 생성된 코드는 관련 SDK 프레임워크를 참조하며 클러스터 및 데이터에 맞게 조정됩니다. 이 앱은 SDK를 사용하여 인증, 관리 및 수집 및 쿼리 데이터를 사용하여 클러스터에 연결하는 방법을 보여 주는 자체 포함된실행 파일 예제입니다.

생성된 코드를 기준으로 사용하여 고유한 앱을 작성하거나, 코드를 변경하거나, 코드 섹션을 사용자 고유의 앱에 복사할 수 있습니다. 코드에는 팁, 모범 사례, 참조 자료에 대한 링크 및 필요에 맞게 코드를 조정할 때 권장되는 TODO 변경 내용이 포함된 주석이 포함되어 있습니다.

필수 구성 요소

• Microsoft 계정 또는 Microsoft Entra 사용자 ID. Azure 구독이 필요하지 않습니다.
• Azure Data Explorer 클러스터 및 데이터베이스. 클러스터 및 데이터베이스를 만듭니다.
• Azure Data Explorer 웹 UI에 로그인하여 클러스터에 연결을 추가합니다.

참고

공용 액세스(프라이빗 엔드포인트/서비스 엔드포인트로 제한됨) 없이 클러스터와 스토리지 계정 간의 액세스를 사용하도록 설정하려면 관리형 프라이빗 엔드포인트 만들기를 참조하세요.

마법사에 액세스

샘플 앱 생성기 마법사는 수집 프로세스를 안내합니다.

Azure Data Explorer 웹 UI에서 마법사에 액세스하려면 다음을 수행합니다.

1. 왼쪽 창에서 쿼리를 선택합니다.

2. 원하는 테이블을 마우스 오른쪽 단추로 클릭하고샘플 코드생성>을 선택합니다.

   

샘플 앱 생성

이 섹션에서는 마법사의 일반적인 내용을 설명합니다. 선택하는 옵션은 수집하는 데이터 형식, 수집할 데이터 원본의 종류, 새 테이블 또는 기존 테이블에 수집하는지 여부에 따라 달라집니다.

이 마법사는 다음 옵션을 안내합니다.

• 기존 테이블에 수집
• 새 테이블에 수집
• 다음에서 데이터를 수집합니다.
  • Blob Storage
  • 로컬 파일

대상

대상 탭에서 다음을 수행 합니다 .

1. 클러스터 및 데이터베이스를 선택합니다.

2. 기존 테이블 또는 새 테이블을 사용할지 여부를 선택합니다. 기존 테이블의 경우 옵션에서 테이블을 선택합니다. 새 테이블의 경우 테이블에 이름을 지정합니다.

3. 앱의 프로그래밍 언어 를 선택합니다.

   

4. 다음: 원본을 선택합니다.

원본

원본 탭에서:

1. 다음 옵션 중에서 선택 합니다.

   • 쿼리 및 수집: 수집을 위해 데이터를 업로드하고 지정된 데이터의 수집 및 쿼리 모두에 해당하는 코드를 받습니다.
   • 쿼리 전용: 이전 탭에서 선택한 테이블을 쿼리하는 코드를 가져옵니다.

2. 쿼리 및 수집을 선택한 경우 수집할 원본 파일 또는 Blob을 선택합니다.

3. 다음: 스키마를 선택합니다.

스키마

스키마 탭에서 서비스는 필요에 따라 수정할 수 있는 스키마 및 수집 속성을 자동으로 생성합니다. 스키마를 설정하려면 다음을 수행합니다.

1. 자동 생성된 압축 유형을 확인합니다.

2. 수집을 위해 Azure Data Explorer 지원하는 형식에서 데이터 형식을 선택합니다. 형식에 따라 사양이 다릅니다.

3. 부분 데이터 미리 보기 창에서 필요에 따라 스키마를 조정합니다. 이렇게 하려면 열 맨 위에 있는 화살표를 선택하여 데이터 형식 변경, 새 열 만들기, 열 삭제 등의 옵션이 있는 메뉴를 엽니다. 데이터가 Parquet, JSON 또는 Avro 형식인 경우 매핑 변환을 적용할 수 있습니다.

   

4. 다음: 샘플 앱 생성을 선택합니다.

팁

입력에서 생성된 명령을 보고 편집하고 복사하려면 부분 데이터 미리 보기 창 위에서 명령 뷰어를 엽니다.

매핑 변환

Parquet, JSON 및 Avro 데이터 형식은 간단한 수집 시간 변환을 지원합니다. 매핑 변환을 적용하려면 부분 데이터 미리 보기 창에서 열을 만들거나 업데이트합니다.

매핑 변환은 데이터 형식이 int 또는 long인 원본 데이터를 사용하여 문자열 또는 datetime 형식의 열에서 수행할 수 있습니다. 지원되는 매핑 변환은 다음과 같습니다.

• DateTimeFromUnixSeconds
• DateTimeFromUnixMilliseconds
• DateTimeFromUnixMicroseconds
• DateTimeFromUnixNanoseconds

자세한 내용은 매핑 변환을 참조하세요.

Generate

스키마 매핑 및 열 조작을 완료하면 샘플 앱 생성기 마법사가 코드 생성 프로세스를 시작합니다. 코드 생성 후 샘플 앱 프로젝트를 ZIP 파일로 다운로드할 수 있습니다.

선택한 SDK를 사용하여 프로젝트를 실행하기 위한 자세한 지침은 성공적인 생성 시 및 샘플 프로젝트 파일 내에서 제공됩니다. 또한 마법사는 데이터의 초기 탐색을 위해 빠른 쿼리를 사용할 수 있는 옵션을 제공합니다.

참고

빠른 쿼리가 작동하려면 다운로드한 앱을 실행해야 할 수 있습니다.

관련 콘텐츠

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