빠른 시작: Azure CLI를 사용하여 Azure Synapse Analytics 작업 영역 만들기
Azure CLI는 Azure 리소스를 관리하는 Azure의 명령줄 환경입니다. 브라우저에서 Azure Cloud Shell과 함께 사용할 수 있습니다. macOS, Linux 또는 Windows에 설치하여 명령줄에서 실행할 수도 있습니다.
이 빠른 시작에서는 Azure CLI를 사용하여 Azure Synapse Analytics 작업 영역을 만드는 방법을 알아봅니다.
Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
필수 조건
가볍고 유연한 명령줄 JSON 프로세서인 jq를 다운로드하여 설치합니다.
Azure Data Lake Storage Gen2 스토리지 계정.
Important
Azure Synapse Analytics 작업 영역은 선택한 Data Lake Storage Gen2 계정을 읽고 쓸 수 있어야 합니다. 또한 기본 스토리지 계정으로 연결하는 스토리지 계정의 경우 스토리지 계정 만들기에 설명된 대로 스토리지 계정을 만들 때 계층 구조 네임스페이스를 사용하도록 설정해야 합니다.
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 Analytics 작업 영역 만들기
Azure Synapse Analytics 작업 영역에 대한 리소스를 만드는 데 필요한 환경 변수를 정의합니다.
환경 변수 이름 설명 StorageAccountName 기존 Data Lake Storage Gen2 스토리지 계정의 이름입니다. StorageAccountResourceGroup 기존 Data Lake Storage Gen2 스토리지 계정 리소스 그룹의 이름입니다. FileShareName 기존 스토리지 파일 시스템의 이름입니다. SynapseResourceGroup Azure Synapse Analytics 리소스 그룹의 새 이름을 선택합니다. 지역 Azure 지역 중 하나를 선택합니다. SynapseWorkspaceName 새 Azure Synapse Analytics 작업 영역의 고유한 이름을 선택합니다. SqlUser 새 사용자 이름에 대한 값을 선택합니다. SqlPassword 보안 암호를 선택합니다. Azure Synapse Analytics 작업 영역에 대한 컨테이너로 리소스 그룹을 만듭니다.
az group create --name $SynapseResourceGroup --location $Region
Azure Synapse Analytics 작업 영역을 만듭니다.
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
Azure Synapse Analytics 작업 영역에 대한 웹 및 개발 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')
머신에서 Azure Synapse Analytics 작업 영역에 대한 액세스를 허용하는 방화벽 규칙을 만듭니다.
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
환경 변수
WorkspaceWeb
에 저장된 Azure Synapse Analytics 작업 영역 웹 URL 주소를 열어 작업 영역에 액세스합니다.echo "Open your Azure Synapse Workspace Web URL in the browser: $WorkspaceWeb"
배포된 후에는 더 많은 권한이 필요합니다.
- Azure Portal에서 작업 영역의 다른 사용자를 작업 영역의 기여자 역할에 할당합니다. 자세한 내용은 Azure Portal을 사용하여 Azure 역할 할당을 참조하십시오.
- Synapse Studio를 사용하여 다른 사용자에게 적절한 Azure Synapse Analytics 역할 기반 액세스 제어 역할을 할당합니다.
- Azure Storage 계정의 소유자 역할 멤버는 Azure Synapse Analytics 작업 영역 관리 서비스 ID 및 기타 사용자에게 Storage Blob 데이터 기여자 역할을 할당해야 합니다.
리소스 정리
다음 단계에 따라 Azure Synapse Analytics 작업 영역을 삭제합니다.
Warning
Azure Synapse Analytics 작업 영역을 삭제하면 포함된 SQL 풀 및 작업 영역 메타데이터의 데이터베이스에 저장된 분석 엔진 및 데이터가 제거됩니다. 더 이상 SQL 또는 Apache Spark 엔드포인트에 연결할 수 없게 됩니다. 모든 코드 아티팩트가 삭제됩니다(쿼리, Notebook, 작업 정의 및 파이프라인).
작업 영역을 삭제해도 작업 영역에 연결된 Data Lake Storage Gen2 계정의 데이터에는 영향을 주지 않습니다.
Azure Synapse Analytics 작업 영역을 삭제하려면 다음 명령을 완료합니다.
az synapse workspace delete --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup
관련 콘텐츠
다음으로 SQL 풀 만들기 또는 Apache Spark 풀 만들기를 수행하여 데이터를 분석하고 살펴볼 수 있습니다.