大网数据广告活动
数据库部署与 SQL 参考

图像搜索示例

· 52CE 我爱测

本示例展示了如何通过结合 TiDB 向量搜索能力与多模态嵌入模型,构建一个图像搜索应用。

图像搜索示例

本示例展示了如何通过结合 TiDB 向量搜索能力与多模态嵌入模型,构建一个图像搜索应用。

只需几行代码,你就可以创建一个能够理解文本和图像的搜索系统。

  • Text-to-image search:通过自然语言描述(如 “fluffy orange cat”)查找宠物照片
  • Image-to-image search:上传一张照片,根据品种、颜色、姿势等查找视觉上相似的宠物

[图示请参阅官方原文]

通过多模态嵌入进行宠物图像搜索

前置条件

在开始之前,请确保你已具备以下条件:

  • Python (>=3.10):安装 Python 3.10 或以上版本。
  • {{{ .starter }}} 实例:你可以在 TiDB Cloud 上创建一个免费的 {{{ .starter }}} 实例。
  • Jina AI API key:你可以从 Jina AI Embeddings 免费获取 API key。

运行方法

步骤 1. 克隆 pytidb 仓库

pytidb 是 TiDB 的官方 Python SDK,旨在帮助开发者高效构建 AI 应用。

git clone https://github.com/pingcap/pytidb.git
cd pytidb/examples/image_search/

步骤 2. 安装所需依赖包

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r reqs.txt

步骤 3. 设置环境变量

  1. 在 TiDB Cloud 控制台中,进入 My TiDB 页面,然后点击目标 {{{ .starter }}} 实例名称进入其概览页面。
  2. 点击右上角的 Connect。此时会弹出连接对话框,显示连接参数。
  3. 根据连接参数设置环境变量,如下所示:
cat > .env <<EOF
TIDB_HOST={gateway-region}.prod.aws.tidbcloud.com
TIDB_PORT=4000
TIDB_USERNAME={prefix}.root
TIDB_PASSWORD={password}
TIDB_DATABASE=test

JINA_AI_API_KEY={your-jina-ai-api-key}
EOF

步骤 4. 下载并解压数据集

本演示使用 Oxford Pets 数据集 将宠物图片加载到数据库中进行搜索。

对于 Linux/MacOS:

# 下载数据集
curl -L -o oxford_pets.tar.gz "https://thor.robots.ox.ac.uk/~vgg/data/pets/images.tar.gz"

# 解压数据集
mkdir -p oxford_pets
tar -xzf oxford_pets.tar.gz -C oxford_pets

步骤 5. 运行应用

streamlit run app.py

在浏览器中访问 http://localhost:8501。

步骤 6. 加载数据

在示例应用中,你可以点击 Load Sample Data 按钮,将部分示例数据加载到数据库中。

如果你想加载 Oxford Pets 数据集中的全部数据,可以点击 Load All Data 按钮。

步骤 7. 搜索

  1. 在侧边栏选择 Search type。
  2. 输入你想查找的宠物的文本描述,或上传一张狗或猫的照片。
  3. 点击 Search 按钮。

相关资源

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。