Краткое руководство. Создание рабочей области Azure Synapse Analytics с помощью Azure CLI

Azure CLI — это интерфейс командной строки Azure для управления ресурсами Azure. Вы можете использовать его в браузере с Azure Cloud Shell. Его также можно установить в macOS, Linux или Windows и запускать из командной строки.

Из этого краткого руководства вы узнаете, как создать рабочую область Azure Synapse Analytics с помощью Azure CLI.

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.

Необходимые компоненты

• Скачайте и установите jq, упрощенный и гибкий обработчик JSON командной строки.

• Azure Data Lake Storage 2-го поколения учетной записи хранения.

  Важно!

  Рабочая область Azure Synapse Analytics должна иметь возможность читать и записывать данные в выбранную учетную запись Data Lake Storage 2-го поколения. Кроме того, для любой учетной записи хранения, которую вы связываете в качестве основной учетной записи хранения, необходимо включить иерархическое пространство имен при создании учетной записи хранения, как описано в разделе "Создание учетной записи хранения".

• Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см . в кратком руководстве по Bash в Azure Cloud Shell.

  

• Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.

  • Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других возможностях, доступных при входе, см. в статье Вход с помощью Azure CLI.

  • Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений с Azure CLI.

  • Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

Создание рабочей области Azure Synapse Analytics с помощью Azure CLI

1. Определите необходимые переменные среды для создания ресурсов для рабочей области Azure Synapse Analytics.

   Имя переменной среды	Описание
   Имя_учетной_записи_хранения	Имя существующей учетной записи хранения Data Lake Storage 2-го поколения.
   StorageAccountResourceGroup	Имя существующей группы ресурсов учетной записи хранения Data Lake Storage 2-го поколения.
   FileShareName	Имя существующей файловой системы хранилища.
   SynapseResourceGroup	Выберите новое имя для группы ресурсов Azure Synapse Analytics.
   Область/регион	Выберите один из регионов Azure.
   SynapseWorkspaceName	Выберите уникальное имя для новой рабочей области Azure Synapse Analytics.
   SqlUser	Выберите значение для нового имени пользователя.
   SqlPassword	Выберите надежный пароль.

2. Создайте группу ресурсов в качестве контейнера для рабочей области Azure Synapse Analytics:

   Azure CLI

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

3. Создайте рабочую область Azure Synapse Analytics:

   Azure CLI

   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. Получите URL-адреса интернета и разработки для рабочей области Azure Synapse Analytics:

   Azure CLI

   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 Analytics на компьютере:

   Azure CLI

   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. Откройте url-адрес веб-URL-адреса рабочей области Azure Synapse Analytics, хранящийся в переменной WorkspaceWeb среды, чтобы получить доступ к рабочей области:

   Azure CLI

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

   

7. После развертывания требуются дополнительные разрешения:

   • На портале Azure назначьте другим пользователям рабочей области роль участника в рабочей области. Дополнительные сведения см. в разделе Назначение ролей Azure с помощью портала Azure.
   • Назначьте другим пользователям соответствующие роли управления доступом на основе ролей Azure Synapse Analytics с помощью Synapse Studio.
   • Участник роли владельца учетной записи служба хранилища Azure должен назначить роль участника данных BLOB-объектов хранилища управляемому удостоверению службы Azure Synapse Analytics и другим пользователям.

Очистка ресурсов

Выполните следующие действия, чтобы удалить рабочую область Azure Synapse Analytics.

Предупреждение

При удалении рабочей области Azure Synapse Analytics удаляются подсистемы аналитики и данные, хранящиеся в базе данных содержащихся пулов SQL и метаданных рабочей области. В этом случае вы больше не сможете подключиться к конечным точкам SQL и Apache Spark. Все артефакты кода будут удалены (запросы, записные книжки, определения заданий и конвейеры).

Удаление рабочей области не повлияет на данные в учетной записи Data Lake Storage 2-го поколения, связанной с рабочей областью.

Если вы хотите удалить рабочую область Azure Synapse Analytics, выполните следующую команду:

Azure CLI

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

Связанный контент

Теперь можно создать пулы SQL или Apache Spark, чтобы начать анализ и изучение данных.