Azure Static Web Apps 中的数据库连接配置（预览）

Azure Static Web Apps 数据库连接适用于各种 Azure 数据库。

将数据库连接到静态 Web 应用时，需要配置数据库的防火墙，通过允许来自 Azure 资源的网络访问以接受来自 Static Web Apps 辅助角色的网络访问。 不支持允许特定的 Static Web Apps IP 地址。

如果使用托管标识身份验证类型，则你需要配置静态 Web 应用的托管标识配置文件以访问数据库。

使用此表，详细了解数据库的防火墙和托管标识配置。

配置

在 staticwebapp.database.config.json 文件中定义数据库连接的运行时行为。 将数据库链接到静态 Web 应用之前，需要在存储库中创建此文件。 按照约定，此文件存在于存储库根的 swa-db-connections 文件夹中，但如果你愿意，可将其重新定位。

配置文件的目的是：

• 将 /data-api 终结点的路径映射到数据库表或实体
• 公开 REST 或 GraphQL 终结点（或两者）
• 定义实体安全规则
• 控制开发配置设置

如果将 Azure Cosmos DB 与 GraphQL 配合使用，则你还需要提供一个 gql 架构文件。

示例配置文件

以下示例配置文件演示如何连接到 Azure SQL 数据库并公开 REST 和 GraphQL 终结点。 有关配置文件及其支持的功能的完整详细信息，请参阅数据 API 生成器文档。

{
  "$schema": "https://github.com/Azure/data-api-builder/releases/latest/download/dab.draft.schema.json",
  "data-source": {
    "database-type": "mssql",
    "options": {
      "set-session-context": false 
    },
    "connection-string": "@env('DATABASE_CONNECTION_STRING')"
  },
  "runtime": {
    "rest": {
      "enabled": true,
      "path": "/rest"
    },
    "graphql": {
      "allow-introspection": true,
      "enabled": true,
      "path": "/graphql"
    },
    "host": {
      "mode": "production",
      "cors": {
        "origins": ["http://localhost:4280"],
        "allow-credentials": false
      },
      "authentication": {
        "provider": "StaticWebApps"
      }
    }
  },
  "entities": {
    "Person": {
      "source": "dbo.MyTestPersonTable",
      "permissions": [
        {
          "actions": ["create", "read", "update", "delete"],
          "role": "anonymous"
        }
      ]
    }
  }
}

生成配置文件

使用 Static Web Apps CLI，可生成配置文件存根。

使用 swa db init --database-type <YOUR_DATABASE_TYPE> 生成配置文件。 默认情况下，CLI 在名为 swa-db-connections 的文件夹中创建一个新的 staticwebapp.database.config.json。

支持的数据库类型包括：

• mssql
• postgresql
• cosmosdb_nosql
• mysql

自定义配置文件夹

staticwebapp.database.config.json 文件的默认文件夹名称为 swa-db-connections。 若要使用不同的文件夹，需要更新工作流文件，以告知 Static Web Apps 运行时在何处查找配置文件。 使用 data_api_location 属性，可定义配置文件夹的位置。

以下代码显示如何对数据库配置文件使用名为 db-config 的文件夹。

app_location: "/src"
api_location: "api"
output_location: "/dist"
data_api_location: "db-config" # Folder holding the staticwebapp.database.config.json file

配置数据库连接

Azure Static Web Apps 必须对数据库具有网络访问权限，数据库连接才能正常工作。 此外，若要使用 Azure 数据库进行本地开发，需要配置数据库，以允许来自你自己的 IP 地址的请求。 以下是适用于所有数据库的通用步骤。 有关数据库类型的特定步骤，请参阅上述链接。

• 在 Azure 门户中转到你的数据库。
• 转到“网络”选项卡。
• 在“防火墙规则”部分下，选择“添加客户端 IPv4 地址”。 此步骤可确保可以将此数据库用于本地开发。
• 选中“允许 Azure 服务和资源访问此服务器”复选框。 此步骤可确保部署的 Static Web Apps 资源可以访问数据库。
• 选择“保存”。

连接数据库

在发布到 Azure 时，将数据库链接到静态 Web 应用会在网站和数据库之间建立生产连接。

1. 在 Azure 门户中打开静态 Web 应用。

2. 在“设置”部分中，选择“数据库连接”。

3. 在“生产”部分下，选择“链接现有数据库”链接。

4. 在“链接现有数据库”窗口中，输入以下值：

   properties	值
   数据库类型	从下拉列表中选择你的数据库类型。
   订阅	从下拉列表中选择你的 Azure 订阅。
   资源名称	选择具有所需数据库的数据库服务器名称。
   数据库名称	选择要链接到静态 Web 应用的数据库的名称。
   身份验证类型	选择连接到数据库所需的连接类型。

相关内容

使用以下数据库之一，将数据库添加到静态 Web 应用：

• Azure Cosmos DB
• Azure SQL
• MySQL
• PostgreSQL

此外，你还可了解如何将数据 API 生成器与 Azure Static Web Apps 配合使用。