VECTORPROPERTY (Transact-SQL) (anteprima)

Articolo
2025-05-19

Si applica a: SQL Server 2025 (17.x) Anteprima del database SQL di Azure Istanza gestita di SQL di Azurein Microsoft Fabric

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

Annotazioni

Questa funzione è in anteprima ed è soggetta a modifiche. Assicurarsi di leggere le condizioni di utilizzo dell'anteprima nei contratti di servizio (SLA) per i servizi online.

Sintassi

Convenzioni relative alla sintassi Transact-SQL

VECTORPROPERTY(vector, property)

Argomenti

vettore

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 .

proprietà

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

Proprietà	Descrizione	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).

Esempi

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;

Restituisce:

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

Condividi tramite