AskTable

20 分钟学会用 Python + AskTable,通过自然语言查询 MySQL 数据库

AskTable 团队
AskTable 团队 2025年3月27日

让我们用 Python 举例说明,从零开始如何使用 AskTable,通过自然语言查询 MySQL 数据库。全部过程只需要三步。

第一步:本地安装 AskTable(约 10 分钟)

(若使用线上 SaaS 版本,则跳过)
参考文档:https://docs.asktable.com/docs/pricing-and-deployment/private-deployment-all-in-one

安装完成后,用初始账号登录系统,进入「项目配置」页面创建一个 API-KEY,备用。

第二步:添加数据库(约 5 分钟)

可以通过网页操作来添加数据库:

  1. 打开 AskTable 网址(如果本地安装,则打开本地网址)
  2. 点击「添加数据」,填写希望生成 SQL 的数据库连接信息,例如 MySQL 的主机地址、端口、用户名和密码等。

添加数据库

第三步:用自然语言查询数据(约 5 分钟)

首先,安装 Python SDK:

pip install asktable

查询数据只需要简单几行代码:

from asktable import Asktable

# 初始化 AskTable 客户端
at = Asktable(api_key="<ASKTABLE_API_KEY>")

# 使用创建的数据源 ID 和问题进行查询
datasource_id = "<YOUR_DATASOURCE_ID>"
question = "今天注册人数"

# 查询
answer = at.answers.create(
    datasource_id=datasource_id,  # 刚才创建的数据源 ID
    question=question
).answer

# 输出答案
print(answer.text)

赠送:用自然语言生成 SQL(约 5 分钟)

生成 SQL 也只需要简单几行代码:

# 生成 SQL 查询
sql = at.sqls.create(
    datasource_id=datasource_id,  # 刚才创建的数据源 ID
    question=question
).query

# 输出生成的 SQL 语句
print(sql.prepared_statement)