openeuler/text2sql

OPEA Docker镜像文档

镜像概述

OPEA Docker镜像是基于openEuler构建的官方镜像，由openEuler CloudNative SIG维护。该镜像可免费使用，且不受用户速率限制。OPEA是一个开放平台项目，旨在帮助用户创建开放、多提供商、稳健且可组合的生成式AI（GenAI）解决方案，充分利用生态系统中的创新成果。

获取帮助：openEuler CloudNative SIG、openEuler社区

核心功能与特性

OPEA平台包含以下核心组件：

• 用于最先进生成式AI系统的可组合构建块详细框架，包括大型语言模型（LLMs）、数据存储和提示引擎
• 检索增强生成式AI组件栈结构及端到端工作流的架构蓝图
• 围绕性能、功能、可信度和企业级就绪性对生成式AI系统进行评分的四步评估方法

了解更多OPEA信息：opea.dev，技术文档：https://opea-project.github.io/

支持的标签及对应Dockerfile链接

DBQnA Docker镜像的标签由DBQnA版本和基础镜像版本组成，具体如下：

使用方法

DBQnA服务可轻松部署在Intel Gaudi2、Intel Xeon可扩展处理器和Nvidia GPU上。目前支持两种DBQnA流水线：带重排序（Rerank）的DBQnA和不带重排序的DBQnA。其中，不带重排序的DBQnA流水线（包含嵌入、检索和LLM）专为无法在HPU上运行重排序服务但需要高性能和准确性的Xeon用户提供。

快速部署步骤

1. 设置环境变量
2. 运行Docker Compose
3. 使用DBQnA服务

1. 设置环境变量

部署DBQnA服务需按以下步骤设置环境变量：

1. 设置必要环境变量：

   bash
   # 示例：host_ip="192.168.1.1"
   export host_ip="外部公网IP"
   # 示例：no_proxy="localhost, 127.0.0.1, 192.168.1.1"
   export no_proxy="你的无需代理地址"
   export HUGGINGFACEHUB_API_TOKEN="你的Huggingface API令牌"
   

2. 若处于代理环境，还需设置代理相关环境变量：

   bash
   export http_proxy="你的HTTP代理"
   export https_proxy="你的HTTPS代理"
   

3. 设置其他环境变量：

   获取set_env.sh：set_env.sh

   bash
   # 在Xeon上执行
   source set_env.sh
   

2. 运行Docker Compose

选择与硬件匹配的compose.yaml文件。

CPU示例：

获取compose.yml：compose.yml

bash
docker compose -f compose.yml up -d

系统将自动从Docker Hub下载镜像：

bash
docker pull openeuler/text2sql:latest
docker pull openeuler/text2sql-ui:latest

3. 使用DBQnA服务

在浏览器中打开URL http://{你的IP}:5174 访问前端界面。

使用场景与适用范围

• 硬件环境：适用于Intel Gaudi2、Intel Xeon可扩展处理器及Nvidia GPU
• 用户需求：需要构建生成式AI解决方案，尤其是数据库问答（DBQnA）场景
• 部署模式：支持带/不带重排序的流水线，满足不同性能和硬件条件需求，特别适合企业级生成式AI系统构建