다음을 통해 공유

Eventstream에 KQL 데이터베이스 대상 추가

  • 아티클

이 문서에서는 Microsoft Fabric 이벤트 스트림의 이벤트 스트림에 대상으로 KQL 데이터베이스를 추가하는 방법을 보여 줍니다.

참고 항목

미리 보기에 있는 향상된 기능을 사용하려면 맨 위에 있는 향상된 기능을 선택합니다. 그렇지 않으면 표준 기능을 선택합니다. 미리 보기로 제공되는 향상된 기능에 대한 자세한 내용은 패브릭 이벤트 스트림 소개를 참조 하세요.

필수 조건

  • 기여자 이상의 권한으로 eventstream이 있는 Fabric 프리미엄 작업 영역에 액세스합니다.
  • 기여자 이상의 권한이 있는 Fabric 프리미엄 작업 영역에서만든 KQL 데이터베이스에 액세스합니다.

참고 항목

하나의 Eventstream에 대한 최대 원본 및 대상 수는 11개입니다.

대상으로 KQL 데이터베이스 추가

KQL 데이터베이스를 대상으로 추가하려면 수집 전 직접 수집 또는 이벤트 처리라는 두 가지 수집 모드 중에서 선택할 수 있습니다.

직접 수집 모드

직접 수집 모드는 처리 없이 이벤트 데이터를 KQL 데이터베이스에 직접 수집합니다. 직접 수집 모드를 사용하여 KQL 데이터베이스 대상을 기본 스트림에 추가할 수 있습니다.

Important

기본 스트림에 대해서만 직접 수집을 사용할 수 있습니다. 직접 수집은 처리 연산자 또는 파생 스트림을 따를 수 없습니다. 연산자 또는 파생 스트림을 처리한 후 KQL 데이터베이스 대상을 추가하려면 수집 전에 이벤트 처리를 대신 사용합니다.

  1. 이벤트 스트림에 대한 편집 모드에서 리본에서 대상 추가를 선택하거나 변환 이벤트를 선택하거나 캔버스에 대상 카드 추가한 다음 KQL 데이터베이스를 선택합니다.

    대상 추가 드롭다운 목록에서 KQL 데이터베이스를 선택하는 스크린샷

  2. KQL 데이터베이스 화면에서 직접 수집을 선택합니다.

  3. 선택한 작업 영역에서 대상 이름, 작업 영역 및 KQL 데이터베이스를 입력합니다.

  4. 저장을 선택합니다.

    KQL 데이터베이스 구성 화면의 스크린샷.

  5. 아직 연결되지 않은 경우 새 KQL 데이터베이스 대상 카드 이벤트 스트림의 출력으로 커넥트 다음 게시를 선택합니다.

    게시 단추가 강조 표시된 이벤트 스트림의 스크린샷.

  6. 라이브 보기에서 KQL 데이터베이스 대상 노드에서 구성을 선택합니다.

    KQL 데이터베이스 대상의 구성 단추가 강조 표시된 게시된 Eventstream의 스크린샷.

  7. 데이터 가져오기 화면에서 KQL 데이터베이스가 열립니다. KQL 데이터베이스의 기존 테이블을 선택하거나 새 테이블을 선택하여 데이터를 라우팅하고 수집할 새 테이블을 만듭니다.

  8. 데이터 연결 이름을 제공하거나 제공된 이름을 그대로 유지한 다음, 다음을 선택합니다. Eventstream에서 데이터를 끌어오는 데 몇 분 정도 걸릴 수 있습니다.

    다음 단추가 강조 표시된 KQL 데이터베이스 대상에 대한 데이터 가져오기 화면의 스크린샷

  9. 데이터 검사 화면에서 다음을 수행할 수 있습니다.

    • 형식을 선택하여 데이터가 KQL 데이터베이스로 전송되는 방법을 미리 봅니다.
    • 열 편집을 선택하여 데이터에 대한 열을 구성합니다.
    • 고급을 선택하여 포함할 이벤트를 선택하거나 매핑 옵션을 선택합니다.

    데이터 검사 화면의 데이터 형식 및 고급 옵션을 보여 주는 스크린샷

  10. 열 편집을 선택하는 경우 열 편집 화면에서 다음을 수행할 수 있습니다.

    • 열 추가를 선택하여 열을 추가합니다.
    • 매핑할 원본 열을 선택합니다.
    • 열에 매핑 변환을 적용합니다.
    • 샘플 데이터 값을 변경합니다.

    그런 다음 적용을 선택합니다.

    열 편집 화면의 스크린샷.

  11. 데이터 구성을 마쳤으면 데이터 검사 화면에서 마침을 선택합니다.

  12. 요약 화면에서 정의한 스키마가 있는 테이블과 eventstream과 KQL 데이터베이스 간의 연결을 포함하여 데이터 수집의 세부 정보 및 상태 검토합니다. 닫기를 선택하여 KQL 데이터베이스 설정을 완료합니다.

    닫기 단추가 강조 표시된 요약 화면의 스크린샷

이제 라이브 보기의 캔버스에서 KQL 데이터베이스 대상을 볼 수 있습니다.

라이브 보기에서 구성된 KQL 데이터베이스 대상의 스크린샷.

수집 전 이벤트 처리

수집 모드 이전의 이벤트 처리는 이벤트 데이터를 KQL 데이터베이스에 수집하기 전에 처리합니다. 필터링 또는 집계와 같은 연산자를 적용하여 수집 전 또는 파생 스트림 이후에 데이터를 처리하는 경우 이 모드를 사용합니다.

  1. 이벤트 스트림에 대한 편집 모드에서 연산자 또는 파생 스트림을 마우스로 가리킨 다음, KQL 데이터베이스를 선택합니다+.

    연산자 출력에 대한 + 기호를 선택하고 KQL 데이터베이스를 선택하는 스크린샷

  2. KQL 데이터베이스 화면에서 수집 전 이벤트 처리를 이미 선택해야 합니다. KQL 데이터베이스에 대한 나머지 정보를 완료한 다음 저장을 선택합니다.

    수집 전 이벤트 처리를 위한 KQL 데이터베이스 구성 화면의 스크린샷.

  3. 새로 추가된 KQL 데이터베이스 대상을 구현하려면 게시를 선택합니다.

    KQL 데이터베이스 대상이 추가된 편집 모드의 이벤트 스트림 스크린샷.

이러한 단계를 완료하면 KQL 데이터베이스 대상이 있는 이벤트 스트림을 라이브 보기에서 시각화할 수 있습니다.

라이브 보기에서 구성된 KQL 데이터베이스 이벤트 처리 흐름의 스크린샷.

관련 콘텐츠

Eventstream에 다른 대상을 추가하는 방법을 알아보려면 다음 문서를 참조하세요.

필수 조건

시작하기 전에 다음 필수 구성 요소를 완료해야 합니다.

  • Eventstream이 있는 기여자 이상의 권한이 있는 프리미엄 작업 영역에액세스합니다.
  • KQL 데이터베이스가 있는 기여자 이상의 권한이 있는 프리미엄 작업 영역에액세스합니다.

참고 항목

하나의 Eventstream에 대한 최대 원본 및 대상 수는 11개입니다.

대상으로 KQL 데이터베이스 추가

KQL 데이터베이스를 대상으로 추가하려면 작업 영역에서 KQL 데이터베이스를 만들고 수집 전에 직접 수집 및 이벤트 처리라는 두 가지 수집 모드 중에서 선택해야 합니다.

직접 수집

이 모드는 처리 없이 이벤트 데이터를 KQL 데이터베이스에 직접 수집합니다. 이벤트 데이터를 있는 그대로 수집하고 나중에 KQL 쿼리를 사용하여 KQL 데이터베이스에서 처리 또는 변환을 수행하려는 경우 이 모드를 사용할 수 있습니다.

  1. 리본에서 새 대상을 선택하거나 기본 편집기 캔버스에서 "+"를 선택한 다음, KQL 데이터베이스를 선택합니다. KQL 데이터베이스 대상 구성 화면이 나타납니다.

  2. 직접 수집을 선택하고, 대상 이름을 입력하고, 작업 영역을 선택하고, 선택한 작업 영역에서 KQL 데이터베이스를 선택한 다음, 추가 및 구성을 선택합니다.

    참고 항목

    Eventstream과 지역 패브릭 용량이 동일한 작업 영역만 선택할 수 있습니다.

    KQL 데이터베이스 끌어오기 모드 대상 구성 화면의 스크린샷

  3. 데이터 가져오기 페이지에서 탭을 탐색하여 구성을 완료합니다.

    1. 구성: KQL 데이터베이스의 기존 테이블을 사용하거나 데이터를 라우팅하고 수집할 새 테이블을 만듭니다. 필수 필드를 완료하고 다음을 선택합니다.

      KQL 데이터베이스 대상을 만들기 위한 데이터 수집 화면의 대상 탭을 보여 주는 스크린샷

    2. 검사: 데이터 형식을 선택하고 데이터가 KQL 데이터베이스로 전송되는 방법을 미리 봅니다.

      KQL 데이터베이스 대상을 만들기 위한 수집 데이터 화면의 데이터 형식을 보여 주는 스크린샷

      테이블 머리글의 화살표를 클릭하여 열 이름, 데이터 형식 또는 업데이트 열을 변경할 수도 있습니다. 필수 필드를 완료하고 마침을 선택합니다.

      KQL 데이터베이스 대상을 만들기 위해 수집 데이터 화면의 열을 변경하는 방법을 보여 주는 스크린샷

      KQL 데이터베이스 대상을 만들기 위한 수집 데이터 화면의 열 이름, 데이터 형식 변경을 보여 주는 스크린샷

    3. 요약: 정의한 스키마로 만든 테이블과 eventstream과 KQL 데이터베이스 간의 연결을 포함하여 데이터 수집의 상태 검토합니다.

      KQL 데이터베이스 대상을 만들기 위한 데이터 수집 화면의 요약 탭을 보여 주는 스크린샷

  4. 모든 항목을 구성하고 닫기를 선택하면 KQL 데이터베이스 대상이 캔버스에 나타나고 이벤트 스트림에 연결됩니다.

    새 KQL 데이터베이스 끌어오기 모드 대상을 보여 주는 스크린샷

수집 전 이벤트 처리

이 모드는 이벤트 데이터를 KQL 데이터베이스에 수집하기 전에 처리합니다. 이벤트 데이터를 수집하기 전에 필터링, 집계 또는 확장과 같은 일부 처리 또는 변환을 적용하려는 경우 이 모드를 사용할 수 있습니다. 이벤트 프로세서를 사용하여 처리 논리를 디자인할 수 있습니다.

  1. 수집하기 전에 이벤트 처리를 선택하고, KQL 데이터베이스에 대한 정보를 완료한 다음, 이벤트 프로세서 열기를 선택합니다.

    KQL 데이터베이스 푸시 모드 대상 구성 화면의 스크린샷.

  2. 이벤트 프로세서를 사용하여 이벤트 처리를 디자인한 다음 저장을 선택합니다 .

    푸시 모드 이벤트 프로세서 화면의 스크린샷.

  3. 기존 Kusto 테이블을 선택하면 이 eventstream의 현재 스키마와 대상 KQL 테이블 간의 스키마 유효성 검사가 수행됩니다. 두 스키마가 일치하지 않으면 오류 메시지가 표시되고 이에 따라 이벤트 스트림에서 스키마를 조정하도록 이벤트 프로세서를 열어야 합니다.

    푸시 모드 이벤트 프로세서 오류 화면의 스크린샷.

    이벤트 프로세서를 열면 작성 오류 탭에 자세한 불일치 정보가 표시됩니다.

    푸시 모드 이벤트 프로세서 불일치 정보 화면의 스크린샷.

  4. 모든 항목을 구성하고 저장을 선택하면 KQL 데이터베이스 대상이 캔버스에 표시되고 이벤트 스트림에 연결되며, Data Insights 의 메트릭과 런타임 로그의 로그를 검사 수 있습니다.

    새 KQL 데이터베이스 푸시 모드 대상을 보여 주는 스크린샷

대상 관리

편집/제거: 탐색 창 또는 캔버스를 통해 이벤트 스트림 대상을 편집하거나 제거할 수 있습니다.

편집을 선택하면 편집 창이 기본 편집기의 오른쪽에 열립니다. 이벤트 프로세서 편집기를 통해 이벤트 변환 논리를 포함하여 원하는 대로 구성을 수정할 수 있습니다.

캔버스에서 대상에 대한 수정 및 삭제 옵션을 선택할 위치를 보여 주는 스크린샷

관련 콘텐츠

Eventstream에 다른 대상을 추가하는 방법을 알아보려면 다음 문서를 참조하세요.