Share via


ASA 도구를 사용한 Visual Studio Code의 Stream Analytics 작업 로컬 테스트 개요

Visual Studio Code용 ASA 도구(Azure Stream Analytics 도구)를 사용하여 로컬에서 Stream Analytics 작업을 테스트할 수 있습니다. 지역성을 말할 때 고려해야 할 세 가지 측면은 작업 실행 컨텍스트(로컬 머신 또는 Azure 클라우드 서비스), 입력 원본, 출력 싱크입니다.

로컬 실행에서는 쿼리가 로컬 머신에서 실행됩니다. 입력의 경우 로컬 파일 또는 라이브 원본에서 데이터를 수집할 수 있습니다. 출력 결과는 로컬 폴더 또는 라이브 싱크에 파일로 전송됩니다.

로컬 실행의 입력 고려 사항

VS Code에서 라이브 및 로컬 입력을 정의할 수 있습니다.

  • 라이브 입력은 지원되는 입력(스트림 및 참조 데이터) 인스턴스를 가리키는 구성 파일입니다. JSON 파일에 대한 미리 보기 및 샘플 데이터도 제공합니다.
  • 로컬 입력은 지원되는 형식(JSON/CSV/AVRO)의 로컬 파일을 가리키는 구성 파일입니다. 이 파일은 라이브 입력에서 샘플링하거나 다른 방법으로 생성할 수 있습니다.

로컬 입력을 만들 때 기존 라이브 입력에 맞출 수 있습니다. 이 경우 로컬 입력 실행 중에 라이브 입력을 모의합니다. 구성 파일의 이름은 라이브 입력의 이름을 따서 지정되며 접두사로 Local_이 붙습니다. 이 로컬 입력에 사용되는 데이터 파일이 라이브 입력에서 정의된 형식과 serialization 형식을 따라야 하는 것은 아닙니다. 해당 형식은 독립적입니다.

로컬 실행의 출력 고려 사항

로컬 출력으로 작업을 실행할 때 출력 결과는 LocalRunOutputs라는 프로젝트의 폴더로 전송됩니다. 이 모드에서는 출력을 정의할 필요가 없습니다. 유일한 제약 조건은 쿼리의 각 INTO 문이 고유한 출력 이름을 가리켜야 한다는 것입니다. 로컬 출력으로 실행하면 고유한 각 출력 이름에 대한 JSON 파일이 생성됩니다.

로컬 실행 모드

VS Code의 ASA 도구에서 로컬로 작업을 실행하기 위해 지원되는 세 가지 모드는 다음과 같습니다.

  • 로컬 입력 및 로컬 출력을 사용하는 로컬 실행: 추가 비용 없는 오프라인 개발, npm 패키지를 사용한 단위 테스트 등에 가장 적합합니다.
  • 라이브 입력 및 로컬 출력을 사용하는 로컬 실행: 입력 구성, deserialization, 분할 디버깅 등에 가장 적합합니다.
  • 라이브 입력 및 라이브 출력을 사용하는 로컬 실행: 출력 구성, serialization, 변환 오류 디버깅 등에 가장 적합합니다.

각 모드는 서로 다른 입력 및 출력 구성을 지원합니다.

실행 모드 입력 출력
VS Code 로컬 입력-로컬 출력 JSON/CSV/AVRO 파일 JSON 파일(해당 라이브 출력 형식이 있어도 사용되지 않음)
VS Code 라이브 입력-로컬 출력 모든 입력 어댑터 JSON 파일(해당 라이브 출력 형식이 있어도 사용되지 않음)
VS Code 라이브 입력-라이브 출력 모든 입력 어댑터 이벤트 허브, 스토리지 계정, Azure SQL
Azure 해당 없음 모든 입력 어댑터 모든 출력 어댑터

로컬로 작업을 실행하는 경우 Azure Stream Analytics 서비스에서 비용이 발생하지 않습니다. Azure에서 Stream Analytics 리소스를 만들 필요가 없습니다.

시작하기

이 빠른 시작을 사용하여 Visual Studio Code 및 ASA 도구를 통해 Stream Analytics 작업을 만드는 방법을 알아봅니다.

로컬 실행에 대한 단계별 자습서는 다음을 참조하세요.

다음 단계