Halaman ini mendokumentasikan AlloyDB Omni versi 18.1.1 menggunakan opsi deployment RPM. Pilih opsi deployment lain.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Menggunakan bahasa alami AlloyDB AI untuk membuat SQL

Pilih versi dokumentasi:

Tutorial ini menjelaskan cara menyiapkan dan menggunakan AlloyDB AI natural language API. Anda akan mempelajari cara mengonfigurasi AlloyDB AI natural language API sehingga Anda dapat mengajukan pertanyaan dalam bahasa alami dan menerima kueri serta hasil SQL.

Contoh dalam tutorial ini hanya untuk tujuan demonstrasi.

Tujuan

Membuat dan mengisi tabel, serta menggunakan pembuatan otomatis untuk membuat konteks.
Membuat indeks nilai untuk kolom dalam database.
Membuat dan mengonfigurasi objek konfigurasi bahasa alami (nl_config).
Membuat template untuk kueri contoh dalam aplikasi.
Menggunakan fungsi get_sql() untuk menghasilkan kueri SQL yang menjawab pertanyaan.
Menggunakan fungsi execute_nl_query() untuk menjawab pertanyaan dalam bahasa alami menggunakan database.

Sebelum memulai

Pastikan Anda memenuhi prasyarat berikut.

Aktifkan penagihan

Di Google Cloud konsol, pilih project.

Buka pemilih project
Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

Menginstal dan terhubung ke database

Mengaktifkan dan menginstal ekstensi yang diperlukan

Untuk menginstal dan menggunakan ekstensi alloydb_ai_nl, aktifkan ekstensi terlebih dahulu dengan menjalankan perintah PostgreSQL berikut:

ALTER SYSTEM SET alloydb_ai_nl.enabled=on;
SELECT pg_reload_conf();

Untuk menginstal ekstensi alloydb_ai_nl, yang merupakan AlloyDB AI natural language support API, jalankan kueri berikut:

CREATE EXTENSION alloydb_ai_nl cascade;

Mengupgrade ekstensi `alloydb_ai_nl`

Jika Anda sudah menginstal ekstensi, jalankan pernyataan berikut untuk mengupdatenya ke versi terbaru:

ALTER EXTENSION alloydb_ai_nl UPDATE;

Membuat skema dan tabel `nla_demo`

Sekarang Anda membuat skema dan tabel nla_demo dalam skema, dan mengisi tabel dengan data sintetis. Skema dan data yang disediakan dirancang untuk mendukung operasi dasar bisnis ritel online, dengan potensi aplikasi yang diperluas ke aspek pengelolaan pelanggan, analisis, pemasaran, dan operasional.

Data contoh menunjukkan cara menggunakan AlloyDB AI natural language untuk tujuan pengembangan, pengujian, dan demonstrasi, terutama untuk fitur seperti antarmuka bahasa alami.

Membuat skema.
```
CREATE SCHEMA nla_demo;
```

Membuat tabel dalam skema nla_demo. Tabel addresses menyimpan informasi alamat untuk tabel customers dan orders.

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

Membuat tabel customers. Tabel ini menyimpan informasi pelanggan termasuk ID pelanggan, nama, detail kontak, referensi alamat, tanggal lahir, dan waktu pembuatan data.

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
);

Membuat tabel categories, yang menyimpan kategori produk.

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

Membuat tabel brands, yang menyimpan nama merek.

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

Membuat tabel products, yang menyimpan informasi produk seperti ID produk, nama, deskripsi, merek, keterkaitan kategori, dan waktu pembuatan data.

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)
);

Membuat tabel orders. Tabel ini menyimpan informasi tentang pesanan pelanggan, termasuk pelanggan, tanggal, jumlah total, alamat pengiriman dan penagihan, serta status pesanan.

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)
);

Membuat tabel order_items. Tabel ini mencatat item individual dalam pesanan, link ke varian pesanan dan produk, serta menentukan kuantitas dan harga.

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
);

Mengisi tabel dalam skema `nla_demo`

Isi tabel addresses dengan menjalankan kueri berikut:

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');

Isi tabel customers.

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');

Isi tabel categories.

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

Isi tabel brands.

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

Isi tabel products.

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);

Isi tabel orders.

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');

Isi tabel order_items.

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, 99.99);

Membuat konfigurasi bahasa alami

Untuk menggunakan AlloyDB AI natural language, pastikan AlloyDB AI diinstal untuk AlloyDB Omni. Kemudian, buat konfigurasi dan daftarkan skema. g_alloydb_ai_nl.g_create_configuration membuat model.

Membuat konfigurasi bahasa alami.

SELECT alloydb_ai_nl.g_create_configuration( 'nla_demo_cfg' );

Mendaftarkan tabel ke konfigurasi nla_demo_cfg.

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}'
);

Membuat dan menerapkan konteks untuk tabel dan kolom

Untuk memberikan jawaban yang akurat atas pertanyaan dalam bahasa alami, Anda menggunakan AlloyDB AI natural language API untuk memberikan konteks tentang tabel, tampilan, dan kolom. Anda dapat menggunakan fitur pembuatan konteks otomatis dari AlloyDB AI natural language API untuk menghasilkan konteks dari tabel dan kolom, serta menerapkan konteks sebagai COMMENTS yang dilampirkan ke tabel, tampilan, dan kolom.

Untuk membuat konteks skema untuk tabel dan kolomnya yang terdaftar dalam konfigurasi nla_demo_cfg, jalankan perintah berikut:
```
SELECT alloydb_ai_nl.generate_schema_context(
  'nla_demo_cfg',
  TRUE
);
```
Kueri sebelumnya mengisi tampilan alloydb_ai_nl.generated_schema_context_view dengan konteks. Mengirimkan TRUE akan menimpa konteks dalam tampilan ini dari proses sebelumnya.

Untuk memverifikasi konteks yang dibuat untuk tabel nla_demo.products, jalankan kueri berikut:

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

Konteks yang dihasilkan mirip dengan berikut ini:

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).

Untuk memverifikasi konteks yang dihasilkan untuk kolom, seperti nla_demo.products.name, jalankan perintah berikut:

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

Output kueri mirip dengan berikut ini:

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.

Tinjau konteks yang dihasilkan dalam tampilan alloydb_ai_nl.generated_schema_context_view, dan perbarui konteks yang perlu direvisi.

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.'
);

Terapkan konteks yang dihasilkan yang ingin Anda lampirkan ke objek yang sesuai:
```
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
);
```
Entri konteks yang dihasilkan dalam tampilan alloydb_ai_nl.generated_schema_context_view diterapkan ke objek skema yang sesuai, dan komentar akan ditimpa.
Terapkan konteks skema yang dihasilkan.
```
SELECT alloydb_ai_nl.apply_generated_schema_context(
  'nla_demo_cfg',
  TRUE);
```
Mengirimkan TRUE akan menimpa konteks yang ada untuk objek yang terdaftar ke nla_demo_cfg.

Membuat indeks nilai

AlloyDB AI natural language API menghasilkan kueri SQL yang akurat dengan menggunakan penautan nilai. Penautan nilai mengaitkan frasa nilai dalam pernyataan bahasa alami dengan jenis konsep dan nama kolom yang telah terdaftar sebelumnya yang dapat memperkaya pertanyaan dalam bahasa alami.

Misalnya, pertanyaan "Beri saya harga Hoodie" dapat dijawab dengan lebih akurat jika Hoodie dikaitkan dengan konsep product_name, yang dikaitkan dengan kolom nla_demo.products.name.

Untuk menentukan jenis konsep product_name dan mengaitkannya dengan kolom nla_demo.products.name, jalankan kueri berikut:

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'
);

Untuk memverifikasi bahwa jenis konsep product_name ditambahkan ke daftar jenis konsep, jalankan kueri berikut untuk memastikan bahwa product_name disertakan dalam hasil kueri ini:
```
SELECT alloydb_ai_nl.list_concept_types();
```
Untuk memverifikasi bahwa kolom nla_demo.products.name dikaitkan dengan jenis konsep product_name, jalankan kueri berikut:
```
SELECT *
FROM alloydb_ai_nl.value_index_columns
WHERE column_names = 'nla_demo.products.name';
```

Untuk menentukan jenis konsep brand_name dan mengaitkannya dengan nla_demo.brands.brand_name kolom, jalankan kueri berikut:

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'
);

Setelah menentukan jenis konsep dan mengaitkan kolom dengannya, buat indeks nilai.

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

Membuat asosiasi jenis konsep secara otomatis

Dengan AlloyDB AI natural language, Anda dapat membuat asosiasi secara otomatis berdasarkan jenis konsep yang ada, tanpa harus mengaitkan jenis konsep dengan kolom secara manual—misalnya, memanggil alloydb_ai_nl.associate_concept_type secara manual.

Untuk membuat asosiasi jenis konsep secara otomatis, ikuti langkah-langkah berikut:

Buat asosiasi untuk semua relasi dalam cakupan nla_demo_cfg:

SELECT alloydb_ai_nl.generate_concept_type_associations('nla_demo_cfg');

Tinjau asosiasi yang dihasilkan.

SELECT * from alloydb_ai_nl.generated_value_index_columns_view;

Hasilnya mirip dengan berikut ini. Konsep bawaan dipertimbangkan serta konsep yang ditentukan pengguna.

-[ 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 | {}

....

Opsional: Perbarui atau hapus asosiasi yang dihasilkan.

-- 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);

Terapkan asosiasi yang dihasilkan.

SELECT alloydb_ai_nl.apply_generated_concept_type_associations('nla_demo_cfg');

Untuk mencerminkan perubahan, muat ulang indeks nilai.

SELECT alloydb_ai_nl.refresh_value_index('nla_demo_cfg');

Menentukan template kueri

Anda dapat menentukan template untuk meningkatkan kualitas jawaban yang dihasilkan oleh AlloyDB AI natural language API.

Untuk memberikan template contoh untuk pertanyaan penting bisnis, dan untuk memberikan pertanyaan yang diantisipasi yang diharapkan memiliki akurasi tinggi, jalankan kueri berikut untuk menambahkan template:

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 rows with p.name = ''Swimsuit''. Return the `first_name` and the `last_name` of the customers with matching records.',
    check_intent => TRUE
);

Untuk melihat daftar template yang ditambahkan, buat kueri tampilan alloydb_ai_nl.template_store_view:

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

Output berikut akan ditampilkan:

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.

Dalam template ini, nilai yang sesuai dengan atribut psql adalah kueri SQL yang diparameterkan, dan nilai untuk kolom pintent adalah pernyataan intent yang diparameterkan. ID template yang baru ditambahkan dapat berbeda, berdasarkan template yang Anda tambahkan sebelumnya. Template memberikan jawaban yang sangat akurat untuk pertanyaan.

Untuk membuat template yang menggunakan penelusuran semantik, jalankan pernyataan contoh berikut:

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 description_embedding of the product with the embedding of 'Swimwear'.$$,
check_intent => TRUE
);

Template sebelumnya menambahkan baris berikut ke tampilan alloydb_ai_nl.template_store_view:

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.

Menentukan fragmen kueri

Anda dapat menentukan fragmen untuk meningkatkan kualitas jawaban yang dihasilkan oleh AlloyDB AI natural language API.

Untuk memberikan fragmen untuk predikat penting bisnis, dan untuk memberikan pertanyaan yang diantisipasi yang diharapkan memiliki akurasi tinggi, jalankan kueri berikut:

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%'$$);

Untuk melihat daftar fragmen yang ditambahkan, buat kueri tampilan alloydb_ai_nl.fragment_store_view:

SELECT intent, fragment, pintent
FROM alloydb_ai_nl.fragment_store_view;

Output berikut akan ditampilkan:

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

Membuat hasil SQL dari pertanyaan dalam bahasa alami

Untuk menggunakan AlloyDB AI natural language API untuk menghasilkan kueri SQL dan kumpulan hasil, jalankan kueri berikut:

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

Output berikut akan ditampilkan:

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';

Output JSON adalah kueri SQL menggunakan template yang Anda tambahkan di Menentukan template kueri.

Untuk menggunakan AlloyDB AI natural language API untuk menghasilkan kueri SQL, jalankan kueri berikut:
```
SELECT
    alloydb_ai_nl.get_sql(
        'nla_demo_cfg',
        'List the maximum price of any CymbalShoe.'
    ) ->> 'sql';
```
Output berikut akan ditampilkan:
```
SELECT max("price")
FROM "nla_demo"."products"
WHERE "name" = 'CymbalShoe'
```
AlloyDB AI natural language API mengenali bahwa CymbalShoe adalah nama produk, dengan menggunakan indeks nilai. Jalankan kueri berikut untuk mengganti CymbalShoe dengan nama merek (CymbalPrime):
```
SELECT
    alloydb_ai_nl.get_sql(
        'nla_demo_cfg',
        'List the maximum price of any CymbalPrime.'
    ) ->> 'sql';
```
Output berikut akan dihasilkan:
```
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 menggunakan indeks nilai yang dibuat di Membuat indeks nilai untuk menyelesaikan CymbalPrime ke jenis konsep brand_name, dan menggunakan kolom nla_demo.brands.brand_name yang terkait dengan brand_name.

Untuk menggunakan AlloyDB AI natural language API untuk menghasilkan hasil pertanyaan, jalankan kueri berikut:

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

Output berikut akan ditampilkan:

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

Untuk menggunakan AlloyDB AI natural language API untuk menghasilkan pernyataan SQL yang menggunakan penelusuran semantik, jalankan kueri berikut:

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

Pernyataan SQL berikut akan ditampilkan:

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

Mendapatkan ringkasan SQL

Anda dapat membuat ringkasan hasil dari pertanyaan dalam bahasa alami berdasarkan data yang disimpan dalam database. Hal ini membantu pengguna akhir memahami data dengan mengajukan pertanyaan dalam bahasa alami secara langsung.

Untuk mendapatkan ringkasan SQL, jalankan kueri contoh berikut:

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

Kueri ini menampilkan objek JSON sebagai output, mirip dengan berikut ini:

   "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."

Pembersihan

Untuk membersihkan, Anda dapat meng-uninstal instance AlloyDB Omni atau mempertahankan instance dan menghapus objek individual.

Menghapus objek

Anda dapat memilih untuk mempertahankan resource yang Anda siapkan di Sebelum memulai, dan Anda hanya dapat menghapus objek yang Anda buat di instance.

Hapus template yang Anda tentukan di Menentukan template kueri.

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

Hapus asosiasi konsep yang dibuat secara otomatis yang dihasilkan di Membuat asosiasi jenis konsep secara otomatis.

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

Hapus jenis konsep product_name yang Anda tentukan di Membuat indeks nilai.
```
SELECT alloydb_ai_nl.drop_concept_type('product_name');
```
Muat ulang indeks nilai setelah Anda menghapus jenis konsep product_name.
```
SELECT alloydb_ai_nl.refresh_value_index();
```

Hapus konfigurasi nla_demo_cfg yang Anda buat di Membuat konfigurasi bahasa alami.

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

Hapus skema dan tabel nla_demo yang Anda buat dan isi di Membuat skema dan tabel nla_demo dan Mengisi tabel dalam skema nla_demo, jalankan kueri berikut:
```
DROP SCHEMA nla_demo CASCADE;
```

Menggunakan bahasa alami AlloyDB AI untuk membuat SQL Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Tujuan

Sebelum memulai

Aktifkan penagihan

Menginstal dan terhubung ke database

Mengaktifkan dan menginstal ekstensi yang diperlukan

Mengupgrade ekstensi alloydb_ai_nl

Membuat skema dan tabel nla_demo

Mengisi tabel dalam skema nla_demo

Membuat konfigurasi bahasa alami

Membuat dan menerapkan konteks untuk tabel dan kolom

Membuat indeks nilai

Membuat asosiasi jenis konsep secara otomatis

Menentukan template kueri

Menentukan fragmen kueri

Membuat hasil SQL dari pertanyaan dalam bahasa alami

Mendapatkan ringkasan SQL

Pembersihan

Menghapus objek

Langkah berikutnya

Menggunakan bahasa alami AlloyDB AI untuk membuat SQL

Mengupgrade ekstensi `alloydb_ai_nl`

Membuat skema dan tabel `nla_demo`

Mengisi tabel dalam skema `nla_demo`