VECTOR_NORM (Transact-SQL) (anteprima)

Si applica a:Database SQL di Azure

Accetta un vettore come input e restituisce la norma del vettore (che è una misura della sua lunghezza o grandezza) in un determinato tipo di norma.

Ad esempio, se si desidera calcolare la norma euclidea (che è il tipo di norma più comune), è possibile usare:

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

Sintassi

Convenzioni relative alla sintassi Transact-SQL

VECTOR_NORM ( vector, norm_type )

Argomenti

vettore

Espressione che restituisce il tipo di dati vector .

norm_type

Stringa con il nome del tipo di norma da utilizzare per calcolare la norma del vettore specificato. Sono supportati i tipi di norma seguenti:

• norm1 - La norma 1, ovvero la somma dei valori assoluti dei componenti vettoriali.
• norm2 - La norma 2, nota anche come Norm euclidea, che è la radice quadrata della somma dei quadrati dei componenti vettoriali.
• norminf - Norma infinito, ovvero il massimo dei valori assoluti dei componenti vettoriali.

Valore restituito

La funzione restituisce un valore float che rappresenta la norma del vettore usando il tipo di norma specificato.

Viene restituito un errore se norm_type non è un tipo di norma valido e se il vettore non è del tipo di dati vector.

Esempi

Esempio 1

L'esempio seguente crea un vettore con tre dimensioni da una stringa con una matrice JSON.

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

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

I valori restituiti previsti sono:

Esempio 2

Nell'esempio seguente viene calcolata la norma di ogni vettore in una tabella.

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;

Contenuto correlato

• Tipo di dati Vector
• Applicazioni intelligenti con database SQL di Azure
• Funzioni vettoriali