133 lines
3.8 KiB
Markdown
133 lines
3.8 KiB
Markdown
---
|
||
name: A-期货日级数据
|
||
description: 通过 mysql_dll2.dll 连接 MySQL 数据库并执行 SQL 查询。当用户需要查询 MySQL 数据库、执行 SQL 语句、获取数据库中的数据时触发。 触发关键词包括：查询数据库、查合约、查日线、查K线、查结算价、查持仓量、查成交量、查保证金、 查品种数据、读取数据库、SQL查询、查某品种某合约、查期货数据、从数据库取数据、db查询、查纯碱、查螺纹等。 注意：此 Skill 依赖 mysql_dll2.dll 文件，仅限 Windows 平台使用。数据库编号固定为 1。
|
||
disable: true
|
||
allowed-tools:
|
||
---
|
||
|
||
.dll 连接 MySQL 数据库并执行 SQL 查询。当用户需要查询 MySQL 数据库、执行 SQL 语句、获取数据库中的数据时触发。
|
||
触发关键词包括：查询数据库、查合约、查日线、查K线、查结算价、查持仓量、查成交量、查保证金、
|
||
查品种数据、读取数据库、SQL查询、查某品种某合约、查期货数据、从数据库取数据、db查询、查纯碱、查螺纹等。
|
||
注意：此 Skill 依赖 mysql_dll2.dll 文件，仅限 Windows 平台使用。数据库编号固定为 1。
|
||
allowed-tools:
|
||
disable: true
|
||
---
|
||
|
||
# A-期货日级数据
|
||
|
||
## 用途
|
||
|
||
把自然语言翻译成 SQL 执行，返回原始数据。不生成汇总、不分析、不联想。
|
||
|
||
---
|
||
|
||
## 数据库
|
||
|
||
- **db_index：固定为 1**，无需询问用户
|
||
|
||
---
|
||
|
||
## 调用方式
|
||
|
||
```python
|
||
import sys
|
||
sys.path.insert(0, r"<skill_scripts_dir>")
|
||
from mysql_client import MysqlDLLClient
|
||
|
||
db = MysqlDLLClient()
|
||
result = db.query(1, "SELECT * FROM `contract_day` WHERE p_code = ?", ["sa"])
|
||
print(result)
|
||
db.close()
|
||
```
|
||
|
||
---
|
||
|
||
## 字段说明（references/field_mapping.md）
|
||
|
||
| 英文字段名 | 中文含义 | 字段类型 |
|
||
|-----------|---------|---------|
|
||
| contract | 合约 | varchar(10) |
|
||
| open | 开盘价 | float |
|
||
| high | 高（最高价） | float |
|
||
| low | 低（最低价） | float |
|
||
| close | 收（收盘价） | float |
|
||
| volume | 成交（成交量） | float |
|
||
| oi | 持仓（持仓量） | float |
|
||
| p_code | 品种 | varchar(4) |
|
||
| jys | 交易所 | varchar(6) |
|
||
| times | 时间 | datetime |
|
||
|
||
### 品种 vs 合约
|
||
|
||
| 概念 | 字段 | 说明 | 示例 |
|
||
|------|------|------|------|
|
||
| 品种 | `p_code` | 品种代码，拼音小写 | `sa`（纯碱）、`rb`（螺纹钢） |
|
||
| 合约 | `contract` | 品种 + 交割月份 | `sa605`（纯碱2026年5月交割） |
|
||
|
||
> 郑商所（CZCE）合约月份为3位，如 `SR501`、`MA509`。
|
||
|
||
---
|
||
|
||
## 查询示例
|
||
|
||
**查所有品种某时间段数据（直接一条SQL搞定，不需要先查品种）**
|
||
|
||
```sql
|
||
SELECT * FROM contract_day WHERE times >= '2026-01-01' AND times <= '2026-12-31'
|
||
```
|
||
|
||
**查纯碱26年所有合约数据**
|
||
|
||
```
|
||
p_code = 'SA'
|
||
时间范围: times >= '2026-01-01' AND times <= '2026-12-31'
|
||
```
|
||
|
||
**查纯碱605合约数据**
|
||
|
||
```
|
||
contract = 'SA605'
|
||
```
|
||
|
||
**查螺纹钢26年所有数据**
|
||
|
||
```
|
||
p_code = 'RB'
|
||
时间范围: times >= '2026-01-01' AND times <= '2026-12-31'
|
||
```
|
||
|
||
---
|
||
|
||
## 执行规则
|
||
|
||
1. **直接执行，不询问确认。**
|
||
2. **只返回数据，不生成汇总、不分析。**
|
||
3. **db_index 固定为 1。**
|
||
4. **参数化查询**，所有条件用 `?` 占位符传参。
|
||
5. **查所有品种时直接一条 SQL**，不需要先 `SELECT DISTINCT p_code` 再逐条查。
|
||
|
||
---
|
||
|
||
## 依赖文件
|
||
|
||
```
|
||
scripts/
|
||
└── mysql_client.py
|
||
lib/
|
||
└── mysql_dll/
|
||
├── mysql_dll2.dll
|
||
├── jsoncpp.dll
|
||
├── libcrypto-1_1-x64.dll
|
||
├── libmysql.dll
|
||
├── libssl-1_1-x64.dll
|
||
└── mysqlcppconn-9-vs14.dll
|
||
```
|
||
|
||
DLL 由 `mysql_client.py` 自动加载，无需手动配置。
|
||
|
||
---
|
||
|
||
## 品种代码对照（references/variety_mapping.md）
|
||
|
||
详见 `references/variety_mapping.md`，包含所有交易所品种代码。
|