如何使用Python和SQL导出pgAdmin表中指定范围行数据为Excel格式

1. 前置依赖安装 #

需要用到3个第三方库，执行以下命令安装：

pip install psycopg2-binary pandas openpyxl

各库作用：

• psycopg2-binary：Python连接PostgreSQL数据库的驱动
• pandas：处理查询结果，快速导出为Excel格式
• openpyxl：pandas写入.xlsx格式文件的依赖引擎

2. 完整可运行代码示例 #

import tkinter as tk
from tkinter import filedialog, messagebox
import psycopg2
import pandas as pd

# -------------------------- 请修改以下配置为你自己的数据库信息 --------------------------
PG_CONFIG = {
    "host": "127.0.0.1",      # 数据库地址
    "port": "5432",           # 数据库端口，默认5432
    "database": "your_db",    # 数据库名称
    "user": "your_user",      # 数据库用户名
    "password": "your_pass"   # 数据库密码
}
TARGET_TABLE = "your_table"   # 要查询的表名
QUERY_FIELDS = ["id", "name", "create_time", "phone"] # 要导出的字段，写*代表导出全部字段
# -------------------------------------------------------------------------------------

def export_data():
    # 1. 让用户选择保存路径
    save_path = filedialog.asksaveasfilename(
        defaultextension=".xlsx",
        filetypes=[("Excel文件", "*.xlsx"), ("所有文件", "*.*")],
        title="选择保存位置"
    )
    if not save_path: # 用户点了取消就直接返回
        return

    try:
        # 2. 连接PostgreSQL数据库
        conn = psycopg2.connect(**PG_CONFIG)

        # 3. 编写查询SQL，取1000-2000行数据
        # 方式1：OFFSET+LIMIT，性能高，适合有稳定排序字段的场景
        fields_str = ", ".join(QUERY_FIELDS)
        sql = f"""
            SELECT {fields_str} 
            FROM {TARGET_TABLE} 
            ORDER BY id  -- 必须指定排序字段，否则查询结果顺序不稳定
            OFFSET 999 LIMIT 1000;
        """
        # 方式2：ROW_NUMBER窗口函数，适合需要明确行号过滤的场景，性能略低于方式1
        # sql = f"""
        #     SELECT {fields_str} FROM (
        #         SELECT {fields_str}, ROW_NUMBER() OVER (ORDER BY id) AS row_num
        #         FROM {TARGET_TABLE}
        #     ) AS temp_table
        #     WHERE row_num BETWEEN 1000 AND 2000;
        # """

        # 4. 读取查询结果到DataFrame
        df = pd.read_sql(sql, conn)

        # 5. 导出到Excel
        df.to_excel(save_path, index=False, engine="openpyxl")

        # 6. 关闭数据库连接
        conn.close()

        messagebox.showinfo("成功", f"数据导出完成，共导出{len(df)}条数据\n文件已保存至：{save_path}")
    except Exception as e:
        messagebox.showerror("失败", f"导出出错：{str(e)}")

# -------------------------- Tkinter界面初始化 --------------------------
root = tk.Tk()
root.title("数据导出工具")
root.geometry("300x150")

export_btn = tk.Button(root, text="导出1000-2000行数据", command=export_data, font=("微软雅黑", 12), padx=10, pady=5)
export_btn.pack(pady=50)

root.mainloop()

3. 关键说明 #

• pgAdmin是PostgreSQL的可视化管理工具，本方案直接连接PostgreSQL数据库服务，不需要启动pgAdmin即可正常运行
• SQL查询中的ORDER BY必须指定稳定的排序字段（比如自增ID、创建时间），否则每次查询的行顺序可能变化，导致导出的区间数据不准确
• OFFSET参数从0开始计数，所以要取1000到2000行的话，OFFSET值为999，LIMIT为1000

4. 常见问题排查 #

• 数据库连接失败：检查PostgreSQL服务是否正常运行，防火墙是否开放5432端口，数据库账号密码、地址端口配置是否正确
• Excel导出失败：检查保存路径是否有写入权限，目标Excel文件是否被其他程序打开占用，openpyxl库是否安装成功
• 导出数据行数不对：检查排序字段是否存在重复值，导致行顺序不稳定，可改为多字段排序保证顺序唯一

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