π usql - Effortless SQL Queries Made Simple

π Getting Started
Welcome to usql! This application allows you to run SQL queries across various databases like SQLite, Postgres, MySQL, DuckDB, and Parquet with ease. It simplifies the process by automating the driver installation and enabling schema introspection for AI models like ChatGPT and Claude.
π» System Requirements
Before you start, ensure your system meets the following requirements:
- Operating System: Windows 10 or later, macOS 10.15 or later, or Linux (Ubuntu 20.04 or later)
- Node.js: Version 14 or later is required. You can download Node.js from Node.js Downloads.
- Network Connection: Required for downloading drivers and updates.
π₯ Download & Install
To get usql, visit the following page to download the latest version:
Download usql
- Open the Releases page in your web browser.
- Find the latest version of usql.
- Download the appropriate file for your operating system.
- Once downloaded, locate the file on your computer and run it to start the installation.
- Follow the on-screen instructions to complete the installation.
π Usage Instructions
After installing, you can start using usql right away. Hereβs how to run simple SQL queries:
- Open the Terminal:
- On Windows, use the Command Prompt or PowerShell.
- On macOS, open Terminal from the Applications folder.
- On Linux, open your preferred terminal emulator.
-
Launch usql:
Type usql and press Enter. This will bring up the usql command line interface.
- Connecting to a Database:
To connect to a database, use the following command:
usql --driver [database_driver] --database [database_name]
Replace [database_driver] with one of the following: sqlite, postgres, mysql, duckdb, or parquet. Substitute [database_name] with your databaseβs name.
- Running a Query:
Once connected, type your SQL query and press Enter. For example:
- Exiting usql:
To exit, simply type
exit and hit Enter.
π Advanced Features
usql comes with several advanced features to enhance your SQL experience:
- Auto-install Drivers: usql automatically installs the required drivers for your database.
- Schema Introspection: Use the
SHOW TABLES; command to view your database schema without needing prior knowledge of its structure.
- Integration with AI Models: Utilize usql in conjunction with AI models like ChatGPT for data analysis and insights.
π Troubleshooting
If you encounter issues, here are a few common solutions:
- Error Messages: Pay close attention to error messages in the terminal. They often give clues about what went wrong.
- Driver Not Found: Ensure you have the correct driver installed. usql usually handles this automatically, but you can manually install drivers if needed.
- Network Issues: Make sure your internet connection is stable, especially during driver downloads.
π Additional Resources
For more detailed information about using usql, consider checking these resources:
π Links
Feel free to open an issue if you face any challenges, and our community will assist you. Happy querying!