SQL mit AlloyDB AI in natürlicher Sprache generieren

In dieser Anleitung wird beschrieben, wie Sie die AlloyDB AI Natural Language API über die Google Cloud Console einrichten und verwenden. Sie erfahren, wie Sie die AlloyDB AI Natural Language API konfigurieren, damit Sie Fragen in natürlicher Sprache stellen und SQL-Abfragen und Ergebnisse erhalten können.

Die Beispiele in diesem Tutorial dienen nur zu Demonstrationszwecken.

.

Ziele

  • Tabellen erstellen und mit Daten füllen sowie Kontext mithilfe der automatischen Generierung erstellen
  • Erstellen Sie einen Wertindex für die Spalten in der Datenbank.
  • Erstellen und konfigurieren Sie ein Objekt für die Konfiguration von natürlicher Sprache (nl_config).
  • Erstellen Sie Vorlagen für eine Beispielabfrage in der Anwendung.
  • Verwenden Sie die Funktion get_sql(), um eine SQL-Abfrage zu erstellen, mit der eine Frage beantwortet wird.
  • Verwenden Sie die Funktion execute_nl_query(), um eine Frage in natürlicher Sprache mithilfe der Datenbank zu beantworten.

Kosten

In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:

Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen.

Neuen Google Cloud Nutzern steht möglicherweise eine kostenlose Testversion zur Verfügung.

Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.

Hinweise

Abrechnung und erforderliche APIs aktivieren

  1. Wählen Sie in der Google Cloud -Console ein Projekt aus.

    Zur Projektauswahl

  2. Die Abrechnung für Ihr Google Cloud -Projekt muss aktiviert sein.

  3. Aktivieren Sie die Cloud APIs, die zum Erstellen einer Verbindung zu AlloyDB for PostgreSQL erforderlich sind.

    API aktivieren

    1. Klicken Sie im Schritt Projekt bestätigen auf Weiter, um den Namen des Projekts zu bestätigen, an dem Sie Änderungen vornehmen möchten.

    2. Klicken Sie im Schritt APIs aktivieren auf Aktivieren, um Folgendes zu aktivieren:

      • AlloyDB API

Erstellen und Verbindung zu einer Datenbank herstellen

  1. Cluster und primäre Instanz erstellen
  2. Verbindung zur Instanz herstellen und Datenbank erstellen
  3. Aktivieren Sie die Vertex AI-Einbindung. Weitere Informationen finden Sie unter Mit Vertex AI integrieren.

Erforderliche Erweiterung aktivieren und installieren

Wenn Sie die alloydb_ai_nl extension installieren und verwenden möchten, müssen Sie die Erweiterung zuerst mit dem Flag alloydb_ai_nl.enabled aktivieren. Weitere Informationen finden Sie unter Datenbank-Flags einer Instanz konfigurieren.

Führen Sie die folgende Abfrage aus, um die alloydb_ai_nl-Erweiterung zu installieren, die die AlloyDB AI Natural Language Support API ist:

CREATE EXTENSION alloydb_ai_nl cascade;

alloydb_ai_nl-Erweiterung aktualisieren

Wenn Sie die Erweiterung bereits installiert haben, führen Sie die folgende Anweisung aus, um sie auf die neueste Version zu aktualisieren:

ALTER EXTENSION alloydb_ai_nl UPDATE;

Schema und Tabellen für nla_demo erstellen

In den folgenden Schritten erstellen Sie das nla_demo-Schema und die Tabellen im Schema. Sie füllen die Tabellen mit synthetischen Daten. Das bereitgestellte Schema und die Daten sind so konzipiert, dass sie die grundlegenden Abläufe eines Online-Einzelhandelsunternehmens unterstützen. Die potenziellen Anwendungen erstrecken sich auf Kundenverwaltung, Analysen, Marketing und betriebliche Aspekte.

Die Beispieldaten zeigen, wie Sie AlloyDB AI Natural Language für Entwicklungs-, Test- und Demonstrationszwecke verwenden können, insbesondere für Funktionen wie Schnittstellen für natürliche Sprache.

  1. Erstellen Sie das Schema mit der folgenden Abfrage:

    CREATE SCHEMA nla_demo;

  2. Erstellen Sie Tabellen im Schema nla_demo. In der Tabelle addresses werden die Adressinformationen für Kunden und Bestellungen gespeichert.

    CREATE TABLE nla_demo.addresses (
    address_id      SERIAL         PRIMARY KEY,
    street_address  VARCHAR(255)   NOT NULL,
    city            VARCHAR(255)   NOT NULL,
    country         VARCHAR(255)
);

  3. Erstellen Sie die Tabelle customers mit der folgenden Abfrage. In dieser Tabelle werden Kundeninformationen wie Kundennummer, Name, Kontaktdaten, Adressreferenz, Geburtsdatum und Erstellungszeit des Datensatzes gespeichert.

    CREATE TABLE nla_demo.customers (
    customer_id     SERIAL         PRIMARY KEY,
    first_name      VARCHAR(255)   NOT NULL,
    last_name       VARCHAR(255)   NOT NULL,
    email           VARCHAR(255)   UNIQUE NOT NULL,
    address_id      INTEGER        REFERENCES nla_demo.addresses(address_id),
    date_of_birth   DATE,
    created_at      TIMESTAMP      DEFAULT CURRENT_TIMESTAMP
);

  4. Erstellen Sie die Tabelle categories, in der Produktkategorien gespeichert werden.

    CREATE TABLE nla_demo.categories (
    category_id     INTEGER        PRIMARY KEY,
    category_name   VARCHAR(255)   UNIQUE NOT NULL
);

  5. Erstellen Sie die Tabelle brands, in der Markennamen gespeichert werden.

    CREATE TABLE nla_demo.brands (
    brand_id      INTEGER        PRIMARY KEY,
    brand_name    VARCHAR(255)   NOT NULL
);

  6. Erstellen Sie die Tabelle products, in der Produktinformationen wie Produkt-ID, Name, Beschreibung, Marke, Kategorieverknüpfung und Erstellungszeit des Datensatzes gespeichert werden.

    CREATE TABLE nla_demo.products (
    product_id    INTEGER        PRIMARY KEY,
    name          VARCHAR(255)   NOT NULL,
    description   TEXT           DEFAULT 'Not available',
    brand_id      INTEGER        REFERENCES nla_demo.brands(brand_id),
    category_id   INTEGER        REFERENCES nla_demo.categories(category_id),
    created_at    TIMESTAMP      DEFAULT CURRENT_TIMESTAMP,
    price         DECIMAL(10, 2),
    description_embedding        VECTOR(768)
);

  7. Erstellen Sie die Tabelle orders. In dieser Tabelle werden Informationen zu Kundenbestellungen gespeichert, einschließlich Kunde, Datum, Gesamtbetrag, Versand- und Rechnungsadressen sowie Bestellstatus.

    CREATE TABLE nla_demo.orders (
    order_id            INTEGER        PRIMARY KEY,
    customer_id         INTEGER        REFERENCES nla_demo.customers(customer_id),
    order_date          TIMESTAMP      DEFAULT CURRENT_TIMESTAMP,
    total_amount        DECIMAL(10, 2) NOT NULL,
    shipping_address_id INTEGER        REFERENCES nla_demo.addresses(address_id),
    billing_address_id  INTEGER        REFERENCES nla_demo.addresses(address_id),
    order_status        VARCHAR(50)
);

  8. Erstellen Sie die Tabelle order_items. In dieser Tabelle werden die einzelnen Artikel in einer Bestellung, Links zur Bestellung und zur Produktvariante sowie Menge und Preis angegeben.

    CREATE TABLE nla_demo.order_items (
    order_item_id   SERIAL         PRIMARY KEY,
    order_id        INTEGER        REFERENCES nla_demo.orders(order_id),
    product_id      INTEGER        REFERENCES nla_demo.products(product_id),
    quantity        INTEGER        NOT NULL,
    price           DECIMAL(10, 2) NOT NULL
);

Tabellen im Schema „nla_demo“ mit Daten füllen

  1. Füllen Sie die Tabelle addresses mit der folgenden Abfrage:

    INSERT INTO nla_demo.addresses (street_address, city, country)
VALUES
    ('1800 Amphibious Blvd', 'Mountain View', 'USA'),
    ('Avenida da Pastelaria, 1903', 'Lisbon', 'Portugal'),
    ('8 Rue du Nom Fictif 341', 'Paris', 'France');

  2. Füllen Sie die Tabelle customers aus.

    INSERT INTO nla_demo.customers (first_name, last_name, email, address_id, date_of_birth)
VALUES
    ('Alex', 'B.', 'alex.b@example.com', 1, '2003-02-20'),
    ('Amal', 'M.', 'amal.m@example.com', 2, '1998-11-08'),
    ('Dani', 'G.', 'dani.g@example.com', 3, '2002-07-25');

  3. Füllen Sie die Tabelle categories aus.

    INSERT INTO nla_demo.categories (category_id, category_name)
VALUES
    (1, 'Accessories'),
    (2, 'Apparel'),
    (3, 'Footwear'),
    (4, 'Swimwear');

  4. Füllen Sie die Tabelle brands aus.

    INSERT INTO nla_demo.brands (brand_id, brand_name)
VALUES
    (1, 'CymbalPrime'),
    (2, 'CymbalPro'),
    (3, 'CymbalSports');

  5. Füllen Sie die Tabelle products aus.

    INSERT INTO nla_demo.products (product_id, brand_id, category_id, name, description, price)
VALUES
    (1, 1, 2, 'Hoodie', 'A comfortable, casual sweatshirt with an attached hood.', 79.99),
    (2, 1, 3, 'Running Shoes', 'Lightweight, cushioned footwear designed for the impact of running.', 99.99),
    (3, 2, 4, 'Swimsuit', 'A garment designed for swimming or other water activities.', 20.00),
    (4, 3, 1, 'Tote Bag', 'A large, unfastened bag with two parallel handles.', 69.99),
    (5, 3, 3, 'CymbalShoe', 'Footwear from Cymbal, designed for your life''s rhythm.', 89.99);

UPDATE nla_demo.products SET description_embedding = embedding('text-embedding-004', description);

  6. Füllen Sie die Tabelle orders aus.

    INSERT INTO nla_demo.orders (order_id, customer_id, total_amount, shipping_address_id, billing_address_id, order_status)
VALUES
    (1, 1, 99.99, 1, 1, 'Shipped'),
    (2, 1, 69.99, 1, 1, 'Delivered'),
    (3, 2, 20.99, 2, 2, 'Processing'),
    (4, 3, 79.99, 3, 3, 'Shipped');

  7. Füllen Sie die Tabelle order_items aus.

    INSERT INTO nla_demo.order_items (order_id, product_id, quantity, price)
VALUES
    (1, 1, 1, 79.99),
    (1, 3, 1, 20.00),
    (2, 4, 1, 69.99),
    (3, 3, 1, 20.00),
    (4, 2, 1, 79.99);

Konfiguration für natürliche Sprache erstellen

Wenn Sie AlloyDB AI für natürliche Sprache verwenden möchten, muss der Vertex AI-Endpunkt konfiguriert sein. Anschließend erstellen Sie eine Konfiguration und registrieren ein Schema. Mit g_alloydb_ai_nl.g_create_configuration wird das Modell erstellt.

  1. Konfiguration für natürliche Sprache erstellen

    SELECT alloydb_ai_nl.g_create_configuration( 'nla_demo_cfg' );

  2. Registrieren Sie Tabellen für die nla_demo_cfg-Konfiguration.

    SELECT alloydb_ai_nl.g_manage_configuration(
    operation => 'register_table_view',
    configuration_id_in => 'nla_demo_cfg',
    table_views_in=>'{nla_demo.customers, nla_demo.addresses, nla_demo.brands, nla_demo.products, nla_demo.categories, nla_demo.orders, nla_demo.order_items}'
);

Kontext für Tabellen und Spalten erstellen und anwenden

Um genaue Antworten auf Fragen in natürlicher Sprache zu geben, verwenden Sie die AlloyDB AI Natural Language API, um Kontext zu Tabellen, Ansichten und Spalten bereitzustellen. Mit der Funktion zur automatischen Kontexterstellung der AlloyDB AI Natural Language API können Sie Kontext aus Tabellen und Spalten generieren und den Kontext als COMMENTS an Tabellen, Ansichten und Spalten anhängen.

  1. Führen Sie den folgenden Befehl aus, um Schemakontexte für die Tabellen und ihre Spalten zu generieren, die in der nla_demo_cfg-Konfiguration registriert sind:

    SELECT alloydb_ai_nl.generate_schema_context(
  'nla_demo_cfg',
  TRUE
);

    Mit der vorherigen Abfrage wird die Ansicht alloydb_ai_nl.generated_schema_context_view mit Kontext gefüllt. Wenn Sie TRUE übergeben, wird der Kontext in dieser Ansicht aus vorherigen Ausführungen überschrieben.

  2. Führen Sie die folgende Abfrage aus, um den generierten Kontext für die Tabelle nla_demo.products zu prüfen:

    SELECT object_context
FROM alloydb_ai_nl.generated_schema_context_view
WHERE schema_object = 'nla_demo.products';

    Der resultierende Kontext sieht etwa so aus:

    The products table stores information about products, including their name,
a brief description, the brand they belong to (referenced by brand_id),
and the category they fall under (referenced by category_id). Each product
has a unique identifier (product_id) and a timestamp indicating its creation
time (created_at).

  3. So prüfen Sie den erstellten Kontext für eine Spalte wie nla_demo.products.name:

    SELECT object_context
FROM alloydb_ai_nl.generated_schema_context_view
WHERE schema_object = 'nla_demo.products.name';

    Die Ausgabe der Abfrage sieht in etwa so aus:

    The name column in the nla_demo.products table contains the specific
name or title of each product. This is a short, descriptive text string
that clearly identifies the product, like "Hoodie," "Tote Bag,"
"Running Shoes," or "Swimsuit." It helps distinguish individual products
within the broader context of their brand and category. The name column
specifies the exact product. This column is essential for users and
systems to identify and refer to specific products within the database.

  4. Sehen Sie sich den generierten Kontext in der Ansicht alloydb_ai_nl.generated_schema_context_view an und aktualisieren Sie den Kontext, der überarbeitet werden muss.

    SELECT alloydb_ai_nl.update_generated_relation_context(
  'nla_demo.products',
  'The "nla_demo.products" table stores product details such as ID, name, description, brand, category linkage, and record creation time.'
);

SELECT alloydb_ai_nl.update_generated_column_context(
  'nla_demo.products.name',
  'The "name" column in the "nla_demo.products" table contains the specific name or title of each product.'
);

  5. Wenden Sie den generierten Kontext an, den Sie den entsprechenden Objekten zuweisen möchten:

    SELECT alloydb_ai_nl.apply_generated_relation_context(
  'nla_demo.products', true
);

SELECT alloydb_ai_nl.apply_generated_column_context(
  'nla_demo.products.name',
  true
);

    Die resultierenden Kontexteinträge in der alloydb_ai_nl.generated_schema_context_view-Ansicht werden auf die entsprechenden Schemaobjekte angewendet und die Kommentare werden überschrieben.

Wertindex erstellen

Die AlloyDB AI Natural Language API generiert mithilfe der Wertverknüpfung genaue SQL-Abfragen. Durch die Wertverknüpfung werden Wertformulierungen in natürlichsprachlichen Anweisungen mit vorab registrierten Konzepttypen und Spaltennamen verknüpft, wodurch die natürlichsprachliche Frage angereichert werden kann.

Die Frage „Gib mir den Preis eines Hoodies“ kann beispielsweise genauer beantwortet werden, wenn Hoodie mit dem Konzept product_name verknüpft ist, das wiederum mit nla_demo.products.name verknüpft ist. Spalte.

  1. Führen Sie die folgenden Abfragen aus, um den Konzepttyp product_name zu definieren und der Spalte nla_demo.products.name zuzuordnen:

    SELECT alloydb_ai_nl.add_concept_type(
    concept_type_in => 'product_name',
    match_function_in => 'alloydb_ai_nl.get_concept_and_value_generic_entity_name',
    additional_info_in => '{
      "description": "Concept type for product name.",
      "examples": "SELECT alloydb_ai_nl.get_concept_and_value_generic_entity_name(''Hoodie'')" }'::jsonb
);
SELECT alloydb_ai_nl.associate_concept_type(
    'nla_demo.products.name',
    'product_name',
    'nla_demo_cfg'
);

  2. Um zu prüfen, ob der Konzepttyp product_name der Liste der Konzepttypen hinzugefügt wurde, führen Sie die folgende Abfrage aus. Das Ergebnis dieser Abfrage muss product_name enthalten:

    SELECT alloydb_ai_nl.list_concept_types();

  3. Führen Sie die folgende Abfrage aus, um zu prüfen, ob die Spalte nla_demo.products.name mit dem Konzepttyp product_name verknüpft ist:

    SELECT *
FROM alloydb_ai_nl.value_index_columns
WHERE column_names = 'nla_demo.products.name';

  4. Führen Sie die folgenden Abfragen aus, um den Konzepttyp brand_name zu definieren und der Spalte nla_demo.brands.brand_name zuzuordnen:

    SELECT alloydb_ai_nl.add_concept_type(
    concept_type_in => 'brand_name',
    match_function_in => 'alloydb_ai_nl.get_concept_and_value_generic_entity_name',
    additional_info_in => '{
      "description": "Concept type for brand name.",
      "examples": "SELECT alloydb_ai_nl.get_concept_and_value_generic_entity_name(''CymbalPrime'')" }'::jsonb
);
SELECT alloydb_ai_nl.associate_concept_type(
    'nla_demo.brands.brand_name',
    'brand_name',
    'nla_demo_cfg'
);

  5. Nachdem Sie die Konzepttypen definiert und Spalten damit verknüpft haben, erstellen Sie einen Wertindex.

    SELECT alloydb_ai_nl.create_value_index('nla_demo_cfg');
SELECT alloydb_ai_nl.refresh_value_index('nla_demo_cfg');

Konzepttypzuordnungen automatisch generieren

Mit der Verarbeitung natürlicher Sprache in AlloyDB AI können Sie Assoziationen basierend auf den vorhandenen Konzepttypen automatisch generieren lassen, anstatt einen Konzepttyp manuell mit Spalten verknüpfen zu müssen, z. B. durch manuelles Aufrufen von alloydb_ai_nl.associate_concept_type.

So erstellen Sie automatisch eine Zuordnung von Konzepttyp:

  1. Assoziationen für alle Beziehungen im Bereich von nla_demo_cfg generieren:

    SELECT alloydb_ai_nl.generate_concept_type_associations('nla_demo_cfg');

  2. Sehen Sie sich die generierten Assoziationen an.

    SELECT * from alloydb_ai_nl.generated_value_index_columns_view;

    Das Ergebnis sieht etwa so aus. Es werden sowohl integrierte als auch nutzerdefinierte Konzepte berücksichtigt.

     -[ RECORD 1 ]---+-----------------------------------------------------------
 id              | 1
 config          | nla_demo_cfg
 column_names    | nla_demo.addresses.city
 concept_type    | city_name
 additional_info | {}
 -[ RECORD 2 ]---+-----------------------------------------------------------
 id              | 2
 config          | nla_demo_cfg
 column_names    | nla_demo.addresses.country
 concept_type    | country_name
 additional_info | {}
 -[ RECORD 3 ]---+-----------------------------------------------------------
 id              | 3
 config          | nla_demo_cfg
 column_names    | nla_demo.customers.first_name,nla_demo.customers.last_name
 concept_type    | full_person_name
 additional_info | {}
 -[ RECORD 4 ]---+-----------------------------------------------------------
 id              | 4
 config          | nla_demo_cfg
 column_names    | nla_demo.brands.brand_name
 concept_type    | brand_name
 additional_info | {}
 -[ RECORD 5 ]---+-----------------------------------------------------------
 id              | 5
 config          | nla_demo_cfg
 column_names    | nla_demo.products.name
 concept_type    | product_name
 additional_info | {}

 ....
 ```

  3. Optional: Aktualisieren oder entfernen Sie die generierten Zuordnungen.

    -- Update, NULL means keeping the original value.
SELECT alloydb_ai_nl.update_generated_concept_type_associations(
 id => 1,
 column_names => NULL,
 concept_type => 'generic_entity_name',
 additional_info => NULL
);

-- Drop
SELECT alloydb_ai_nl.drop_generated_concept_type_association(id => 1);

  4. Wenden Sie die generierten Zuordnungen an.

    SELECT alloydb_ai_nl.apply_generated_concept_type_associations('nla_demo_cfg');

  5. Aktualisieren Sie den Wertindex, damit die Änderungen berücksichtigt werden.

    SELECT alloydb_ai_nl.refresh_value_index('nla_demo_cfg');

Abfragevorlagen definieren

Sie können Vorlagen definieren, um die Qualität der Antworten zu verbessern, die von der AlloyDB AI Natural Language API generiert werden.

  1. Wenn Sie Beispielvorlagen für geschäftskritische Fragen und erwartete Fragen bereitstellen möchten, für die eine hohe Genauigkeit erwartet wird, führen Sie die folgende Abfrage aus, um eine Vorlage hinzuzufügen:

    SELECT alloydb_ai_nl.add_template(
    nl_config_id => 'nla_demo_cfg',
    intent => 'List the first names and the last names of all customers who ordered Swimsuit.',
    sql => 'SELECT c.first_name, c.last_name FROM nla_demo.Customers c JOIN nla_demo.orders o ON c.customer_id = o.customer_id JOIN nla_demo.order_items oi ON o.order_id = oi.order_id JOIN nla_demo.products p ON oi.product_id = p.product_id  AND p.name = ''Swimsuit''',
    sql_explanation => 'To answer this question, JOIN `nla_demo.Customers` with `nla_demo.orders` on having the same `customer_id`, and JOIN the result with nla_demo.order_items on having the same `order_id`. Then JOIN the result with `nla_demo.products` on having the same `product_id`, and filter rwos that with p.name = ''Swimsuit''. Return the `first_name` and the `last_name` of the customers with matching records.',
    check_intent => TRUE
);

  2. Wenn Sie die Liste der hinzugefügten Vorlagen aufrufen möchten, fragen Sie die Ansicht alloydb_ai_nl.template_store_view ab:

    SELECT nl, sql, intent, psql, pintent
FROM alloydb_ai_nl.template_store_view
WHERE config = 'nla_demo_cfg';

    Die folgende Ausgabe wird zurückgegeben:

    nl      | List the first names and the last names of all customers who ordered Swimsuit.
sql     | SELECT c.first_name, c.last_name
        | FROM nla_demo.Customers c
        | JOIN nla_demo.orders o ON c.customer_id = o.customer_id
        | JOIN nla_demo.order_items oi ON o.order_id = oi.order_id
        | JOIN nla_demo.products p ON oi.product_id = p.product_id
        | AND p.name = 'Swimsuit'
intent  | List the first names and the last names of all customers who ordered
        | Swimsuit.
psql    | SELECT c.first_name, c.last_name
        | FROM nla_demo.Customers c JOIN nla_demo.orders o
        | ON c.customer_id = o.customer_id 
        | JOIN nla_demo.order_items oi ON o.order_id = oi.order_id
        | JOIN nla_demo.products p ON oi.product_id = p.product_id
        | AND p.name = $1
pintent | List the first names and the last names of all customers who ordered
        | $1.

    In dieser Vorlage ist der Wert, der dem Attribut psql entspricht, die parametrisierte SQL-Abfrage und der Wert für die Spalte pintent die parametrisierte Intent-Anweisung. Die ID einer neu hinzugefügten Vorlage kann sich je nach den zuvor hinzugefügten Vorlagen unterscheiden. Vorlagen liefern sehr genaue Antworten auf Fragen.

  3. Führen Sie die folgende Beispielanweisung aus, um eine Vorlage zu erstellen, die die semantische Suche verwendet:

    SELECT alloydb_ai_nl.add_template(
 nl_config_id => 'nla_demo_cfg',
 intent => 'List 3 products most similar to a Swimwear.',
 sql => $$SELECT name FROM nla_demo.products 
         ORDER BY description_embedding <=> embedding('text-embedding-004', 'Swimwear')::vector$$,
 sql_explanation => $$To answer this question, ORDER products in `nla_demo.products` , based by their distance of the descrption_embedding of the product with the embedding of 'Swimwear'.$$,
 check_intent => TRUE
);

    Mit der oben genannten Vorlage wird der Ansicht alloydb_ai_nl.template_store_view die folgende Zeile hinzugefügt:

    nl      | List 3 products most similar to a Swimwear.
sql     | SELECT name FROM nla_demo.products                                                                
        | ORDER BY description_embedding <=>
        | embedding('text-embedding-004', 'Swimwear')::vector
intent  | List 3 products most similar to a Swimwear.
psql    | SELECT name FROM nla_demo.products                                                                
        | ORDER BY description_embedding <=>
        | embedding('text-embedding-004', $1)::vector
pintent | List 3 products most similar to a $1.

Abfragefragment definieren

Sie können Fragmente definieren, um die Qualität der Antworten zu verbessern, die von der AlloyDB AI Natural Language API generiert werden.

Führen Sie die folgende Abfrage aus, um ein Fragment für geschäftskritische Attribute und erwartete Bedingungen zu erstellen, für die eine hohe Genauigkeit erwartet wird:

SELECT alloydb_ai_nl.add_fragment(
  nl_config_id => 'nla_demo_cfg',
  table_aliases => ARRAY['nla_demo.products AS T'],
  intent => 'luxury product',
  fragment => $$description LIKE '%luxury%' OR description LIKE '%premium%' OR description LIKE '%exclusive%' OR description LIKE '%high-end%' OR description LIKE '%finest%' OR description LIKE '%elite%' OR description LIKE '%deluxe%'$$);

Wenn Sie die Liste der hinzugefügten Fragment-IDs aufrufen möchten, fragen Sie die Ansicht alloydb_ai_nl.fragment_store_view ab:

SELECT intent, fragment, pintent
FROM alloydb_ai_nl.fragment_store_view;

Die folgende Ausgabe wird zurückgegeben:

intent    | luxury product
fragment  | description LIKE '%luxury%' OR description LIKE '%premium%' OR description LIKE '%exclusive%' OR description LIKE '%high-end%' OR description LIKE '%finest%' OR description LIKE '%elite%' OR description LIKE '%deluxe%'
pintent   | luxury product

SQL-Ergebnisse aus Fragen in natürlicher Sprache generieren

  1. Führen Sie die folgende Abfrage aus, um mit der AlloyDB AI Natural Language API SQL-Abfragen und Ergebnismengen zu erstellen:

    SELECT
    alloydb_ai_nl.get_sql(
        'nla_demo_cfg',
        'Find the customers who purchased Tote Bag.'
    ) ->> 'sql';

    Die folgende Ausgabe wird zurückgegeben:

    SELECT DISTINCT "c"."first_name", "c"."last_name"
FROM "nla_demo"."customers" AS "c"
JOIN "nla_demo"."orders" AS "o" ON "c"."customer_id" = "o"."customer_id"
JOIN "nla_demo"."order_items" AS "oi" ON "o"."order_id" = "oi"."order_id"
JOIN "nla_demo"."products" AS "p" ON "oi"."product_id" = "p"."product_id"
WHERE "p"."name" = 'Tote Bag';

    Die JSON-Ausgabe ist eine SQL-Abfrage, die die Vorlage verwendet, die Sie unter Abfragevorlage definieren hinzugefügt haben.

  2. Wenn Sie die AlloyDB AI Natural Language API verwenden möchten, um SQL-Abfragen zu erstellen, führen Sie die folgende Abfrage aus:

    SELECT
    alloydb_ai_nl.get_sql(
        'nla_demo_cfg',
        'List the maximum price of any CymbalShoe.'
    ) ->> 'sql';

    Die folgende Ausgabe wird zurückgegeben:

    SELECT max("price")
FROM "nla_demo"."products"
WHERE "name" = 'CymbalShoe'

    Die AlloyDB AI Natural Language API erkennt anhand des Wertindex, dass CymbalShoe der Name des Produkts ist. Führen Sie die folgende Abfrage aus und ersetzen Sie CymbalShoe durch einen Markennamen (CymbalPrime):

    SELECT
    alloydb_ai_nl.get_sql(
        'nla_demo_cfg',
        'List the maximum price of any CymbalPrime.'
    ) ->> 'sql';

    Die folgende Ausgabe wird generiert:

    SELECT max("price")
FROM "nla_demo"."products" AS t1
JOIN "nla_demo"."brands" AS t2
ON t1."brand_id" = t2."brand_id"
WHERE t2."brand_name" = 'CymbalPrime';

    AlloyDB AI verwendet den in Wertindex erstellen erstellten Wertindex, um CymbalPrime in den Konzepttyp brand_name aufzulösen, und verwendet die Spalte nla_demo.brands.brand_name, die mit brand_name verknüpft ist.

  3. Wenn Sie die AlloyDB AI Natural Language API verwenden möchten, um das Ergebnis einer Frage zu generieren, führen Sie die folgende Abfrage aus:

    SELECT
alloydb_ai_nl.execute_nl_query(
    'nla_demo_cfg',
    'Find the last name of the customers who live in Lisbon.'
);

    Die folgende Ausgabe wird zurückgegeben:

    execute_nl_query     
--------------------------
{"last_name":"M."}

  4. Wenn Sie die AlloyDB AI Natural Language API verwenden möchten, um SQL-Anweisungen zu erstellen, die die semantische Suche nutzen, führen Sie die folgende Abfrage aus:

    SELECT
 alloydb_ai_nl.get_sql(
     'nla_demo_cfg',
     'List 2 products similar to a Tote Bag.');

    Die folgende SQL-Anweisung wird zurückgegeben:

    SELECT name FROM nla_demo.products
ORDER BY description_embedding <=> embedding(
    'text-embedding-004', 'Tote Bag')::vector
LIMIT 2;

SQL-Zusammenfassungen abrufen

Sie können eine Ergebniszusammenfassung aus einer Frage in natürlicher Sprache erstellen, die auf den in der Datenbank gespeicherten Daten basiert. So können Endnutzer Daten besser verstehen, indem sie direkt Fragen in natürlicher Sprache stellen.

Wenn Sie eine SQL-Zusammenfassung erhalten möchten, führen Sie die folgende Beispielabfrage aus:

SELECT
   alloydb_ai_nl.get_sql_summary(
      nl_config_id => 'nla_demo_cfg',
      nl_question => 'which brands have the largest number of products.'
);

Diese Abfrage gibt ein JSON-Objekt als Ausgabe zurück, das in etwa so aussieht:

   "answer": "The result set lists three brands: CymbalSports, CymbalPro, and CymbalPrime. Each brand is represented once, suggesting an equal distribution of products across these three brands within the dataset."

Bereinigen

Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie entweder das Projekt, das die Ressourcen enthält, oder Sie behalten das Projekt und löschen die einzelnen Ressourcen.

In den folgenden Abschnitten erfahren Sie, wie Sie diese Ressourcen und Objekte löschen.

Cluster löschen

Wenn Sie den Cluster löschen, den Sie unter Vorbereitung erstellt haben, werden auch alle Objekte gelöscht, die Sie erstellt haben.

  1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

    Zu den Clustern

  2. Klicken Sie in der Spalte Ressourcenname auf den Namen Ihres Clusters, my-cluster.

  3. Klicken Sie auf  Cluster löschen.

  4. Geben Sie in Cluster „my-cluster“ löschen my-cluster ein, um zu bestätigen, dass Sie den Cluster löschen möchten.

  5. Klicken Sie auf Löschen.

  6. Wenn Sie beim Erstellen eines Clusters eine private Verbindung erstellt haben, rufen Sie in der Google Cloud Console die Seite „VPC-Netzwerke“ auf und klicken Sie auf VPC-Netzwerk löschen.

Objekte löschen

Sie können die Ressourcen, die Sie unter Vorbereitung eingerichtet haben, beibehalten und nur die Objekte löschen, die Sie im Google Cloud Projekt erstellt haben.

  1. Führen Sie die folgende Abfrage aus, um die Vorlage zu entfernen, die Sie in Abfragevorlage definieren definiert haben:

    SELECT alloydb_ai_nl.drop_template(id)
FROM alloydb_ai_nl.template_store_view
WHERE config = 'nla_demo_cfg';

  2. Wenn Sie die automatisch generierten Konzeptzuordnungen entfernen möchten, die in Automatische Generierung von Konzepttypzuordnungen generiert wurden, führen Sie die folgende Abfrage aus:

    SELECT alloydb_ai_nl.drop_generated_concept_type_association(id)
FROM alloydb_ai_nl.generated_value_index_columns_view
WHERE config = 'nla_demo_cfg';

  3. Wenn Sie den Konzepttyp product_name entfernen möchten, den Sie in Wertindex erstellen definiert haben, führen Sie die folgende Abfrage aus:

    SELECT alloydb_ai_nl.drop_concept_type('product_name');

  4. Führen Sie die folgende Abfrage aus, um den Wertindex zu aktualisieren, nachdem Sie den Konzepttyp product_name entfernt haben:

    SELECT alloydb_ai_nl.refresh_value_index();

  5. Führen Sie die folgende Abfrage aus, um die nla_demo_cfg-Konfiguration zu entfernen, die Sie in Konfiguration in natürlicher Sprache erstellen erstellt haben:

    SELECT
alloydb_ai_nl.g_manage_configuration(
    'drop_configuration',
    'nla_demo_cfg'
);

  6. Wenn Sie das Schema „nla_demo“ und die Tabellen entfernen möchten, die Sie in nla_demo-Schema und -Tabellen erstellen und Tabellen im nla_demo-Schema mit Daten füllen erstellt und mit Daten gefüllt haben, führen Sie die folgende Abfrage aus:

    DROP SCHEMA nla_demo CASCADE;

Nächste Schritte