Notebook URI를 사용하여 매개 변수가 있는 Notebook 만들기

중요하다

Azure Data Studio는 2026년 2월 28일에사용 중지됩니다. Visual Studio Code용 MSSQL 확장을 사용하는 것이 좋습니다. Visual Studio Code로 마이그레이션하는 방법에 대한 자세한 내용은 Azure Data Studio에 무슨 일이 일어나고 있는지 확인하세요.

Azure Data Studio의 매개 변수화는 다른 매개 변수 집합을 사용하여 동일한 Notebook을 실행합니다.

이 문서에서는 Python 커널을 사용하여 Azure Data Studio에서 매개 변수가 있는 Notebook을 만들고 실행하는 방법을 보여줍니다.

Note

현재 Python, PySpark, PowerShell 및 .NET Interactive 커널에서 매개 변수화를 사용할 수 있습니다.

Prerequisites

Azure Data Studio URI의 쿼리에 매개변수를 프로그래밍 방식으로 추가하여 새 매개변수를 사용해 Azure Data Studio에서 노트북을 엽니다.

Azure Data Studio Notebook URI는 HTTPS, HTTP 및 FILE URI 스키마를 지원하며 다음 형식을 사용합니다.

azuredatastudio://microsoft.notebook/open?url=

Azure Data Studio Notebook URI를 사용하여 매개 변수를 전달하려면 다음 형식을 사용합니다.

azuredatastudio://microsoft.notebook/open?url=LinkToNotebook?x=1&y=2

URI 쿼리에서 삽입할 새 매개 변수를 나타내는 데 사용합니다 & .

예제 Notebook 파일을 사용하여 이 문서의 단계를 진행할 수 있습니다.

Notebook의 내용과 구조는 다음과 같습니다.

x = 2.0
y = 5.0

addition = x + y
multiply = x * y

print("Addition: " + str(addition))
print("Multiplication: " + str(multiply))

Azure Data Studio에서 열린 예제 Notebook으로 시작하거나 다음 단계를 완료하여 Notebook을 만들 수 있습니다. 그런 다음, 다른 매개 변수를 사용해 보세요. 모든 단계는 Azure Data Studio Notebook 내에서 실행됩니다.

첫 번째 코드 셀은 매개 변수로 태그를 지정해야 합니다. 새 Notebook 파일을 사용하는 경우 새 코드 셀을 만듭니다. 매개 변수를 선택하여 셀에 매개 변수 셀로 태그를 지정합니다.
브라우저의 검색 창 또는 Markdown 셀을 사용하여 Notebook URI 링크를 열 수 있습니다. 다음에 표시된 Azure Data Studio Notebook URI를 사용하여 GitHub에서 예제 입력 Notebook을 매개 변수화할 수 있습니다.

다음 Notebook URI를 복사하여 GitHub의 예제 입력 Notebook을 x 및 y에 대한 새 값으로 매개 변수화합니다. 브라우저 검색 창에 URI를 붙여넣습니다.

azuredatastudio://microsoft.notebook/open?url=https://raw.githubusercontent.com/microsoft/sql-server-samples/master/samples/applications/azure-data-studio/parameterization.ipynb?x=10&y=20

웹 브라우저에서 링크를 열면 Azure Data Studio에서 Notebook을 열라는 메시지가 표시됩니다. Azure Data Studio 열기를 선택합니다.
새 매개 변수를 사용하여 Notebook을 다운로드하고 열라는 메시지가 표시됩니다.

예를 선택한 다음 매개 변수가 있는 새 전자 필기장을 봅니다. 도구 모음에서 모두 실행을 선택하여 모든 셀을 실행하고 새 출력을 확인합니다.

레이블이 지정된 # Injected-Parameters 새 셀에는 전달된 새 매개 변수 값이 포함됩니다.