savepoint.versionTags()

DOCS • API • Savepoint API

---

Get the list of version tags for the database.

See related ➞ savepoint.versionTag()

Syntax

savepoint.versionTags(): Array<number>;

Usage

A database's life starts at version 1:

// Version 1
const savepoint = await client.createDatabase(
    {
        name: 'database_1',
        tables: [{
            name: 'table_1',
            columns: [],
        }]
    },
    { desc: 'Create description', returning: 'savepoint' }
);
console.log(savepoint.versionTag()); // 1
console.log(savepoint.versionTags()); // [ 1 ]

Subsequent alterations increment the version:

// Version 2
const savepoint = await client.database('database_1').createTable(
    {
        name: 'table_2',
        columns: [],
    },
    { desc: 'Create description', returning: 'savepoint' }
);
console.log(savepoint.versionTag()); // 2
console.log(savepoint.versionTags()); // [ 1, 2 ]

// Version 2 currently
const savepoint = await client.database('database_1').savepoint();
console.log(savepoint.versionTag()); // 2
console.log(savepoint.versionTags()); // [ 1, 2 ]

A rollback doesn't necessarily delete a Savepoint:

// Rollback to version 1
await savepoint.rollback({
    desc: 'Changes no more necessary'
});

// Version 1 currently
const savepoint = await client.database('database_1').savepoint();
console.log(savepoint.versionTag()); // 1
console.log(savepoint.versionTags()); // [ 1, 2 ]