VECTORPROPERTY (Transact-SQL) (préversion)

2025-06-21

S’applique à : SQL Server 2025 (17.x) Préversion de la base de données SQL Azure SQL Database Azure SQL Managed Instance SQL dans Microsoft Fabric

La fonction VECTORPROPERTY retourne des propriétés spécifiques d’un vecteur donné. La fonction nécessite deux arguments : le vecteur lui-même et la propriété à récupérer.

Remarque

Cette fonction est en préversion et peut être modifiée. Veillez à lire les conditions d’utilisation en préversion dans les contrats de niveau de service (SLA) pour les services en ligne.

Syntaxe

Conventions de la syntaxe Transact-SQL

VECTORPROPERTY(vector, property)

Les arguments

vecteur

Vecteur valide du type de vecteur . Il peut s’agir d’une expression, telle qu’une variable ou une référence à une colonne.

Le vecteur d’entrée peut être spécifié en tant que [tablename].[colname] variable valide du type de vecteur .

propriété

Expression spécifiant le nom de la propriété de base de données à retourner. La propriété prend en charge l’une des valeurs suivantes :

Propriété	Descriptif	Valeur retournée
`Dimensions`	Nombre de dimensions du vecteur de retour	Valeur entière avec nombre de dimensions.
`BaseType`	Type de base du vecteur de retour	sysname avec le nom du type de données.

Le type de base par défaut pour les vecteurs est actuellement défini sur float (32 bits).

Valeur retournée

La fonction retourne les propriétés spécifiques d’un vecteur donné en fonction de la propriété sélectionnée. Par exemple:

Si la propriété est Dimensions, la fonction retourne une valeur entière représentant le nombre de dimensions du vecteur.
Si la propriété est BaseType, la fonction retourne le nom du type de données (sysname).

Exemples

Récupérer le nombre de dimensions

Dans l’exemple suivant, déclarez un vecteur avec trois dimensions et récupérez son nombre de dimensions. La VECTORPROPERTY fonction retourne la valeur 3 entière représentant le nombre de dimensions.

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

SELECT VECTORPROPERTY(@v, 'Dimensions');

Nombre de dimensions renvoyées

L’exemple suivant récupère le nombre de dimensions d’une colonne embeddings vectorielle à partir d’une table 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;

Retours :

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

Partager via