VECTORPROPERTY (Transact-SQL) (Pratinjau)

2025-06-21

Berlaku untuk: Pratinjau SQL Server 2025 (17.x) Azure SQL Database Azure SQL Managed Instance SQL database di Microsoft Fabric

Fungsi VECTORPROPERTY mengembalikan properti tertentu dari vektor tertentu. Fungsi ini memerlukan dua argumen: vektor itu sendiri dan properti yang akan diambil.

Nota

Fungsi ini dalam pratinjau dan dapat berubah. Pastikan untuk membaca persyaratan penggunaan pratinjau dalam Perjanjian Tingkat Layanan (SLA) untuk Layanan Online.

Sintaksis

Konvensi sintaks Transact-SQL

VECTORPROPERTY(vector, property)

Argumen

Vektor

Vektor yang valid dari jenis vektor . Ini bisa menjadi ekspresi, seperti variabel atau referensi ke kolom.

Vektor input mungkin ditentukan sebagai [tablename].[colname] atau sebagai variabel yang valid dari jenis vektor .

harta benda

Ekspresi yang menentukan nama properti database yang akan dikembalikan. Properti mendukung salah satu nilai berikut:

Harta benda	Deskripsi	Nilai yang Dikembalikan
`Dimensions`	Mengembalikan jumlah dimensi vektor	Nilai bilangan bulat dengan jumlah dimensi.
`BaseType`	Mengembalikan jenis dasar vektor	sysname dengan nama jenis data.

Jenis dasar default untuk vektor saat ini diatur ke float (32-bit).

Mengembalikan nilai

Fungsi mengembalikan properti tertentu dari vektor tertentu berdasarkan properti yang dipilih. Contohnya:

Jika properti adalah Dimensions, fungsi mengembalikan nilai bilangan bulat yang mewakili jumlah dimensi vektor.
Jika properti adalah BaseType, fungsi mengembalikan nama jenis data (sysname).

Contoh

Mengambil jumlah dimensi

Dalam contoh berikut, deklarasikan vektor dengan tiga dimensi dan ambil jumlah dimensinya. Fungsi VECTORPROPERTY mengembalikan nilai 3 bilangan bulat yang mewakili jumlah dimensi.

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

SELECT VECTORPROPERTY(@v, 'Dimensions');

Jumlah pengembalian dimensi

Contoh berikut mengambil jumlah dimensi kolom embeddings vektor dari tabel 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;

Pengembalian:

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

Bagikan melalui