This commit is contained in:
1 parent
23b1cb2966
commit
e9532e8878
30 files changed
+1835
-542
No files matched your search
+61
-35
@@ -1,49 +1,75 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
Name: scripts/reset_qdrant.py
|
||||
Version: v1.2.1 (2025-12-11)
|
||||
Kurzbeschreibung:
|
||||
Sicheres Zurücksetzen der Qdrant-Collections für EIN Projektpräfix. Das Skript
|
||||
ermittelt zunächst die tatsächlich betroffenen Collections und zeigt eine
|
||||
Übersicht an. Anschließend wird der User um Bestätigung gebeten (interaktive
|
||||
Abfrage), bevor eine der Aktionen ausgeführt wird:
|
||||
FILE: scripts/reset_qdrant.py
|
||||
VERSION: 2.1.0 (2025-12-15)
|
||||
STATUS: Active (Core)
|
||||
COMPATIBILITY: v2.9.1 (Post-WP14/WP-15b)
|
||||
|
||||
- wipe: Löscht die Collections komplett und legt sie gemäß Projekt-Defaults neu an.
|
||||
**Neu**: Danach werden *immer* die Payload-Indizes & Schema-Ergänzungen
|
||||
über ensure_payload_indexes() idempotent eingerichtet (falls nicht mit --no-indexes deaktiviert).
|
||||
- truncate: Löscht nur alle Points (Inhalte), behält die Collection-Settings.
|
||||
**Neu**: Optional (Default) werden im Anschluss die Payload-Indizes geprüft/ergänzt.
|
||||
Zweck:
|
||||
-------
|
||||
Sicheres Zurücksetzen der Qdrant-Collections für ein Projektpräfix.
|
||||
Ermöglicht vollständigen Neustart (wipe) oder Löschen nur der Inhalte (truncate).
|
||||
|
||||
Aufruf (aus Projekt-Root, im venv):
|
||||
python3 -m scripts.reset_qdrant --mode wipe [--prefix PREFIX] [--yes] [--dry-run]
|
||||
python3 -m scripts.reset_qdrant --mode truncate [--prefix PREFIX] [--yes] [--dry-run]
|
||||
Funktionsweise:
|
||||
---------------
|
||||
1. Ermittelt betroffene Collections (notes, chunks, edges für Präfix)
|
||||
2. Zeigt Preview der existierenden Collections
|
||||
3. Interaktive Bestätigung (außer mit --yes)
|
||||
4. Führt Aktion aus:
|
||||
- wipe: Löscht Collections komplett, legt neu an, richtet Indizes ein
|
||||
- truncate: Löscht nur Points, behält Collection-Settings, prüft Indizes
|
||||
5. Richtet Payload-Indizes idempotent ein (außer mit --no-indexes)
|
||||
|
||||
Parameter:
|
||||
--mode wipe | truncate (Pflicht)
|
||||
--prefix Collection-Prefix (Default: env COLLECTION_PREFIX oder 'mindnet')
|
||||
--yes Keine Rückfrage, direkt ausführen (CI/CD geeignet)
|
||||
--dry-run Nur anzeigen, was passieren würde; nichts ändern
|
||||
--no-indexes Überspringt den Schritt ensure_payload_indexes() (Standard: Indizes/Schema werden geprüft/ergänzt)
|
||||
Ergebnis-Interpretation:
|
||||
------------------------
|
||||
- Preview: Zeigt betroffene Collections vor Ausführung
|
||||
- Exit-Code 0: Erfolgreich
|
||||
- Exit-Code 1: Abgebrochen oder keine Aktion
|
||||
- Exit-Code 2: Verbindungs- oder Konfigurationsfehler
|
||||
|
||||
Umgebungsvariablen (optional):
|
||||
QDRANT_URL, QDRANT_API_KEY, COLLECTION_PREFIX, VECTOR_DIM (Default 384)
|
||||
(Zusätzliche ENV für Named Vectors etc. werden innerhalb ensure_collections/ensure_payload_indexes berücksichtigt.)
|
||||
Verwendung:
|
||||
-----------
|
||||
- Vor größeren Migrationen oder Schema-Änderungen
|
||||
- Bei Inkonsistenzen in der Datenbank
|
||||
- Für Entwicklung/Testing (schneller Reset)
|
||||
- CI/CD-Pipelines (mit --yes)
|
||||
|
||||
Sicherheitsmerkmale:
|
||||
- Betrachtet ausschließlich Collections des angegebenen Präfixes.
|
||||
- Listet vor Ausführung die tatsächlich existierenden Ziel-Collections auf.
|
||||
- Fragt interaktiv nach Bestätigung (es sei denn --yes ist gesetzt).
|
||||
-------------------
|
||||
- Betrachtet nur Collections des angegebenen Präfixes
|
||||
- Listet betroffene Collections vor Ausführung auf
|
||||
- Interaktive Bestätigung (außer mit --yes)
|
||||
- Dry-Run Modus verfügbar
|
||||
|
||||
Exitcodes:
|
||||
0 = OK, 1 = abgebrochen/keine Aktion, 2 = Verbindungs-/Konfigurationsfehler
|
||||
Aufruf:
|
||||
-------
|
||||
python3 -m scripts.reset_qdrant --mode wipe --prefix mindnet
|
||||
python3 -m scripts.reset_qdrant --mode truncate --prefix mindnet --yes
|
||||
python3 -m scripts.reset_qdrant --mode wipe --dry-run
|
||||
|
||||
Changelog:
|
||||
v1.2.1: Fix: load_dotenv() hinzugefügt, damit VECTOR_DIM aus .env gelesen wird.
|
||||
v1.2.0: ensure_payload_indexes() nach wipe/truncate standardmäßig ausführen (idempotent); --no-indexes Flag ergänzt.
|
||||
v1.1.1: Stabilisierung & Preview (2025-09-05).
|
||||
v1.1.0: Interaktive Bestätigung, --yes/--dry-run hinzugefügt, Preview der betroffenen Collections.
|
||||
v1.0.0: Wipe/Truncate ohne Bestätigungsabfrage.
|
||||
Parameter:
|
||||
----------
|
||||
--mode MODE wipe | truncate (Pflicht)
|
||||
- wipe: Collections löschen & neu anlegen
|
||||
- truncate: Nur Points löschen, Settings behalten
|
||||
--prefix TEXT Collection-Präfix (Default: ENV COLLECTION_PREFIX oder mindnet)
|
||||
--yes Keine Rückfrage, direkt ausführen (CI/CD)
|
||||
--dry-run Nur anzeigen, was passieren würde
|
||||
--no-indexes Überspringt ensure_payload_indexes() (Standard: Indizes werden geprüft/ergänzt)
|
||||
|
||||
Umgebungsvariablen:
|
||||
-------------------
|
||||
QDRANT_URL, QDRANT_API_KEY, COLLECTION_PREFIX, VECTOR_DIM (Default: 768)
|
||||
|
||||
Änderungen:
|
||||
-----------
|
||||
v2.1.0 (2025-12-15): Kompatibilität mit WP-14 Modularisierung
|
||||
- Aktualisiert: Import-Pfade für neue Struktur
|
||||
v1.2.1 (2025-12-11): Fix load_dotenv() für VECTOR_DIM
|
||||
v1.2.0: ensure_payload_indexes() standardmäßig nach wipe/truncate
|
||||
v1.1.0: Interaktive Bestätigung, --yes/--dry-run
|
||||
v1.0.0: Initial Release
|
||||
"""
|
||||
from __future__ import annotations
|
||||
import argparse
|
||||
|
||||
Reference in new issue
Block a user