Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

feat(adk): add vector memory support for psqlpy and PostgreSQL ADBC

オープン
#728 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
42/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
postgresql, python
領域
backend, databases

調査の方向性

PsqlpyADKMemoryStore と AdbcADKMemoryStore の実装、および共有の StoredMemory embedding contract から着手します。既存の unit テストと PostgreSQL integration テストを確認し、続いて PostgreSQL とサポート対象外の ADBC ドライバーに対する parameter binding と動作を検証します。nullable embedding が永続化されて返され、最近傍の順序付けが機能し、サポート対象外のバックエンドが明確に失敗し、capability のドキュメントとテストが指定されたマトリクスを網羅していれば完了です。

索引モデルが issue の本文から書いたものです。

説明

Summary

The psqlpy and ADBC ADK memory stores accept StoredMemory.embedding and an embedding search argument through the shared public contract, but currently ignore both.

  • PsqlpyADKMemoryStore creates no vector column, omits embeddings from inserts, and performs text-only searches.
  • AdbcADKMemoryStore is multi-dialect and reduced-scope; its PostgreSQL path likewise has no vector column or search branch and returns embedding=None.

This makes PostgreSQL vector-memory behavior inconsistent across SQLSpec adapters and silently discards caller data.

Proposed behavior

Add PostgreSQL ADK vector-memory support for psqlpy and the PostgreSQL ADBC backend while preserving reduced-scope behavior for non-PostgreSQL ADBC drivers.

  • Persist nullable embeddings in owner and non-owner insert paths.
  • Add vector-only nearest-neighbor search with null embeddings excluded.
  • Use codec-independent parameter binding. Psqlpy supports explicit SQL casts; determine and document the portable ADBC PostgreSQL binding representation rather than assuming native pgvector codecs.
  • Return stored embeddings when the backend exposes them.
  • Do not silently ignore a supplied embedding on an unsupported ADBC backend; fail clearly or expose an explicit capability boundary.
  • Decide whether pg_textsearch BM25/hybrid search should reach parity in the same implementation or remain a separately declared capability.

Acceptance criteria

  • Unit tests cover SQL, nullable embeddings, owner-column parameter ordering, and vector query operands for both adapters.
  • PostgreSQL integrations insert via the public memory-store API and assert nearest-neighbor IDs/order with client pgvector codecs disabled.
  • ADBC tests cover PostgreSQL vector decoding and unsupported non-PostgreSQL behavior.
  • Adapter documentation and the ADK backend matrix accurately describe vector and BM25 capabilities.
  • No public method signatures or shared record types change.

Related: #726, #727

主要言語
Python
スター
104
フォーク
9
平均マージ
1日 4時間
マージ済み PR(30日)
44

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

litestar-org/sqlspec のほかの issue

litestar-org/sqlspec の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。