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

  • Статья

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

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

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

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

  • Скачайте и установите jg, простой и удобный процессор командной строки JSON

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

    Важно!

    В рабочей области Azure Synapse должна быть возможность считывать данные в выбранной учетной записи ADLS 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 с помощью Azure CLI

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

    Имя переменной среды Описание
    Имя_учетной_записи_хранения Имя существующей учетной записи хранения ADLS 2-го поколения.
    StorageAccountResourceGroup Имя существующей группы ресурсов учетной записи хранения ADLS 2-го поколения.
    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. Получите URL-адрес Web и Dev для рабочей области Azure Synapse:

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

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

    Azure Synapse workspace web

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

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

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

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

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

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

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

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

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

Следующие шаги

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