Share via

Azure Stream Analytics에서 Azure Cosmos DB 출력

  • 아티클

Azure Cosmos DB는 전 세계의 무제한 탄력적 크기 조정, 풍부한 쿼리 및 스키마와 관련 없는 데이터 모델에 대한 자동 인덱싱을 제공하는 전역적으로 분산된 데이터베이스 서비스입니다. Stream Analytics의 Azure Cosmos DB 컨테이너 옵션에 대해 알아보려면 Azure Cosmos DB를 출력으로 사용하는 Stream Analytics 문서를 참조하세요.

Stream Analytics의 Azure Cosmos DB 출력은 현재 21Vianet에서 운영하는 Microsoft Azure 및 Azure 독일(T-Systems International)에서 사용할 수 없습니다.

참고 항목

Azure Stream Analytics는 SQL API를 사용한 Azure Cosmos DB에 대한 연결만 지원합니다. 다른 Azure Cosmos DB API는 아직 지원되지 않습니다. Azure Stream Analytics를 다른 API로 만든 Azure Cosmos DB 계정에 지정한 경우 데이터는 올바르게 저장되지 않을 수도 있습니다.

다음 표에서는 Azure Cosmos DB 출력을 만드는 속성에 대해 설명합니다.

Property name Description
출력 별칭 Stream Analytics 쿼리에서 이 출력을 참조할 별칭입니다.
sink Azure Cosmos DB
가져오기 옵션 구독에서 Azure Cosmos DB 선택 또는 Azure Cosmos DB 설정 수동 제공 중 하나를 선택합니다.
계정 ID Azure Cosmos DB 계정의 이름 또는 엔드포인트 URI입니다.
계정 키 Azure Cosmos DB 계정에 대한 공유 액세스 키입니다.
데이터베이스 Azure Cosmos DB 데이터베이스 이름입니다.
컨테이너 이름 사용할 컨테이너 이름이며, Azure Cosmos DB에 있어야 합니다. 예:
  • MyContainer: “MyContainer”라는 컨테이너가 있어야 합니다.
문서 ID 선택 사항. 삽입 또는 업데이트 작업의 기반이 되는 기본 키를 지정하는 데 사용되는 출력 이벤트의 필드 이름입니다.

참고 항목

Azure Stream Analytics용 Azure Cosmos DB 출력은 .NET V3 SDK를 사용합니다. 여러 지역에 쓸 때 SDK는 사용 가능한 최상의 지역을 자동으로 선택합니다.

분할

partition 키 값은 쿼리의 PARTITION BY 절에 기반합니다. 출력 작성기의 수는 완전히 병렬화된 쿼리의 입력 분할을 따릅니다. Stream Analytics는 Azure Cosmos DB 출력 파티션 키를 문자열로 변환합니다. 예를 들어 bigint 형식의 값이 1인 파티션 키가 있는 경우 문자열 형식의 "1"로 변환됩니다. 이 변환은 파티션 속성이 Azure Cosmos DB 기록되는지에 관계없이 항상 발생합니다.

출력 일괄 처리 크기

최대 메시지 크기는 Azure Cosmos DB 제한을 참조하세요. 일괄 처리 크기 및 쓰기 빈도는 Azure Cosmos DB 응답에 따라 동적으로 조정됩니다. Stream Analytics에서 미리 결정된 제한이 없습니다.

다음 단계