Azure托管Postgres灵活服务器PostGIS函数找不到问题求助

1. PostGIS函数位于ext schema的原因 #

这是Azure PostgreSQL灵活服务器的托管特性，而非PostGIS的标准规范。标准PostGIS安装时，所有对象（函数、表、类型）都会被部署到你指定的目标schema（这里是dbo），但Azure的托管服务可能会将部分核心扩展对象默认放在ext schema中，即使你指定了其他安装路径——这是Azure为了统一管理扩展依赖、避免用户误操作系统对象而做的限制。

你看到pgAdmin中dbo扩展列表显示PostGIS，是因为扩展的元数据（pg_extension记录）被放在了dbo，但实际的函数、系统表等实体对象被Azure托管到了ext schema。

2. 能否将PostGIS函数移动到dbo schema？ #

理论上可以通过ALTER FUNCTION语句批量迁移函数，但不推荐：

• Azure托管的扩展对象可能受到保护，强行修改会触发未知的兼容性问题，甚至导致PostGIS功能失效；
• 迁移过程中会产生依赖连锁反应（比如函数依赖的类型、其他函数），容易引发错误；
• 后续Azure对PostGIS的版本更新可能会重置这些对象的schema，导致配置失效。

如果必须尝试，单条函数迁移的命令示例：

ALTER FUNCTION ext.st_asewkb(geometry) SET SCHEMA dbo;

但批量操作需要遍历所有PostGIS函数，风险极高，不建议在生产环境执行。

3. 在SQLAlchemy/GeoAlchemy2中指定函数schema的解决方案 #

无需修改数据表或数据库搜索路径，通过以下方式让SQLAlchemy调用带schema前缀的PostGIS函数：

方案一：自定义Geometry类型重载序列化函数 #

创建自定义Geometry类型，强制使用ext schema的ST_AsEWKB函数：

from sqlalchemy import func
from geoalchemy2 import Geometry

class ExtSchemaGeometry(Geometry):
    def as_binary(self, value):
        # 明确指定ext schema下的ST_AsEWKB
        return func.ext.ST_AsEWKB(value)

在模型中使用该类型：

from sqlalchemy import Column, Integer, String
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class Building(Base):
    __tablename__ = 'building'
    __table_args__ = {'schema': 'dbo'}  # 数据表仍在dbo
    id = Column(Integer, primary_key=True)
    postal_code = Column(String)
    coordinates = Column(ExtSchemaGeometry(geometry_type='POINT', srid=4326))

方案二：直接调用带schema的函数对象 #

在需要手动构造查询时，直接使用func.ext.ST_AsEWKB替代默认的ST_AsEWKB：

from sqlalchemy import select

# 查询时明确指定schema
stmt = select(
    Building.id,
    Building.postal_code,
    func.ext.ST_AsEWKB(Building.coordinates).label('coordinates')
).where(Building.id == 1)

方案三：配置GeoAlchemy2的默认schema #

通过init_geometries函数注册PostGIS对象时指定ext schema：

from sqlalchemy import create_engine
from geoalchemy2 import init_geometries

engine = create_engine('postgresql://<user>:<password>@<host>:<port>/<dbname>')
# 注册ext schema下的PostGIS几何类型和函数
init_geometries(engine, schema='ext')

此方法会让GeoAlchemy2默认使用ext schema中的PostGIS函数，无需修改模型定义。

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