Databricks uygulamasına yapay zeka arama dizini kaynağı ekleme

Uygulamalarınızda anlamsal aramayı ve benzerlik tabanlı almayı etkinleştirmek için AI Search dizinlerini Databricks Apps kaynakları olarak ekleyin. AI Search indeksleri, yüksek boyutlu vektör gömmelerini depolar ve sorgular; erişim destekli üretim (RAG), anlamsal arama ve öneri sistemleri gibi kullanım senaryolarını destekler.

Databricks AI Search eskiden Databricks Vektör Arama olarak biliniyordu.

Yetki gereksinimleri

Bir Yapay Zekâ Arama dizinine erişmek için uygulamanın hizmet sorumlusu kimliğinin üst katalog üzerinde USE CATALOG ayrıcalığına, üst şema üzerinde USE SCHEMA ayrıcalığına ve dizin üzerinde SELECT ayrıcalığına sahip olması gerekir. Dizin kaynağını eklediğinizde, Azure Databricks uygulamanın hizmet sorumlusuna otomatik olarak bu ayrıcalıkları 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 AI Search dizinlerini sorgulama hakkında daha fazla bilgi için bkz. AI Search dizinini sorgulama.

Bkz Unity Kataloğu ayrıcalıkları referansı.

AI Search dizin kaynağı ekleme

AI Search dizinini kaynak olarak eklemeden önce uygulama kaynağı önkoşullarını gözden geçirin.

1. Uygulama oluştururken veya düzenlerken Uygulama kaynakları bölümünde + Kaynak> ekleVektör arama dizini'ne tıklayın.
2. Çalışma alanınızdaki kullanılabilir dizinlerden bir Yapay Zeka Arama dizini seçin. Dizin Unity Kataloğu'nda zaten mevcut olmalıdır.
3. Uygulamanız için izin düzeyini seçin:
   • Şu seçeneği belirleyebilirsiniz: Uygulama, benzerlik aramaları için yapay zeka arama dizinini sorgulama izni verir. Ayrıcalığına SELECT karşılık gelir.
4. (İ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.

Ortam değişkenleri

Bir uygulamayı bir AI Search dizin kaynağıyla dağıttığınızda Azure Databricks, valueFrom alanını kullanarak başvurabileceğiniz ortam değişkenleri aracılığıyla üç düzeyli tam adı sunar.

Ö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 AI Search index name
index_name = os.getenv("VECTOR_SEARCH_INDEX")

# Initialize workspace client
w = WorkspaceClient()

# Query the AI 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.

AI Search dizin kaynağını kaldırma

Bir uygulamadan yapay zeka 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

AI Search dizin 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.