Darmowy konwerter online YAML do ACCDB

Czym jest format YAML

YAML to tekstowy format serializacji oparty na wcięciach, używany do konfiguracji, wymiany danych strukturalnych, plików wdrożeniowych i eksportów aplikacji. Programy takie jak Docker Compose, Kubernetes, Ansible, GitHub Actions oraz niestandardowe aplikacje Python lub JavaScript często tworzą pliki YAML lub korzystają z takich plików.

Dokument YAML może zawierać mapowania, listy, obiekty zagnieżdżone, liczby, daty, wartości logiczne i wartości null. Nie ma ustalonego schematu bazy danych, dlatego konwersja musi określić, które mapowanie stanie się tabelą, które klucze staną się kolumnami, w jaki sposób powiązać powtarzające się listy oraz jak przechowywać wartości zagnieżdżone.

Czym jest format ACCDB

ACCDB to format bazy danych Microsoft Access używany przez Access 2007 i nowsze wersje. Przechowuje tabele, relacje, indeksy, kwerendy, formularze, raporty, makra i moduły VBA w jednym pliku bazy danych.

ACCDB jest odpowiedni, gdy użytkownicy potrzebują kwerend relacyjnych, indeksowanych wyszukiwań, formularzy wprowadzania danych, raportów lub zgodności z Microsoft Access i Microsoft Access Database Engine. Jest mniej odpowiedni dla bardzo dużych systemów wieloużytkownikowych, dużej liczby jednoczesnych operacji zapisu lub dokumentów YAML, których struktura często się zmienia.

Jak faktycznie przekonwertować YAML do ACCDB

W celu szybkiej konwersji bez instalowania oprogramowania można użyć konwertera YAML-to-ACCDB na stronie 101convert.com. W przypadku powtarzalnego importu, kontroli schematu lub danych zagnieżdżonych należy użyć lokalnego skryptu i Access Database Engine.

Metoda 1: import za pośrednictwem pośredniego pliku CSV

1. Otwórz YAML i zidentyfikuj listę rekordów. Struktura taka jak records: po której następuje lista, jest łatwiejsza do zaimportowania niż dokument o głębokim zagnieżdżeniu.
2. Przekonwertuj listę do CSV za pomocą narzędzia lub skryptu obsługującego YAML. Spłaszcz proste pola do kolumn i zserializuj zagnieżdżone obiekty jako ciągi JSON.
3. Otwórz Microsoft Access i wybierz File → New → Blank database. Zapisz nowy plik jako output.accdb.
4. Wybierz External Data → New Data Source → From File → Text File, wskaż plik CSV i wybierz Import the source data into a new table.
5. Ustaw typ danych każdego pola, wybierz klucz podstawowy i przejrzyj podgląd importu przed wybraniem Finish.

Metoda 2: utworzenie tabeli za pomocą Python

Ten przykład obsługuje najwyższego poziomu listę YAML zawierającą płaskie rekordy. Przechowuje wartości zagnieżdżone jako JSON i początkowo tworzy każdą kolumnę jako długi tekst, co pozwala uniknąć nieprawidłowego wnioskowania o typach.

pip install pyyaml pyodbc

Utwórz pusty plik output.accdb w Access, a następnie uruchom w systemie Windows skrypt podobny do poniższego, mając zainstalowany 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()

Uruchom go z folderu zawierającego input.yaml i output.accdb. Jeśli YAML zawiera wiele typów encji, utwórz osobne tabele Access zamiast umieszczać niepowiązane obiekty w jednej tabeli.

Jakość, zgodność i ograniczenia

Nie istnieje uniwersalne mapowanie jeden do jednego z YAML do ACCDB. Mapowania YAML zwykle stają się wierszami i kolumnami, ale zagnieżdżone listy wymagają tabel podrzędnych i kluczy obcych, jeśli mają być indywidualnie przeszukiwane. Przechowywanie ich jako JSON zachowuje zawartość, ale uniemożliwia standardowe filtrowanie relacyjne.

Przykładowy skrypt nie rozpoznaje typów liczbowych, daty, waluty ani wartości logicznych. Po zaimportowaniu zmień odpowiednie kolumny na typy Access, takie jak INTEGER, DOUBLE, DATETIME lub YESNO, a także dodaj klucz podstawowy i indeksy. Access ma ograniczenia dotyczące nazw pól i ich rozmiaru, w tym limit 64 znaków dla nazwy tabeli lub pola; długie albo zduplikowane klucze YAML należy zmienić w schemacie produkcyjnym.

Używaj yaml.safe_load, a nie niebezpiecznego loadera YAML. Zweryfikuj źródło przed importem, ponieważ nieprawidłowe wcięcia, zduplikowane klucze, kotwice, niestandardowe tagi i niejawne konwersje dat mogą zmienić lub unieważnić wynikowe wartości. Sterownik Microsoft Access ODBC jest dostępny głównie w systemie Windows, a jego architektura 32-bitowa lub 64-bitowa musi być zgodna z instalacją Python, która go używa.