Online konvertor TOML do ACCDB zdarma

Applications, které vyžadují databázi Microsoft Access, mohou obdržet konfigurační nebo datové záznamy ve formátu TOML, takže hodnoty je nutné analyzovat a vložit do souboru .accdb. Jde o převod datové struktury, nikoli o přímou změnu formátu, protože TOML nemá tabulky, indexy ani relace ekvivalentní těm v Accessu.

Co je formát TOML

TOML, zkráceně Tom's Obvious Minimal Language, je člověkem čitelný konfigurační formát založený na párech klíč–hodnota, tabulkách, polích, řetězcích, číslech, booleovských hodnotách a datech. Vývojáři jej používají pro nastavení aplikací, nástroje pro sestavování, správce balíčků, deploymentové soubory a metadata projektů.

Mezi běžné producenty a konzumenty patří Cargo v Rustu prostřednictvím Cargo.toml, nástroje pro balení Pythonu prostřednictvím pyproject.toml, generátory statických webů, nástroje pro vývoj her a vlastní aplikace. S TOML se obvykle setkáte jako s konfiguračním souborem, nikoli jako s exportem databáze.

Co je formát ACCDB

ACCDB je formát databáze Microsoft Access používaný verzemi Access 2007 a novějšími. Ukládá tabulky, dotazy, formuláře, sestavy, indexy, relace, makra a – v podporovaných konfiguracích – přílohy a vícehodnotová pole.

Soubor ACCDB je užitečný, když uživatelé potřebují upravovat záznamy v Microsoft Access, spouštět uložené dotazy, tisknout sestavy nebo sdílet malou relační databázi bez nasazení serverového databázového systému. Access vyžaduje k vytvoření a úpravě souborů ACCDB odpovídající instalaci Microsoft Access Database Engine nebo Microsoft Access.

Jak skutečně převést TOML na ACCDB

Protože neexistuje univerzální mapování jedna ku jedné, nejprve určete, které sekce TOML se stanou tabulkami a které klíče sloupci. Nejjednodušším případem je jednoduchý TOML soubor obsahující pole tabulek:

[[products]]
name = 'Keyboard'
price = 49.95
available = true

[[products]]
name = 'Mouse'
price = 19.95
available = false

U této struktury může Python 3.11 nebo novější analyzovat TOML pomocí vestavěného modulu tomllib. Nainstalujte ODBC ovladač Microsoft Access a pyodbc a poté spusťte skript, který vytvoří databázi a vloží záznamy:

import tomllib
import pyodbc

with open('products.toml', 'rb') as source:
    data = tomllib.load(source)

rows = data['products']
fields = ['name', 'price', 'available']

def quote_identifier(value):
    return '[' + value.replace(']', ']]') + ']'

def sql_type(values):
    if all(isinstance(value, bool) for value in values):
        return 'YESNO'
    if all(isinstance(value, (int, float)) and not isinstance(value, bool) for value in values):
        return 'DOUBLE'
    return 'LONGTEXT'

database = 'products.accdb'
connection_string = (
    'DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};'
    'DBQ=' + database + ';'
)

with pyodbc.connect(connection_string, autocommit=True) as connection:
    cursor = connection.cursor()
    columns = ['[id] COUNTER PRIMARY KEY']
    for field in fields:
        values = [row.get(field) for row in rows if row.get(field) is not None]
        columns.append(quote_identifier(field) + ' ' + sql_type(values))
    cursor.execute('CREATE TABLE [products] (' + ', '.join(columns) + ')')

    placeholders = ', '.join('?' for field in fields)
    column_list = ', '.join(quote_identifier(field) for field in fields)
    statement = 'INSERT INTO [products] (' + column_list + ') VALUES (' + placeholders + ')'
    for row in rows:
        cursor.execute(statement, [row.get(field) for field in fields])

Uložte skript jako toml_to_accdb.py a spusťte python toml_to_accdb.py. Skript vytvoří products.accdb, přidá primární klíč s automatickým číslováním, odvodí základní typy Accessu a vloží položky pole.

U složitějších souborů data před načtením normalizujte. Tabulka TOML, například [server], se může stát jednořádkovou tabulkou server; pole, například [[users]], se může stát tabulkou users; a vnořené tabulky by se obvykle měly stát souvisejícími tabulkami s primárními a cizími klíči. Neukládejte každý vnořený objekt do jediného textového sloupce, pokud není zachování původní konfigurace důležitější než možnost jejího dotazování.

Microsoft Access pak může výsledek otevřít prostřednictvím File → Open → Browse. Pokud byla data nejprve zapsána do CSV, použijte External Data → New Data Source → From File → Text File, vyberte oddělovač a typy polí a během importu zvolte primární klíč.

Bez instalace softwaru můžete také vyzkoušet bezplatný převodník na webu 101convert.com. Online převod je vhodný pouze tehdy, pokud služba podporuje strukturu TOML a výsledné schéma databáze splňuje vaše potřeby; před použitím souboru ověřte vygenerované tabulky a hodnoty.

Kvalita, kompatibilita a omezení

Soubor TOML nedefinuje relační klíče, indexy, délky polí ani relace mezi tabulkami, takže tyto prvky je nutné navrhnout během převodu. Data TOML, místní časy, pole, vložené tabulky, víceřádkové řetězce a pole se smíšenými typy mohou vyžadovat explicitní zpracování namísto automatického odvození typů.

Textová pole Accessu mohou ukládat Unicode, ale vyhrazená slova a znaky v klíčích TOML by měly být před vytvořením SQL identifikátorů escapovány nebo přejmenovány. ODBC ovladač Microsoft Access je obvykle dostupný v systému Windows; 32bitové a 64bitové instalace Pythonu, ovladače a Office musí používat kompatibilní architektury.

Po načtení otevřete soubor ACCDB v Accessu a ověřte počty řádků, hodnoty null, data, přesnost desetinných čísel, znaky Unicode a relace. Původní soubor TOML si ponechte, protože vygenerovaná databáze obvykle nedokáže reprodukovat původní formátování, komentáře, pořadí klíčů ani přesnou vnořenou strukturu.