VECTORPROPERTY (Transact-SQL)

Aplica-se a: SQL Server 2025 (17.x) Banco de Dados SQL do AzureBanco de DadosSQL do Azure Banco de Dados SQL banco de dados SQL do Banco de Dados SQL do Azurebanco de dados SQL no Microsoft Fabric

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

Syntax

Convenções de sintaxe de Transact-SQL

VECTORPROPERTY(vector , property)

Arguments

vetor

Um vetor válido do tipo de vetor . Isso 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 do banco de dados a ser retornada. A propriedade dá suporte a um dos seguintes valores:

O tipo 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

• Pesquisa de vetor e índices de vetor no Mecanismo de Banco de Dados SQL
• Exemplos de Pesquisa de Vetores do Banco de Dados SQL do Azure