使用Laravel Query Builder实现同主机SQL Server跨库连表查询

问题描述 #

需要在单条查询中关联同一主机SQL Server实例下两个不同数据库的表，基于Laravel Query Builder编写查询时返回语法错误，但框架生成的SQL语句直接复制到数据库脚本编辑器中可以正常执行并返回预期结果。

初始报错写法 #

return DB::table('users')
    ->select([
        'users.id',
        'Resources.FirstName'
    ])
    ->join('Resources.dbo.ID', 'Resources.UserID', '=', 'users.id');

对应报错信息 #

General error: 1 near ".": syntax error (SQL: select "users"."id", "Resources"."FirstName" from "users" inner join "Resources"."dbo"."ID" on "Resources"."ID" = "users"."id")

已尝试的无效写法 #

• 使用DB::raw包裹带dbo前缀的跨库表名：

return DB::table('users')
    ->select([
        'users.id',
        'Resources.FirstName'
    ])
    ->join(DB::raw('Resources.dbo.ID'), 'Resources.UserID', '=', 'users.id');

• 使用DB::raw包裹省略dbo前缀的跨库表名：

return DB::table('users')
    ->select([
        'users.id',
        'Resources.FirstName'
    ])
    ->join(DB::raw('Resources.ID'), 'Resources.UserID', '=', 'users.id');

• 在join闭包内单独指定跨库连接：

->join('Resources', function($q) {
    $q->connection('tcollect')->on('Resources.ID', '=', 'users.id');
});

解决方案 #

报错核心原因是Laravel查询构造器默认会对包含.的标识符做自动拆分、逐段加双引号处理，原本合法的跨库表名格式库名.dbo.表名被错误拆分为多个独立字段标识符，最终生成的SQL不符合SQL Server语法要求。可根据项目场景选择以下任意一种方案实现：

1. 临时关闭标识符引用（开发调试/单次查询推荐）
   查询前临时关闭当前数据库连接的标识符自动加引号逻辑，查询完成后恢复，不影响其他业务查询：

   // 临时关闭标识符自动引用
   DB::connection()->getQueryGrammar()->setQuoting(false);
   
   $res = DB::table('users')
       ->select([
           'users.id',
           'Resources.dbo.FirstName' // 跨库字段需写全 库名.dbo.字段名 前缀
       ])
       ->join('Resources.dbo.ID', 'Resources.dbo.UserID', '=', 'users.id')
       ->get();
   
   // 恢复默认引用配置
   DB::connection()->getQueryGrammar()->setQuoting(true);
   
   return $res;
   

2. 全跨库字段使用raw包裹（无需修改配置）
   不想调整连接配置的话，把所有涉及跨库的表名、关联字段、查询字段全部用DB::raw()包裹，跳过Laravel的自动标识符拆分逻辑：

   return DB::table('users')
       ->select([
           'users.id',
           DB::raw('Resources.dbo.FirstName')
       ])
       ->join(
           DB::raw('Resources.dbo.ID'), 
           DB::raw('Resources.dbo.UserID'), 
           '=', 
           'users.id'
       )
       ->get();
   

3. 全局配置关闭标识符引用（跨库查询频繁的项目推荐）
   如果项目中存在大量同实例跨库查询需求，直接修改config/database.php中对应SQL Server连接的配置，添加'quoting' => false，后续查询直接写全库名+schema前缀即可，无需额外加raw或临时修改配置。

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