@@ -14,13 +14,13 @@ If your database connection is successful, but the tables aren't showing up in t
1. Go to **Admin** > **Databases** and select your database to confirm that your connection hasn’t been changed or deleted.
- If Metabase hasn't started syncing with your database, click **Sync database schema now**.
- If Metabase hasn't started syncing with your database, click **Sync database schema now**.
- If Metabase is taking a long time to sync, go to [Troubleshooting syncs and scans](./sync-fingerprint-scan.md).
- If Metabase is taking a long time to sync, go to [Troubleshooting syncs and scans](./sync-fingerprint-scan.md).
2. Go to **Admin** > **Troubleshooting** > **Logs** to check if Metabase failed to sync [due to an error](#common-database-connection-errors).
- If the logs feel overwhelming, check out [How to read the server logs](./server-logs.md).
- If the logs feel overwhelming, check out [How to read the server logs](./server-logs.md).
If you don't have access to the Metabase Admin panel, you'll need to ask the person who set up your Metabase.
...
...
@@ -30,9 +30,9 @@ If you don't have access to the Metabase Admin panel, you'll need to ask the per
2. Check if you can connect to the data warehouse from another client using the machine that you’re running Metabase on.
- If you can access the server from a bastion host or another machine, [check if your Metabase's IP address has access to your database server](#checking-your-server-access).
- If you can access the server from a bastion host or another machine, [check if your Metabase's IP address has access to your database server](#checking-your-server-access).
- If you're running Metabase Cloud, check that you've [whitelisted our IP addresses](https://www.metabase.com/cloud/docs/ip-addresses-to-whitelist).
- If you're running Metabase Cloud, check that you've [whitelisted our IP addresses](https://www.metabase.com/cloud/docs/ip-addresses-to-whitelist).
3. Make sure that Metabase is using a role with the necessary privileges to connect to your data warehouse. See [Granting database privileges](../databases/users-roles-privileges.md).
...
...
@@ -40,6 +40,10 @@ The steps above will help you detect whether the problem is occurring outside of
If you don't have access to the data warehouse server, you’ll need to ask the person who manages your database or data warehouse.
## Troubleshooting BigQuery and Google Drive connections
See [Troubleshooting BigQuery and Google Drive connections](./bigquery-drive.md)
## Common database connection errors
### Your question took too long
...
...
@@ -74,7 +78,7 @@ If you have direct access to a command-line interface, log in and make sure that
To verify that your Metabase's IP address can access the database server:
1. Use the [netcat](https://en.wikipedia.org/wiki/Netcat) command `nc` (or your operating system’s equivalent) to check if you can connect to the host on a given port. Note that different databases use different ports by default.
1. Use the [netcat](https://en.wikipedia.org/wiki/Netcat) command `nc` (or your operating system’s equivalent) to check if you can connect to the host on a given port. Note that different databases use different ports by default.
2. If you're running Metabase Cloud, check that you've [whitelisted our IP addresses](https://www.metabase.com/cloud/docs/ip-addresses-to-whitelist).
...
...
@@ -93,13 +97,14 @@ To verify your credentials for a PostgreSQL database (you'll see an error if the
```
psql -h HOSTNAME -p PORT -d DATABASENAME -U DATABASEUSER
```
### Testing the connection status
1. Go to the Metabase [SQL editor](../questions/native-editor/writing-sql.md).
2. Test the connection to your database by running:
```
SELECT 1
```
```
SELECT 1
```
## Related problems
...
...
@@ -112,7 +117,7 @@ If you can’t solve your problem using the troubleshooting guides:
- Search or ask the [Metabase community][discourse].
- Search for [known bugs or limitations][known-issues].
- Hire a [Metabase Expert](https://www.metabase.com/partners/){:target="_blank"}.
- Hire a [Metabase Expert](https://www.metabase.com/partners/){:target="\_blank"}.
