시계열 ID 선택 모범 사례

  • 아티클

참고

TSI(Time Series Insights) 서비스는 2025년 3월 이후에 더 이상 지원되지 않습니다. 가능한 한 빨리 기존 TSI 환경을 대체 솔루션으로 마이그레이션하는 것을 고려합니다. 사용 중단 및 마이그레이션에 대한 자세한 내용은 설명서를 참조하세요.

이 문서에서는 Azure Time Series Insights Gen2 환경에 대한 시계열 ID의 중요도와 이를 선택하는 모범 사례를 요약합니다.

시계열 ID 선택

적절한 시계열 ID 선택이 중요합니다. 시계열 ID 선택은 데이터베이스에 대한 파티션 키를 선택하는 것과 같습니다. Azure Time Series Insights Gen2 환경을 만들 때 필요합니다.

시계열 ID에 대한 자세한 설명은 환경 프로비저닝 자습서를 시청하세요. 두 가지 JSON 원격 분석 페이로드 예제와 각 페이로드에 대한 올바른 시계열 ID 선택을 볼 수 있습니다.

중요

시계열 ID는 다음과 같습니다.

  • 대/소문자를 구분하는 문자열 속성: 글자 및 문자 대/소문자는 검색, 비교, 업데이트 및 분할 시 사용됩니다.
  • 변경이 불가능한 속성: 만든 후에는 변경할 수 없습니다.

팁

이벤트 원본이 IoT 허브인 경우 Time Series ID는 iothub-connection-device-id일 수 있습니다. IoT 플러그 앤 플레이 디바이스 모델을 사용하거나 구성 요소 없이 사용하려는 경우 나중에 필요할 때를 대비해서 dt-subject를 복합 키의 일부로 포함해야 합니다.

주요 모범 사례는 다음과 같습니다.

  • 고유한 값이 많은(수백 개 또는 수천 개) 파티션 키를 사용하면 좋습니다. 많은 경우 JSON의 디바이스 ID, 센서 ID 또는 태그 ID일 수 있습니다.
  • 시계열 ID는 시계열 모델의 리프 노드 수준에서 고유해야 합니다.
  • 시계열 ID의 속성 이름 문자열의 문자 수 제한은 128자입니다. 시계열 ID의 속성 값에 대한 문자 수 제한은 1,024자입니다.
  • 시계열 ID의 고유한 속성 값이 누락된 경우 Null 값으로 처리되고 고유성 제약 조건의 동일한 규칙을 따릅니다.
  • 시계열 ID가 복잡한 JSON 개체 내에 중첩된 경우 속성 이름을 작성할 때 수신 평면화 규칙을 따라야 합니다. 예제 B를 확인해 보세요.
  • 또한 최대 3개의 키 속성을 시계열 ID로 선택할 수 있습니다. 해당 조합은 시계열 ID를 나타내는 복합 키가 됩니다.

    참고

    3개의 키 속성은 문자열이어야 합니다. 한 번에 하나의 속성 대신 이 복합 키에 쿼리해야 합니다.

키 속성을 두 개 이상 선택

다음 시나리오에서는 둘 이상의 키 속성을 시계열 ID로 선택하는 방법을 설명합니다.

예제 1: 고유 키가 있는 시계열 ID

  • 레거시 자산 집합이 있습니다. 각 집합에는 고유한 키가 있습니다.
  • 한 집합은 deviceId 속성에 의해 고유하게 식별됩니다. 다른 집합의 고유 속성은 objectId입니다. 두 집합 모두, 다른 집합의 고유 속성은 없습니다. 이 예제에서는 두 개의 키인 deviceId와 objectId를 고유 키로 선택합니다.
  • Null 값이 허용되며, 이벤트 페이로드에 속성이 없을 경우 Null 값으로 산출됩니다. 이는 각 이벤트 원본의 데이터에 고유한 시계열 ID가 있는 두 개의 이벤트 원본에 대한 데이터 전송을 처리하는 적절한 방법이기도 합니다.

예제 2: 복합 키가 있는 시계열 ID

  • 동일한 자산 집합 내에서 여러 속성이 고유해야 합니다.
  • 스마트 건물의 제조업체가 모든 방에 센서를 배포한다고 가정합니다. 일반적으로 각 방의 sensorId 값은 동일합니다. 예를 들자면 sensor1, sensor2, sensor3가 있습니다.
  • 또한 빌딩의 flrRm 속성에는 사이트 간에 겹치는 층 및 방 번호가 있습니다. 해당 숫자에는 1a, 2b, 3a와 같은 값이 있습니다.
  • Redmond, Barcelona, Tokyo와 같은 값을 포함하는 location속성이 있습니다. 고유한 속성을 만들려면 sensorId, flrRm, location의 세 가지 속성을 시계열 ID 키로 지정합니다.

원시 이벤트 예제

{
  "sensorId": "sensor1",
  "flrRm": "1a",
  "location": "Redmond",
  "temperature": 78
}

Azure Portal에서 다음과 같이 복합 키를 입력할 수 있습니다.

환경에 대한 시계열 ID를 구성합니다.

참고

Azure Portal에서 쉼표로 구분된 속성 이름을 하나의 텍스트 상자에 입력하지 않으면 쉼표를 포함하는 단일한 속성 이름으로 처리됩니다. 자체 텍스트 상자에 각 속성의 이름을 입력합니다.

다음 단계