Partilhar via

VECTORPROPERTY (Transact-SQL)

Aplica-se a: SQL Server 2025 (17.x) Azure SQL Database AzureSQL Managed InstanceSQL database in Microsoft Fabric

A VECTORPROPERTY função retorna propriedades específicas de um determinado vetor. A função requer dois argumentos: o vetor em si e a propriedade a ser recuperada.

Note

VECTORPROPERTYestá disponível na Instância Gerenciada SQL do Azure com a política de atualizaçãoSQL Server 2025 ou Always-up-to-date.

Syntax

Transact-SQL convenções de sintaxe

VECTORPROPERTY(vector , property)

Arguments

vetor

Um vetor válido do tipo vetorial . Pode ser uma expressão, como uma variável ou uma referência a uma coluna.

O vetor de entrada pode ser especificado como [tablename].[colname] ou como uma variável válida do tipo de vetor .

propriedade

Uma expressão que especifica o nome da propriedade de banco de dados a ser retornada. A propriedade suporta um dos seguintes valores:

Property Description Valor devolvido
Dimensions Contagem de dimensões do vetor de retorno Valor inteiro com contagem de dimensões.
BaseType Tipo base do vetor de retorno sysname com o nome do tipo de dados.

O tipo de base padrão para vetores está atualmente definido como float (32 bits).

Valor de retorno

A função retorna as propriedades específicas de um determinado vetor com base na propriedade selecionada. Por exemplo:

  • Se a propriedade for Dimensions, a função retornará um valor inteiro que representa a contagem de dimensões do vetor.
  • Se a propriedade for BaseType, a função retornará o nome do tipo de dados (sysname).

Examples

Recuperar contagem de dimensões

No exemplo a seguir, declare um vetor com três dimensões e recupere sua contagem de dimensões. A VECTORPROPERTY função retorna o valor 3 inteiro que representa a contagem de dimensões.

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

SELECT VECTORPROPERTY(@v, 'Dimensions');

Contagem de retorno de dimensões

O exemplo a seguir recupera a contagem de dimensões de uma coluna embeddings de vetor de uma tabela 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

Conteúdo relacionado

  • Last updated on