Prev Next

Database / pgvector basics Interview Questions

How do you use pgvector with Python and psycopg2?

The standard Python path for pgvector uses psycopg2 (or psycopg3) as the PostgreSQL driver, with the pgvector Python package providing type adapters that automatically convert Python lists to vector literals and back.

# Install dependencies
# pip install pgvector psycopg2-binary openai

import psycopg2
from pgvector.psycopg2 import register_vector
from openai import OpenAI

# Connect and register the vector type adapter
conn = psycopg2.connect("postgresql://user:pass@localhost/mydb")
register_vector(conn)  # allows Python lists <-> vector column
cur = conn.cursor()

# Create the schema
cur.execute("""
    CREATE TABLE IF NOT EXISTS documents (
        id        BIGSERIAL PRIMARY KEY,
        content   TEXT NOT NULL,
        embedding VECTOR(1536)
    )
""")
conn.commit()

# Generate embedding and insert
oai = OpenAI()
text = "How does pgvector work?"
response = oai.embeddings.create(model="text-embedding-3-small", input=text)
embedding = response.data[0].embedding  # list of 1536 floats

cur.execute(
    "INSERT INTO documents (content, embedding) VALUES (%s, %s)",
    (text, embedding)   # psycopg2 + register_vector handles the conversion
)
conn.commit()

# Query: find 5 most similar documents
query_text = "What is the pgvector extension?"
query_embedding = oai.embeddings.create(
    model="text-embedding-3-small", input=query_text
).data[0].embedding

cur.execute(
    "SELECT id, content, embedding <=> %s AS distance"
    " FROM documents ORDER BY distance LIMIT 5",
    (query_embedding,)
)
results = cur.fetchall()
for row in results:
    print(f"id={row[0]}, dist={row[2]:.4f}: {row[1]}")

cur.close()
conn.close()

What does the register_vector() function do in the pgvector Python package?
What Python package provides the register_vector() adapter for psycopg2?

Invest now in Acorns!!! 🚀 Join Acorns and get your $5 bonus!
Acorns Logo

Invest now in Acorns!!! 🚀
Join Acorns and get your $5 bonus!

Earn passively and while sleeping

Acorns is a micro-investing app that automatically invests your "spare change" from daily purchases into diversified, expert-built portfolios of ETFs. It is designed for beginners, allowing you to start investing with as little as $5. The service automates saving and investing. Disclosure: I may receive a referral bonus.

Robinhood Logo

Invest now!!! Get Free equity stock (US, UK only)!

Use Robinhood app to invest in stocks. It is safe and secure. Use the Referral link to claim your free stock when you sign up!.

The Robinhood app makes it easy to trade stocks, crypto and more.


Webull Logo

Webull! Receive free stock by signing up using the link: Webull signup.

More Related questions...

What is pgvector and what problem does it solve for developers? What are vector embeddings and why are they central to pgvector's use? How do you install and enable pgvector in PostgreSQL? What data types does pgvector provide and how do you define vector columns? What distance operators does pgvector provide and when do you use each? How do you insert and update vector data in pgvector? How do you perform a basic nearest-neighbour search with pgvector? What is the difference between exact and approximate nearest-neighbour search in pgvector? What is the HNSW index in pgvector and how do you create and tune it? What is the IVFFlat index in pgvector and how does it compare to HNSW? How do you use pgvector with Python and psycopg2? How do you use pgvector with SQLAlchemy and Python ORMs? How do you combine vector similarity search with SQL filters (hybrid search) in pgvector? How do you bulk-load vectors efficiently into pgvector? What operator classes must you use when creating pgvector indexes and why do they matter? How does pgvector fit into a RAG (Retrieval-Augmented Generation) pipeline? What is cosine distance vs cosine similarity and which does pgvector return? How do you check and monitor pgvector index creation progress? What is the pgvector maximum supported dimensions limit and how do you handle high-dimensional vectors? How do you use pgvector with LangChain for building AI applications? How does pgvector handle NULL values in vector columns? What are partial indexes in pgvector and when should you use them? How do you perform vector arithmetic and other vector functions in pgvector? How does pgvector compare to dedicated vector databases like Pinecone, Weaviate, and Qdrant? What is the difference between L1 and L2 distance in pgvector? How do you store and query vector embeddings with pgvector in a real schema design? What is halfvec and when should you use it to reduce storage costs? How do you handle vector dimensionality mismatches in pgvector? How do you use pgvector with Django? What are common performance tuning techniques for pgvector at scale? How do you implement semantic search with pgvector and a similarity threshold? How do you use pgvector with asyncpg or asyncio in Python? What is vector quantisation and how does pgvector support binary quantisation? How does pgvector integrate with managed PostgreSQL services? How do you use the inner product operator <#> with pgvector and when is it appropriate? How do you combine pgvector with full-text search (hybrid keyword + semantic search)? What PostgreSQL configuration parameters affect pgvector performance? How do you implement recommendation systems using pgvector? How do you use EXPLAIN and EXPLAIN ANALYZE to debug pgvector queries? What are best practices for a production pgvector deployment?
Show more question and Answers...

Integration

Comments & Discussions