ベクトルデータ型¶

データ型¶

Snowflakeは単一のベクトルデータ型 VECTOR をサポートしています。

VECTOR( <type>, <dimension> )

ベクトル変換¶

このセクションでは、 VECTOR 値への、またその値からの変換方法について説明します。キャスティングの詳細については、 データ型の変換 を参照してください。

Parquetデータのロードとアンロード¶

VECTOR 列の直接ロードおよびアンロードはサポートされていません。VECTOR 列の場合は、 ARRAY としてデータのロードとアンロードを行い、使用時に VECTOR にキャストする必要があります。ARRAY データ型のロードとアンロードの方法については、 Introduction to loading semi-structured data をご参照ください。ベクトルの一般的な使用例は、 ベクトルの埋め込み を生成することです。

次の例は、 VECTOR 列を持つテーブルを mystage という内部ステージにアンロードする方法を示しています。

CREATE OR REPLACE TABLE myvectortable (a VECTOR(float, 3), b VECTOR(float, 3));
INSERT INTO myvectortable SELECT [1.1,2.2,3]::VECTOR(FLOAT,3), [1,1,1]::VECTOR(FLOAT,3);
INSERT INTO myvectortable SELECT [1,2.2,3]::VECTOR(FLOAT,3), [4,6,8]::VECTOR(FLOAT,3);

COPY INTO @mystage/unload/
  FROM (SELECT TO_ARRAY(a), TO_ARRAY(b) FROM myvectortable);

次の例は、ステージからテーブルをロードし、 ARRAY 列を VECTOR 列としてキャストする方法を示しています。

CREATE OR REPLACE TABLE arraytable (a ARRAY, b ARRAY);

COPY INTO arraytable
  FROM @mystage/unload/mydata.csv.gz;

SELECT a::VECTOR(FLOAT, 3), b::VECTOR(FLOAT, 3)
  FROM arraytable;

例¶

定数 ARRAY をキャストして VECTOR を構築します。

SELECT [1, 2, 3]::VECTOR(FLOAT, 3) AS vec;

VECTOR データ型の列を追加します。

ALTER TABLE myissues ADD COLUMN issue_vec VECTOR(FLOAT, 768);

UPDATE TABLE myissues
  SET issue_vec = SNOWFLAKE.CORTEX.EMBED_TEXT_768('e5-base-v2', issue_text);

制限事項¶

VECTOR データには以下の制限が適用されます。

• VECTOR データ型は言語サポートに制限があります。このテーブルにない言語はサポートされていません。

  Snowflake機能	Python	SQL
  UDFs	✔	✔
  UDTFs	✔	✔
  ドライバー/コネクタ	✔	✔
  Snowpark API	✔

• VARIANT の列ではベクトルはサポートされていません。

• ベクトルは、 クラスタリングキー としてはサポートされていません。

• サーバー側のバインドはサポートされていません。つまり、Snowflakeドライバーを介して VECTOR 列に書き込む場合は、クエリを実行する前にクエリ内の VECTOR 値をキャストする必要があるということです。

• ハイブリッドテーブル ではベクトルを使用できますが、プライマリキーやセカンダリインデックスキーとしては使用できません。

• VECTOR データ型は、以下のSnowflake機能での使用はサポートされていません。

  • Snowflake Scripting

  • Apache Iceberg™ テーブル

  • 検索最適化サービス

  • Snowpipe

  • バインド変数