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

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

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

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

必要條件

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

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

  重要

  Azure Synapse 工作區必須能夠讀取和寫入選取的 ADLS 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 工作區

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

   環境變數名稱	描述
   StorageAccountName	現有 ADLS Gen2 儲存體帳戶的名稱。
   儲存體AccountResourceGroup	您現有的 ADLS Gen2 儲存體帳戶資源群組名稱。
   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. 取得 Azure Synapse 工作區的 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 工作區：

   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 工作區 Web URL 位址，以存取您的工作區：

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

   

7. 部署之後，需要額外的許可權。

• 在Azure 入口網站中，將工作區的其他使用者指派給 工作區中的參與者 角色。 如需詳細步驟，請參閱使用 Azure 入口網站指派 Azure 角色。
• 使用 Synapse Studio 將適當的 Synapse RBAC 角色 指派給其他使用者。
• Azure 儲存體帳戶的 擁有者 角色成員必須將儲存體 Blob 資料參與者 角色指派 給 Azure Synapse 工作區 MSI 和其他使用者。

清除資源

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

警告

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

刪除工作區不會影響 連結至工作區之 Data Lake Store Gen2 中的資料。

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

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

下一步

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