Online konvertor YAML do ACCDB zdarma

Co je formát YAML

YAML je textový serializační formát založený na odsazení, který se používá pro konfiguraci, výměnu strukturovaných dat, deploymentové soubory a exporty aplikací. Programy jako Docker Compose, Kubernetes, Ansible, GitHub Actions a vlastní aplikace v Pythonu nebo JavaScriptu běžně vytvářejí nebo načítají soubory YAML.

Dokument YAML může obsahovat mapování, seznamy, vnořené objekty, čísla, data, logické hodnoty a hodnoty null. Nemá pevně dané databázové schéma, takže při konverzi je nutné určit, které mapování se stane tabulkou, které klíče se stanou sloupci, jak spolu souvisejí opakované seznamy a jak se uloží vnořené hodnoty.

Co je formát ACCDB

ACCDB je databázový formát Microsoft Access používaný v Accessu 2007 a novějších verzích. Ukládá tabulky, relace, indexy, dotazy, formuláře, sestavy, makra a moduly VBA v jednom databázovém souboru.

ACCDB je vhodný, když uživatelé potřebují relační dotazy, indexované vyhledávání, formuláře pro zadávání dat, sestavy nebo kompatibilitu s Microsoft Access a Microsoft Access Database Engine. Méně vhodný je pro velmi rozsáhlé systémy s více uživateli, souběžné zápisy ve velkém objemu nebo dokumenty YAML, jejichž struktura se často mění.

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

Pro rychlou konverzi bez instalace softwaru můžete použít převodník YAML-to-ACCDB na 101convert.com. Pro opakované importy, kontrolu schématu nebo vnořená data použijte místní skript a Access Database Engine.

Metoda 1: import prostřednictvím mezilehlého souboru CSV

1. Otevřete YAML a identifikujte seznam záznamů. Struktura, například records: následovaná seznamem, se importuje snadněji než hluboce vnořený dokument.
2. Převeďte seznam na CSV pomocí nástroje nebo skriptu podporujícího YAML. Jednoduchá pole rozbalte do sloupců a vnořené objekty serializujte jako řetězce JSON.
3. Otevřete Microsoft Access a zvolte File → New → Blank database. Uložte nový soubor jako output.accdb.
4. Zvolte External Data → New Data Source → From File → Text File, vyberte soubor CSV a zvolte Import the source data into a new table.
5. Nastavte datový typ každého pole, vyberte primární klíč a před výběrem možnosti Finish zkontrolujte náhled importu.

Metoda 2: vytvoření tabulky pomocí Pythonu

Tento příklad zpracovává seznam plochých záznamů na nejvyšší úrovni YAML. Vnořené hodnoty ukládá jako JSON a všechny sloupce nejprve vytvoří jako dlouhý text, čímž se zabrání nesprávnému odvození typů.

pip install pyyaml pyodbc

V Accessu vytvořte prázdný soubor output.accdb a poté spusťte skript podobný následujícímu v systému Windows s nainstalovaným Microsoft Access Database Engine:

import json
import yaml
import pyodbc

with open("input.yaml", encoding="utf-8") as f:
    data = yaml.safe_load(f)

if isinstance(data, dict) and isinstance(data.get("records"), list):
    rows = data["records"]
elif isinstance(data, list):
    rows = data
else:
    raise ValueError("Expected a top-level list or a records list")

keys = []
for row in rows:
    if not isinstance(row, dict):
        raise ValueError("Every record must be a mapping")
    for key in row:
        if key not in keys:
            keys.append(key)

def column_name(value):
    return "[" + str(value).replace("]", "]]")[:64] + "]"

connection_string = (
    r"DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};"
    r"DBQ=output.accdb;"
)
cn = pyodbc.connect(connection_string)
cur = cn.cursor()

columns = ", ".join(f"{column_name(k)} LONGTEXT" for k in keys)
cur.execute(f"CREATE TABLE [ImportedData] ({columns})")

names = ", ".join(column_name(k) for k in keys)
marks = ", ".join("?" for _ in keys)
for row in rows:
    values = []
    for key in keys:
        value = row.get(key)
        if isinstance(value, (dict, list)):
            value = json.dumps(value, ensure_ascii=False)
        elif value is not None:
            value = str(value)
        values.append(value)
    cur.execute(f"INSERT INTO [ImportedData] ({names}) VALUES ({marks})", values)

cn.commit()
cn.close()

Spusťte jej ze složky obsahující input.yaml a output.accdb. Pokud YAML obsahuje více typů entit, vytvořte samostatné tabulky Access namísto umístění nesouvisejících objektů do jedné tabulky.

Kvalita, kompatibilita a omezení

Neexistuje univerzální mapování jedna ku jedné z YAML na ACCDB. Mapování YAML se obvykle převedou na řádky a sloupce, ale vnořené seznamy vyžadují podřízené tabulky a cizí klíče, pokud v nich má být možné provádět jednotlivé dotazy. Jejich uložení jako JSON zachová obsah, ale znemožní běžné relační filtrování.

Ukázkový skript neodvozuje číselné, datové, měnové ani logické typy. Po importu změňte vhodné sloupce na typy Access, jako jsou INTEGER, DOUBLE, DATETIME nebo YESNO, a přidejte primární klíč a indexy. Access má omezení názvů a velikostí polí, včetně limitu 64 znaků pro název tabulky nebo pole; dlouhé či duplicitní klíče YAML by měly být v produkčním schématu přejmenovány.

Používejte yaml.safe_load namísto nebezpečného YAML loaderu. Před importem zdroj ověřte, protože chybné odsazení, duplicitní klíče, kotvy, vlastní tagy a implicitní převody dat mohou změnit výsledné hodnoty nebo způsobit jejich neplatnost. Ovladač Microsoft Access ODBC je primárně dostupný v systému Windows a jeho 32bitová nebo 64bitová architektura musí odpovídat instalaci Pythonu, která jej používá.