VECTORPROPERTY (Transact-SQL) (プレビュー)

適用対象: SQL Server 2025 (17.x) プレビュー Azure SQL DatabaseAzure SQL Managed InstanceSQL データベース

VECTORPROPERTY 関数は、特定のベクターの特定のプロパティを返します。 この関数には、ベクター自体と取得するプロパティの 2 つの引数が必要です。

構文

Transact-SQL 構文表記規則

VECTORPROPERTY(vector, property)

論争

ベクトル

ベクター型の有効な ベクター 。 変数や列への参照などの式を指定できます。

入力ベクターは、 [tablename].[colname] または ベクター 型の有効な変数として指定できます。

資産

返されるデータベース プロパティの名前を指定する式。 このプロパティは、次のいずれかの値をサポートします。

現在、ベクトルの既定の基本型は float (32 ビット) に設定されています。

戻り値

この関数は、選択したプロパティに基づいて、特定のベクターの特定のプロパティを返します。 例えば次が挙げられます。

• プロパティが Dimensions場合、この関数はベクターの次元数を表す 整数値 を返します。
• プロパティが BaseType場合、関数はデータ型 (sysname) の名前を返します。

例示

ディメンション数を取得する

次の例では、3 次元のベクトルを宣言し、その次元数を取得します。 VECTORPROPERTY関数は、ディメンション数を表3整数値を返します。

DECLARE @v AS VECTOR(3) = '[1,2,3]';

SELECT VECTORPROPERTY(@v, 'Dimensions');

ディメンションの戻り値の数

次の例では、テーブル embeddingsからmytableベクター列の次元数を取得します。

CREATE TABLE mytable
(
    id INT IDENTITY NOT NULL PRIMARY KEY,
    embeddings VECTOR(3) NOT NULL
);

INSERT INTO mytable (embeddings)
VALUES ('[4, -2, -1]'),
       ('[1, 3, -5]'),
       ('[7, -8, -10]'),
       ('[4.0, 0.2, -1.1]'),
       ('[0, 0, 0]'),
       ('[10, 10, 10]'),
       ('[-0.1, -0.2, -0.3]');

SELECT VECTORPROPERTY(t.embeddings, 'dimensions')
FROM mytable AS t;

戻り値:

Dimensions
----------
3
3
3
3
3
3
3

関連コンテンツ

• SQL データベース エンジンでのベクトルの概要
• Azure SQL Database Vector Search のサンプル