qdrant

Qdrant（スキルルーター）

このファイルは、あえて導入編として作成されています。

これはルーターとして機能します。状況に応じて、references/ 以下の適切なノートを開いてください。

リリースの主な変更点（1.19.0 → 1.19.1）

• 主要ストレージとしてのTurboQuant 4ビット： "turbo4" データ型は、4ビット量子化ベクトルのみを保存し、元のベクトルに必要なディスク容量を節約します。
• コンポーネントごとのメモリ戦略： コレクションの各コンポーネントで "memory": "cold" / "cached" / "pinned" を指定できるようになり、メモリとパフォーマンスをより細かく制御できます。strictモードの max_resident_memory_percent は非推奨となり、新しいグローバルクォータAPIに置き換えられます。
• キーワードのプレフィックス一致： フィルターの {"match": {"prefix": "..."}} は、プレフィックスによってキーワードを照合します。キーワードインデックスで有効にする必要があります。
• スパース検索： テナントごとのIDFコーパスにより、スパース検索のランキングが向上します。
• スライスフィルタリング： スライスフィルター条件により、スライス指定のスクロールや決定論的サンプリングが可能になります。
• グローバルクォータAPI： クラスターのリソース使用量を上限設定する一元的な仕組みです（strictモードのメモリ上限に代わるものです）。
• ルーティングトークン： 読み取りアフィニティオプションの使用時に、決定論的な読み取りルートを指定します。
• 1.19.1： TurboQuant SIMDの再設計とバッチHNSW検索（スコアリングの高速化）、量子化スコアリングのプリフェッチに加え、入力の検証を強化しました。空の密ベクトル、65536を超えるサイズのベクトル、コレクション名に含まれる . / .. を拒否します（セキュリティ）。

リリースの主な変更点（1.16.3 → 1.18.0）

• 監視と運用： 最適化の進捗状況・ステージと、クラスター全体のテレメトリーを確認する新しいAPIに加え、/metrics 専用のHTTPポートを設定するオプションが追加されました。
• セキュリティ： アクセス監査ログと、ローテーションに対応したセカンダリAPIキーが追加されました。
• 検索： ハイブリッドランキング向けに、関連性フィードバックとWeighted RRFが追加されました。
• 書き込みセマンティクス： アップサートの update_mode（upsert / update / insert）が追加されました。
• 1.18.0： TurboQuantに高圧縮のベクトル圧縮方式が追加され、コレクションでは名前付きベクトルをその場で追加・削除できるようになりました。また、運用担当者向けに、メモリ使用量を抑える設定と厳格なメモリ制限の設定、および詳細なメモリレポートが追加されました。

パッチノート（1.18.1 → 1.18.2）

• 1.18.2のセキュリティ： 特別に細工されたパスによるREST認証の許可リスト回避と、不正なスナップショットによるヒープ読み取りの脆弱性を修正しました。認証や許可リストを有効にしてQdrantを公開している場合、またはアップロードされたスナップショットを受け付けている場合は、速やかにアップグレードしてください。
• 1.18.2： シャードのWALリカバリ中に時間のかかる操作をログに記録し、セグメントの構築後にIDトラッカーのキャッシュをクリアします。
• 浮動小数点値を受け取るインデックス付き整数範囲フィルターと、ペイロードインデックス付きフィールドに対する {match: {except: []}} のフィルター動作が修正されました。
• 空のベクトルリクエストでパニックが発生しなくなりました。無効な入力として扱い、Qdrantに送信する前に呼び出し元で検証してください。
• TurboQuantのヒープメモリレポートの精度が向上しました。圧縮の影響を確認する際は、古い基準値よりも現在のメトリクスを信頼してください。
• スナップショットのアップロード認証が強化されました。リストア／アップロードエンドポイントも、メインAPIと同じ認証レビューなしに安全だと判断しないでください。

破壊的変更／アップグレードに関する注意（1.17.0）

• gRPCクライアント： gRPCのベクトルフィールドのレスポンス形式が変更されました。公式のQdrantクライアントライブラリをアップグレードし、カスタムgRPC連携を検証してください。
• ストレージのアップグレード： RocksDBは廃止され、gridstoreに置き換えられました。v1.15.xをお使いの場合、v1.17.xに直接アップグレードしないでください。マイナーバージョンを1つずつ順にアップグレードしてください。

その他のアップグレードに関する注意（1.18.0）

• 認証が有効な場合、内部gRPCエンドポイントでもAPIキー／JWT認証が必須になりました。これまでプライベートネットワーク内であることのみを信頼していた場合は、アップグレード前に内部サービス間の通信を検証してください。
• URLからのスナップショットのリストアを設定で無効にできるようになりました。セキュリティを強化した環境やセルフホスト環境で関係する変更です。

まずはこちら（すぐに始める）

• Qdrantを初めて使う場合：references/concepts.md をお読みください。
• ローカルで最速の動作確認を行う場合：references/quickstart.md と references/deployment.md をお読みください。
• Pythonと連携する場合：references/api-clients.md をお読みください。

状況に応じて選ぶ

データモデリング

• ベクトル、ペイロード、メインの DB には何を格納すべきでしょうか？references/modeling.md をお読みください。
• ID、アップサート、書き込みのセマンティクスについて知りたい場合は、references/points.md をお読みください。
• ペイロードの型や更新モードについて知りたい場合は、references/payload.md をお読みください。

検索（search）

• 検索、フィルタリング、探索、ハイブリッド検索をまとめたエントリーポイントです：references/retrieval.md。

パフォーマンスとインデックス作成

• インデックスの種類とトレードオフ：references/indexing.md。
• 運用上重要なストレージ／オプティマイザーの内部情報：references/storage.md + references/optimizer.md。
• 実践的なチューニング、モニタリング、トラブルシューティング：references/ops-checklist.md。

デプロイと運用

• インストール／Docker／Kubernetes：references/deployment.md。
• 設定のレイヤリング：references/configuration.md。
• セキュリティ／認証／TLS の境界：references/security.md。
• バックアップ／復元：references/snapshots.md。

API インターフェースの選択

• REST と gRPC、Python SDK：references/api-clients.md。

このスキルのメンテナンス方法

• SKILL.md は短く保ちます（ルーター + 使用方法のガイダンス）。
• 詳細は references/*.md に記載します。
• 見つけやすさが向上する場合は、リファレンスを統合または再編成します。

重要な禁止事項

• ベンダーのドキュメントから長い文章をそのまま取り込んだり、引用したりしないでください。独自の言葉で要約してください。
• ドキュメントに明示的な根拠がないデフォルト値を作り出さないでください。不確かな点は TODO として記録してください。
• 復元の手順をテストせずに、バックアップ／復元を設計しないでください。
• インストールのドキュメントで明示的に警告されているため、プライマリ永続化バックエンドとして NFS を使用しないでください。
• 内部クラスター通信ポートを公開しないでください。プライベートネットワークを使用してください。
• 信頼できないネットワークでは、TLS なしで API キー／JWT を使用しないでください。
• 本番環境で、暗黙的なランタイムのデフォルト値に依存しないでください。有効な設定を記録してください。

リンク

• ドキュメント
• リリース
• GitHub