关于Azure SQL Database 2014版API退役通知的疑问及排查

收到的微软通知内容 #

Azure SQL Database 2014-04-01版本API将于2025年10月31日退役。

你收到此邮件是因为你使用了Azure SQL Database API。

为提升性能与安全性，我们正在更新Azure SQL Database API。作为更新的一部分，所有2014-04-01版本的API将于2025年10月31日退役。在此日期前，你需要更新所有相关资源（包括模板、工具、脚本和程序）以使用更新的API版本。过期后仍使用旧版本API的调用将停止工作，直至完成更新。

我的情况与疑问 #

本人2020年后才开始使用Azure，不解为何会触发该通知。本人通过以下六种方式访问Azure SQL Database：

• 从Web应用通过Java连接和ODBC驱动访问：

  public final class DBConnection {
      private static DataSource ds = null;
      private static DBConnection instance = null;
      private DBConnection() throws NamingException {
          InitialContext ic = new InitialContext();
          ds = (DataSource) ic.lookup(Monitor.getDsName());
      }
  }
  

  <dependency>
      <groupId>com.microsoft.sqlserver</groupId>
      <artifactId>mssql-jdbc</artifactId>
      <version>10.2.1.jre11</version>
  </dependency>
  

• 通过sqlcmd访问
• 通过Node.js访问：

  const configDB = {
      user: "",
      password: "",
      server: "myserver.database.windows.net",
      database: "mydb",
      connectionTimeout: 3000,
      parseJSON: true,
      options: {encrypt: true, enableArithAbort: true},
      pool: {min: 0, idleTimeoutMillis: 3000}
  };
  const poolDB = new sql.ConnectionPool(configDB);
  aLine='EXEC ...'
  await poolFOI.connect();
  let resultDB = await poolDB.request().query(aLine);
  

• 通过Azure Logic Apps（使用API连接）访问
• 通过Azure Function Apps（连接方式与上述Web应用类似）访问
• 通过SSMS访问

请问上述哪些访问方式可能触发该API退役通知？

解答 #

首先明确：这个通知针对的是Azure资源管理层面的ARM API（用于创建、配置、删除Azure SQL Database等资源的REST API），而非直接连接数据库执行SQL的客户端驱动或工具。

各访问方式分析 #

1. Web应用Java连接、Azure Function Apps：通过JDBC驱动直接连接数据库执行SQL，属于数据库协议层面的访问，和ARM API无关，不会触发通知。
2. sqlcmd、Node.js、SSMS：作为客户端工具/SDK，直接通过TDS协议连接数据库执行SQL，不涉及ARM API调用，不会触发通知。
3. Azure Logic Apps（API连接）：如果你的Logic Apps使用的是管理类连接器（比如用来创建数据库、修改数据库配置等操作），底层可能调用了旧版本ARM API，会触发通知；但如果只是用连接器执行SQL查询/写入，属于数据库协议访问，和ARM API无关，不会触发。

为何2020年后使用仍收到通知？ #

可能的原因包括：

• 你的Azure订阅下存在早期部署的ARM模板、自动化脚本，在调用2014-04-01版本的ARM API；
• 你使用的第三方工具、CI/CD管道等自动化流程，底层依赖了旧版本API；
• 微软通知存在误触发，可通过Azure门户的资源活动日志排查是否有旧版本API的调用记录。

内容的提问来源于stack exchange，提问作者gordon613