다음을 통해 공유


Visual Studio Code를 사용하여 SQL Server 빅 데이터 클러스터에 애플리케이션을 배포하는 방법

적용 대상: SQL Server 2019(15.x)

이 문서에서는 SQL Server 빅 데이터 클러스터에 애플리케이션을 배포하는 방법을 설명합니다. Microsoft Visual Studio Code 및 앱 배포 확장을 사용합니다.

중요합니다

Microsoft SQL Server 2019 빅 데이터 클러스터 추가 기능이 사용 중지됩니다. SQL Server 2019 빅 데이터 클러스터에 대한 지원은 2025년 2월 28일에 종료됩니다. Software Assurance를 사용하는 SQL Server 2019의 모든 기존 사용자는 플랫폼에서 완전히 지원되며, 소프트웨어는 지원 종료 시점까지 SQL Server 누적 업데이트를 통해 계속 유지 관리됩니다. 자세한 내용은 공지 블로그 게시물Microsoft SQL Server 플랫폼의 빅 데이터 옵션을 참조하세요.

필수 조건

역량

앱 배포 확장은 Visual Studio Code에서 다음 작업을 지원합니다.

  • SQL Server 빅 데이터 클러스터를 사용하여 인증합니다.
  • 지원되는 런타임 배포를 위해 GitHub 리포지토리에서 애플리케이션 템플릿을 검색합니다.
  • 현재 사용자의 작업 영역에서 열려 있는 애플리케이션 템플릿을 관리합니다.
  • YAML 형식의 사양을 통해 애플리케이션을 배포합니다.
  • SQL Server 빅 데이터 클러스터 내에서 배포된 앱을 관리합니다.
  • 사이드바에 배포한 모든 앱에 추가 정보가 표시됩니다.
  • 앱을 사용하거나 클러스터에서 앱을 삭제하는 실행 사양을 생성합니다.
  • 실행 명세 YAML 파일을 통해 배포된 앱을 소비합니다.

다음 섹션에서는 앱 배포 설치를 안내합니다. 또한 작동 방식에 대한 개요를 제공합니다.

Visual Studio Code에서 앱 배포 확장을 설치하는 방법

Visual Studio Code에서 앱 배포 확장을 설치합니다.

  1. Visual Studio Code의 일부로 앱 배포를 설치하려면 GitHub에서 확장을 다운로드 합니다.

  2. Visual Studio Code를 시작하고 확장 사이드바로 이동합니다.

  3. 사이드바 위쪽의 상황에 맞는 메뉴를 클릭하고 을 선택합니다Install from vsix.

    VSIX 설치

  4. 다운로드한 sqlservbdc-app-deploy.vsix 파일을 찾아 설치하도록 선택합니다.

앱 배포가 성공적으로 설치되면 Visual Studio Code를 다시 로드하라는 메시지가 표시됩니다. 이제 Visual Studio Code 사이드바에 SQL Server BDC 앱 탐색기가 표시됩니다.

앱 탐색기 로드

사이드바에서 확장 아이콘을 선택합니다. 측면 패널이 로드되고 App Explorer가 표시됩니다.

앱 또는 앱 사양이 없는 App Explorer를 보여 주는 스크린샷

클러스터 엔드포인트에 연결

다음 방법 중 원하는 방법을 사용하여 클러스터 엔드포인트에 연결할 수 있습니다.

  • 아래쪽 SQL Server BDC Disconnected에 있는 상태 표시줄을 클릭합니다.
  • 또는 화살표가 Connect to Cluster 출입구로 가리키는 위쪽의 단추를 클릭합니다.

Visual Studio Code는 적절한 엔드포인트, 사용자 이름 및 암호를 묻는 메시지를 표시합니다.

포트 30080을 사용하여 엔드포인트 Cluster Management Service 에 연결합니다.

다음 명령을 사용하여 명령줄에서 이 엔드포인트를 찾을 수도 있습니다.

azdata bdc endpoint list

이 정보를 검색하는 또 다른 방법은 Azure Data Studio 에서 서버로 이동하고 관리를 마우스 오른쪽 단추로 클릭하는 것입니다. 서비스에 대한 엔드포인트가 나열됩니다.

사용하려는 엔드포인트를 찾은 다음 클러스터에 연결합니다.

새 연결

연결이 성공하면 Visual Studio Code에서 클러스터에 연결되어 있음을 알 수 있습니다. 배포된 앱이 사이드바에 표시되고 엔드포인트 및 사용자 이름이 사용자 프로필의 일부로 저장 ./sqldbc 됩니다. 암호 또는 토큰은 저장되지 않습니다. 후속 로그인을 사용하면 프롬프트가 저장된 호스트 및 사용자 이름으로 미리 채워지지만 항상 암호를 입력해야 합니다. 다른 클러스터 엔드포인트에 연결하려면 .를 선택합니다 New Connection. Visual Studio Code를 종료하고 다른 작업 영역을 열 때 연결이 자동으로 닫힙니다. 그런 다음 다시 연결해야 합니다.

앱 템플릿 만들기

Visual Studio Code에서 앱 아티팩트를 저장할 위치에서 작업 영역을 엽니다.

템플릿에서 새 앱을 배포하려면 앱 사양 창에서 새 앱 템플릿 단추를 선택합니다. 로컬 컴퓨터에서 이름, 런타임 및 새 앱을 저장할 위치를 묻는 메시지가 표시됩니다. 제공하는 이름과 버전은 DNS-1035 레이블이어야 하며 소문자, 영숫자 문자 또는 '-'로 구성되어야 합니다. 또한 알파벳 문자로 시작하고 영숫자로 끝나야 합니다.

현재 Visual Studio Code 작업 영역에 확장을 배치하는 것이 좋습니다. 이렇게 하면 확장의 전체 기능을 사용할 수 있습니다.

새 앱 템플릿

완료되면 지정한 위치에서 새 앱 템플릿이 스캐폴드되고 배포가 spec.yaml 작업 영역에서 열립니다. 선택한 디렉터리가 작업 영역에 있는 경우 앱 사양 창에 나열됩니다.

로드된 앱 템플릿

새 템플릿은 다음과 같이 앱 사양 창에 배치된 간단한 helloworld 앱입니다.

  • spec.yaml
    • 클러스터에 앱을 배포하는 방법을 알려줍니다.
  • run-spec.yaml
    • 앱을 호출하는 방법을 클러스터에 알릴 수 있습니다.

앱 소스 코드는 작업 영역 폴더에 있습니다.

  • 원본 파일 이름
    • 이 파일은 src에서 지정한 spec.yaml 소스 코드 파일입니다.
    • 앱의 handler로 여겨지는 entrypoint라는 기능이 하나 있으며, 이는 spec.yaml에 표시됩니다. 문자열 입력 msg을 받아 문자열 출력 out을 반환합니다. 이러한 항목은 inputsoutputsspec.yaml에 지정됩니다.

앱을 배포할 때 스캐폴드된 템플릿 대신 spec.yaml을 사용하려면 New Deploy Spec 버튼 옆에 있는 New App Template 버튼을 선택하십시오. 이제 동일한 프로세스를 반복합니다. 당신은 수정할 수 있는 spec.yaml만 받게 될 것입니다.

앱 배포

앱 사양 메뉴에서 CodeLens Deploy Appspec.yaml 를 통해 즉시 앱을 배포하거나 파일 옆에 있는 spec.yaml 단추를 선택할 수 있습니다. 확장은 현재 spec.yaml 위치의 디렉터리에 있는 모든 파일을 압축합니다. 그런 다음, 클러스터에 앱을 배포합니다.

비고

spec.yaml 소스 코드 디렉터리의 루트 수준에 있어야 합니다. 또한 모든 앱 파일이 spec.yaml와 동일한 디렉터리에 있는지 확인합니다.

앱 배포 단추

앱 CodeLens 배포

사이드바의 앱 상태는 사용할 준비가 되면 알려줍니다.

앱 배포됨

앱 준비 사이드바

앱 준비 알림

측면 창에서 다음을 볼 수 있습니다.

다음 링크를 사용하여 배포한 모든 앱을 볼 수 있습니다.

  • 버전
  • 입력 매개 변수
  • 출력 매개 변수
  • 링크
    • 자신만만한 태도
    • 세부 정보

links을 클릭하면, 배포된 앱의 swagger.json에 액세스할 수 있다는 것을 알게 됩니다. 이렇게 하면 앱을 호출하는 클라이언트를 작성할 수 있습니다.

swagger.json 파일을 표시하는 Visual Studio Code UI를 보여 주는 스크린샷

자세한 내용은 빅 데이터 클러스터에서 애플리케이션 사용을 참조하세요.

앱을 실행합니다.

앱이 준비되면 run-spec.yaml을(를) 사용하세요. 이 파일은 앱 템플릿의 일부로 제공됩니다.

스펙 실행

바꿀 hello문자열을 지정합니다. 그런 다음 , 사이드바의 CodeLens 링크 또는 번개 단추를 통해 앱을 다시 실행합니다. 옵션이 run-spec 표시되지 않으면, 클러스터의 배포된 앱에서 해당 옵션을 생성하십시오.

실행 사양 가져오기

실행 사양을 편집한 후 실행합니다. Visual Studio Code는 앱 실행이 완료되면 피드백을 반환합니다.

앱 출력

이전 스크린샷에서는 작업 영역의 임시 .json 파일에 출력이 제공된 것을 볼 수 있습니다. 이 출력을 유지하려면 저장할 수 있습니다. 그렇지 않으면 닫을 때 삭제됩니다. 앱에 파일에 인쇄할 출력이 없는 경우 상태 알림만 받게 Successful App Run 됩니다. 성공적으로 실행되지 않은 경우 무엇이 잘못되었는지 확인하는 데 도움이 되는 오류 메시지가 표시됩니다.

앱을 실행할 때 매개 변수를 전달하는 다양한 방법이 있습니다.

.json를 통해 모든 필요한 입력을 지정할 수 있습니다.

  • inputs: ./example.json

배포된 앱이 호출되고 입력 매개 변수가 기본 형식이 아닌 경우 매개 변수 형식을 줄에 지정합니다. 따라서 배열, 벡터, 데이터 프레임, 복잡한 JSON 등을 사용합니다.

  • 벡터
    • inputs:
      • x: [1, 2, 3]
  • 행렬
    • inputs:
      • x: [[A,B,C],[1,2,3]]
  • 객체
    • inputs:
      • x: {A: 1, B: 2, C: 3}

또는 앱에 필요한 형식의 .txt.json문자열 또는 .csv 파일에 문자열을 전달합니다. 이 경우, 파일 구문 분석은 Node.js Path library 기반으로 이루어지며, 여기서 파일 경로는 string that contains a / or \ character로 정의됩니다.

필요한 입력 매개 변수가 제공되지 않으면 오류 메시지가 표시됩니다. 문자열 파일 경로가 지정된 경우 잘못된 파일 경로를 제공하거나 매개 변수가 잘못되었음을 나타냅니다. 앱 작성자는 자신이 정의하는 매개 변수를 이해해야 합니다.

앱을 삭제하려면 측면 창에서 앱으로 Deployed Apps 이동하여 휴지통 아이콘을 선택합니다.

다음 단계

자세한 내용은 빅 데이터 클러스터에서 애플리케이션 사용을 참고하여 SQL Server 빅 데이터 클러스터에 배포된 앱을 자신의 애플리케이션에 통합하는 방법을 탐색해 보세요. App Deploy 샘플 에서 추가 샘플을 참조하여 확장을 사용해 볼 수도 있습니다.

SQL Server 빅 데이터 클러스터에 대한 자세한 내용은 SQL Server 2019 빅 데이터 클러스터 소개를 참조하세요.

Microsoft의 목표는 이 확장을 사용자에게 유용하게 만드는 것이며 여러분의 의견에 감사드립니다. SQL Server 팀에 보내주세요.