Power BI通过Python脚本连接CockroachDB的简易快速方法指导

前置准备 #

• 确保电脑已安装Python（推荐3.8及以上版本，和Power BI兼容）
• 打开命令提示符（CMD）或终端，执行以下命令安装必要库：

  pip install psycopg2-binary pandas
  

  （用psycopg2-binary是因为它无需编译环境，比原版psycopg2更容易安装）

步骤1：在Power BI中启动Python脚本数据源 #

1. 打开Power BI Desktop，点击左上角获取数据 > 选择更多...
2. 在弹出窗口搜索Python脚本，选中后点击连接

步骤2：编写连接CockroachDB的Python脚本 #

在弹出的脚本编辑框中，粘贴以下代码，替换成你的CockroachDB连接信息：

import pandas as pd
import psycopg2

# 替换成你的CockroachDB连接参数
conn_params = {
    "host": "你的CockroachDB主机地址",
    "port": "26257",  # 默认端口，如有修改请替换
    "dbname": "目标数据库名",
    "user": "数据库用户名",
    "password": "数据库密码",
    "sslmode": "require"  # CockroachDB通常需要SSL连接，保持这个参数
}

# 建立连接并查询数据
try:
    conn = psycopg2.connect(**conn_params)
    # 替换成你要执行的SQL查询语句
    sql_query = "SELECT * FROM 你的表名 LIMIT 100;"
    # 将查询结果转为Power BI能识别的DataFrame
    df = pd.read_sql(sql_query, conn)
finally:
    # 确保连接关闭
    if conn:
        conn.close()

# 输出数据框，Power BI会识别这个变量
df

• 重点替换：host、dbname、user、password、sql_query里的表名和查询语句
• 若CockroachDB无需SSL，把sslmode改成disable（生产环境不推荐）

步骤3：加载数据到Power BI #

1. 点击确定运行脚本，Power BI会执行代码并显示可用的数据表（即df）
2. 选中df，点击加载，数据就会导入Power BI，之后可正常建模和可视化

常见问题排查 #

• 提示找不到psycopg2或pandas：检查Power BI使用的Python环境是否和安装库的环境一致。可在Power BI的文件 > 选项和设置 > 选项 > Python脚本里查看Python路径，确保用的pip对应这个路径
• 连接失败：检查主机地址、端口、用户名密码是否正确，确认CockroachDB实例允许你的电脑IP访问，防火墙是否开放26257端口
• SQL查询报错：确保表名、字段名拼写正确，用户有对应表的查询权限

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