Awesome
mssql-cli
DEPRECATION NOTICE mssql-cli is on the path to deprecation, and will be fully replaced by the new go-sqlcmd utility once it becomes generally available. We are actively in development for the new sqlcmd, and would love to hear feedback on it here!
mssql-cli is an interactive command line query tool for SQL Server. This open source tool works cross-platform and proud to be a part of the dbcli community.
mssql-cli supports a rich interactive command line experience, with features such as:
- Auto-completion: fewer keystrokes needed to complete complicated queries.
- Syntax highlighting: highlights T-SQL keywords.
- Query history: easily complete an auto-suggested query that was previously executed.
- Configuration file support: customize the mssql-cli experience for your needs.
- Multi-line queries: execute multiple queries at once using the multi-line edit mode.
- Non-interactive support: execute a query without jumping into the interactive experience.
Quick Start
Read the section below to quickly get started with mssql-cli. Consult the usage guide for a deeper dive into mssql-cli features.
Install mssql-cli
Platform-specific installation instructions are below:
| Windows (preview) | macOS | Linux |
|---|
Visit the installation reference guide to view all supported releases and downloads.
Install with Linux Package Manager
Follow the Linux installation instructions to install mssql-cli using apt-get, yum, and other Linux package managers.
Install with pip
python -m pip install mssql-cli
Please refer to the pip installation docs for more platform-specific information.
Connect to Server
Complete the command below to connect to your server:
mssql-cli -S <server URL> -d <database name> -U <username> -P <password>
Exit mssql-cli
Press Ctrl+D or type quit.
Show Options
For general help content, pass in the -h parameter:
mssql-cli --help
Usage Docs
Please refer to the usage guide for details on options and example usage. If you are having any issues using mssql-cli, please see the troubleshooting guide.
Telemetry
The mssql-cli tool includes a telemetry feature. Please refer to the telemetry guide for more information.
Contributing
If you would like to contribute to the project, please refer to the development guide.
Contact Us
If you encounter any bugs or would like to leave a feature request, please file an issue in the Issues section of our GitHub repo.
Code of Conduct
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
License
mssql-cli is licensed under the BSD-3 license.