Résoudre les erreurs d'indexation ScaNN

Sélectionnez une version de la documentation :

Ce document décrit les erreurs que vous pouvez rencontrer lorsque vous générez un index ScaNN. Des exemples d'erreurs et de corrections recommandées sont également fournis.

Liste des erreurs

Vous trouverez ci-dessous la liste des erreurs générées lorsque vous essayez de créer un index ScaNN. Vous pouvez désactiver la génération de ces erreurs et continuer à générer l'index. Pour en savoir plus, consultez Appliquer la création d'index et supprimer les erreurs.

ERREUR : Impossible de créer un index ScaNN avec une table vide

Message d'erreur

Lorsque vous essayez de générer un index sur une table sans données ou de tronquer une table sur laquelle un index ScaNN a été généré, l'erreur suivante se produit :

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

Exemples de requêtes qui génèrent l'erreur

  • Exemple de requête 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');

  • Exemple de requête B

    truncate t1;

Assurez-vous que votre table est remplie de vecteurs d'intégration avant de générer un index ScaNN.

ERREUR : Impossible de créer l'index ScaNN

Message d'erreur

Lorsque vous essayez de générer un index sur une table avec peu de lignes renseignées, l'erreur suivante se produit :

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

Exemple de requête qui provoque l'erreur

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

Assurez-vous que votre table est remplie de vecteurs d'intégration avant de générer un index ScaNN. Nous vous recommandons de définir un nombre de lignes dans le tableau supérieur à la valeur définie dans le paramètre num_leaves.

ERREUR : Impossible de créer un index ScaNN sur la table de partitions parent.

Message d'erreur

Si vous avez créé des tables partitionnées à partir d'une table parente, la création d'un index ScaNN sur la table parente génère l'erreur suivante :

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

Exemple de requête qui provoque l'erreur

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

Vous ne pouvez pas générer d'index ScaNN sur la table parente d'une table partitionnée. Vous devez générer les index ScaNN sur la table partitionnée.

Appliquer la création d'index et supprimer les erreurs

Vous pouvez forcer AlloyDB à générer un index et à supprimer les erreurs. Avant d'autoriser la génération d'index avec cette méthode, tenez compte des implications suivantes :

  • Étant donné que l'index est entraîné sur peu ou pas de données, les centroïdes apprennent sur zéro donnée, ce qui entraîne un mauvais rappel.
  • Les performances d'écriture dans la base de données peuvent également être lentes.

Pour forcer la génération d'index, procédez comme suit :

  1. Définissez le paramètre scann.allow_blocked_operations creation au niveau de la session sur true dans la base de données :

    SET scann.allow_blocked_operations = true;

  2. Attribuez le droit SUPERUSER à l'utilisateur qui exécutera ces requêtes sur la base de données :

    CREATE USER USER_NAME WITH SUPERUSER PASSWORD PASSWORD;

    Remplacez les éléments suivants :

    • USER_NAME : nom de l'utilisateur auquel vous souhaitez accorder le privilège.
    • PASSWORD : mot de passe de l'utilisateur.