mirror of
https://github.com/infiniflow/ragflow.git
synced 2026-05-21 00:36:43 +08:00
### What problem does this PR solve?
## Summary
Refactor the dataset API layer into a clean service/REST separation
pattern, add a unified `/index` API for graph/raptor/mindmap operations,
and introduce several new dataset management endpoints with full test
coverage.
## Changes
### Service Layer (`dataset_api_service.py`)
- Added `trace_index(dataset_id, tenant_id, index_type)` — unified trace
function for all index types
- Added `run_index`, `delete_index` service functions
- Added `get_dataset`, `get_ingestion_summary`, `list_ingestion_logs`,
`get_ingestion_log`
- Added `run_embedding`, `list_tags`, `aggregate_tags`, `delete_tags`,
`rename_tag`
- Added `get_flattened_metadata`, `get_auto_metadata`,
`update_auto_metadata`
### REST API Layer (`dataset_api.py`)
**New unified routes:**
| Method | Route | Description |
|--------|-------|-------------|
| POST | `/datasets/<id>/index?type=graph\|raptor\|mindmap` | Run index
task |
| GET | `/datasets/<id>/index?type=graph\|raptor\|mindmap` | Trace index
task |
| DELETE | `/datasets/<id>/<index_type>` | Delete index |
| GET | `/datasets/<id>` | Get dataset details |
| GET | `/datasets/<id>/ingestions/summary` | Ingestion summary |
| GET | `/datasets/<id>/ingestions` | List ingestion logs |
| GET | `/datasets/<id>/ingestions/<log_id>` | Get single ingestion log
|
| POST | `/datasets/<id>/embedding` | Run embedding |
| GET | `/datasets/<id>/tags` | List tags |
| GET | `/datasets/tags/aggregation` | Aggregate tags across datasets |
| DELETE | `/datasets/<id>/tags` | Delete tags |
| PUT | `/datasets/<id>/tags` | Rename tag |
| GET | `/datasets/metadata/flattened` | Get flattened metadata |
| GET/PUT | `/datasets/<id>/metadata/config` | New metadata config path
|
**Removed routes (replaced by unified `/index`):**
- `POST /datasets/<id>/mindmap`
- `GET /datasets/<id>/mindmap`
**Preserved legacy routes (backward compatibility):**
- `/run_graphrag`, `/trace_graphrag`, `/run_raptor`, `/trace_raptor`
- `/auto_metadata` GET/PUT
### Test Suite
- Updated `common.py` helpers: added `trace_index`, removed
`run_mindmap`/`trace_mindmap`
- Added 7 new test files with 39 test cases total:
| Test File | Cases |
|-----------|-------|
| `test_get_dataset.py` | 4 |
| `test_ingestion_summary.py` | 2 |
| `test_ingestion_logs.py` | 5 |
| `test_index_api.py` | 14 |
| `test_embedding.py` | 2 |
| `test_tags.py` | 8 |
| `test_flattened_metadata.py` | 4 |
- Deleted `test_mindmap_tasks.py` (covered by unified index tests)
## Design Decisions
1. **Unified `/index?type=...`** — single endpoint replaces 3 separate
route pairs for graph/raptor/mindmap
2. **Backward compatibility** — old routes (`/run_graphrag`,
`/run_raptor`, `/auto_metadata`) preserved alongside new paths
3. **`_VALID_INDEX_TYPES = {"graph", "raptor", "mindmap"}`** — input
validation via constant set
4. **`_INDEX_TYPE_TO_TASK_ID_FIELD`** — maps index type to KB model task
ID field for clean dispatch
## Files Changed
- `api/apps/restful_apis/dataset_api.py`
- `api/apps/services/dataset_api_service.py`
- `sdk/python/ragflow_sdk/modules/dataset.py`
- `test/testcases/test_http_api/common.py`
- `test/testcases/test_http_api/test_dataset_management/` (7 new files)
### Type of change
- [x] New Feature (non-breaking change which adds functionality)
- [x] Refactoring
---------
Signed-off-by: noob <yixiao121314@outlook.com>
195 lines
6.1 KiB
Python
195 lines
6.1 KiB
Python
#
|
|
# Copyright 2025 The InfiniFlow Authors. All Rights Reserved.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
#
|
|
|
|
from common import create_dataset, list_dataset, rm_dataset, update_dataset, DATASET_NAME_LIMIT
|
|
import re
|
|
import random
|
|
import string
|
|
|
|
|
|
def test_dataset(get_auth):
|
|
# create dataset
|
|
res = create_dataset(get_auth, {"name": "test_create_dataset"})
|
|
assert res.get("code") == 0, f"{res.get('message')}"
|
|
|
|
# list dataset
|
|
page_number = 1
|
|
dataset_list = []
|
|
while True:
|
|
res = list_dataset(get_auth, {"page": page_number, "page_size": 150})
|
|
data = res.get("data")
|
|
if isinstance(data, dict):
|
|
data = data.get("kbs", [])
|
|
for item in data:
|
|
dataset_id = item.get("id")
|
|
dataset_list.append(dataset_id)
|
|
if len(dataset_list) < page_number * 150:
|
|
break
|
|
page_number += 1
|
|
|
|
print(f"found {len(dataset_list)} datasets")
|
|
# delete dataset
|
|
if dataset_list:
|
|
res = rm_dataset(get_auth, dataset_list)
|
|
assert res.get("code") == 0, f"{res.get('message')}"
|
|
print(f"{len(dataset_list)} datasets are deleted")
|
|
|
|
|
|
def test_dataset_1k_dataset(get_auth):
|
|
# create dataset
|
|
for i in range(1000):
|
|
res = create_dataset(get_auth, {"name": f"test_create_dataset_{i}"})
|
|
assert res.get("code") == 0, f"{res.get('message')}"
|
|
|
|
# list dataset
|
|
page_number = 1
|
|
dataset_list = []
|
|
while True:
|
|
res = list_dataset(get_auth, {"page": page_number, "page_size": 150})
|
|
data = res.get("data")
|
|
if isinstance(data, dict):
|
|
data = data.get("kbs", [])
|
|
for item in data:
|
|
dataset_id = item.get("id")
|
|
dataset_list.append(dataset_id)
|
|
if len(dataset_list) < page_number * 150:
|
|
break
|
|
page_number += 1
|
|
|
|
print(f"found {len(dataset_list)} datasets")
|
|
# delete dataset
|
|
if dataset_list:
|
|
res = rm_dataset(get_auth, dataset_list)
|
|
assert res.get("code") == 0, f"{res.get('message')}"
|
|
print(f"{len(dataset_list)} datasets are deleted")
|
|
|
|
|
|
def test_duplicated_name_dataset(get_auth):
|
|
# create dataset
|
|
for i in range(20):
|
|
res = create_dataset(get_auth, {"name": "test_create_dataset"})
|
|
assert res.get("code") == 0, f"{res.get('message')}"
|
|
|
|
# list dataset
|
|
res = list_dataset(get_auth, {"page": 1})
|
|
data = res.get("data")
|
|
if isinstance(data, dict):
|
|
data = data.get("kbs", [])
|
|
dataset_list = []
|
|
pattern = r'^test_create_dataset.*'
|
|
for item in data:
|
|
dataset_name = item.get("name")
|
|
dataset_id = item.get("id")
|
|
dataset_list.append(dataset_id)
|
|
match = re.match(pattern, dataset_name)
|
|
assert match is not None
|
|
|
|
if dataset_list:
|
|
res = rm_dataset(get_auth, dataset_list)
|
|
assert res.get("code") == 0, f"{res.get('message')}"
|
|
print(f"{len(dataset_list)} datasets are deleted")
|
|
|
|
|
|
def test_invalid_name_dataset(get_auth):
|
|
# create dataset
|
|
res = create_dataset(get_auth, {"name": 0})
|
|
assert res['code'] != 0
|
|
|
|
res = create_dataset(get_auth, {"name": ""})
|
|
assert res['code'] != 0
|
|
|
|
long_string = ""
|
|
|
|
while len(long_string.encode("utf-8")) <= DATASET_NAME_LIMIT:
|
|
long_string += random.choice(string.ascii_letters + string.digits)
|
|
|
|
res = create_dataset(get_auth, {"name": long_string})
|
|
assert res['code'] != 0
|
|
print(res)
|
|
|
|
|
|
def test_update_different_params_dataset_success(get_auth):
|
|
# create dataset
|
|
res = create_dataset(get_auth, {"name": "test_create_dataset"})
|
|
assert res.get("code") == 0, f"{res.get('message')}"
|
|
|
|
# list dataset
|
|
page_number = 1
|
|
dataset_list = []
|
|
while True:
|
|
res = list_dataset(get_auth, {"page": page_number, "page_size": 150})
|
|
data = res.get("data")
|
|
if isinstance(data, dict):
|
|
data = data.get("kbs", [])
|
|
for item in data:
|
|
dataset_id = item.get("id")
|
|
dataset_list.append(dataset_id)
|
|
if len(dataset_list) < page_number * 150:
|
|
break
|
|
page_number += 1
|
|
|
|
print(f"found {len(dataset_list)} datasets")
|
|
dataset_id = dataset_list[0]
|
|
|
|
res = update_dataset(get_auth, dataset_id, {
|
|
"name": "test_update_dataset",
|
|
"description": "test",
|
|
"permission": "me",
|
|
"chunk_method": "presentation",
|
|
"language": "spanish",
|
|
})
|
|
assert res.get("code") == 0, f"{res.get('message')}"
|
|
|
|
# delete dataset
|
|
if dataset_list:
|
|
res = rm_dataset(get_auth, dataset_list)
|
|
assert res.get("code") == 0, f"{res.get('message')}"
|
|
print(f"{len(dataset_list)} datasets are deleted")
|
|
|
|
|
|
# update dataset with different parameters
|
|
def test_update_different_params_dataset_fail(get_auth):
|
|
# create dataset
|
|
res = create_dataset(get_auth, {"name": "test_create_dataset"})
|
|
assert res.get("code") == 0, f"{res.get('message')}"
|
|
|
|
# list dataset
|
|
page_number = 1
|
|
dataset_list = []
|
|
while True:
|
|
res = list_dataset(get_auth, {"page": page_number, "page_size": 150})
|
|
data = res.get("data")
|
|
if isinstance(data, dict):
|
|
data = data.get("kbs", [])
|
|
for item in data:
|
|
dataset_id = item.get("id")
|
|
dataset_list.append(dataset_id)
|
|
if len(dataset_list) < page_number * 150:
|
|
break
|
|
page_number += 1
|
|
|
|
print(f"found {len(dataset_list)} datasets")
|
|
dataset_id = dataset_list[0]
|
|
|
|
res = update_dataset(get_auth, dataset_id, {"id": "xxx"})
|
|
assert res.get("code") == 101
|
|
|
|
# delete dataset
|
|
if dataset_list:
|
|
res = rm_dataset(get_auth, dataset_list)
|
|
assert res.get("code") == 0, f"{res.get('message')}"
|
|
print(f"{len(dataset_list)} datasets are deleted")
|