Vektorunterstützung verwenden

Wählen Sie eine Dokumentationsversion aus:

Mit der Vektor-Assistenz können Sie eine Vektorarbeitslast auf Ihren AlloyDB Omni-Instanzen bereitstellen und verwalten.

Weitere Informationen zur Vektor-Assistenz und ihrer Funktionsweise finden Sie unter Übersicht zur Vektor-Assistenz.

Hinweis

  • Prüfen Sie, ob auf Ihrer AlloyDB Omni-Instanz Version 18.1.0 oder höher ausgeführt wird. Weitere Informationen zum Upgrade finden Sie unter AlloyDB Omni aktualisieren.

  • Aktivieren Sie die Erweiterung für die Vektor-Assistenz mit dem folgenden Befehl in der Datenbank, die Sie verwenden möchten:

    CREATE EXTENSION vector_assist CASCADE;

    Dadurch wird das Schema vector_assist generiert, das von der Vektor-Assistenz verwendet wird.

Vektor-Assistenz zum Bereitstellen einer Vektorarbeitslast verwenden

Wenn Sie die Vektor-Assistenz zum Bereitstellen und Verwalten einer Vektorarbeitslast verwenden möchten, müssen Sie Folgendes tun:

Vektorspezifikation definieren

Die Definition der Vektorspezifikation, oder Vektorspezifikation, ist der erste Schritt bei der Verwendung der Vektor-Assistenz. Je nach Art der Vektorarbeitslast können sich die Felder unterscheiden, die Sie zum Definieren der Vektorspezifikation verwenden.

Wenn Sie beispielsweise die semantische Suche für eine bestimmte Spalte in einer Tabelle aktivieren möchten, führen Sie die vector_assist.define_spec Funktion aus, um die Vektorspezifikation zu definieren:

SELECT
  recommendation_id,
  REGEXP_REPLACE(query, 'SET hnsw.ef_search TO \d+', 'SET hnsw.ef_search TO') AS query_1,
  recommendation,
  vector_spec_id,
  table_name,
  applied,
  modified
FROM vector_assist.define_spec(
  table_name => 'TABLE_NAME',
  vector_column_name => 'VECTOR_COLUMN_NAME',
  target_recall => TARGET_RECALL,
  tune_vector_index => TUNE_INDEX
);

Ersetzen Sie die folgenden Parameter:

  • TABLE_NAME: Name der Tabelle, die Sie in Ihrer Vektorarbeitslast verwenden möchten.
  • (Optional) VECTOR_COLUMN_NAME: Spalte, in der Sie eine semantische Suche ausführen möchten. Wenn Ihre Tabelle nur eine Spalte mit Vektoren enthält, kann vector_assist diese automatisch festlegen. Wenn es mehrere Tabellen mit Vektoren gibt, müssen Sie angeben, welche Spalte verwendet werden soll.
  • (Optional) TARGET_RECALL: Ziel-Recall, den die Vektor-Assistenz erreichen soll. Wenn angegeben, testet vector_assist verschiedene ef_search-Werte und vergleicht den Recall bei genauen Suchen und Suchen nach dem nächsten Nachbarn. vector_assist legt ef_search auf den Wert fest, der den Ziel-Recall am besten erreicht. Der Standardwert ist 0.95.
  • (Optional) TUNE_INDEX: Boolescher Wert, der angibt, ob die Vektor-Assistenz die Vektorindizes in Ihrer Arbeitslast optimiert. Der Standardwert ist false. Das bedeutet, dass nur die suchbezogenen Parameter (ef_search) optimiert werden. Parameter für die Erstellungszeit (m, ef_construction) werden nicht optimiert.

Eine vollständige Liste aller verfügbaren Parameter für die Vektorspezifikation finden Sie unter siehe Funktionsreferenzen für die Vektor-Assistenz.

Nachdem Sie die Abfrage zum Erstellen der Vektorspezifikation ausgeführt haben, generiert die Vektor-Assistenz automatisch Schritte, sogenannte Empfehlungen, die Sie ausführen müssen, um Ihre Vektorarbeitslast bereitzustellen.

Empfehlungen der Vektor-Assistenz ansehen

Wenn Sie die Empfehlungen ansehen möchten, die von der Vektor-Assistenz mit Ihrer Vektorspezifikation generiert wurden, führen Sie die vector_assist.get_recommendations Funktion aus:

SELECT vector_assist.get_recommendations(
  spec_id => 'SPEC_ID'
);

Ersetzen Sie SPEC_ID durch die Spezifikations-ID der Vektorspezifikation, für die Sie Empfehlungen ansehen möchten. Eine Liste der verfügbaren Vektorspezifikationen finden Sie unter Vektorspezifikationen auflisten.

vector_assist.get_recommendations gibt eine Tabelle mit dem Namen vector_assist.RECOMMENDATIONS zurück, die alle Empfehlungen enthält. Jede Empfehlung wird in einer Tabelle mit der zugehörigen spec_id gespeichert. Jede Empfehlung enthält in der Regel die folgenden Informationen:

  • SQL-Abfrage, die Sie ausführen müssen
  • Detaillierte Erläuterung der Empfehlung
  • Weitere relevante Informationen, die die Empfehlung erläutern

Empfehlungen der Vektor-Assistenz anwenden

Sie können die generierten Empfehlungen einzeln oder als Ganzes anwenden.

Wenn Sie eine bestimmte Empfehlung anwenden möchten, führen Sie die vector_assist.apply_recommendation Funktion aus:

SELECT vector_assist.apply_recommendation(
  recommendation_id => 'RECOMMENDATION_ID'
);

Ersetzen Sie RECOMMENDATION_ID durch die ID der Empfehlung der Vektor-Assistenz, die Sie aus der Tabelle vector_assist.RECOMMENDATIONS anwenden möchten.

Wenn Sie alle Empfehlungen zusammen anwenden möchten, führen Sie die vector_assist.apply_spec Funktion mit dem Parameter spec_id oder table_name aus:

SELECT vector_assist.apply_spec(
  spec_id => 'SPEC_ID'
);

Ersetzen Sie SPEC_ID durch die ID der Vektorspezifikation, die Sie verwenden möchten.

Optional können Sie auch die Parameter schema_name oder column_name eingeben. Informationen zu allen verfügbaren Suchparametern finden Sie unter Funktionsreferenzen für die Vektor-Assistenz.

Nachdem Sie die von der Vektor-Assistenz generierten Empfehlungen angewendet haben, ist der Vektorindex einsatzbereit.

Suchanfragen generieren

Mit der Vektor-Assistenz können Sie optimierte Suchanfragen für Ihre bereitgestellten Vektorarbeitslasten erstellen. Dazu werden die Vektorspezifikation und der generierte Vektorindex der Arbeitslast verwendet. Führen Sie die vector_assist.generate_query Funktion aus, um eine optimierte Suchanfrage zu generieren:

SELECT vector_assist.generate_query(
  spec_id => 'SPEC_ID',
  search_vector => 'SEARCH_VECTOR',
  top_k => 'TOP_K',
  target_recall => TARGET_RECALL,
  filter_expression => 'FILTER_EXPRESSION'
);

Ersetzen Sie die folgenden Parameter:

  • SPEC_ID: ID der Spezifikation, die Sie verwenden möchten.
  • SEARCH_VECTOR: Vektor für Ihre Suchanfrage. Beispiel: [1, 2, 3].
  • (Optional) TOP_K: Anzahl der zurückzugebenden nächsten Nachbarn. Ohne explizite Angabe beträgt der Standardwert 10.
  • (Optional) TARGET_RECALL: Ziel-Recall, den die Vektor-Assistenz erreichen soll. Wenn angegeben, testet vector_assist verschiedene ef_search-Werte und vergleicht den Recall bei genauen Suchen und Suchen nach dem nächsten Nachbarn. vector_assist legt ef_search auf den Wert fest, der den Ziel-Recall am besten erreicht.
  • (Optional) FILTER_EXPRESSION: Alle Filter für die Suchanfrage. Beispiel: Filtern nach anderen Spalten.

Eine vollständige Liste aller verfügbaren Parameter zum Generieren einer Such anfrage finden Sie unter Funktionsreferenzen für die Vektor-Assistenz.

Die Ausgabe dieser Funktion enthält Text mit einer SQL-Abfrage. Sie können diese SQL-Abfrage nach Bedarf ausführen oder speichern.

Vektorspezifikationen auflisten

Wenn Sie eine einzelne oder alle vorhandenen Vektorspezifikationen auflisten möchten, führen Sie die Funktion vector_assist.list_specs aus:

SELECT vector_assist.list_specs(
  spec_id => 'SPEC_ID',
  table_name => 'TABLE_NAME'
);

Ersetzen Sie die folgenden Parameter:

  • (Optional) SPEC_ID: ID der Vektorspezifikation, die Sie verwenden möchten.
  • TABLE_NAME: Name der Tabelle, die Sie zum Definieren der Vektorspezifikation verwendet haben.

Nächste Schritte