Resolver erros de índice do ScaNN

Selecione uma versão da documentação:

Este documento descreve os erros que podem ocorrer ao gerar um índice ScaNN. Exemplos de erros e correções recomendadas também são apresentados.

Lista de erros

Confira a seguir uma lista de erros gerados quando você tenta criar um índice ScaNN. Você pode desativar a geração desses erros e continuar gerando o índice. Para mais informações, consulte Forçar a criação de índices e suprimir erros.

ERRO: não é possível criar um índice ScaNN com uma tabela vazia

Mensagem de erro

Quando você tenta gerar um índice em uma tabela sem dados ou truncar uma tabela com um índice ScaNN gerado nela, ocorre o seguinte erro:

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

Exemplos de consultas que causam o erro

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

  • Exemplo de consulta B

    truncate t1;

Verifique se a tabela está preenchida com vetores de embedding antes de gerar um índice ScaNN.

ERRO: não é possível criar o índice ScaNN

Mensagem de erro

Quando você tenta gerar um índice em uma tabela com poucas linhas preenchidas, ocorre o seguinte erro:

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

Exemplo de consulta que causa o erro

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

Verifique se a tabela está preenchida com vetores de embedding antes de gerar um índice ScaNN. Recomendamos que o número de linhas na tabela seja maior que o valor definido no parâmetro num_leaves.

ERRO: não é possível criar o índice ScaNN na tabela de partição mãe.

Mensagem de erro

Se você criou tabelas particionadas com base em uma tabela mãe, a criação de um índice do ScaNN na tabela mãe vai gerar o seguinte erro:

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

Exemplo de consulta que causa o erro

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

Não é possível gerar um índice ScaNN na tabela mãe de uma tabela particionada. Você precisa gerar os índices ScaNN na tabela particionada.

Aplicar a criação de índice e suprimir erros

É possível forçar o AlloyDB a gerar um índice e suprimir erros. Antes de permitir a geração de índices com esse método, considere as seguintes implicações:

  • Como o índice é treinado com poucos ou nenhum dado, os centroides aprendem com dados zero, o que leva a uma baixa capacidade de recall.
  • A performance de gravação no banco de dados também pode ser lenta.

Para forçar a geração de índice, faça o seguinte:

  1. Defina o parâmetro scann.allow_blocked_operations creation no nível da sessão como true no banco de dados:

    SET scann.allow_blocked_operations = true;

  2. Atribua o privilégio SUPERUSER ao usuário que vai executar essas consultas no banco de dados:

    CREATE USER USER_NAME WITH SUPERUSER PASSWORD PASSWORD;

    Substitua:

    • USER_NAME: o nome do usuário a quem você quer conceder o privilégio.
    • PASSWORD: a senha do usuário.