快速入门:创建 Azure SQL 数据库的本地开发环境

Azure SQL 数据库本地开发体验提供了一种在本地 Azure SQL 数据库模拟器中设计、编辑、生成/验证、发布和运行数据库架构的方法。 借助数据库项目功能,开发人员可以轻松地将数据库项目从其本地环境发布到 Azure SQL 数据库公共服务,并管理数据库的整个生命周期(例如管理架构偏差等)。 本快速入门介绍了利用 Azure SQL 数据库本地开发体验的整个工作流。

重要

使用Azure SQL 数据库开发容器模板设置开发环境。 首先,使用开发容器模板设置 Azure SQL 数据库本地开发环境。 对于本地开发来说,开发容器模板是 Azure SQL 数据库模拟器的更好替代方案和替代品。

先决条件

若要完成本快速入门,必须先为 Azure SQL 数据库设置本地开发环境

创建一个空白项目

首先,创建一个空白数据库项目,或打开一个现有项目。 本部分中的步骤可帮助你创建新的空白项目,但你也可以:

  1. 转到“数据库项目”视图,或在命令面板中搜索“数据库项目: 打开现有”,以打开现有项目。
  2. 通过从命令面板或数据库上下文菜单中选择“从数据库创建项目”,从现有的数据库开始。
  3. 使用命令面板中的“数据库项目: 从 OpenAPI/Swagger 规范生成 SQL 项目(预览版)”命令,从 OpenAPI/Swagger 规范开始。

使用 Visual Studio Code 或 Azure Data Studio 创建新项目的步骤是相同的。 若要创建空白项目,请执行以下步骤:

  1. 打开所选择的开发人员工具 - Azure Data Studio 或 Visual Studio Code。

  2. 选择“项目”,然后选择创建新的数据库项目。 或者,在命令面板中搜索“数据库项目: 新建”。

  3. 选择“SQL 数据库”作为项目类型。

    在 Visual Studio Code 中为数据库项目选择项目类型的屏幕截图。

  4. 提供新 SQL 数据库项目的名称。

    在 Visual Studio Code 中为数据库项目输入名称的屏幕截图。

  5. 选择“SDK 样式的 SQL 数据库项目”项目。 (建议使用 SDK 样式的 SQL 项目,因为针对团队的存储库与多个开发人员合作时,它更简洁、更易于管理。)

    在 Visual Studio Code 中为数据库项目选择样式的屏幕截图。

  6. 若要为项目设置目标平台,请右键单击数据库项目名称,然后选择“更改目标平台”。 选择“Azure SQL 数据库”作为项目的目标平台。

    为数据库项目选择 Azure SQL 数据库作为目标的屏幕截图。

    设置目标平台可为 SQL 数据库项目对象和脚本提供编辑和生成时间支持。 选择目标平台后,Visual Studio Code 突出显示语法问题或指示所选平台正在使用不受支持的功能。

    可选地,可将 SQL 数据库项目文件与应用程序项目一起置于源代码管理之下。

  7. 将对象添加到数据库项目。 可创建或更改数据库对象,例如表、视图、存储过程和脚本。 例如,请右键单击数据库项目名称,然后选择“添加表”以添加表。

    在 Visual Studio Code 中从“数据库项目”菜单添加表的屏幕截图。

  8. 生成数据库项目,验证它可以针对 Azure SQL 数据库平台工作。 若要生成项目,请右键点击数据库项目名称,然后选择“生成”。

    在 Visual Studio Code 中从“数据库项目”菜单选择生成的屏幕截图。

  9. 数据库项目准备好进行测试后,将其发布到目标。 若要开始发布过程,请右键单击数据库项目的名称,然后选择“发布”。

    在 Visual Studio Code 的“SQL 数据库项目”菜单中选择“发布”的屏幕截图。

  10. 发布时,可选择发布到新服务器或现有服务器。 在此示例中,选择“发布到新的 Azure SQL 数据库模拟器”。

    在 Visual Studio Code 中选择发布目标的屏幕截图。

  11. 发布到新的 Azure SQL 数据库模拟器时,系统会提示你在“精简”和“完整”映像之间进行选择。 “精简”映像与大多数 Azure SQL 数据库功能兼容,并且是一种轻量级映像,下载和实例化所需的时间更少。 “完整”映像使你能够访问内存中优化表、异地空间数据类型等高级功能,但需要更多资源。

    在 Visual Studio Code 中选择 Azure SQL 数据库模拟器的屏幕截图。

    可根据可用资源创建任意数量的本地实例,并通过 Visual Studio Code Docker 扩展或 CLI 命令管理它们的生命周期。

    通过 CLI 管理 Azure SQL 数据库模拟器的屏幕截图。

  12. 运行数据库项目的实例后,可从 Visual Studio Code mssql 扩展进行连接,并测试脚本和查询,就像 Azure SQL 数据库中的任何常规数据库一样。

    连接到 Azure SQL 数据库模拟器并对其进行查询的屏幕截图。

  13. 随着每次在数据库项目中添加或修改对象的迭代,重新生成数据库项目并将其部署到本地计算机上运行的容器化实例之一,直到它准备就绪。

    在数据库项目上进行迭代的屏幕截图。

  14. 数据库项目生命周期的最后一步是使用 mssql 扩展将完成的项目发布到 Azure SQL 数据库中的新数据库或现有数据库。 右键单击数据库项目名称,然后选择“发布”。 然后,选择要发布项目的目标,例如 Azure 中新的或现有的逻辑服务器

    向 Azure SQL 数据库发布数据库项目的屏幕截图。

后续步骤

详细了解 Azure SQL 数据库的本地开发体验: