Condividi tramite


VETTORIOPROPRIETÀ (Transact-SQL)

Si applica a: Sql Server 2025 (17.x) DatabaseSQL di Azure Istanza gestita di SQL di Azurein Microsoft Fabric

La VECTORPROPERTY funzione restituisce proprietà specifiche di un determinato vettore. La funzione richiede due argomenti: il vettore stesso e la proprietà da recuperare.

Note

VECTORPROPERTYè disponibile in Istanza gestita di SQL di Azure con i criteri di aggiornamento di SQL Server 2025 o Always-up-to-date.

Syntax

Convenzioni relative alla sintassi Transact-SQL

VECTORPROPERTY(vector , property)

Arguments

vector

Vettore valido del tipo di vettore . Può trattarsi di un'espressione, ad esempio una variabile o un riferimento a una colonna.

Il vettore di input può essere specificato come [tablename].[colname] o come variabile valida del tipo di vettore .

property

Espressione che specifica il nome della proprietà del database da restituire. La proprietà supporta uno dei valori seguenti:

Property Description Valore restituito
Dimensions Conteggio delle dimensioni del vettore restituito Valore intero con conteggio delle dimensioni.
BaseType Tipo di base del vettore restituito sysname con il nome del tipo di dati.

Il tipo di base predefinito per i vettori è attualmente impostato su float (32 bit).

Valore restituito

La funzione restituisce le proprietà specifiche di un vettore specificato in base alla proprietà selezionata. Per esempio:

  • Se la proprietà è Dimensions, la funzione restituisce un valore intero che rappresenta il conteggio delle dimensioni del vettore.
  • Se la proprietà è BaseType, la funzione restituisce il nome del tipo di dati (sysname).

Examples

Recuperare il numero di dimensioni

Nell'esempio seguente dichiarare un vettore con tre dimensioni e recuperarne il conteggio. La VECTORPROPERTY funzione restituisce il valore 3 intero che rappresenta il conteggio delle dimensioni.

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

SELECT VECTORPROPERTY(@v, 'Dimensions');

Conteggio restituito delle dimensioni

Nell'esempio seguente viene recuperato il numero di dimensioni di una colonna embeddings vettoriale da una tabella 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;

Returns:

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