Поддержка Javascript в MySQL: пример UUID

Возможно, вы заметили, что MySQL теперь поддерживает создание функций (и процедур хранения) в Javascript с использованием GraalVM.

Эта новая функциональность доступна только в MySQL Enterprise и MySQL HeatWave.

Как разработчик, вы также можете получить бесплатный доступ к MySQL Enterprise из Oracle Technology Network (OTN): Загрузка MySQL Enterprise.

Зачем использовать JS-функцию?

Как вы, возможно, знаете, UUID становятся все более популярными, и их использование в MySQL ограничено UUID V1.

Итак, мы знаем, что можно извлечь временную метку из UUIDv1. Есть компонент MySQL (C ++), который предоставляет 3 UDF (определяемые пользователем функции) для этой цели. Компонент доступен на GitHub: mysql-component-uuid_v1.

При использовании MySQL DBaaS невозможно установить такие компоненты, и то же самое происходит с MySQL HeatWave. Следовательно, возможность использования функций JavaScript становится особенно выгодной в этом сценарии.

Функции для обработки UUIDv1

Затем мы создадим функции для анализа UUID MySQL и отображения метки времени.

Давайте начнем с извлечения временной метки как времени Unix в миллисекундах:

USE test;
DROP function IF EXISTS js_uuid_to_unixtime;
CREATE FUNCTION js_uuid_to_unixtime (uuid_in CHAR(36))
RETURNS CHAR(23) LANGUAGE JAVASCRIPT AS $$
    
const UUID_T_LENGTH = 16;
const UNIX_TS_LENGTH = 6;

function uuidToUnixTs(uuid_str) {
    const MS_FROM_100NS_FACTOR = 10000;
    const OFFSET_FROM_15_10_1582_TO_EPOCH = 122192928000000000n;

    // Разделите UUID символом "-" в качестве разделителя
    let uuid_parts = uuid_str.split('-');

    // Создайте временную метку UUID из ее частей
    let uuid_timestamp =
        uuid_parts[2].substring(1) +
        uuid_parts[1] +
        uuid_parts[0];

    // Преобразовать строку шестнадцатеричной метки времени в целое число
    let timestamp = BigInt('0x' + uuid_timestamp);

    // Вычислить временную метку Unix в миллисекундах
    let unixTimestampMs = Number((timestamp - OFFSET_FROM_15_10_1582_TO_EPOCH) / BigInt(MS_FROM_100NS_FACTOR));

    return unixTimestampMs;
}

function stringToUuid(str) {
    if (str.length !== 36) {
        return 1;
    }
    if (str[14] !== '1') {
        return 1;
    }
    return 0;
}

let result = stringToUuid(uuid_in);
let timestamp_out;
if (result === 0) {
    timestamp_out = uuidToUnixTs(uuid_in)/1000;
} else {
    timestamp_out="Error parsing UUID";
}

return (timestamp_out);

$$    

;

Давайте протестируем это:

MySQL > select now(), from_unixtime(js_uuid_to_unixtime(uuid()));
+---------------------+--------------------------------------------+
| now()               | from_unixtime(js_uuid_to_unixtime(uuid())) |
+---------------------+--------------------------------------------+
| 2024-03-20 22:24:13 | 2024-03-20 22:24:13.503000                 |
+---------------------+--------------------------------------------+
1 row in set (0.0009 sec)

Мы создали другие функции Javascript, предлагающие другой результат:

• js_uuid_to_datetime()
• js_uuid_to_datetime_long()

Давайте посмотрим на них в действии:

MySQL > select js_uuid_to_datetime(uuid());
+-----------------------------+
| js_uuid_to_datetime(uuid()) |
+-----------------------------+
| 2024-03-20 22:31:20.824     |
+-----------------------------+
1 row in set (0.0009 sec)

MySQL > select js_uuid_to_datetime_long(uuid());
+----------------------------------------------+
| js_uuid_to_datetime_long(uuid())             |
+----------------------------------------------+
| Wednesday, March 20, 2024 at 10:31:30 PM GMT |
+----------------------------------------------+
1 row in set (0.0012 sec)

UUIDv7

Все больше и больше людей используют UUIDv7. К сожалению, они недоступны в MySQL. UUIDv7 являются последовательными и не используют Mac-адрес.

Мы также можем создавать функции Javascript для генерации и обработки UUIDv7 в MySQL HeatWave.

Функции доступны здесь.

Давайте протестируем UUIDv7 в качестве первичного ключа для таблицы:

MySQL > CREATE TABLE `item` (
  `id` varbinary(16) NOT NULL,
  `name` varchar(20) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

MySQL > insert into item values (uuid_to_bin(js_uuidv7()),'item01'),
                                (uuid_to_bin(js_uuidv7()),'item02'), 
                                (uuid_to_bin(js_uuidv7()),'item03');
Query OK, 3 rows affected (0.0060 sec)

MySQL > select * from item;
+------------------------------------+--------+
| id                                 | name   |
+------------------------------------+--------+
| 0x018E5E04BA3376AED34A5B5EB51720A5 | item01 |
| 0x018E5E04BA34732799E01BED0C1A06F9 | item03 |
| 0x018E5E04BA34780F6A683BA37F00CA27 | item02 |
+------------------------------------+--------+
3 rows in set (0.0007 sec)

MySQL > select bin_to_uuid(id) uuid, name from item;
+--------------------------------------+--------+
| uuid                                 | name   |
+--------------------------------------+--------+
| 018e5e04-ba33-76ae-d34a-5b5eb51720a5 | item01 |
| 018e5e04-ba34-7327-99e0-1bed0c1a06f9 | item03 |
| 018e5e04-ba34-780f-6a68-3ba37f00ca27 | item02 |
+--------------------------------------+--------+
3 rows in set (0.0008 sec)

Мы также можем получить время создания каждой записи:

MySQL > insert into item values (uuid_to_bin(js_uuidv7()),'item04');
Query OK, 1 row affected (0.0035 sec)

MySQL > select js_uuidv7_to_datetime(bin_to_uuid(id)) insert_date, 
        name from item;
+-------------------------+--------+
| insert_date             | name   |
+-------------------------+--------+
| 2024-03-20 22:39:11.923 | item01 |
| 2024-03-20 22:39:11.924 | item03 |
| 2024-03-20 22:39:11.924 | item02 |
| 2024-03-20 22:41:54.567 | item04 |
+-------------------------+--------+
4 rows in set (0.0041 sec)

Для повышения производительности лучше хранить UUID с использованием uuid_to_bin() как BINARY(16). Конечно, если мы планируем использовать и вторичные индексы.

Но, возможно, вы предпочитаете напрямую видеть представление (значение) UUID при запросе таблицы.

Затем мы можем изменить нашу таблицу следующим образом:

MySQL > alter table item add column uuid char(36) 
        generated always as (bin_to_uuid(id)) virtual after id,
        alter column id set invisible;

MySQL > insert into item (id, name) 
        values (uuid_to_bin(js_uuidv7()),'item05');

MySQL > select * from item;
+--------------------------------------+--------+
| uuid                                 | name   |
+--------------------------------------+--------+
| 018e5e04-ba33-76ae-d34a-5b5eb51720a5 | item01 |
| 018e5e04-ba34-7327-99e0-1bed0c1a06f9 | item03 |
| 018e5e04-ba34-780f-6a68-3ba37f00ca27 | item02 |
| 018e5e07-3587-73af-6535-f805bee0cc04 | item04 |
| 018e5e15-12bf-7590-a010-7a5b5457a6c3 | item05 |
+--------------------------------------+--------+
5 rows in set (0.0006 sec)

MySQL > select *, js_uuidv7_to_datetime(uuid) inserted_at from item;
+--------------------------------------+--------+-------------------------+
| uuid                                 | name   | inserted_at             |
+--------------------------------------+--------+-------------------------+
| 018e5e04-ba33-76ae-d34a-5b5eb51720a5 | item01 | 2024-03-20 22:39:11.923 |
| 018e5e04-ba34-7327-99e0-1bed0c1a06f9 | item03 | 2024-03-20 22:39:11.924 |
| 018e5e04-ba34-780f-6a68-3ba37f00ca27 | item02 | 2024-03-20 22:39:11.924 |
| 018e5e07-3587-73af-6535-f805bee0cc04 | item04 | 2024-03-20 22:41:54.567 |
| 018e5e15-12bf-7590-a010-7a5b5457a6c3 | item05 | 2024-03-20 22:57:03.167 |
+--------------------------------------+--------+-------------------------+
5 rows in set (0.0014 sec)

Заключение

Возможность писать программы на Javascript непосредственно в MySQL является приятным дополнением, особенно при запуске MySQL HeatWave в облаке, где невозможно установить дополнительные компоненты или плагины.

Для тех, кто владеет такими пользовательскими функциями (UDF), теперь вы можете переписать их в Javascript и использовать там, где MySQL поддерживает GraalVM: MySQL Enterprise и MySQL Heatwave.

Наслаждайтесь написанием функций Javascript в MySQL!

(1 оценок, среднее: 5,00 из 5)

Загрузка...