{"id":28194544,"url":"https://github.com/fvarrui/dbtools","last_synced_at":"2026-04-19T03:02:02.125Z","repository":{"id":287396818,"uuid":"944554965","full_name":"fvarrui/dbtools","owner":"fvarrui","description":":toolbox: Conjunto de herramientas para bases de datos","archived":false,"fork":false,"pushed_at":"2025-10-26T23:15:58.000Z","size":225,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-27T01:13:07.869Z","etag":null,"topics":["analyzer","database","docs","mapper","schema","sql","tools"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fvarrui.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-07T14:56:00.000Z","updated_at":"2025-10-26T23:16:02.000Z","dependencies_parsed_at":"2025-04-11T14:47:23.416Z","dependency_job_id":"5b953a87-2e3f-4252-aa5c-1bc52ffdf636","html_url":"https://github.com/fvarrui/dbtools","commit_stats":null,"previous_names":["fvarrui/dbtools"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fvarrui/dbtools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fvarrui%2Fdbtools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fvarrui%2Fdbtools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fvarrui%2Fdbtools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fvarrui%2Fdbtools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fvarrui","download_url":"https://codeload.github.com/fvarrui/dbtools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fvarrui%2Fdbtools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31992822,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analyzer","database","docs","mapper","schema","sql","tools"],"created_at":"2025-05-16T13:12:20.625Z","updated_at":"2026-04-19T03:02:02.034Z","avatar_url":"https://github.com/fvarrui.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DBTools\n\nConjunto de comandos implementados en Python para facilitar tareas relacionadas con bases de datos relacionales:\n\n- [`dbanalyzer`](src/dbanalyzer/README.md): Analiza la estructura de una base de datos usando IA, obteniendo información semántica de las tablas y columnas.\n- [`dbchecker`](src/dbchecker/README.md): Verifica la integridad de una base de datos. [Próximamente]\n- [`dbmapper`](src/dbmapper/README.md): Crea mapas de entre esquemas de bases de datos para facilitar la migración de datos.\n- [`dbsequel`](src/dbsequel/README.md): Genera consultas SQL para un esquema dado en lenguaje natural utilizando IA. [Próximamente]\n- [`dbschema`](src/dbschema/README.md): Genera un esquema de la base de datos en formato JSON.\n- [`dbutils`](src/dbutils/README.md): Utilidades de soporte de `dbtools` para crear y gestionar ficheros de configuración con las conexiones a las bases de datos.\n- [`ddrsearch`](src/ddrsearch/README.md): Extrae información de un DDR (Data Dictionary Report) de una base de datos Oracle.\n\n\u003e 😱 Útil para no amargarte la vida.\n\n## ¿Cómo se instala?\n\nPara instalar **dbtools** en tu sistema, puedes hacerlo desde el repositorio de GitHub con el comando `pip` (debes ejecutarlo como Administrador en Windows o con `sudo` en Linux):\n\n```bash\npip install git+https://github.com/fvarrui/dbtools.git\n```\n\n\u003e 🐍 Por supuesto, debes tener Python instalado en tu sistema.\n\nSi ya has instalado alguna versión de `dbtools`, puedes actualizarlo con el siguiente comando:\n\n```bash\npip install --upgrade --force-reinstall --no-cache-dir git+https://github.com/fvarrui/dbtools.git\n```\n\n## ¿Cómo se usa?\n\nCada comando tiene su propia ayuda, que se puede obtener ejecutando el comando con la opción `--help`.\n\n```bash\n{db.command} --help\n```\n\n\u003e ℹ️ Remplaza `{db.command}` por el nombre del comando que quieras usar, por ejemplo `dbanalyzer`, `dbchecker`, etc.\n\nPara obtener más información sobre cada comando, consultar la documentación correspondiente.\n\nLas conexiones a la base de datos se configuran en el archivo de configuración `$HOME/.dbtools/dbtools.ini` y usando la opción `--db-name`, o bien proporcionando la cadena de conexión con la opción `--db-url` en la línea de comandos.\n\nEjemplo de archivo de configuración `dbtools.ini`:\n\n```ini\n[database]\ntype=\u003cmysql|postgresql|mssql\u003e\nhost=\u003cserver\u003e\nport=\u003cport\u003e\nusername=\u003cusername\u003e\npassword=\u003cpassword\u003e\ndatabase=\u003cdatabase name\u003e\ndriver=\u003cdriver\u003e\ntrusted_connection=\u003cyes|no\u003e\n```\n\n\u003e [!WARNING]\n\u003e - Si no se proporciona `port`, se usará el puerto por defecto para el tipo de base de datos especificado.\n\u003e - Si no se proporciona `password` en el archivo de configuración, se solicitará al usuario.\n\u003e - Las opciones `driver` y `trusted_connection` son específicas de SQL Server.\n\n```bash\n{db.command} --db-name database \u003copciones\u003e\n```\n\nó \n\n```bash\n{db.command} --db-url postgresql://user:password@host:port/database \u003copciones\u003e\n```\n\nSiendo `database` el nombre de la sección en el archivo de configuración.\n\n### Cadenas de conexión\n\nCadenas de conexión para los distintos sistemas gestores de bases de datos soportados:\n\n| Sistema                                        | Cadena de conexión                                                         |\n| ---------------------------------------------- | -------------------------------------------------------------------------- |\n| **PostgreSQL**                                 | `postgresql://{USER}:{PASSWORD}@{SERVER}:{PORT}/{DB_NAME}`                 |\n| **MySQL**                                      | `mysql://{USER}:{PASSWORD}@{SERVER}:{PORT}/{DB_NAME}`                      |\n| **SQL Server (SQL Server Authentication)**     | `mssql://{USER}:{PASSWORD}@{SERVER}:{PORT}/{DB_NAME}?driver={DRIVER}`      |\n| **SQL Server (Windows Authentication) [SSPI]** | `mssql://{SERVER}:{PORT}/{DB_NAME}?driver={DRIVER}\u0026trusted_connection=yes` |\n\n\n## Para desarrolladores\n\nSi quieres colaborar en el desarrollo de **dbtools**, puedes hacerlo de la siguiente manera.\n\nClonar el repositorio y entrar en el directorio:\n\n```bash\ngit clone https://github.com/fvarrui/dbtools.git\ncd dbtools\n```\n\nCrear un entorno virtual:\n\n```bash\npython -m venv venv\n```\n\nActivar el entorno virtual:\n\n```bash\nvenv\\Scripts\\activate\n```\n\nInstalar el paquete en modo de edición, de modo que se crearán los scripts del paquete y se instalarán las dependencias en el entorno virtual:\n\n```bash\npip install -e .\n```\n\n¡Y a programar!\n\n```bash\ncode .\n```\n\n## ¿Cómo contribuir?\n\n¡Tus PRs son bienvenidos!\n\n--- \n\nMade with ❤️ by [fvarrui](https://github.com/fvarrui)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffvarrui%2Fdbtools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffvarrui%2Fdbtools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffvarrui%2Fdbtools/lists"}