weaviateが MMR の正規化修正とマルチテナントの再ベクトル化バグを修正した
この記事のポイント
- PATCHでテナントを再ベクトル化チェックに渡すよう修正した
- テナントをre-vectorizeチェックに渡すように修正した
- マルチテナントコレクションでのみ対象
数字で見る
この記事に出てくる数字
| WALファイル最小バイト | 4 bytes |
|---|
どこで使えるか
マルチテナントで再ベクトル化が必要な人向け。テナント単位で正しく処理される GitHub Releasesで公開済み v1.39.7から更新で利用可能
スポンサーリンク
解説
かみくだいて説明します
Weaviateのバージョン 1.39.8 が antas-marcin さんをメンテナーに迎えた開発チームによって、2026年 10月 2日に公開されました。今回の更新ではベクトル検索の精度に関わる MMR 関数のクエリベクトル正規化処理が修正され、マルチテナントコレクションで PATCH 操作を行った際の再ベクトル化チェックがテナント単位で正しく適用されるようになりました。バックアップのエンドポイントが呼び出し元がアクセス権を持たないコレクションを露出していた問題や、クラスター間でリーダー交代時に進行中のネットワーク通信を中断していた問題も同時に解消されています。
再ベクトル化のチェックがテナント単位で動くようになったんですか? 複数のテナントが一つのコレクションを共用している場面では、更新が全部のテナントに影響を与えていたということですか?
正確には、以前は PATCH 命令がコレクション全体にかかったときに、すべてのテナントのデータを強制的に再計算していました。今回の修正では、実際にテキストや属性が書き換わったテナントだけを対象に再ベクトル化を行うパスに切り替わります。これにより、書き換えがなかったテナントの処理がスキップされるため、同じ操作でも必要な演算量が減ります。
アクセス権を持たないデータを出していたんですか。呼び出し元が見えないコレクションまでバックアップ機能が勝手に読み込んでいたということですね。
その通りです。呼び出し元にそのコレクションへの読み取り権限がない場合でも、バックアップ用のエンドポイントが内部で全コレクションを走査して情報を返していました。修正後は呼び出し元の権限を最初に検証し、アクセス不可のコレクションはバックエンド側で完全に遮断されます。
ノードが入れ替わった瞬間に処理がリセットされるリスクがあったんですね。進行中の作業が全部中途半端な状態で止まる可能性があるということです。
はい。リーダーノードが切り替わった際に、それまで進行中だった通信を即座に中止するロジックが動いていました。修正後は進行中の通信を最後まで完了させてから次のリーダーに引き継ぐ形になり、中途半端な状態でのデータ不整合を防げます。
検索結果の多様性を保つ仕組みに直接効いてくる修正なんですね。重複を避けて関連性の高いものを選ぶアルゴリズムの計算式が正しくなったということです。
効いてきます。MMR 関数は検索結果の中から重複を避けつつ関連性の高いドキュメントを選ぶアルゴリズムで、例えば図書館で似た本を並べて展示する際、同じ著者の本が隣り合わないように配置するイメージです。その際に使うクエリベクトルのサイズを調整する正規化の計算式に誤りがありました。修正後はクエリベクトルが適切な範囲に収まるようになり、類似度スコアの比較が正確に行えるようになります。
開発者が組み込む際の手間は増えますか。既存のバージョン 1.39.7 から切り替えるときの互換性はどうなっていますか。
互換性については破壊的変更はないと明記されています。設定ファイルや API の呼び出し方に変化はないため、既存のアプリケーションを止めることなくバージョン 1.39.8 に置き換えられます。ただしクラスター構成で運用している場合は、ノードを順番に更新してからリーダー交代のテストを一度行うことを開発チームが推奨しています。
最後に、今回の修正でまだ解決していない課題や、次のバージョンで予定されている方向性について教えてください。
公開された更新内容には次のバージョンの具体的な予定や、未解決の課題についての記載はありません。そこはまだ分かっていません。開発チームが次回リリースで何を優先するかは、今後の GitHub のイシューやプルリクエストの動向を見ていくしかありません。
出典
この記事のもとになった情報
※ 本文と音声は生成 AI が作成しています。内容は出典をご確認ください。
本作品のキャラクターには株式会社Live2Dの著作物であるサンプルデータが株式会社Live2Dの定める規約に従って用いられています。本作品は制作者の完全な自己の裁量で制作されています。このキャラクターモデルは株式会社Live2Dより許諾を得て商用利用しています。