0Pricing
Vector Databases: Pinecone, Weaviate & pgvector · 강의

Pinecone에서 벡터 데이터 질의하기

질의 임베딩을 바탕으로 관련 벡터를 검색하는 효율적인 유사도 검색을 Pinecone에서 실행합니다.

Pinecone에서 벡터 데이터 질의하기은(는) CoddyKit의 무료 Vector Databases: Pinecone, Weaviate & pgvector 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vector Databases: Pinecone, Weaviate & pgvector 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vector Databases: Pinecone, Weaviate & pgvector 강의에는 총 4개의 강의가 포함되어 있습니다.

이 강의의 일부는 아직 번역되지 않았으며 영어로 표시됩니다.

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 (if include_values=True).
  • metadata: Any associated metadata (if include_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=True to retrieve the dictionary of metadata stored with each vector.
  • You can also set include_values=True to 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 like vector, top_k, include_metadata, and include_values.
  • Results include id and a score indicating similarity.

Next, we'll explore more advanced ways to refine your searches!

자주 묻는 질문

“Pinecone에서 벡터 데이터 질의하기” 강의는 무료인가요?

네 — “Pinecone에서 벡터 데이터 질의하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vector Databases: Pinecone, Weaviate & pgvector 강의 전체를 잠금 해제할 수 있습니다. Vector Databases: Pinecone, Weaviate & pgvector 강의에는 총 4개의 강의가 포함되어 있습니다.

“Pinecone에서 벡터 데이터 질의하기”에서 뭘 배우나요?

질의 임베딩을 바탕으로 관련 벡터를 검색하는 효율적인 유사도 검색을 Pinecone에서 실행합니다. 브라우저에서 직접 실행하는 실습 코드로 Vector Databases: Pinecone, Weaviate & pgvector을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Vector Databases: Pinecone, Weaviate & pgvector을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Vector Databases: Pinecone, Weaviate & pgvector은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“Pinecone에서 벡터 데이터 질의하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Vector Databases: Pinecone, Weaviate & pgvector 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Vector Databases: Pinecone, Weaviate & pgvector 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. Pinecone 색인 생성
  2. Pinecone에 데이터 업서트하기
  3. Pinecone에서 벡터 데이터 질의하기
  4. Pinecone 가격 및 파드 이해하기
← Vector Databases: Pinecone, Weaviate & pgvector(으)로 돌아가기