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

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

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

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

先決條件

• 下載並安裝 jq，這是一個輕量且具彈性的命令列 JSON 處理器。

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

  重要事項

  Azure Synapse Analytics 工作區需要能夠讀取和寫入所選的 Data Lake Storage Gen2 帳戶。 此外，對於您連結為主要儲存體帳戶的任何儲存體帳戶，您必須已在建立儲存體帳戶時啟用 [階層式命名空間]，如在建立儲存體帳戶中所述。

• 在 Azure Cloud Shell 中使用 Bash 環境。 如需詳細資訊，請參閱開始使用 Azure Cloud Shell。

  

• 若要在本機執行 CLI 參考命令，請安裝 (部分機器翻譯) Azure CLI。 若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。 如需詳細資訊，請參閱如何在 Docker 容器中執行 Azure CLI。

  • 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。 請遵循您終端機上顯示的步驟，以完成驗證流程。 如需其他登入選項，請參閱 使用 Azure CLI 向 Azure 進行驗證。

  • 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。 如需擴充功能的詳細資訊，請參閱 使用和管理 Azure CLI 的擴充功能。

  • 執行 az version (部分機器翻譯) 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本，請執行 az upgrade。

使用 Azure CLI 來建立 Azure Synapse Analytics 工作區

1. 定義必要的環境變數來為 Azure Synapse Analytics 工作區建立資源。

   環境變數名稱	描述
   儲存帳戶名稱	您現有的 Data Lake Storage Gen2 儲存體帳戶的名稱。
   StorageAccountResourceGroup	您現有的 Data Lake Storage Gen2 儲存體帳戶資源群組的名稱。
   檔案分享名稱	現有儲存體檔案系統的名稱。
   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 工作區的網頁和開發 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 端點。 所有程式碼成品 (查詢、Notebooks、工作定義和管線) 都將被刪除。

刪除工作區不會影響連結到該工作區的 Data Lake Storage Gen2 帳戶中的資料。

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

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

相關內容

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