Databricks uygulamasına vektör arama dizini kaynağı ekleme

Uygulamalarınızda anlamsal aramayı ve benzerlik tabanlı almayı etkinleştirmek için Databricks Apps kaynakları olarak vektör arama dizinleri ekleyin. Vektör arama dizinleri yüksek boyutlu vektör eklemelerini depolar ve sorgular, alma artırılmış oluşturma (RAG), anlamsal arama ve öneri sistemleri gibi kullanım örneklerini güçlendirir.

Yetki gereksinimleri

Vektör arama dizinine erişmek için uygulamanın hizmet sorumlusunun USE CATALOG üst katalogda ayrıcalığı, USE SCHEMA üst şemada ayrıcalığı ve SELECT dizindeki ayrıcalığı olması gerekir. Dizin kaynağını eklediğinizde Azure Databricks bu ayrıcalıkları otomatik olarak uygulamanın hizmet sorumlusuna verir.

Bu otomatik verme işleminin başarılı olması için her ayrıcalık için aşağıdakilerden birinin geçerli olması gerekir:

• İçin USE CATALOG: Ya tüm hesap kullanıcılarının katalog üzerinde USE CATALOG ayrıcalıkları vardır ya da sizin katalog üzerinde MANAGE ayrıcalığınız vardır.
• için USE SCHEMA: Ya tüm hesap kullanıcılarının şema üzerinde USE SCHEMA yetkisi vardır, ya da sizin şema üzerinde MANAGE yetkiniz vardır.
• için SELECT: Ya tüm hesap kullanıcılarının dizinde SELECT ayrıcalığı vardır ya da sizin dizinde MANAGE ayrıcalığınız vardır.

Bu izinlerle vektör arama dizinlerini sorgulama hakkında daha fazla bilgi için bkz. Vektör arama dizinini sorgulama.

Bkz. Unity Kataloğu ayrıcalıkları ve güvenliği sağlanabilecek nesneler.

Vektör arama dizini kaynağı ekleme

Kaynak olarak vektör arama dizini eklemeden önce uygulama kaynağı önkoşullarını gözden geçirin.

1. Bir uygulama oluşturduğunuzda veya düzenlediğinizde Yapılandır adımına gidin.
2. Uygulama kaynakları bölümünde + Kaynak ekle'ye tıklayın.
3. Kaynak türü olarak Vektör arama dizini'ni seçin.
4. Çalışma alanınızdaki kullanılabilir dizinlerden bir vektör arama dizini seçin. Dizin Unity Kataloğu'nda zaten mevcut olmalıdır.
5. Uygulamanız için izin düzeyini seçin:
   • Şu seçeneği belirleyebilirsiniz: Benzerlik aramaları için vektör arama dizinini sorgulamak için uygulamaya izin verir. Ayrıcalığına SELECT karşılık gelir.
6. (İsteğe bağlı) Uygulama yapılandırmanızda dizine nasıl başvuracağınız için özel bir kaynak anahtarı belirtin. Varsayılan anahtardır vector-search-index.

Uyarı

Vektör arama dizinleri, türü TABLE_ONLINE_VECTOR_INDEX_REPLICA veya TABLE_ONLINE_VECTOR_INDEX_DIRECTolan Unity Kataloğu tablolarıdır. Vektör arama dizini seçtiğinizde, semantik arama işlemlerini destekleyen özel olarak yapılandırılmış bir tablo seçersiniz.

Ortam değişkenleri

Vektör arama dizini kaynağı olan bir uygulama dağıttığınızda Azure Databricks, valueFrom kullanarak başvurabileceğiniz ortam değişkenleri aracılığıyla tam üç düzeyli adı gösterir.

Örnek yapılandırma:

env:
  - name: VECTOR_SEARCH_INDEX
    valueFrom: vector-search-index # Use your custom resource key if different

Uygulamanızda dizini kullanma:

import os
from databricks.sdk import WorkspaceClient

# Access the vector search index name
index_name = os.getenv("VECTOR_SEARCH_INDEX")

# Initialize workspace client
w = WorkspaceClient()

# Query the vector search index
results = w.vector_search_indexes.query_index(
    index_name=index_name,
    query_text="What is machine learning?",
    num_results=10
)

# Process results
for result in results.manifest.columns:
    print(f"Result: {result}")

Daha fazla bilgi için bkz. Kaynaklara erişmek için ortam değişkenlerini kullanma.

Vektör arama dizini kaynağını kaldırma

Bir uygulamadan vektör arama dizini kaynağını kaldırdığınızda, uygulamanın hizmet sorumlusu dizine erişimi kaybeder. Dizinin kendisi değişmeden kalır ve uygun izinlere sahip diğer kullanıcılar ve uygulamalar için kullanılabilir olmaya devam eder.

En iyi yöntemler

Vektör arama dizini kaynaklarıyla çalışırken aşağıdakileri göz önünde bulundurun:

• Dizin diğer tablolara başvuruyorsa uygulamanın hizmet sorumlusunun temel veri kaynaklarına erişimi olduğundan emin olun.
• Yanıt sürelerinin düşmesi durumunda sorgu performansını izleyin ve dizin yapılandırmasını veya ekleme modellerini ayarlayın.
• Eklemeleri kaynak verilerle eşitlenmiş olarak tutmak için dizin yenileme zamanlamalarını göz önünde bulundurun.
• Ekleme modelinize göre uygun benzerlik ölçümlerini (kosinüs, öklid, noktalı ürün) kullanın.