{"id":22624675,"url":"https://github.com/barrettotte/cf-sql-client","last_synced_at":"2025-03-29T03:16:55.645Z","repository":{"id":114089705,"uuid":"221334278","full_name":"barrettotte/CF-SQL-Client","owner":"barrettotte","description":"An unfinished toy SQL client for MSSQL and IBMi DB2 written with Lucee, Bootstrap, and a bit of vanilla JS.","archived":false,"fork":false,"pushed_at":"2019-11-22T17:54:18.000Z","size":116,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-03T13:13:22.885Z","etag":null,"topics":["bootstrap","coldfusion","db2","lucee","mssql","sql-client"],"latest_commit_sha":null,"homepage":"","language":"ColdFusion","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/barrettotte.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2019-11-12T23:51:19.000Z","updated_at":"2022-02-10T18:31:10.000Z","dependencies_parsed_at":"2023-06-12T13:45:35.763Z","dependency_job_id":null,"html_url":"https://github.com/barrettotte/CF-SQL-Client","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barrettotte%2FCF-SQL-Client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barrettotte%2FCF-SQL-Client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barrettotte%2FCF-SQL-Client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barrettotte%2FCF-SQL-Client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/barrettotte","download_url":"https://codeload.github.com/barrettotte/CF-SQL-Client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246131335,"owners_count":20728303,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bootstrap","coldfusion","db2","lucee","mssql","sql-client"],"created_at":"2024-12-09T00:17:20.672Z","updated_at":"2025-03-29T03:16:55.624Z","avatar_url":"https://github.com/barrettotte.png","language":"ColdFusion","readme":"# CF-SQL-Client\n\nAn unfinished toy SQL client for MSSQL and IBMi DB2 written with Lucee, Bootstrap, and a bit of vanilla JS.\n\nThis was made to just screw around with Lucee, JS, and some SQL.\nIts just a toy and by no means should be used seriously or at all.\n\n\u003cbr\u003e\n\n[![screenshot02](screenshots/screenshot02.PNG)](screenshots/screenshot02.PNG)\n\n\u003cbr\u003e\n\n## Features\n* MSSQL support - I started IBMi DB2 but got bored of this project\n* Execute multiple SQL statements\n* File loading\n* Resultset output with bootstrap\n* Basic database information output\n\n\u003cbr\u003e\n\n[![screenshot01](screenshots/screenshot01.PNG)](screenshots/screenshot01.PNG)\n\n\n## Limitations / Issues\n* I didn't feel like finishing it because ColdFusion makes me want to vomit.\n* My encryption for credentials is just XOR encryption with a random number between 0 and 2048 lol...this is just a mess around project anyway.\n* I wanted to use integrated security for MSSQL, but I ran into a bunch of issues. Its just easier to do user/password for setting up the datasource.\n* SQL input can have multiple statements and are parsed using ';' as a delimiter.\n* Comments aren't parsed right at all...I have no intention to fix it either.\n* Each query is limited to 100 rows per statement execution.\n* There's no guarantee that cloning and setting this up will even work. CommandBox sucks to setup, it doesn't work half the time.\n\n\n## Setup\nDownload ```jt400-9.6-jt400_jdk8.jar``` from http://jt400.sourceforge.net/ and place in server directory under **/jars** directory.\n\nEnter datasources into **config.json**\n```javascript\n// config.json\n{\n  \"datasources\": [\n    {\n      \"name\":\"MY_MSSQL\",\n      \"type\":\"MSSQL\",\n      \"class\":\"com.microsoft.jdbc.sqlserver.SQLServerDriver\",\n      \"connectionString\":\"jdbc:sqlserver://someserver:1433;DATABASE_NAME\",\n      \"username\":\"myuser\",    // These will be encrypted\n      \"password\":\"mypassword\" //   in the next step\n    }\n  ]\n}\n```\n\nStart CommandBox in current directory with ```box.exe``` and run the encryption task with ```task run tasks/setup```.\nThis task will overwrite the configuration file with encrypted credentials.\n\nStart the server with ```server start```, mine was running at http://127.0.0.1:51444/\n\n\n## Commands\n* Start server ```CommandBox\u003e server start cfengine=lucee```\n* Restart current server ```CommandBox\u003e restart```\n* View log ```CommandBox\u003e server log --follow```\n* All in one ```CommandBox\u003e restart \u0026\u0026 server log --follow```\n\n\n## Improvements\nNOTE: These will never be done\n* SQL Syntax highlighting\n* Save textarea content to file\n* Save resultset to JSON file\n* Better error handling\n* Better encryption, xor encryption is insanely weak\n* Better statement parsing - comments\n* Loading animation when loading file or executing query\n* Database object browser - schemas, tables, columns\n\n\n## References\n* CF Admin - http://server:port/lucee/admin/web.cfm\n* CommandBox - https://www.ortussolutions.com/products/commandbox\n* **Learn Modern ColdFusion in 100 Minutes** - https://modern-cfml.ortusbooks.com/\n* Lucee Docs - https://docs.lucee.org/index.html\n* Lucce CommandBox - https://docs.lucee.org/guides/getting-started/commandbox.html\n* Lucee Tutorials - https://lucee.org/learn/tutorials.html\n* Server reloading examples - https://gist.github.com/nicklepedde/3277959\n* Datasources in CF - https://coldfusion.adobe.com/2014/08/application-datasources-in-coldfusion/\n* Generated favicon with https://favicon.io/\n* SQL Server Operating System Docs - https://docs.microsoft.com/en-us/sql/relational-databases/system-dynamic-management-views/sql-server-operating-system-related-dynamic-management-views-transact-sql?view=sql-server-ver15\n* Lucee 3rd party jars - https://docs.lucee.org/guides/working-with-source/3rd-party-libraries.html\n* JT400 Jar - http://jt400.sourceforge.net/\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarrettotte%2Fcf-sql-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbarrettotte%2Fcf-sql-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarrettotte%2Fcf-sql-client/lists"}