Risolvere i problemi relativi agli errori dell'indice ScaNN

Questo documento descrive gli errori che potresti riscontrare quando generi un indice ScaNN. Vengono forniti anche esempi di errori e correzioni consigliate.

Elenco degli errori

Di seguito è riportato un elenco di errori generati quando provi a creare un indice ScaNN. Puoi disattivare la generazione di questi errori e continuare a generare l'indice. Per saperne di più, vedi Forzare la creazione dell'indice su tabelle vuote o di piccole dimensioni.

ERRORE: impossibile creare l'indice ScaNN con una tabella vuota

Messaggio di errore

Quando tenti di generare un indice su una tabella senza dati o di troncare una tabella con un indice ScaNN generato, si verifica il seguente errore:

ERROR: Cannot create ScaNN index with empty table. Once the table is populated with data, create the index. See documentation to bypass this validation.

Query di esempio che causano l'errore

  • Esempio di query A

    create table t1 (a INT, b VECTOR(512));
CREATE TABLE
create index on t1 using ScaNN(b cosine) with (num_leaves = 10, quantizer = 'sq8');

  • Esempio di query B

    truncate t1;

Assicurati che la tabella sia compilata con i vettori di incorporamento prima di generare un indice ScaNN.

ERRORE: impossibile creare l'indice ScaNN

Messaggio di errore

Quando tenti di generare un indice in una tabella con poche righe popolate, si verifica il seguente errore:

Cannot create ScaNN index, error: INVALID_ARGUMENT: Number of row (5) must be larger than (1000).

Query di esempio che causa l'errore

create table t1 (a INT, b VECTOR(512));
CREATE TABLE
insert into t1 select (random()*1e9)::int, random_vector(512) from generate_series(1, 5);
INSERT 0 5
create index on t1 using scann(b cosine) with (num_leaves = 100, quantizer = 'sq8');

Assicurati che la tabella sia compilata con i vettori di incorporamento prima di generare un indice ScaNN. Ti consigliamo che il numero di righe nella tabella sia maggiore del valore definito nel parametro num_leaves.

ERRORE: impossibile creare l'indice ScaNN nella tabella delle partizioni principale.

Messaggio di errore

Se hai creato tabelle partizionate da una tabella principale, la creazione di un indice ScaNN sulla tabella principale genera il seguente errore:

ERROR: Cannot create ScaNN index on parent partition table. Create ScaNN indexes on the child tables instead. See documentation to bypass this validation.

Query di esempio che causa l'errore

create table t1 (a INT, b VECTOR(512)) partition by range(a);
CREATE TABLE
CREATE TABLE t1_one_ten PARTITION of t1 for values from (1) to (10);
CREATE TABLE
insert into t1_one_ten select (random()*1e9)::int, random_vector(512) from generate_series(1, 100);
INSERT 0 100
CREATE TABLE t1_eleven_twenty PARTITION of t1 for values from (11) to (20);
CREATE TABLE
insert into t1_eleven_twenty select (random()*1e9)::int, random_vector(512) from generate_series(1, 100);
INSERT 0 100
create index on t1 using scann(b cosine) with (num_leaves = 10, quantizer = 'sq8');

Non puoi generare un indice ScaNN nella tabella principale di una tabella partizionata. Devi generare gli indici ScaNN nella tabella partizionata.