Partager via

VECTORPROPERTY (Transact-SQL)

S’applique à : Base de données SQL Server 2025 (17.x) Azure SQL DatabaseAzure SQL Managed InstanceSQL dans Microsoft Fabric

La VECTORPROPERTY fonction 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.

Note

VECTORPROPERTYest disponible dans Azure SQL Managed Instance avec la stratégie de mise à jourSQL Server 2025 ou Always-up-to-date.

Syntax

Conventions de la syntaxe Transact-SQL

VECTORPROPERTY(vector , property)

Arguments

vector

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 .

property

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 :

Property Description 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).

Examples

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;

Returns:

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

Contenu connexe

  • Last updated on