快速入門：使用 Azure CLI 建立 Synapse SQL 集區

發行項
03/10/2023

使用 Azure CLI 在 Azure Synapse Analytics 中建立 Synapse SQL 集區 (資料倉儲)。

必要條件

在 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 並設定資源群組。

如果您使用本機安裝，請執行 az login 命令以登入 Azure：
```
az login
```
如有需要，請使用 az account set 命令選取您的訂用帳戶：
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```

執行 az group create 命令以建立資源群組：

az group create --name myResourceGroup --location WestEurope

使用 az sql server create 命令建立邏輯 SQL Server：

az sql server create --resource-group myResourceGroup --name mysqlserver \
   --admin-user ServerAdmin --admin-password ChangeYourAdminPassword1

一個伺服器會包含一組以群組方式管理的資料庫。

設定伺服器層級防火牆規則

建立伺服器層級防火牆規則。伺服器層級防火牆規則可讓外部應用程式 (例如 SQL Server Management Studio 或 SQLCMD 公用程式) 穿過 SQL 集區服務防火牆連線到 SQL 集區。

執行 az sql server firewall-rule create 命令，以建立防火牆規則：

az sql server firewall-rule create --resource-group myResourceGroup --name AllowSome \
   --server mysqlserver --start-ip-address 0.0.0.0 --end-ip-address 0.0.0.0

在此範例中，只會針對其他 Azure 資源開啟防火牆。若要啟用外部連線，請將 IP 位址變更為適合您環境的地址。若要開啟所有 IP 位址，請使用 0.0.0.0 作為起始 IP 位址，並使用 255.255.255.255 作為結束位址。

注意

SQL 端點會透過連接埠 1433 進行通訊。如果您嘗試從公司網路連線，您網路的防火牆可能不允許透過連接埠 1433 的連出流量。若是如此，除非 IT 部門開啟連接埠 1433，否則您將無法連線到您的伺服器。

建立和管理您的 SQL 集區

建立 SQL 集區。此範例會使用 DW100c 作為服務目標，這對 SQL 集區而言是成本較低的起點。

注意

您需要先前建立的工作區。如需詳細資訊，請參閱快速入門：使用 Azure CLI 建立 Azure Synapse 工作區。

使用 az synapse sql pool create 命令建立 SQL 集區：

az synapse sql pool create --resource-group myResourceGroup --name mySampleDataWarehouse \
   --performance-level "DW1000c" --workspace-name testsynapseworkspace

如需參數選項的詳細資訊，請參閱 az synapse sql pool。

您可以使用 az synapse sql pool list 命令來查看您的 SQL 集區：

az synapse sql pool list --resource-group myResourceGroup --workspace-name testsynapseworkspace

使用 az synapse sql pool update 命令更新現有的集區：

az synapse sql pool update --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

使用 az synapse sql pool pause 命令暫停集區：

az synapse sql pool pause --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

使用 az synapse sql pool resume 命令啟動暫停的集區：

az synapse sql pool resume --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

若要移除現有的 SQL 集區，請使用 az synapse SQL pool delete 命令：

az synapse sql pool delete --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

清除資源

此集合中的其他快速入門教學課程會以此快速入門為基礎。

提示

如果您打算繼續進行後續的快速入門教學課程，請勿清除在此快速入門中建立的資源。如果您不打算繼續，請使用 az group delete 命令刪除本快速入門中建立的所有資源。

az group delete --ResourceGroupName MyResourceGroup

後續步驟

您現在已建立了 SQL 集區、防火牆規則並連線到您的 SQL 集區。若要深入了解，請繼續閱讀將資料載入 SQL 集區一文。