你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：使用 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 服务器：

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 池。

可使用 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 池一文。

通过