Dzięki zastosowaniu protokołu SQLite Wasm w prywatnym systemie plików punktu początkowego można uniwersalnie zastąpić wycofaną technologię bazy danych Web SQL. Ten artykuł to przewodnik po migracji danych z Web SQL do SQLite Wasm.
Wymagany wątek
W poście Wycofanie i usunięcie bazy danych Web SQL ogłosiliśmy wycofanie bazy danych Web SQL. Choć sama technologia może zostać wycofana, jej zastosowania w dużym stopniu nie są już wykorzystywane, dlatego kolejny post SQLite Wasm w przeglądarce oparty na Origin Private File System zawiera nowy zestaw technologii opartych na bazie danych SQLite, skompilowanych do Web Assembly (Wasm) i wspierane przez prywatny system plików origin. W tym artykule znajdziesz instrukcje migracji baz danych z Web SQL do SQLite Wasm.
Migracja baz danych
Te 4 sekwencje działań przedstawiają koncepcję migracji bazy danych Web SQL do SQLite Wasm, przy czym baza danych SQLite jest obsługiwana przez prywatny system plików źródła. Może on posłużyć jako podstawa do Twojego własnego kodu dostosowywanego do Twoich potrzeb związanych z migracją bazy danych Web SQL.
Bazy danych Web SQL do przeniesienia
W tym przewodniku zakładamy, że masz co najmniej 1 istniejącą bazę danych Web SQL, która zawiera dane istotne dla Twojej aplikacji. Na poniższym zrzucie ekranu widać przykładową bazę danych o nazwie mydatabase z tabelą rainstorms, która mapuje nastroje na ich natężenie. Narzędzia deweloperskie w Chrome umożliwiają wyświetlanie baz danych WebSQL na potrzeby debugowania, jak pokazano na poniższym zrzucie ekranu.
Przekształcanie bazy danych Web SQL w instrukcje SQL
Aby dane zostały przeniesione w sposób przejrzysty dla użytkownika, czyli bez konieczności samodzielnego wykonywania przez niego jakichkolwiek kroków migracji, elementy danych w bazie danych muszą zostać przetłumaczone z powrotem na pierwotne instrukcje SQL, które je utworzyły. Ten problem pojawiał się już wcześniej, a skrypt migracji użyty w tym artykule (mywebsqldump.js) opiera się na bibliotece społeczności o nazwie websqldump.js z niewielkimi zmianami. Poniższy przykładowy kod pokazuje kod wymagany do przekształcenia bazy danych Web SQL mydatabase w zbiór instrukcji SQL.
websqldump.export({
database: 'mydatabase',
version: '1.0',
success: function(sql) {
// The SQL statements.
},
error: function(err) {
// Handle the error.
}
});
Uruchomienie tego kodu powoduje utworzenie ciągu instrukcji SQL widocznego poniżej.
CREATE TABLE IF NOT EXISTS rainstorms (mood text, severity int);
INSERT INTO rainstorms(mood,severity) VALUES ('somber','6');
INSERT INTO rainstorms(mood,severity) VALUES ('rainy','8');
INSERT INTO rainstorms(mood,severity) VALUES ('stormy','2');
Importowanie danych do SQLite Wasm
Teraz wystarczy wykonać te polecenia SQL w kontekście SQLite Wasm. Szczegółowe informacje o konfigurowaniu SQLite Wasm znajdziesz w artykule SQLite Wasm w przeglądarce obsługiwanym przez prywatny system plików Origin, ale najważniejsze informacje znajdziesz poniżej. Pamiętaj, że ten kod musi zostać uruchomiony w instancji roboczej (której biblioteka tworzy automatycznie) z poprawnie ustawionymi wymaganymi nagłówkami HTTP. Możesz zainstalować pakiet @sqlite.org/sqlite-wasm z npm.
import { sqlite3Worker1Promiser } from '@sqlite.org/sqlite-wasm';
(async () => {
try {
const promiser = await new Promise((resolve) => {
const _promiser = sqlite3Worker1Promiser({
onready: () => {
resolve(_promiser);
},
});
});
let response;
response = await promiser('open', {
filename: 'file:mydatabase.db?vfs=opfs',
});
const { dbId } = response;
const sql = `
CREATE TABLE IF NOT EXISTS rainstorms (mood text, severity int);
INSERT INTO rainstorms(mood,severity) VALUES ('somber','6');
INSERT INTO rainstorms(mood,severity) VALUES ('rainy','8');
INSERT INTO rainstorms(mood,severity) VALUES ('stormy','2');`
await promiser('exec', { dbId, sql });
await promiser('close', { dbId });
} catch (err) {
if (!(err instanceof Error)) {
err = new Error(err.result.message);
}
console.error(err.name, err.message);
}
})();
Po uruchomieniu tego kodu sprawdź zaimportowany plik bazy danych za pomocą rozszerzenia OPFS Explorer do Narzędzi deweloperskich w Chrome. Masz teraz 2 pliki: jeden z rzeczywistą bazą danych, a drugi z informacjami z dziennika. Pamiętaj, że te 2 pliki znajdują się w prywatnym systemie plików źródłowego, więc aby je zobaczyć, musisz użyć rozszerzenia OPFS Explorer.
Aby sprawdzić, czy zaimportowane dane są takie same jak początkowe dane Web SQL, kliknij plik mydatabase.db, a rozszerzenie OPFS Explorer wyświetli okno Zapisz plik, w którym możesz zapisać plik w widocznym dla użytkownika systemie plików. Po zapisaniu pliku bazy danych przejrzyj dane za pomocą aplikacji przeglądarki SQLite. Prezentacja interfejsów API projektu Fugu zawiera kilka aplikacji do pracy z SQLite w przeglądarce. Na przykład Sqlime – SQLite Playground umożliwia otwieranie pliku bazy danych SQLite z twardego dysku i uruchamianie w niej zapytań. Jak widać na zrzucie ekranu poniżej, tabela rainstorm została prawidłowo zaimportowana do SQLite.
Uwolnienie miejsca na dane w Web SQL
Chociaż usunięcie bazy danych Web SQL jest (być może zaskakujące) niemożliwe, nadal warto zwolnić trochę miejsca, usuwając przestarzałe tabele Web SQL po przeniesieniu danych do Wasm SQLite. Aby wyświetlić wszystkie tabele w bazie danych Web SQL i usunąć je za pomocą JavaScriptu, użyj kodu podobnego do tego:
const dropAllTables = () => {
try {
db.transaction(function (tx) {
tx.executeSql(
"SELECT name FROM sqlite_master WHERE type='table' AND name !='__WebKitDatabaseInfoTable__'",
[],
function (tx, result) {
const len = result.rows.length;
const tableNames = [];
for (let i = 0; i < len; i++) {
const tableName = result.rows.item(i).name;
tableNames.push(`'${tableName}'`);
db.transaction(function (tx) {
tx.executeSql('DROP TABLE ' + tableName);
});
}
console.log(`Dropped table${tableNames.length > 1 ? 's' : ''}: ${tableNames.join(', ')}.`);
}
);
});
} catch (err) {
console.error(err.name, err.message);
}
};
Praca z danymi po migracji
Po przeniesieniu danych wykorzystaj je w sposób opisany w przykładowym kodzie dla początkujących. Więcej informacji znajdziesz w dokumentacji interfejsu SQLite Wasm API. Przypominamy, że jeśli jako backendu miejsca na dane używasz prywatnego systemu plików punktu początkowego, musisz uzyskać dostęp do modułu Wasm SQLite z poziomu instancji roboczej.
Przetestuj
To demo pozwala wypełnić bazę danych Web SQL przykładowymi danymi, a potem wygenerować dane Web SQL jako instrukcje SQL, które następnie są importowane do SQLite Wasm obsługiwanego przez prywatny system plików pochodzenia. Na koniec zwolnij miejsce, usuwając nieaktualne dane Web SQL. Pełną implementację, w tym poprawiony plik mywebsqldump.js, znajdziesz w kodzie źródłowym.
Podsumowanie
Migracja baz danych Web SQL do Wasm SQLite w ramach prywatnego systemu plików punktu początkowego jest możliwa w sposób przejrzysty dla użytkowników. Nie zauważą, że ich dane są teraz hostowane w prywatnym systemie plików origin w bazie danych SQLite i nie są już dostępne w Web SQL. Ogólnie rzecz biorąc, migracja z Web SQL na SQLite jest konieczna dla deweloperów internetowych, którzy chcą zapewnić długoterminową stabilność i skalowalność swoich aplikacji. Chociaż proces ten może wymagać początkowego wysiłku, korzyści płynące z bardziej niezawodnego, elastycznego i przede wszystkim przyszłościowego rozwiązania bazy danych sprawiają, że jest to inwestycja warta swojej ceny.