다음을 통해 공유


복사 작업에서 KQL 데이터베이스 구성

이 문서에서는 데이터 파이프라인에서 복사 활동을 사용하여 KQL Database에서 데이터를 복사하고 KQL Database로 데이터를 복사하는 방법에 대해 설명합니다.

지원되는 구성

복사 작업 아래의 각 탭을 구성하려면 각각 다음 섹션으로 이동합니다.

일반

일반 탭을 구성하려면 일반으로 이동합니다.

원본

복사 작업의 원본 탭에서 KQL 데이터베이스에 대해 지원되는 속성은 다음과 같습니다.

원본 탭 및 속성 목록을 보여주는 스크린샷.

다음 속성은 필수입니다.

  • 데이터 저장소 유형: 작업 영역을 선택합니다.

  • 작업 영역 데이터 저장소 유형: 데이터 저장소 형식 목록에서 KQL 데이터베이스를 선택합니다.

  • KQL 데이터베이스: 작업 영역에서 기존 KQL 데이터베이스를 선택합니다.

  • 쿼리 사용: 테이블 또는 쿼리 중에 선택합니다.

    • : 드롭다운 목록에서 테이블을 선택하거나 편집을 선택하여 수동으로 입력하여 데이터를 읽습니다.

      테이블을 보여주는 스크린샷.

    • 쿼리: KQL 형식으로 지정된 읽기 전용 요청을 지정합니다. 사용자 지정 KQL 쿼리를 참조로 사용합니다.

      쿼리를 보여주는 스크린샷.

고급에서 다음 필드를 지정할 수 있습니다.

  • 쿼리 시간 제한: 쿼리 요청이 시간 초과되기 전 대기 시간을 지정합니다. 기본값은 10분(00:10:00)입니다. 허용되는 최대값은 1시간(01:00:00)입니다.

  • 잘림 없음: 반환된 결과 집합을 잘라낼지를 나타냅니다. 기본적으로 결과는 500,000개 레코드 또는 64MB 이후에는 잘립니다. 작업의 올바른 동작을 위해 잘라내기를 강력히 권장합니다.

  • 추가 열: 데이터 열을 추가하여 원본 파일의 상대 경로 또는 정적 값을 저장하세요. 식은 정적 값에 대해 지원됩니다. 자세한 내용은 복사하는 동안 추가 열 추가로 이동합니다.

    추가 열을 보여주는 스크린샷.

대상

복사 작업의 대상 탭에서 KQL 데이터베이스에 대해 지원되는 속성은 다음과 같습니다.

대상 탭 정보를 보여주는 스크린샷.

다음 속성은 필수입니다.

  • 데이터 저장소 유형: 작업 영역을 선택합니다.
  • 작업 영역 데이터 저장소 유형: 데이터 저장소 형식 목록에서 KQL 데이터베이스를 선택합니다.
  • KQL 데이터베이스: 작업 영역에서 기존 KQL 데이터베이스를 선택합니다.
  • : 드롭다운 목록에서 테이블을 선택하거나 편집을 선택하여 수동으로 입력하여 데이터를 작성합니다.

고급에서 다음 필드를 지정할 수 있습니다.

  • 수집 매핑 이름: 미리 생성되어 KQL 데이터베이스 대상 테이블에 할당된 매핑의 이름입니다.

  • 추가 속성: KQL 데이터베이스 대상에서 아직 설정하지 않은 수집 속성을 지정하는 데 사용할 수 있는 속성 모음입니다. 특히 수집 태그를 지정하는 데 유용할 수 있습니다. 자세히 알아보려면 Azure Data Explorer 데이터 수집으로 이동합니다.

    추가 속성을 보여주는 스크린샷.

매핑

매핑 탭 구성의 경우 매핑 탭에서 매핑 구성으로 이동합니다.

설정

설정 탭을 구성하려면 설정 탭에서 기타 설정 구성으로 이동합니다.

표 요약

다음 표에는 KQL 데이터베이스의 복사 활동에 대한 자세한 정보가 포함되어 있습니다.

원본 정보

이름 설명 필수 JSON 스크립트 속성
데이터 저장소 유형 데이터 저장소 유형입니다. 작업 영역 /
작업 영역 데이터 저장소 유형 데이터 저장소 형식 목록에서 KQL 데이터베이스를 선택합니다. KQL 데이터베이스 /
KQL 데이터베이스 작업 영역에서 기존 KQL 데이터베이스를 선택합니다. <KQL 데이터베이스> /
쿼리 사용 테이블 또는 쿼리를 선택합니다. 테이블
쿼리
아니요 테이블
쿼리
쿼리 시간 제한 쿼리 요청이 시간 초과되기 전 대기 시간을 지정합니다. 기본값은 10분(00:10:00)입니다. 허용되는 최대값은 1시간(01:00:00)입니다. 시간 범위 아니요 queryTimeout
잘림 없음 반환된 결과 집합을 잘라낼지를 나타냅니다. 기본적으로 결과는 500,000개 레코드 또는 64MB 이후에는 잘립니다. 작업의 올바른 동작을 위해 잘라내기를 강력히 권장합니다. 선택 또는 선택 취소 아니요 noTruncation: true 또는 false
추가 열 데이터 열을 추가하여 원본 파일의 상대 경로 또는 정적 값을 저장하세요. 식은 정적 값에 대해 지원됩니다. 자세한 내용은 복사하는 동안 추가 열 추가에서 확인할 수 있습니다. • 이름
• 값
아니요 additionalColumns:
• 이름
• 값

대상 정보

이름 설명 필수 JSON 스크립트 속성
데이터 저장소 유형 데이터 저장소 유형입니다. 작업 영역 /
작업 영역 데이터 저장소 유형 데이터 저장소 형식 목록에서 KQL 데이터베이스를 선택합니다. KQL 데이터베이스 /
KQL 데이터베이스 작업 영역에서 기존 KQL 데이터베이스를 선택합니다. <KQL 데이터베이스> /
테이블 데이터를 쓸 대상 데이터 테이블입니다. <테이블 이름> 테이블
수집 매핑 이름 미리 생성되어 KQL 데이터베이스 대상 테이블에 할당된 매핑의 이름입니다. <수집 매핑 이름> ingestionMappingName
추가 속성 KQL 데이터베이스 대상에서 이미 설정되어 있지 않은 수집 속성을 지정하는 데 사용할 수 있는 속성 모음입니다. 특히 수집 태그를 지정하는 데 유용할 수 있습니다. Azure Data Explore 데이터 수집에서 자세히 알아보세요. • 이름
• 유형
• 값
additionalProperties