Example 1 - BLOB Arguments

Create a table with a column of type BLOB to store the vectors. The second column in this table, with column name vec and type BLOB, will store the vectors. This example demonstrates storing vector data using BLOBs, hence the column of type BLOB named vec.

CREATE TABLE vectors_b (id int, vec BLOB not null);

INSERT INTO vectors_b VALUES (1, JSON_ARRAY_PACK('[0.1, 0.8, 0.2, 0.555]')); 
INSERT INTO vectors_b VALUES (2, JSON_ARRAY_PACK('[0.45, 0.55, 0.495, 0.5]'));

The following query adds the vector '[0.1,0.1,0.1,0.1]' to the vectors in the vectors_b table and uses JSON_ARRAY_UNPACK to see the results in JSON format.

SET @qv = JSON_ARRAY_PACK('[0.1,0.1,0.1,0.1]');

SELECT id, JSON_ARRAY_UNPACK(VECTOR_ADD(vec, @qv)) AS vector_add
FROM vectors_b
ORDER BY id;

+------+---------------------------------------------------+
| id   | vector_add                                        |
+------+---------------------------------------------------+
|    1 | [0.200000003,0.900000036,0.300000012,0.655000031] |
|    2 | [0.550000012,0.650000036,0.595000029,0.600000024] |
+------+---------------------------------------------------+

JSON_ARRAY_UNPACK was used here to output the vectors in readable format because VECTOR_ADD returns a BLOB when its inputs are BLOBs.

The following query adds the vector '[0.1,0.1,0.1,0.1]' to the vectors in the vectors_b table and uses HEX to view the results in hexadecimal format.

SET @qv = JSON_ARRAY_PACK('[0.1,0.1,0.1,0.1]');

SELECT id, HEX(VECTOR_ADD(vec, @qv)) AS vector_add
FROM vectors_b
ORDER BY id;

+------+----------------------------------+
| id   | vector_add                       |
+------+----------------------------------+
|    1 | CDCC4C3E6766663F9A99993E15AE273F |
|    2 | CDCC0C3F6766263FEC51183F9A99193F |
+------+----------------------------------+

Example 2 - BLOBs with 16-bit Integers

Below is an example of using JSON_ARRAY_PACK and VECTOR_ADD with 16-bit signed integers.

First create a table of vectors stored as 16-bit integers. Note the use of the _I16 suffix on JSON_ARRAY_PACK.

CREATE TABLE vectors_b_i (id int, vec BLOB not null);

INSERT INTO vectors_b_i VALUES (1, JSON_ARRAY_PACK_I16('[1, 3, 2, 5]')); 
INSERT INTO vectors_b_i VALUES(2, JSON_ARRAY_PACK_I16('[23, 4, 1, 8]'));

The following query adds the vector '[2,2,2,2]' to the vectors in the vectors_b_i.

SET @qv = JSON_ARRAY_PACK_I16('[2, 2, 2, 2]');

SELECT JSON_ARRAY_UNPACK_I16(VECTOR_ADD_I16(@qv, vec)) AS vector_add
FROM vectors_b_i;

+--------------+
| vector_add   |
+--------------+
| [3,5,4,7]    |
| [25,6,3,10]  |
+--------------+

The result is an array of 16-bit integers as indicated by the _I16 suffix.

Formatting Binary Vector Data for BLOBs

When using the BLOB type for vector operations, vector data can be formatted using JSON_ARRAY_PACK. If your vector data is already in a packed binary format, you can load that data into the BLOBs. The data must be encoded as a BLOB containing packed numbers in little-endian byte order. Vectors stored as BLOBs can be of any length; however, the input blob length must be divisible by the size of the packed vector elements .