Compartir vía

VECTORPROPERTY (Transact-SQL)

Se aplica a: SQL Server 2025 (17.x) Base de datos SQL de Azure SQL Database deAzure SQL Managed Instanceen Microsoft Fabric

La VECTORPROPERTY función devuelve propiedades específicas de un vector determinado. La función requiere dos argumentos: el propio vector y la propiedad que se va a recuperar.

Note

VECTORPROPERTYestá disponible en Instancia administrada de Azure SQL con la directiva de actualización de sql Server 2025 o Always-up-to-date.

Syntax

Convenciones de sintaxis de Transact-SQL

VECTORPROPERTY(vector , property)

Arguments

vector

Vector válido del tipo de vector . Puede ser una expresión, como una variable o una referencia a una columna.

El vector de entrada puede especificarse como [tablename].[colname] o como una variable válida del tipo de vector .

property

Una expresión que especifica el nombre de la propiedad de base de datos que se va a devolver. La propiedad admite uno de los siguientes valores:

Property Description Valor devuelto
Dimensions Recuento de dimensiones del vector de retorno Valor entero con recuento de dimensiones.
BaseType Tipo base del vector de retorno sysname con el nombre del tipo de datos.

El tipo base predeterminado para vectores se establece actualmente en float (32 bits).

Valor devuelto

La función devuelve las propiedades específicas de un vector determinado en función de la propiedad seleccionada. Por ejemplo:

  • Si la propiedad es Dimensions, la función devuelve un valor entero que representa el recuento de dimensiones del vector.
  • Si la propiedad es BaseType, la función devuelve el nombre del tipo de datos (sysname).

Examples

Recuperar recuento de dimensiones

En el ejemplo siguiente, declare un vector con tres dimensiones y recupere su recuento de dimensiones. La VECTORPROPERTY función devuelve el valor 3 entero que representa el recuento de dimensiones.

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

SELECT VECTORPROPERTY(@v, 'Dimensions');

Recuento devuelto de dimensiones

En el ejemplo siguiente se recupera el recuento de dimensiones de una columna embeddings vectorial de una tabla 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

Contenido relacionado

  • Last updated on