Convertitore online gratuito da YAML a ACCDB

Cos'è il formato YAML

YAML è un formato di serializzazione in testo semplice basato sull'indentazione, utilizzato per la configurazione, lo scambio di dati strutturati, i file di distribuzione e le esportazioni delle applicazioni. Programmi come Docker Compose, Kubernetes, Ansible, GitHub Actions e applicazioni personalizzate in Python o JavaScript creano o utilizzano comunemente file YAML.

Un documento YAML può contenere mapping, elenchi, oggetti annidati, numeri, date, valori booleani e valori null. Non dispone di uno schema di database fisso, quindi una conversione deve stabilire quale mapping diventa una tabella, quali chiavi diventano colonne, come sono correlate le liste ripetute e come vengono memorizzati i valori annidati.

Cos'è il formato ACCDB

ACCDB è il formato di database Microsoft Access utilizzato da Access 2007 e versioni successive. Memorizza tabelle, relazioni, indici, query, maschere, report, macro e moduli VBA in un unico file di database.

ACCDB è appropriato quando gli utenti necessitano di query relazionali, ricerche indicizzate, maschere di immissione dati, report o compatibilità con Microsoft Access e Microsoft Access Database Engine. È meno adatto per sistemi multiutente molto grandi, scritture simultanee ad alto volume o documenti YAML la cui struttura cambia frequentemente.

Come convertire effettivamente YAML in ACCDB

Per una conversione rapida senza installare software, è possibile utilizzare il convertitore da YAML ad ACCDB su 101convert.com. Per importazioni ripetibili, controllo dello schema o dati annidati, utilizzare uno script locale e Access Database Engine.

Metodo 1: importazione tramite un file CSV intermedio

1. Aprire il file YAML e identificare l'elenco dei record. Una struttura come records: seguita da un elenco è più facile da importare rispetto a un documento profondamente annidato.
2. Convertire l'elenco in CSV con uno strumento o uno script compatibile con YAML. Trasformare i campi semplici in colonne e serializzare gli oggetti annidati come stringhe JSON.
3. Aprire Microsoft Access e scegliere File → New → Blank database. Salvare il nuovo file come output.accdb.
4. Scegliere External Data → New Data Source → From File → Text File, selezionare il CSV e scegliere Import the source data into a new table.
5. Impostare il tipo di dati di ciascun campo, selezionare una chiave primaria e controllare l'anteprima dell'importazione prima di selezionare Finish.

Metodo 2: creare la tabella con Python

Questo esempio gestisce un elenco YAML di primo livello contenente record semplici. Memorizza i valori annidati come JSON e inizialmente crea ogni colonna come testo lungo, evitando un'inferenza errata dei tipi.

pip install pyyaml pyodbc

Creare un file output.accdb vuoto in Access, quindi eseguire uno script simile a questo su Windows con Microsoft Access Database Engine installato:

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()

Eseguirlo dalla cartella contenente input.yaml e output.accdb. Se YAML contiene più tipi di entità, creare tabelle Access separate invece di inserire oggetti non correlati nella stessa tabella.

Qualità, compatibilità e limitazioni

Non esiste una corrispondenza universale uno a uno tra YAML e ACCDB. I mapping YAML solitamente diventano righe e colonne, ma gli elenchi annidati richiedono tabelle figlio e chiavi esterne se devono essere sottoposti a query individualmente. Memorizzarli come JSON preserva il contenuto, ma impedisce il normale filtraggio relazionale.

Lo script di esempio non rileva i tipi numerici, di data, valuta o booleani. Dopo l'importazione, modificare le colonne appropriate nei tipi Access come INTEGER, DOUBLE, DATETIME o YESNO, quindi aggiungere una chiave primaria e gli indici. Access presenta limitazioni relative ai nomi e alle dimensioni dei campi, incluso un limite di 64 caratteri per il nome di una tabella o di un campo; le chiavi YAML lunghe o duplicate devono essere rinominate in uno schema di produzione.

Utilizzare yaml.safe_load invece di un loader YAML non sicuro. Convalidare l'origine prima dell'importazione, poiché indentazione non valida, chiavi duplicate, anchor, tag personalizzati e conversioni implicite delle date possono modificare o invalidare i valori risultanti. Il driver ODBC di Microsoft Access è disponibile principalmente su Windows e la relativa architettura a 32 o 64 bit deve corrispondere a quella dell'installazione Python che lo utilizza.