Frequently Asked Questions

Find answers to commonly asked questions about DBView. Can't find what you're looking for?Ask on Discord

General

What is DBView?

DBView is a beautiful, fast, and modern database client for macOS. It supports MySQL, PostgreSQL, and SQLite databases with features like SQL editing, schema visualization, AI-powered queries, and more. Built with Tauri 2.0 and Rust for native performance.

Is DBView free?

Yes, DBView is free to download and use. We may introduce premium features in the future, but the core functionality will always remain free.

Which operating systems are supported?

Currently, DBView supports macOS 12.0 (Monterey) and later on Apple Silicon (M1/M2/M3/M4). Intel Mac and Windows/Linux support are planned for future releases.

Is my data secure?

Yes. DBView stores all sensitive information (passwords, API keys) in the macOS Keychain, which is encrypted and protected by your system password. Your database credentials never leave your machine.

Databases

Which databases does DBView support?

DBView supports MySQL, PostgreSQL, and SQLite. Each database type has full support for connections, schema exploration, query execution, and data export.

Can I connect to remote databases?

Yes, you can connect to any database that's accessible from your network. For databases behind firewalls, you can use SSH tunneling with password or key-based authentication.

How do I connect through an SSH tunnel?

When creating a connection, enable the SSH Tunnel option and provide your SSH server details. DBView supports password authentication and private keys (RSA, Ed25519, ECDSA), including keys with passphrases.

Can I connect to cloud databases (AWS RDS, Google Cloud SQL)?

Yes, DBView can connect to any cloud-hosted database. Simply use the connection details provided by your cloud provider. For private databases, use SSH tunneling through a bastion host.

Features

How does the AI assistant work?

The AI assistant uses your configured AI provider (OpenAI, Anthropic Claude, Google Gemini, or Ollama) to convert natural language questions into SQL queries. It's schema-aware, meaning it understands your table and column names to generate accurate queries.

Which AI providers are supported?

DBView supports OpenAI (GPT-4, GPT-3.5), Anthropic Claude, Google Gemini, and Ollama for local models. You can configure your preferred provider in Settings > AI Settings.

What is the SQL Book?

The SQL Book is a feature for saving and organizing your frequently used queries. You can save queries with names, organize them in folders, and quickly access them from the sidebar.

Can I export query results?

Yes, you can export query results in multiple formats: CSV, JSON, and SQL INSERT statements. Click the export button in the results panel to choose your format.

What is ERD visualization?

ERD (Entity Relationship Diagram) visualization automatically generates a visual diagram of your database schema. It shows tables, columns, and foreign key relationships. You can click on tables to highlight their relationships and export the diagram as an image.

Troubleshooting

The app shows "damaged" or won't open on macOS

This can happen if Gatekeeper blocks the app. Open Terminal and run: `xattr -cr /Applications/DBView.app` then try opening the app again. The app is signed and notarized by Apple, so this is safe.

I can't connect to my database

Check the following: 1) Verify your connection details (host, port, username, password). 2) Ensure the database server is running and accepting connections. 3) Check if a firewall is blocking the connection. 4) For remote connections, try using SSH tunneling.

SSH tunnel connection fails

Common issues: 1) Verify your SSH credentials are correct. 2) Ensure the SSH server is accessible and accepting connections. 3) For key-based auth, make sure your key format is supported (RSA, Ed25519, ECDSA). 4) If using a passphrase-protected key, enter the passphrase when prompted.

Query execution is slow

Slow queries are usually due to the database, not DBView. Try: 1) Adding appropriate indexes to your tables. 2) Using LIMIT to reduce result set size. 3) Analyzing your query with EXPLAIN. DBView uses virtual scrolling to handle large result sets efficiently.

The AI assistant isn't working

Make sure you've configured an AI provider in Settings > AI Settings. You'll need to add your API key for OpenAI, Anthropic, or Google. For Ollama, ensure the Ollama server is running locally.

Data & Privacy

Does DBView collect my data?

No. DBView does not collect, store, or transmit any of your data. All database connections and queries happen directly between your Mac and your database servers. The only network requests are to AI providers when you use the AI assistant feature.

Where are my connections stored?

Connection configurations are stored locally on your Mac. Sensitive data like passwords and API keys are stored in the macOS Keychain for security.

Is my data sent to AI providers?

Only when you explicitly use the AI assistant feature. When you ask the AI to generate a query, your table schema (names only, not data) and your question are sent to the configured AI provider. Your actual database data is never sent.

Still have questions?

We're here to help. Reach out to us through any of these channels.

DBView - The SQL client you'll love using | Product Hunt