Azure Portal을 사용하여 Azure Time Series Insights Gen1 환경에 대한 참조 데이터 집합 만들기

이 문서에서는 Azure Time Series Insights 환경에 참조 데이터 집합을 추가하는 방법을 설명합니다. 참조 데이터는 값을 보강하기 위해 원본 데이터에 조인하는 데 유용합니다.

참조 데이터 집합은 이벤트 원본에서 이벤트를 보강하는 항목의 컬렉션입니다. Azure Time Series Insights 인그레스 엔진은 이벤트 원본의 각 이벤트를 참조 데이터 집합의 해당 데이터 행과 조인합니다. 그러면 이 보강된 이벤트를 쿼리에 사용할 수 있습니다. 이 조인은 참조 데이터 집합에 정의된 기본 키 열을 기반으로 합니다.

참조 데이터는 소급하여 조인되지 않습니다. 따라서 현재 및 미래의 수신 데이터만 일치하고 구성되고 업로드된 후 참조 날짜 집합에 조인됩니다.

비디오

Time Series Insight의 참조 데이터 모델에 대해 알아봅니다.

참조 데이터 집합 추가

1. Azure Portal로그인합니다.

2. 기존 Azure Time Series Insights 환경을 찾습니다. Azure portal의 왼쪽 메뉴에서 모든 리소스 을 선택합니다. Azure Time Series Insights 환경을 선택합니다.

3. 개요 페이지를 선택합니다. 페이지 위쪽에 있는 Essentials 섹션을 확장하여 Time Series Insights 탐색기 URL을 찾아 링크를 엽니다.

   

   Azure Time Series Insights 환경에 대한 탐색기를 확인하십시오.

4. Azure Time Series Insights 탐색기에서 환경 선택기를 확장합니다. 활성 환경을 선택합니다. 탐색기 페이지의 오른쪽 위에 있는 참조 데이터 아이콘을 선택합니다.

   추가

5. + 데이터 집합 추가 단추를 선택하여 새 데이터 집합 추가를 시작합니다.

   추가

6. 새 참조 데이터 집합 페이지에서 데이터 형식을 선택합니다.

   • 쉼표로 구분된 데이터를 위해 CSV을 선택하세요. 첫 번째 행은 머리글 행으로 처리됩니다.
   • JavaScript 개체 표기법(JSON) 형식 데이터에 대하여 JSON 배열을 선택합니다.

   

7. 다음 두 가지 방법 중 하나를 사용하여 데이터를 제공합니다.

   • 데이터를 텍스트 편집기에 붙여넣습니다. 그런 다음, 참조 데이터 구문 분석 단추를 선택합니다.
   • 파일 선택 단추를 선택하여 로컬 텍스트 파일에서 데이터를 추가합니다.

   예를 들어 CSV 데이터 붙여넣기: 붙여넣은 CSV 데이터

   예를 들어 JSON 배열 데이터를 붙여넣습니다. 붙여넣기

   데이터 값을 구문 분석하는 동안 오류가 발생하면 페이지 아래쪽에 빨간색으로 표시됩니다(예: CSV parsing error, no rows extracted).

8. 데이터가 성공적으로 구문 분석되면 데이터를 나타내는 열과 행을 표시하는 데이터 표가 표시됩니다. 데이터 그리드를 검토하여 정확성을 확인합니다.

   검토

9. 각 열을 검토하여 가정된 데이터 형식을 이해하고 필요한 경우 데이터 형식을 변경합니다. 열 머리글에서 데이터 형식 기호 선택: 이중(숫자 데이터) , T|부울의 경우 F, 문자열의 경우 Abc .

   

10. 필요한 경우 열 머리글의 이름을 바꿉니다. 키 열 이름은 이벤트 원본의 해당 속성에 조인하는 데 필요합니다.

    중요하다

    참조 데이터 키 열 이름이 대/소문자 구분을 포함하여 들어오는 데이터에 대한 이벤트 이름과 정확히 일치하는지 확인합니다. 키가 아닌 열 이름은 들어오는 데이터를 해당 참조 데이터 값으로 보강하는 데 사용됩니다.

11. 행 필터링... 필드에 값을 입력하여 필요에 따라 특정 행을 검토합니다. 필터는 데이터를 검토하는 데 유용하지만 데이터를 업로드할 때는 적용되지 않습니다.

12. 데이터 그리드 위의 데이터 집합 이름 필드를 입력하여 데이터 집합의 이름을 지정합니다.

    

13. 데이터 그리드 위의 드롭다운을 선택하여 데이터 집합의 기본 키 열을 제공합니다.

    

    (선택 사항)+ 단추를 선택하여 보조 키 열을 복합 기본 키로 추가합니다. 선택을 취소해야 하는 경우 드롭다운에서 빈 값을 선택하여 보조 키를 제거합니다.

14. 데이터를 업로드하려면 행 업로드 버튼을 선택합니다.

    

    이 페이지는 완료된 업로드를 확인하고 데이터 세트성공적으로 업로드된 메시지를 표시합니다.

    경고

    참조 데이터 집합 간에 공유되는 열 또는 속성은 업로드 오류 시 중복 속성 이름 메시지를 표시합니다. 이 오류는 참조 데이터 집합의 성공적인 업로드를 방지하지 않습니다. 중복된 속성 이름을 공유하는 행을 결합하여 제거할 수 있습니다.

15. 행추가, 행 일괄 가져오기, 또는 열 추가하여 필요할 경우 참조 데이터 값을 더 추가합니다.

    

    중요하다

    다른 행과 고유 키를 공유하는 모든 행의 열은 해당 고유 키를 공유하는 가장 마지막으로 추가된 행에 의해 덮어씌워집니다.

    메모

    추가된 행은 직사각형 필요가 없습니다. 참조 데이터 집합의 다른 항목에서 열이 더 적거나, 크거나, 다양할 수 있습니다.

다음 단계

• 프로그래밍 방식으로 참조 데이터 관리합니다.

• 전체 API 참조를 보려면 참조 데이터 API 문서를 참조하세요.