次の方法で共有


VECTOR_NORM(Transact-SQL)

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

VECTOR_NORMを使用して、ベクトルを入力として取得し、指定されたノルム型のベクトル (長さまたは大きさの尺度) のノルムを返します。

たとえば、ユークリッドノルム (最も一般的なノルム型) を計算する場合は、次の値を使用できます。

SELECT VECTOR_NORM ( vector, 'norm2' )
FROM ...

Note

VECTOR_NORM は、SQL Server 2025 または Always-up-to-date更新ポリシーを使用して、Azure SQL Managed Instance で使用できます。

Syntax

Transact-SQL 構文表記規則

VECTOR_NORM ( vector , norm_type )

Arguments

ベクタ

ベクター データ型に評価される式。

norm_type

指定されたベクトルのノルムの計算に使用するノルム型の名前を持つ文字列。 次の標準型がサポートされています。

  • norm1 - 1 ノルム。ベクトル 成分の絶対値の合計です。
  • norm2 - ユークリッドノルムとも呼ばれる2ノルム。これはベクトル成分の平方和の平方根です。
  • norminf - 無限ノルム。これはベクトル成分の絶対値の最大値です。

戻り値

この関数は、指定されたノルム型を使用して、ベクトルのノルムを表す 浮動小数点 値を返します。

norm_typeが有効なノルム型でない場合、およびベクターがベクター データ型でない場合は、エラーが返されます。

Examples

例 1

次の例では、JSON 配列を持つ文字列から 3 次元のベクターを作成します。

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

SELECT VECTOR_NORM(@v, 'norm2') AS norm2,
       VECTOR_NORM(@v, 'norm1') AS norm1,
       VECTOR_NORM(@v, 'norminf') AS norminf;

期待される戻り値は次のようになります。

norm2 norm1 norminf
3.7416573867739413 6.0 3.0

例 2

次の例では、テーブル内の各ベクトルのノルムを計算します。

CREATE TABLE dbo.vectors
(
    ID INT PRIMARY KEY,
    v VECTOR(3) NOT NULL
);

INSERT INTO dbo.vectors (ID, v)
VALUES (1, '[0.1, -2, 42]'),
       (2, '[2, 0.1, -42]');

SELECT ID, VECTOR_NORM(v, 'norm2') AS norm
FROM dbo.vectors;