Soluciona problemas relacionados con errores del índice de ScaNN

En este documento, se describen los errores que puedes encontrar cuando generas un índice de ScaNN. También se proporcionan ejemplos de errores y correcciones recomendadas.

Lista de errores

A continuación, se incluye una lista de los errores que se generan cuando intentas crear un índice de ScaNN. Puedes inhabilitar la generación de estos errores y seguir generando el índice. Para obtener más información, consulta Cómo forzar la creación de índices en tablas vacías o pequeñas.

ERROR: No se puede crear el índice de ScaNN con una tabla vacía

Mensaje de error

Cuando intentas generar un índice en una tabla sin datos o truncar una tabla con un índice ScaNN generado en ella, se produce el siguiente error:

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

Ejemplos de consultas que causan el error

  • Ejemplo de consulta 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');

  • Ejemplo de consulta B

    truncate t1;

Asegúrate de que tu tabla esté completada con vectores de embedding antes de generar un índice de ScaNN.

ERROR: No se puede crear el índice de ScaNN

Mensaje de error

Cuando intentas generar un índice en una tabla con pocas filas completadas, se produce el siguiente error:

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

Ejemplo de consulta que causa el error

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

Asegúrate de que tu tabla esté completada con vectores de embedding antes de generar un índice de ScaNN. Te recomendamos que la cantidad de filas de la tabla sea mayor que el valor definido en el parámetro num_leaves.

ERROR: No se puede crear el índice de ScaNN en la tabla de partición principal.

Mensaje de error

Si creaste tablas particionadas a partir de una tabla principal, la creación de un índice de ScaNN en la tabla principal genera el siguiente error:

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

Ejemplo de consulta que causa el error

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

No puedes generar un índice ScaNN en la tabla principal de una tabla particionada. Debes generar los índices ScaNN en la tabla particionada.