Azure DevOps YAML管道SQL迁移任务报架构不存在或无权限错误

报错根因 #

使用服务主体身份执行SQL脚本时，Azure SQL会为当前登录身份默认分配与账号名一致的默认架构，也就是报错中的xxx@xxx，但你未提前创建该架构，也没有给服务主体配置正确的默认架构与操作权限，导致建表时无法找到对应架构。

排查步骤 #

• 确认sqlserviceConnection对应的服务主体标识：进入Azure DevOps项目设置→服务连接→找到sqlserviceConnection，查看对应的服务主体名称/客户端ID，确认和报错中的xxx@xxx是否匹配。
• 以SQL AD管理员身份登录demodb，执行以下命令验证服务主体是否已被添加到数据库用户列表：

SELECT name, type_desc FROM sys.database_principals WHERE type = 'E'

检查返回结果中是否存在和报错xxx@xxx一致的用户。

• 检查该服务主体的默认架构配置：

SELECT name, default_schema_name FROM sys.database_principals WHERE name = 'xxx@xxx' --替换为报错中的架构名

如果未提前配置，default_schema_name字段会返回NULL，这是报错的直接原因。

解决方案 #

以下两种方案任选其一即可：

方案1：给服务主体配置默认使用dbo架构（最常用，适配你当前无前缀的SQL脚本） #

用SQL Server AD管理员账号登录demodb，执行以下命令：

-- 若服务主体尚未创建数据库用户，先执行创建
CREATE USER [你的服务主体名称/客户端ID] FROM EXTERNAL PROVIDER;
-- 分配权限，可根据安全需求调整为更小权限集，比如db_ddladmin+db_datawriter+db_datareader
ALTER ROLE db_owner ADD MEMBER [你的服务主体名称/客户端ID];
-- 设置默认架构为dbo
ALTER USER [你的服务主体名称/客户端ID] WITH DEFAULT_SCHEMA = dbo;

配置完成后重新运行流水线即可，你的SQL脚本中的表未指定架构前缀，会默认使用dbo，不会再查找xxx@xxx架构。

方案2：修改SQL脚本，所有表操作明确指定架构前缀 #

如果你的团队规范要求不能使用dbo作为默认架构，可以把脚本中所有表名前加上[dbo].前缀，示例：

-- 原写法
CREATE TABLE [__EFMigrationsHistory]
-- 修改后写法
CREATE TABLE [dbo].[__EFMigrationsHistory]

所有涉及表操作的语句（建表、查询、插入）都需要加上[dbo].前缀，修改完成后重新提交代码运行流水线即可。

额外检查项 #

你提供的YAML配置中SqlFile字段缩进异常，会导致参数读取失败，修正后的正确配置如下：

- task: SqlAzureDacpacDeployment@1
  inputs:
    azureSubscription: 'sqlserviceConnection' 
    AuthenticationType: 'servicePrincipal'
    ServerName: 'demodb.database.windows.net'
    DatabaseName: 'demodb'
    deployType: 'SqlTask'
    SqlFile: '$(Build.ArtifactStagingDirectory)\publish\SQL\migrate.sql'
    IpDetectionMethod: AutoDetect

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