发布模型

本指南将带您快速完成 OraAI 智能分析平台的数据模型部署与发布，助力高效上线您的第一个分析模型。

先决条件

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux、Windows 10+
• 存储空间：至少 80GB 可用空间

步骤1: 安装 CLI 工具

OraAI 命令行工具是您与平台交互的主要方式。

1. Linux系统需安装系统依赖：

# Linux系统需要安装 PostgreSQL 开发包
sudo dnf install postgresql-devel

2. 下载 CLI 工具：

访问下载地址：https://downloads.oraai.chat/orai-cli

3. 验证安装：

orai-cli --h

步骤2: 账户认证

在使用 OraAI 平台之前，您需要进行账户认证：

1. 配置环境变量：

# 替换为您的API密钥
export ORAI_API_KEY="eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5MDk5MDc2MDYsImF1ZCI6ImFwaSIsInN1YiI6Ijc5YzZmYTJiLWYxMDYtNDI5OC05YTNmLTY3MzRmZTFlNTczZSJ9.e1ofnaoRCfME4_-hDLJWBNTsO-iA-L8e_WxriPwxl8g"

# 替换为您的服务器地址
export ORAI_HOST="http://192.168.31.227:3001"

2. 执行认证命令：

$ orai-cli auth
✅ 您已成功连接到 OraAI!
连接详情:
host: http://47.120.51.218:3001
api_key: ****XXXXX
凭据保存成功!

提示

请登录系统获取认证密钥，替换上方的ORAI_API_KEY值。

步骤3: 初始化项目

1. 下载项目模板：

访问下载地址：ora-projects

2. 项目结构说明：

demo_project/
├── ora.yml                # 项目配置文件
├── models/                # 语义模型定义
│   ├── departments.yml    # 部门表语义模型
│   └── users.yml          # 用户表语义模型
└── sql/                   # SQL定义
    ├── departments.sql    # 部门表SQL查询
    └── users.sql          # 用户表SQL查询

用户可以基于当前项目模板进行扩展，项目结构兼容DBT项目结构和定义。

步骤4: 连接数据源

OraAI 在发布之前需要配置数据源，系统支持多种主流数据库：

1. 选择数据源类型（MySQL、PostgreSQL 等）
2. 提供连接详情（主机、端口、用户名、密码等）

进入系统设置界面配置数据源：

配置成功后将显示：

注意

请确保您有足够的权限访问所选数据源，并且防火墙设置允许 OraAI 平台进行连接。

步骤5: 解析和验证模板

OraAI 的语义层基于DBT语法，使用以下命令解析并校验项目中的模型语法：

$ orai-cli parse
🚀 开始 OraAI 模型解析...
......
🎉 所有指定的模型文件解析成功!

步骤6: 部署项目

完成配置后，将项目部署到 OraAI 云平台：

orai-cli deploy

部署成功后，系统将提供访问URL。

步骤7: 数据集列表

部署完成后，您可以在平台上查看可用的数据集：

步骤8: 开始对话

现在，您可以使用自然语言与数据进行对话，例如：

• "过去30天的销售额是多少？"
• "哪个产品的增长率最高？"
• "客户满意度与销售额之间有什么关联？"
• "预测下个季度的收入趋势"

后续步骤

恭喜！您已成功完成 OraAI 平台的快速上手。接下来，您可以：

• 查看部署指南，了解更多部署选项
• 探索API 文档，实现系统集成