Consulta de datos vectoriales en Pinecone
Ejecute búsquedas por similitud eficientes en Pinecone para recuperar vectores relevantes a partir de un embedding de consulta.
Consulta de datos vectoriales en Pinecone es una lección gratuita de Vector Databases: Pinecone, Weaviate & pgvector en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Vector Databases: Pinecone, Weaviate & pgvector, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Vector Databases: Pinecone, Weaviate & pgvector incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
Intro to Pinecone Querying
After setting up your index and adding data, the next crucial step is to retrieve relevant information. This is where querying comes in!
Querying in Pinecone means finding vectors in your index that are most similar to a given "query vector." It's how you perform semantic search, recommendations, and more.
Your Query as a Vector
Just like the data you stored, your search query also needs to be converted into a vector. This "query vector" is then compared against all vectors in your Pinecone index.
- Embedding Model: You use the same embedding model that generated your stored vectors to create your query vector.
- Similarity: Pinecone calculates the distance or similarity between your query vector and indexed vectors.
Generating a Query Embedding
Before you can query Pinecone, you need an embedding for your search term. Let's say you want to find documents similar to "machine learning models."
You'd pass "machine learning models" through your chosen embedding model (e.g., OpenAI's text-embedding-ada-002) to get a vector representation.
Introducing `index.query()`
Pinecone's client provides a straightforward method for querying: index.query(). This method is your gateway to finding similar vectors.
Key parameters you'll often use:
vector: The embedding of your query.top_k: How many similar results you want.include_metadata: Whether to return associated metadata.include_values: Whether to return the raw vector values.
Your First Pinecone Query
Let's perform a simple query. We'll use a placeholder vector for now, assuming it's already generated. Remember to replace YOUR_API_KEY and YOUR_ENVIRONMENT.
import os
from pinecone import Pinecone, Index
# Initialize Pinecone (replace with your actual API key and environment)
# In a real app, use environment variables!
api_key = os.environ.get("PINECONE_API_KEY", "YOUR_API_KEY")
environment = os.environ.get("PINECONE_ENVIRONMENT", "YOUR_ENVIRONMENT")
pc = Pinecone(api_key=api_key, environment=environment)
index_name = "my-first-index"
index = pc.Index(index_name)
# A dummy query vector (in reality, this would be an embedding)
query_vector = [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8] # Example 8-dim vector
# Perform the query
query_results = index.query(
vector=query_vector,
top_k=3 # Get the 3 most similar results
)
print("Query Results:")
for match in query_results.matches:
print(f"ID: {match.id}, Score: {match.score:.2f}")Deciphering Query Matches
The query_results object contains a list of matches. Each match represents a similar vector found in your index.
id: The unique identifier of the matched vector.score: A numerical value indicating similarity. Higher scores (closer to 1 for cosine, closer to 0 for Euclidean) mean higher similarity.values: The raw vector (ifinclude_values=True).metadata: Any associated metadata (ifinclude_metadata=True).
Limiting Results with `top_k`
The top_k parameter is crucial for controlling how many results Pinecone returns. It specifies the number of nearest neighbors you want to retrieve.
- If
top_k=1, you get only the single most similar vector. - If
top_k=10, you get the top 10 most similar vectors.
Choose top_k based on how many relevant items your application needs.
Getting More Context: Metadata
Often, you don't just want the ID and score; you need the original content or other properties associated with the vector. This is where include_metadata comes in.
- Set
include_metadata=Trueto retrieve the dictionary of metadata stored with each vector. - You can also set
include_values=Trueto get the actual vector array of the matched item, though this is less common for basic retrieval.
Combining Query with Filters (Preview)
Pinecone allows you to refine your similarity searches by adding filters based on the metadata you stored with your vectors.
For example, you could search for similar items only within a specific category or by a certain author.
We'll dive deeper into powerful metadata filtering in a later lesson, but know that it's a key feature for precise searches.
Practical Query with Metadata
Let's expand our previous example to include metadata in the results. For this to work, we'd need to have upserted data with metadata in a previous step.
This example assumes an index with vectors and associated metadata (e.g., {"genre": "sci-fi"}).
import os
from pinecone import Pinecone, Index
# Initialize Pinecone
api_key = os.environ.get("PINECONE_API_KEY", "YOUR_API_KEY")
environment = os.environ.get("PINECONE_ENVIRONMENT", "YOUR_ENVIRONMENT")
pc = Pinecone(api_key=api_key, environment=environment)
index_name = "my-first-index"
index = pc.Index(index_name)
# A dummy query vector
query_vector = [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8]
# Perform query, including metadata
query_results = index.query(
vector=query_vector,
top_k=2, # Get top 2 results
include_metadata=True # Request metadata
)
print("Detailed Query Results:")
for match in query_results.matches:
print(f"ID: {match.id}, Score: {match.score:.2f}, Metadata: {match.metadata}")Query Parameter Check
You want to retrieve the 5 most similar vectors from your Pinecone index. You also need to see the original metadata associated with each matched vector.
Which combination of parameters should you use in your index.query() call?
Querying Pinecone: Recap
Great job! You've learned how to query your Pinecone index to find similar vectors.
- Queries use a query vector, typically generated by the same embedding model.
- The
index.query()method is used, with key parameters likevector,top_k,include_metadata, andinclude_values. - Results include
idand ascoreindicating similarity.
Next, we'll explore more advanced ways to refine your searches!
Preguntas frecuentes
¿La lección «Consulta de datos vectoriales en Pinecone» es gratis?
Sí — el texto completo de «Consulta de datos vectoriales en Pinecone» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Vector Databases: Pinecone, Weaviate & pgvector, actualiza a CoddyKit PRO. El curso de Vector Databases: Pinecone, Weaviate & pgvector incluye 4 lecciones en total.
¿Qué aprenderé en «Consulta de datos vectoriales en Pinecone»?
Ejecute búsquedas por similitud eficientes en Pinecone para recuperar vectores relevantes a partir de un embedding de consulta. Practicas Vector Databases: Pinecone, Weaviate & pgvector con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Vector Databases: Pinecone, Weaviate & pgvector?
No se requiere experiencia previa. Vector Databases: Pinecone, Weaviate & pgvector en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.
¿Cuánto tiempo toma la lección «Consulta de datos vectoriales en Pinecone»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Vector Databases: Pinecone, Weaviate & pgvector?
Sí. Cada lección de Vector Databases: Pinecone, Weaviate & pgvector incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Creación de índices en Pinecone
- Upsert de datos en Pinecone
- Consulta de datos vectoriales en Pinecone
- Comprender los precios y los pods de Pinecone