KQL 쿼리 세트의 데이터 쿼리

  • 아티클

이 문서에서는 KQL 쿼리 세트를 사용하는 방법을 알아봅니다. KQL 쿼리 세트는 KQL 데이터베이스의 데이터에 대한 쿼리 결과를 실행하고, 보고, 사용자 지정하는 데 사용되는 항목입니다.

KQL 쿼리 세트는 쿼리를 만들기 위해 Kusto 쿼리 언어 사용하며 많은 SQL 함수도 지원합니다. 쿼리 언어에 대한 자세한 내용은 Kusto 쿼리 언어 개요를 참조하세요.

필수 조건

데이터베이스 선택

쿼리는 데이터베이스의 컨텍스트에서 실행됩니다. 언제든지 연결된 데이터베이스를 변경하고 쿼리 편집기에서 저장된 쿼리를 유지할 수 있습니다. KQL 쿼리 세트를 Azure Data Explorer 클러스터의 KQL 데이터베이스 또는 데이터베이스와 연결할 수 있습니다.

원하는 데이터베이스 유형에 해당하는 탭을 선택합니다.

  1. KQL 쿼리 세트를 엽니다.

  2. 데이터베이스에서 V를 선택하여 데이터베이스 연결 메뉴를 확장합니다.

    연결된 데이터베이스 목록을 보여 주는 데이터베이스 메뉴의 스크린샷

  3. 커넥트 원본에서 OneLake 데이터 허브를 선택합니다.

  4. 표시되는 OneLake 데이터 허브 창에서 KQL 데이터베이스를 선택한 다음 선택을 선택합니다.

    선택한 KQL 데이터베이스를 보여 주는 OneLake 데이터 허브 창의 스크린샷

이 데이터베이스와 연결된 테이블 목록이 데이터베이스 이름 아래에 표시됩니다.

쿼리 작성

이제 데이터 원본에 연결되었으므로 이 데이터에 대한 쿼리를 실행할 수 있습니다. KQL 쿼리 세트는 KQL(Kusto 쿼리 언어)을 사용하여 액세스 권한이 있는 데이터베이스의 데이터를 쿼리합니다. KQL에 대한 자세한 내용은 Kusto 쿼리 언어 개요를 참조하세요.

다음 예제에서는 .에서 https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv공개적으로 사용할 수 있는 데이터를 사용합니다.

  1. KQL 쿼리 세트의 위쪽 창에서 쿼리를 작성하거나 복사합니다.

  2. 실행 단추를 선택하거나 Shift Enter 키를+눌러 쿼리를 실행합니다.

    결과 쿼리 출력은 쿼리 창 아래에 표시되는 결과 표에 표시됩니다. 쿼리가 성공적으로 완료되었음을 나타내는 녹색 검사 쿼리 결과를 계산하는 데 사용된 시간을 확인합니다.

    쿼리 결과를 보여 주는 KQL 쿼리 세트의 스크린샷 쿼리와 결과 창이 모두 강조 표시됩니다.

쿼리 세트 탭 관리

KQL 쿼리 세트 내에서 여러 탭을 만들 수 있습니다. 각 탭을 다른 KQL 데이터베이스와 연결할 수 있으며 나중에 사용할 쿼리를 저장하거나 다른 사용자와 공유하여 데이터 탐색을 공동 작업할 수 있습니다. 탭과 연결된 KQL 데이터베이스를 변경하여 다른 상태의 데이터에 대해 동일한 쿼리를 실행할 수도 있습니다.

KQL 쿼리 세트의 탭 편집 옵션 스크린샷

  • 탭 이름 바꾸기: 탭 이름 옆에 있는 연필 아이콘 을 선택합니다.
  • 새 탭 추가: 기존 탭의 오른쪽에 있는 더 + 하기 탭을 선택합니다. 다른 탭을 다른 데이터베이스에 연결할 수 있습니다.
  • 기존 데이터베이스 연결 변경: 데이터베이스에서 기존 데이터베이스 연결을 선택하여 데이터 허브를 엽니다.

쿼리 복사

만든 쿼리를 복사하거나 공유할 수 있습니다.

  1. 쿼리 창의 맨 위에서 홈 탭을 선택합니다.

  2. 쿼리 복사를 선택합니다.

    복사 쿼리 또는 쿼리 결과 옵션의 드롭다운을 보여 주는 KQL 쿼리 세트의 관리 탭 스크린샷

    다음 표에서는 쿼리를 공유하는 방법에 대한 여러 옵션을 간략하게 설명합니다.

    Important

    쿼리 링크를 받는 사용자에게는 쿼리를 실행하고 결과를 보려면 기본 데이터에 대한 보기 권한이 있어야 합니다.

    작업 설명
    쿼리 복사 쿼리 텍스트를 복사합니다.
    클립보드에 링크 쿼리를 실행하는 데 사용할 수 있는 딥 링크를 복사합니다.
    클립보드에 연결 및 쿼리 쿼리 및 쿼리 텍스트를 실행하는 데 사용할 수 있는 링크를 복사합니다.
    클립보드에 연결, 쿼리 및 결과 쿼리, 쿼리 텍스트 및 쿼리 결과를 실행하는 데 사용할 수 있는 링크를 복사합니다.
    결과 복사 쿼리 결과를 복사합니다.

  3. 위의 표에서 원하는 공유 작업을 선택합니다.

  4. Microsoft Word와 같은 모든 편집기에 이 정보를 붙여넣습니다.

쿼리 데이터를 CSV로 내보내기

쿼리 출력을 복사하여 붙여넣는 대신 쿼리 결과를 내보낼 수도 있습니다.

쿼리 결과가 포함된 CSV 파일을 내보내는 일회성 메서드입니다.

  1. 쿼리 창의 맨 위에서 관리 탭을 선택합니다.

    CSV로 결과를 내보내는 강조 표시된 옵션을 보여 주는 KQL 쿼리 세트의 관리 탭 스크린샷

  2. CSV로 결과 내보내기를 선택합니다.

  3. CSV 파일을 로컬로 저장합니다.

KQL 쿼리 세트 삭제

KQL 쿼리 세트를 삭제하려면 다음을 수행합니다.

  1. KQL 쿼리 세트가 연결된 작업 영역을 선택합니다.

  2. 삭제하려는 KQL 쿼리 집합을 마우스로 가리킵니다. [...]를 더 선택한 다음 삭제를 선택합니다.

    KQL 쿼리 세트를 삭제하는 방법을 보여 주는 Microsoft Fabric 작업 영역의 스크린샷

다음 단계

KQL 쿼리 세트 결과 표에서 결과 사용자 지정