Conversor online gratuito de YAML para ACCDB

O que é o formato YAML

YAML é um formato de serialização de texto simples baseado em indentação, usado para configuração, intercâmbio de dados estruturados, arquivos de implantação e exportações de aplicativos. Programas como Docker Compose, Kubernetes, Ansible, GitHub Actions e aplicativos personalizados em Python ou JavaScript geralmente criam ou consomem arquivos YAML.

Um documento YAML pode conter mapeamentos, listas, objetos aninhados, números, datas, valores booleanos e valores nulos. Ele não possui um schema fixo de banco de dados, portanto, uma conversão precisa decidir qual mapeamento se torna uma tabela, quais chaves se tornam colunas, como as listas repetidas se relacionam e como os valores aninhados são armazenados.

O que é o formato ACCDB

ACCDB é o formato de banco de dados do Microsoft Access usado pelo Access 2007 e versões posteriores. Ele armazena tabelas, relações, índices, consultas, formulários, relatórios, macros e módulos VBA em um único arquivo de banco de dados.

ACCDB é apropriado quando os usuários precisam de consultas relacionais, pesquisas indexadas, formulários de entrada de dados, relatórios ou compatibilidade com o Microsoft Access e o Microsoft Access Database Engine. Ele é menos adequado para sistemas muito grandes com vários usuários, gravações simultâneas de alto volume ou documentos YAML cuja estrutura muda com frequência.

Como realmente converter YAML para ACCDB

Para uma conversão rápida sem instalar software, você pode usar o conversor de YAML para ACCDB em 101convert.com. Para importações repetíveis, controle do schema ou dados aninhados, use um script local e o Access Database Engine.

Método 1: importar por meio de um arquivo CSV intermediário

1. Abra o YAML e identifique a lista de registros. Uma estrutura como records: seguida por uma lista é mais fácil de importar do que um documento profundamente aninhado.
2. Converta a lista para CSV com uma ferramenta ou script compatível com YAML. Transforme campos simples em colunas e serialize objetos aninhados como strings JSON.
3. Abra o Microsoft Access e escolha File → New → Blank database. Salve o novo arquivo como output.accdb.
4. Escolha External Data → New Data Source → From File → Text File, selecione o CSV e escolha Import the source data into a new table.
5. Defina o tipo de dados de cada campo, selecione uma chave primária e revise a visualização da importação antes de selecionar Finish.

Método 2: criar a tabela com Python

Este exemplo processa uma lista YAML de nível superior contendo registros simples. Ele armazena valores aninhados como JSON e inicialmente cria todas as colunas como texto longo, evitando uma inferência de tipos incorreta.

pip install pyyaml pyodbc

Crie um output.accdb em branco no Access e execute um script semelhante a este no Windows com o Microsoft Access Database Engine instalado:

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

Execute-o na pasta que contém input.yaml e output.accdb. Se o YAML contiver vários tipos de entidade, crie tabelas separadas do Access em vez de colocar objetos não relacionados em uma única tabela.

Qualidade, compatibilidade e limitações

Não existe um mapeamento universal individual entre YAML e ACCDB. Os mapeamentos YAML geralmente se tornam linhas e colunas, mas listas aninhadas exigem tabelas filhas e chaves estrangeiras se precisarem ser consultadas individualmente. Armazená-las como JSON preserva o conteúdo, mas impede a filtragem relacional normal.

O script de exemplo não infere tipos numéricos, de data, moeda ou booleanos. Após a importação, altere as colunas apropriadas para tipos do Access, como INTEGER, DOUBLE, DATETIME ou YESNO, e adicione uma chave primária e índices. O Access possui restrições de nome e tamanho de campos, incluindo um limite de 64 caracteres para nomes de tabelas ou campos; chaves YAML longas ou duplicadas devem ser renomeadas em um schema de produção.

Use yaml.safe_load em vez de um carregador YAML inseguro. Valide a origem antes da importação, pois indentação malformada, chaves duplicadas, âncoras, tags personalizadas e conversões implícitas de datas podem alterar ou invalidar os valores resultantes. O driver ODBC do Microsoft Access está disponível principalmente no Windows, e sua arquitetura de 32 ou 64 bits deve corresponder à instalação do Python que o utiliza.