DBF de Visual FoxPro a PostgreSQL, SQL Server o SQLite Visual FoxPro DBFs to PostgreSQL, SQL Server or SQLite

Compile desde el código fuente con el SDK de .NET 10. El binario resultante se llama dbfsync.exe.

Build from source with the .NET 10 SDK. The resulting binary is called dbfsync.exe.

git clone https://github.com/peopleworks/DBFSync.git
cd DBFSync
dotnet publish src/DBFSync/DBFSync.csproj `
  --configuration Release `
  --runtime win-x86 `
  --self-contained false `
  --output dist/win-x86

# verificar instalaciónverify install
dbfsync --version
dbfsync --help
dbfsync sample

SQLite no requiere servidor ni credenciales: es el destino recomendado para la primera prueba. El archivo y sus carpetas padre se crean solos.

SQLite needs no server and no credentials — the recommended destination for a first run. The file and its parent folders are created automatically.

# 1 · crear el perfil y el archivo SQLitecreate the profile and the SQLite file
dbfsync profile set local `
  --engine sqlite `
  --file C:\DBFSync\erp.db

# 2 · revisar qué se leeráreview what will be read
dbfsync inspect `
  --source C:\ERP\Datos `
  --tables "clientes,articulos,fa*.dbf" `
  --exclude "*hist*,*bak*"

# 3 · carga inicialinitial load
dbfsync migrate `
  --profile local `
  --source C:\ERP\Datos `
  --tables "clientes,articulos,fa*.dbf"

# 4 · sincronizaciones posterioressubsequent synchronizations
dbfsync sync `
  --profile local `
  --source C:\ERP\Datos `
  --tables "clientes,articulos,fa*.dbf" `
  --sync-schema

Un perfil guarda motor, servidor, base, esquema y usuario. La contraseña se protege con DPAPI y nunca viaja en los argumentos.

A profile stores engine, server, database, schema, and user. The password is protected with DPAPI and never travels in the arguments.

dbfsync profile set erp-pg `
  --engine postgresql `
  --server pg01.example.com `
  --port 5432 `
  --database erp `
  --schema public `
  --user dbfsync `
  --create-database

dbfsync profile set erp-mssql `
  --engine sqlserver `
  --server sql01 `
  --database ERP `
  --schema dbo `
  --integrated

dbfsync profile list
dbfsync profile show erp-pg
dbfsync profile test erp-pg
dbfsync profile remove erp-pg

# lee una línea desde stdinreads one line from stdin
"s3cr3t" | dbfsync profile set erp-pg `
  --engine postgresql `
  --server pg01.example.com `
  --database erp `
  --user dbfsync `
  --password-stdin

Opciones de profile setprofile set options

Crea o verifica la base del perfil. Idempotente: si ya existe, lo informa y termina con éxito.

Creates or verifies the profile database. Idempotent: if it already exists it reports so and exits successfully.

dbfsync database create --profile erp-pg

# aliases equivalentesequivalent aliases
dbfsync db ensure --profile erp-pg
dbfsync base crear --profile erp-pg

Muestra esquema, filas activas y una muestra de datos sin tocar el destino. No necesita perfil.

Shows schema, live rows, and a data sample without touching the destination. No profile needed.

dbfsync inspect `
  --source C:\ERP\Datos `
  --tables "fa*.dbf" `
  --exclude "*hist*"

# toda la carpetathe whole folder
dbfsync inspect --source C:\ERP\Datos --all

Ambos comparten las mismas opciones. La diferencia está en qué hacen con el contenido que ya existe en el destino.

Both share the same options. The difference is what they do with content that already exists in the destination.

dbfsync migrate `
  --profile erp-pg `
  --source C:\ERP\Datos `
  --tables "clientes,articulos" `
  --batch-size 5000

dbfsync sync `
  --profile erp-pg `
  --source C:\ERP\Datos `
  --tables "clientes,articulos" `
  --sync-schema

Opciones de transferenciaTransfer options

Los patrones usan * y ?. La extensión .dbf es opcional y las exclusiones se aplican al final.

Patterns use * and ?. The .dbf extension is optional and exclusions are applied last.

# lista separada por comacomma-separated list
--tables "clientes,articulos,fa*.dbf"

# opción repetidarepeated option
--table "fa*" --table "cbmovf??"

# toda la carpeta menos lo excluidowhole folder minus exclusions
--all --exclude "*hist*,*bak*,tmp?"

Sin --sync-schema, una diferencia estructural detiene la tabla en vez de adivinar. Los cambios destructivos exigen autorización explícita.

Without --sync-schema, a structural difference stops the table instead of guessing. Destructive changes require explicit authorization.

dbfsync sync `
  --profile erp-pg `
  --source C:\ERP\Datos `
  --all `
  --sync-schema

# eliminar columnas ausentes en el DBFdrop columns missing from the DBF
dbfsync sync … --sync-schema --allow-drop-columns

# reconstruir desde cero (solo migrate)rebuild from scratch (migrate only)
dbfsync migrate … --recreate

La tarea programada solo recibe el nombre del perfil: nunca necesita la contraseña.

The scheduled task only receives the profile name — it never needs the password.

$action = New-ScheduledTaskAction `
  -Execute "C:\Tools\PeopleWorks\DBFSync\dbfsync.exe" `
  -Argument 'sync --profile erp-pg --source C:\ERP\Datos --tables "fa*.dbf" --lang es'

$trigger = New-ScheduledTaskTrigger -Once `
  -At (Get-Date).AddMinutes(1) `
  -RepetitionInterval (New-TimeSpan -Minutes 5)

$settings = New-ScheduledTaskSettingsSet `
  -MultipleInstances IgnoreNew -StartWhenAvailable

Register-ScheduledTask -TaskName "PeopleWorks DBFSync ERP" `
  -Action $action -Trigger $trigger -Settings $settings

# predeterminadosdefaults
C:\ProgramData\PeopleWorks\DBFSync\profiles.json
C:\ProgramData\PeopleWorks\DBFSync\logs\

# idioma sin argumentoslanguage without arguments
$env:DBFSYNC_LANG = "es"

Todos los comandos y sus aliases. --lang (o --language) puede aparecer en cualquier posición.

Every command and its aliases. --lang (or --language) can appear at any position.