Frequently Asked Questions

Everything you need to know about connecting your database, how queries work, and how ByeSQL handles your data.

Security & Privacy

Are my database credentials safe?

Credentials are encrypted at rest using AES-256. The encryption key is stored separately from the database. If the database were ever compromised, credentials would not be recoverable in plain text.

Does ByeSQL store the data returned by my queries?

No. Query results are returned directly to your browser and are not stored by ByeSQL. What is stored is metadata: the natural language prompt, the generated SQL, execution status, row count, and duration. The actual rows from your database are never persisted.

Can I limit which tables or schemas are visible to ByeSQL?

ByeSQL introspects whatever the database user you configure has access to. The recommended approach is to create a dedicated read-only user with access restricted to only the tables you want to expose.

Queries & Functionality

Can ByeSQL modify data in my database?

No. ByeSQL runs in SAFE mode by default, which only allows SELECT statements. Any write operation (INSERT, UPDATE, DELETE, DROP, CREATE, ALTER, TRUNCATE) is blocked before execution. This is a product-level guarantee, not a configuration option.

Is there a row limit on results?

Yes. The default limit is 200 rows, automatically applied if your prompt does not specify one. The maximum allowed is 5,000 rows per query.

What happens if a query takes too long?

Queries time out after 20 seconds. If this happens, ByeSQL will suggest adding more specific filters to narrow down the result set.

Can I refine a query in plain language without starting over?

Yes. ByeSQL supports multi-turn conversations. You can follow up with prompts like "now group by country" or "filter from January" and ByeSQL will build on the previous query maintaining context.

What languages can I write my prompts in?

ByeSQL supports prompts in any major language. Write your queries in whatever language you prefer.

Connection & Setup

Which databases do you support and which are coming?

Currently supported: PostgreSQL and MySQL. Planned: MariaDB, SQL Server, SQLite, Oracle, and others.

Does my database need to be accessible from the internet?

It depends on which version you use. With the web app, yes: ByeSQL connects to your database over the network, so it must be reachable from ByeSQL's servers. With the ByeSQL Desktop app, no: the connection is made directly from your computer, so you can query local databases, VPN-only databases, or databases on a private network without exposing them to the internet.

What is the minimum permission set needed for the database user I configure?

The database user only needs SELECT permission on the tables you want to query. No write permissions are needed or recommended.

Can I connect more than one database?

Yes. ByeSQL supports multiple connections per account. You can switch between them in the Query Studio.

What happens if I change my database schema after connecting?

ByeSQL caches your schema at connection time. If your schema changes, use the manual "Refresh" button available on each connection to re-introspect and update the cache. Until you refresh, ByeSQL will work from the outdated schema.

Do you have a fixed IP I can whitelist for my database firewall?

We don't currently publish a fixed IP range. If you need to whitelist ByeSQL's access, please contact support@byesql.com and we'll provide the current egress IPs for your infrastructure setup.

Desktop App

Does the desktop app send my query results to ByeSQL?

No. With the desktop app, your database connection and query execution happen entirely on your machine. The only data sent to ByeSQL is your database schema (table and column names, no actual data) — this is needed to generate accurate SQL. Query results are displayed locally and never reach ByeSQL's servers.

Can I connect to a local or VPN-only database with the desktop app?

Yes. The desktop app connects directly from your computer to your database — there is no intermediary server. This means it works with databases on localhost, private LANs, or behind a VPN, without any need to expose your database to the internet.

What is the difference between the web app and the desktop app?

The web app connects to your database through ByeSQL's servers — your database must be reachable from the internet. The desktop app connects directly from your computer, so it works with local, private, and VPN-only databases, and your connection and query results never pass through ByeSQL's infrastructure.

Both versions use the same AI to generate SQL, support multi-turn query refinement, and enforce SAFE mode. The desktop app is available on Basic, Pro and Enterprise plans.

AI & Accuracy

How accurate is the generated SQL? Can it hallucinate table or column names?

ByeSQL sends your real database schema as context with every prompt, so the model works with the actual table and column names from your database — not guesses. This eliminates the most common source of SQL hallucinations. That said, complex queries with ambiguous prompts may still require refinement.

Are my queries used to train any AI model?

No. Your queries and schema data are never used to train models.