AI Search indexerőforrás hozzáadása Egy Databricks-alkalmazáshoz

Adjon hozzá AI-keresési indexeket Databricks Apps-erőforrásokként a szemantikai keresés és a hasonlóságalapú lekérés engedélyezéséhez az alkalmazásokban. Az AI Search indexei nagydimenziós vektorbeágyazásokat tárolnak és kérdeznek le, lehetővé téve az olyan felhasználási eseteket, mint a visszakereséssel kiegészített generálás (RAG), a szemantikai keresés és az ajánlórendszerek.

A Databricks AI Search korábban Databricks Vector Search néven volt ismert.

Jogosultsági követelmények

Az AI Search-index eléréséhez az alkalmazás szolgáltatásnevének a szülőkatalóguson USE CATALOG jogosultsággal, a szülősémán USE SCHEMA jogosultsággal, valamint az indexen SELECT jogosultsággal kell rendelkeznie. Az indexerőforrás hozzáadásakor Azure Databricks automatikusan megadja ezeket a jogosultságokat az alkalmazás szolgáltatásnevéhez.

Ahhoz, hogy ez az automatikus engedélyezés sikeres legyen, az alábbiak egyikének igaznak kell lennie az egyes jogosultságokra:

  • A következőhöz USE CATALOG: Vagy minden fiókfelhasználó rendelkezik jogosultsággal USE CATALOG a katalógusban, vagy Ön rendelkezik a MANAGE katalógusban lévő jogosultsággal.
  • A következőhöz USE SCHEMA: Vagy minden fiókfelhasználó rendelkezik USE SCHEMA jogosultsággal a sémán, vagy Ön rendelkezik MANAGE jogosultsággal a sémán.
  • A következőhöz SELECT: Vagy minden fiókfelhasználó rendelkezik jogosultsággal SELECT az indexen, vagy Ön rendelkezik jogosultsággal MANAGE az indexen.

Az AI Search-indexek ilyen engedélyekkel való lekérdezéséről további információt az AI Search-indexek lekérdezése című témakörben talál.

Lásd a Unity Catalog jogosultságok referencia részt.

AI Search indexerőforrás hozzáadása

Mielőtt erőforrásként ad hozzá AI Search-indexet, tekintse át az alkalmazáserőforrás előfeltételeit.

  1. Az Alkalmazáserőforrások szakaszban, amikor létrehoz vagy szerkeszt egy alkalmazást, kattintson az + Erőforrás-vektor>keresési index hozzáadása elemre.
  2. Válasszon egy AI Search-indexet a munkaterületen elérhető indexekből. Az indexnek már léteznie kell a Unity Katalógusban.
  3. Válassza ki az alkalmazás jogosultsági szintjét:
    • Kiválaszthatja a következőt: Engedélyt ad az alkalmazásnak, hogy lekérdezhesse az AI Search indexet a hasonlósági keresésekhez. A SELECT jogosultságnak felel meg.
  4. (Nem kötelező) Adjon meg egy egyéni erőforráskulcsot, így hivatkozhat az indexre az alkalmazáskonfigurációban. Az alapértelmezett kulcs a következő vector-search-index.

Megjegyzés:

Az AI Search-indexek olyan Unity Catalog-táblák, amelyek típusa TABLE_ONLINE_VECTOR_INDEX_REPLICA vagy TABLE_ONLINE_VECTOR_INDEX_DIRECT. Az AI Search-index kiválasztásakor egy speciálisan konfigurált táblát választ ki, amely támogatja a szemantikai keresési műveleteket.

Környezeti változók

Amikor egy AI Search-indexerőforrással rendelkező alkalmazást helyez üzembe, Azure Databricks a teljes háromszintű nevet környezeti változókon keresztül teszi elérhetővé, amelyekre a valueFrom mező használatával hivatkozhat.

Példakonfiguráció:

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

Az index használata az alkalmazásban:

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}")

További információ: Környezeti változók használata erőforrások eléréséhez.

AI Search indexerőforrás eltávolítása

Amikor eltávolít egy AI Search-indexerőforrást egy alkalmazásból, az alkalmazás szolgáltatásnév elveszíti az indexhez való hozzáférést. Maga az index változatlan marad, és továbbra is elérhető lesz más, megfelelő engedélyekkel rendelkező felhasználók és alkalmazások számára.

Ajánlott eljárások

Az AI Search indexerőforrásaival végzett munka során vegye figyelembe a következőket:

  • Győződjön meg arról, hogy az alkalmazás szolgáltatásnévének hozzáférése van a mögöttes adatforrásokhoz, ha az index más táblákra hivatkozik.
  • A lekérdezési teljesítmény monitorozása, és az indexkonfiguráció vagy a beágyazási modellek módosítása, ha a válaszidő romlik.
  • Fontolja meg az indexfrissítés ütemezését, hogy a beágyazások szinkronizálva maradjanak a forrásadatokkal.
  • A beágyazási modell alapján használjon megfelelő hasonlósági metrikákat (koszinusz, euklideszi, pont termék).
  • Last updated on