다음을 통해 공유


KQL 작업을 사용하여 쿼리 실행

Microsoft Fabric용 Data Factory의 KQL 작업을 사용하면 Azure Data Explorer 인스턴스에 대해 Kusto 쿼리 언어(KQL)에서 쿼리를 실행할 수 있습니다.

필수 조건

시작하려면 다음 필수 조건을 완료해야 합니다.

UI를 사용하여 파이프라인에 KQL 작업 추가

파이프라인에서 KQL 작업을 사용하려면 다음 단계를 완료합니다.

활동 만들기

  1. 작업 영역에서 새 파이프라인을 만듭니다.

  2. 파이프라인 활동 창에서 KQL을 검색하고 이를 선택하여 파이프라인 캔버스에 추가합니다.

    참고 항목

    아래 스크린샷에서 강조 표시된 대로 메뉴를 확장하고 아래로 스크롤하여 KQL 활동을 확인해야 할 수 있습니다.

    Screenshot of the Fabric UI with the Activities pane and KQL activity highlighted.

  3. 아직 선택되지 않은 경우 파이프라인 편집기 캔버스에서 새 KQL 작업을 선택합니다.

    Screenshot showing the General settings tab of the KQL activity.

일반 설정 탭을 구성하려면 일반 설정 지침을 참조하세요.

KQL 활동 설정

  1. 설정 탭을 선택한 다음 데이터 저장소 유형을 선택합니다. 패브릭 작업 영역 내에서 만든 KQL 데이터베이스를 사용하거나 클러스터 URI, 데이터베이스 및 자격 증명을 제공하여 Azure Data Explorer를 사용하여 외부 데이터베이스에 연결할 수 있습니다.

  2. 다음으로, KQL 데이터베이스 연결을 선택합니다. 작업 영역 데이터 저장소를 선택하는 경우 동적 콘텐츠를 사용하여 드롭다운에 표시되는 동적 콘텐츠 추가 옵션을 선택하여 데이터베이스 선택을 매개 변수화할 수 있습니다.

  3. 그런 다음 Command 속성에 대해 선택한 데이터베이스에 대해 실행할 KQL 쿼리를 제공합니다. 텍스트 상자를 선택할 때 표시되는 동적 콘텐츠 추가 링크를 선택하여 쿼리에서 동적 콘텐츠를 사용할 수 있습니다.

    Screenshot showing the Settings tab of the KQL activity highlighting the Command property and showing where its Add dynamic content link appears.

  4. 마지막으로 명령 시간 제한을 지정하거나 기본 시간 제한을 20분으로 유지합니다. 이 속성에도 동적 콘텐츠를 사용할 수 있습니다.

파이프라인 저장 및 실행 또는 예약

KQL 활동은 일반적으로 다른 활동과 함께 사용될 수 있습니다. 파이프라인에 필요한 다른 작업을 구성한 후 파이프라인 편집기 맨 위에 있는 홈 탭으로 전환하고 저장 단추를 선택하여 파이프라인을 저장합니다. 실행을 선택하여 직접 실행하거나 예약을 예약합니다. 여기에서 실행 기록을 보거나 다른 설정을 구성할 수도 있습니다.

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.