快速入門：使用 Azure CLI 建立 Azure Synapse Analytics 工作區

Azure CLI 是管理 Azure 資源的 Azure 命令列體驗。 您可以在瀏覽器中使用它搭配 Azure Cloud Shell。 您也可以將它安裝在 macOS、Linux 或 Windows 上，並從命令列執行。

在本快速入門中，您將瞭解如何使用 Azure CLI 建立 Azure Synapse Analytics 工作區。

如果您沒有 Azure 訂閱，請在開始之前，先建立 Azure 免費帳戶。

必要條件

• 下載並安裝 jq，這是輕量型且彈性的命令行 JSON 處理器。

• Azure Data Lake Storage Gen2 儲存器帳戶。

  重要

  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 工作區

1. 定義必要的環境變數，以建立 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	選擇安全的密碼。

2. 建立資源群組作為 Azure Synapse Analytics 工作區的容器：

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

3. 建立 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
   

4. 取得 Azure Synapse Analytics 工作區的 Web 和開發 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 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
   

6. 開啟儲存在環境變數 WorkspaceWeb 中的 Azure Synapse Analytics 工作區 Web URL 位址，以存取您的工作區：

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

   

7. 部署之後，需要更多許可權：

   • 在 Azure 入口網站 中，將工作區的其他使用者指派給工作區中的參與者角色。 如需詳細資訊，請參閱使用 Azure 入口網站指派 Azure 角色。
   • 使用 Synapse Studio 將適當的 Azure Synapse Analytics 角色型存取控制角色 指派給其他使用者。
   • Azure 儲存體 帳戶的擁有者角色成員必須將記憶體 Blob 數據參與者角色指派給 Azure Synapse Analytics 工作區受控服務識別和其他使用者。

清除資源

請遵循下列步驟來刪除 Azure Synapse Analytics 工作區。

警告

刪除 Azure Synapse Analytics 工作區會移除分析引擎，以及儲存在自主 SQL 集區和工作區元數據資料庫中的數據。 無法再連線到 SQL 或 Apache Spark 端點。 將會刪除所有程式代碼成品（查詢、筆記本、作業定義和管線）。

刪除工作區不會影響連結至工作區之 Data Lake Storage Gen2 帳戶中的數據。

如果您想要刪除 Azure Synapse Analytics 工作區，請完成下列命令：

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

相關內容

接下來，您可以 建立 SQL 集 區或 建立 Apache Spark 集 區，以開始分析和探索您的數據。