빠른 시작: Azure CLI를 사용하여 Azure Synapse 작업 영역 만들기

Azure CLI는 Azure 리소스를 관리하는 Azure의 명령줄 환경입니다. 브라우저에서 Azure Cloud Shell과 함께 사용할 수 있습니다. macOS, Linux 또는 Windows에 설치하여 명령줄에서 실행할 수도 있습니다.

이 빠른 시작에서는 Azure CLI를 사용하여 Synapse 작업 영역을 만드는 방법을 알아봅니다.

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

필수 조건

• 간단하고 유연한 명령줄 JSON 프로세서인 jq를 다운로드하여 설치합니다.

• Azure Data Lake Storage Gen2 스토리지 계정

  Important

  선택한 ADLS Gen2 계정을 Azure Synapse 작업 영역에서 읽고 쓸 수 있어야 합니다. 또한 기본 스토리지 계정으로 연결하는 모든 스토리지 계정의 경우 스토리지 계정 만들기 페이지에 설명된 대로 스토리지 계정을 만들 때 계층 구조 네임스페이스를 사용하도록 설정해야 합니다.

• Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell의 Bash에 대한 빠른 시작을 참조하세요.

  

• CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.

  • 로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 로그인을 참조하세요.

  • 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI에서 확장 사용을 참조하세요.

  • az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.

Azure CLI를 사용하여 Azure Synapse 작업 영역 만들기

1. Azure Synapse 작업 영역에 대한 리소스를 만드는 데 필요한 환경 변수를 정의합니다.

   환경 변수 이름	설명
   StorageAccountName	기존 ADLS Gen2 스토리지 계정에 대한 이름입니다.
   StorageAccountResourceGroup	기존 ADLS Gen2 스토리지 계정 리소스 그룹의 이름입니다.
   FileShareName	기존 스토리지 파일 시스템의 이름입니다.
   SynapseResourceGroup	Azure Synapse 리소스 그룹의 새 이름을 선택합니다.
   지역	Azure 지역 중 하나를 선택합니다.
   SynapseWorkspaceName	새 Azure Synapse 작업 영역의 고유한 이름을 선택합니다.
   SqlUser	새 사용자 이름에 대한 값을 선택합니다.
   SqlPassword	보안 암호를 선택합니다.

2. Azure Synapse 작업 영역의 컨테이너로 리소스 그룹을 만듭니다.

   az group create --name $SynapseResourceGroup --location $Region
   

3. Azure Synapse 작업 영역을 만듭니다.

   az synapse workspace create \
     --name $SynapseWorkspaceName \
     --resource-group $SynapseResourceGroup \
     --storage-account $StorageAccountName \
     --file-system $FileShareName \
     --sql-admin-login-user $SqlUser \
     --sql-admin-login-password $SqlPassword \
     --location $Region
   

4. Azure Synapse 작업 영역에 대한 웹 및 개발 URL을 가져옵니다.

   WorkspaceWeb=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .web')
   
   WorkspaceDev=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .dev')
   

5. 머신에서 Azure Synapse 작업 영역에 액세스할 수 있도록 허용하는 방화벽 규칙을 만듭니다.

   ClientIP=$(curl -sb -H "Accept: application/json" "$WorkspaceDev" | jq -r '.message')
   ClientIP=${ClientIP##'Client Ip address : '}
   echo "Creating a firewall rule to enable access for IP address: $ClientIP"
   
   az synapse workspace firewall-rule create --end-ip-address $ClientIP --start-ip-address $ClientIP --name "Allow Client IP" --resource-group $SynapseResourceGroup --workspace-name $SynapseWorkspaceName
   

6. 환경 변수 WorkspaceWeb에 저장된 Azure Synapse 작업 영역 웹 URL 주소를 열어 작업 영역에 액세스합니다.

   echo "Open your Azure Synapse Workspace Web URL in the browser: $WorkspaceWeb"
   

   

7. 배포되면 추가 권한이 필요합니다.

• Azure Portal에서 작업 영역의 다른 사용자를 작업 영역의 기여자 역할에 할당합니다. 세부 단계에 대해서는 Azure Portal을 사용하여 Azure 역할 할당을 참조하세요.
• Synapse Studio를 사용하여 다른 사용자에게 적절한 Synapse RBAC 역할을 할당합니다.
• Azure Storage 계정의 소유자 역할 멤버는 Azure Synapse 작업 영역 MSI 및 기타 사용자에게 Storage Blob 데이터 기여자 역할을 할당해야 합니다.

리소스 정리

Azure Synapse 작업 영역을 삭제하려면 다음 단계를 수행합니다.

Warning

Azure Synapse 작업 영역을 삭제하면 포함된 SQL 풀 및 작업 영역 메타데이터 데이터베이스에 저장된 분석 엔진과 데이터가 제거됩니다. 더 이상 SQL 또는 Apache Spark 엔드포인트에 연결할 수 없게 됩니다. 모든 코드 아티팩트(쿼리, Notebook, 작업 정의 및 파이프라인)가 삭제됩니다.

작업 영역을 삭제해도 작업 영역에 연결된 Data Lake Store Gen2의 데이터에는 영향을 주지 않습니다.

Azure Synapse 작업 영역을 삭제하려면 다음 명령을 완료합니다.

az synapse workspace delete --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup

다음 단계

다음으로 SQL 풀 만들기 또는 Apache Spark 풀 만들기를 수행하여 데이터를 분석하고 살펴볼 수 있습니다.