다음을 통해 공유


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에 대해 자세히 알아보려면 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 작업 영역의 스크린샷.

다음 단계