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

發行項
05/11/2023

Azure PowerShell 是一組 Cmdlet，可直接從 PowerShell 管理 Azure 資源。您可以在瀏覽器中使用它搭配 Azure Cloud Shell。您也可以將其安裝在 macOS、Linux 或 Windows 上。

在本快速入門中，您會了解如何使用 Azure PowerShell 建立 Synapse 工作區。

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

必要條件

Azure Data Lake Storage Gen2 儲存體帳戶

重要

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

如果您選擇使用 Cloud Shell，請參閱 Azure Cloud Shell 的概觀以取得詳細資訊。

在本機安裝 Azure PowerShell 模組

如果您選擇在本機使用 PowerShell，本文會要求您安裝 Az PowerShell 模組，並使用 Connect-AzAccount Cmdlet 連線到您的 Azure 帳戶。如需安裝 Az PowerShell 模組的詳細資訊，請參閱安裝 Azure PowerShell。

如需關於使用 Azure PowerShell 進行驗證的詳細資訊，請參閱使用 Azure PowerShell 登入。

安裝 Azure Synapse PowerShell 模組

重要

Az.Synapse PowerShell 模組處於預覽狀態，因此您必須使用 Install-Module Cmdlet 來將其分開安裝。此 PowerShell 模組正式推出後，便會成為未來 Az PowerShell 模組版本的一部分，且預設可從 Azure Cloud Shell 內使用。

Install-Module -Name Az.Synapse

使用 Azure PowerShell 建立 Azure Synapse 工作區

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

變數名稱	描述
StorageAccountName	現有 ADLS Gen2 儲存體帳戶的名稱。
StorageAccountResourceGroup	現有 ADLS Gen2 儲存體帳戶資源群組的名稱。
FileShareName	現有儲存體檔案系統的名稱。
SynapseResourceGroup	為您的 Azure Synapse 資源群組選擇新的名稱。
區域	選擇其中一個 Azure 區域。
SynapseWorkspaceName	為新的 Azure Synapse 工作區選擇唯一的名稱。
SqlUser	選擇新使用者名稱的值。
SqlPassword	選擇安全的密碼。
ClientIP	您正在從中執行 PowerShell 的系統所擁有的公用 IP 位址。

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

New-AzResourceGroup -Name $SynapseResourceGroup -Location $Region

建立 Azure Synapse 工作區：

$Cred = New-Object -TypeName System.Management.Automation.PSCredential ($SqlUser, (ConvertTo-SecureString $SqlPassword -AsPlainText -Force))

$WorkspaceParams = @{
  Name = $SynapseWorkspaceName
  ResourceGroupName = $SynapseResourceGroup
  DefaultDataLakeStorageAccountName = $StorageAccountName
  DefaultDataLakeStorageFilesystem = $FileShareName
  SqlAdministratorLoginCredential = $Cred
  Location = $Region
}
New-AzSynapseWorkspace @WorkspaceParams

取得 Azure Synapse 工作區的 Web 和開發 URL：

$WorkspaceWeb = (Get-AzSynapseWorkspace -Name $SynapseWorkspaceName -ResourceGroupName $StorageAccountResourceGroup).ConnectivityEndpoints.web
$WorkspaceDev = (Get-AzSynapseWorkspace -Name $SynapseWorkspaceName -ResourceGroupName $StorageAccountResourceGroup).ConnectivityEndpoints.dev

建立防火牆規則，以允許從您的電腦存取 Azure Synapse 工作區：

$FirewallParams = @{
  WorkspaceName = $SynapseWorkspaceName
  Name = 'Allow Client IP'
  ResourceGroupName = $StorageAccountResourceGroup
  StartIpAddress = $ClientIP
  EndIpAddress = $ClientIP
}
New-AzSynapseFirewallRule @FirewallParams

開啟儲存在環境變數 WorkspaceWeb 中的 Azure Synapse 工作區 Web URL 位址，以存取您的工作區：
```
Start-Process $WorkspaceWeb
```
部署之後，需要額外的權限。

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

清除資源

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

警告

刪除 Azure Synapse 工作區將會移除分析引擎和儲存在包含 SQL 集區和工作區繼資料之資料庫中的資料。您無法再連線到 SQL 或 Apache Spark 端點。系統將刪除所有程式碼成品 (查詢、筆記本、作業定義和管線)。刪除工作區不會影響連結到工作區之 Data Lake Store Gen2 中的資料。

如果您不需要本文所建立的 Azure Synapse 工作區，則可以執行下列範例來將其刪除。

Remove-AzSynapseWorkspace -Name $SynapseWorkspaceNam -ResourceGroupName $SynapseResourceGroup

後續步驟

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

共用方式為