ScaNN インデックスの生成時に発生する可能性のあるエラーについて説明します。エラーの例と推奨される修正方法も記載しています。
エラーのリスト
ScaNN インデックスの作成時に生成されるエラーのリストは次のとおりです。これらのエラーの生成を無効にして、インデックスの生成を続行できます。詳細については、空のテーブルまたは小さなテーブルでインデックスの作成を強制するをご覧ください。
ERROR: 空のテーブルで ScaNN インデックスを作成できません
エラー メッセージ
データのないテーブルにインデックスを生成しようとする、または ScaNN インデックスが生成されたテーブルを切り捨てようとすると、次のエラーが発生します。
ERROR: Cannot create ScaNN index with empty table. Once the table is populated
with data, create the index. See documentation to bypass this validation.
エラーを引き起こすクエリの例
クエリ例 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');クエリ例 B
truncate t1;
推奨する修正:
ScaNN インデックスを生成する前に、テーブルにエンベディング ベクトルが入力されていることを確認してください。
ERROR: ScaNN インデックスを作成できません
エラー メッセージ
行数が少ないテーブルにインデックスを生成しようとすると、次のエラーが発生します。
Cannot create ScaNN index, error: INVALID_ARGUMENT: Number of row (5) must be
larger than (1000).
エラーを引き起こすクエリの例
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');
推奨する修正:
ScaNN インデックスを生成する前に、テーブルにエンベディング ベクトルが入力されていることを確認してください。テーブルの行数は、num_leaves パラメータで定義された値よりも大きくすることをおすすめします。
ERROR: 親パーティション テーブルに ScaNN インデックスを作成できません。
エラー メッセージ
親テーブルからパーティション分割テーブルを作成した場合、親テーブルに ScaNN インデックスを作成すると、次のエラーが発生します。
ERROR: Cannot create ScaNN index on parent partition table. Create ScaNN
indexes on the child tables instead. See documentation to bypass this
validation.
エラーを引き起こすクエリの例
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');
推奨する修正:
パーティション分割テーブルの親テーブルに ScaNN インデックスを生成することはできません。パーティション分割テーブルに ScaNN インデックスを生成する必要があります。