在Jupyter Notebook运行SQL命令报错：需SQLAlchemy格式的连接信息

核心错误原因 #

你当前使用的PostgreSQL连接字符串不符合SQLAlchemy要求的格式，是触发报错的直接原因。

第一步：修正连接字符串 #

SQLAlchemy规定PostgreSQL的连接URI标准格式为：
postgresql://[用户名]:[密码]@[主机地址]:[端口号]/[数据库名]
你现有代码中postgresql:/仅写了1个斜杠，修正后完整代码如下：

%load_ext sql
%sql postgresql://test:test@localhost:5432/tm351test

修正后重新运行，大部分情况下可直接连接成功。

第二步：修正后仍报错的排查方案 #

• 检查依赖安装完整性：需要同时安装ipython-sql、sqlalchemy、psycopg2-binary三个依赖包，执行以下命令安装后重启Jupyter内核重试：

  pip install ipython-sql sqlalchemy psycopg2-binary
  

• 检查PostgreSQL服务状态：确认本地5432端口的PostgreSQL服务已正常启动，没有被防火墙拦截。
• 验证账号权限：可直接通过命令行登录验证账号和数据库是否正常，命令如下，能正常登录则说明账号权限无问题：

  psql -U test -d tm351test -h localhost -p 5432
  

• 适配高版本SQLAlchemy：如果使用的是2.0及以上版本的SQLAlchemy，需要用连接对象写法，代码调整为：

  %load_ext sql
  from sqlalchemy import create_engine
  engine = create_engine('postgresql://test:test@localhost:5432/tm351test')
  %sql engine
  

连接成功验证 #

运行测试查询语句，正常返回PostgreSQL版本信息即为连接成功：

%sql SELECT version();

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