> ## Documentation Index
> Fetch the complete documentation index at: https://julius.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Connectors Error Log

> A document of potential errors when connecting data sources to Julius, with context and suggested resolutions. 

<Info>
  **Please note**: If you're running into an error that isn't on this document yet, reach out to us at [team@julius.ai](mailto:team@julius.ai).
</Info>

***

## Postgres Errors:

| Error Message                                                                                                                                                                                                                                                                                | Error Code | Root Cause                                                                                        | Fix                                                                            |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- | :------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------- |
| `Initializing connection. Internal service error while initializing the connector. Please retry.`                                                                                                                                                                                            | 5432       | Password authentication failure.                                                                  | Correct Password and retry                                                     |
| `Error initializing connector: ['Failed to initialize connector: {"error":"Error executing connector init code: could not translate host name \\<URL>\\ to address: Name or service not known\n","message":"Connector initialization failed"}']`                                             | 3001       | Connection failed                                                                                 | Correct Host and retry                                                         |
| `Initializing connection. Connection test was cancelled.`                                                                                                                                                                                                                                    | 54321      | Network: Cannot reach the server                                                                  | Check ssl/firewall and retry                                                   |
| `Error initializing connector: ['Failed to initialize connector: {"error":"Error executing connector init code: connection to server at \"localhost\" (127.0.0.1), port 5432 failed`                                                                                                         | 5432       | Network: Cannot reach the server                                                                  | Use a real hostname(not localhost) and retry                                   |
| `Error: Unrecognized configuration parameter`                                                                                                                                                                                                                                                | n/a        | PostgreSQL: Connection failed                                                                     | Incompatible postgres versions, ensure you are actually connecting to postgres |
| `{"error": "Error initializing connector: [\"Error connecting to Porcupine: HTTPConnectionPool(host='localhost', port=54321): Read timed out.`                                                                                                                                               | 54321      | Network: Cannot reach the server                                                                  | Check ssl/firewall and retry                                                   |
| `Error initializing connector: ['Failed to initialize connector: {"error":"Error executing connector init code: connection to server at \"<IP>\", port <PORT> failed: server closed the connection unexpectedly`                                                                             | 1433       | Database: Connection failed                                                                       | Check why database keeps failing                                               |
| `Error initializing connector: ['Failed to initialize connector: {"error":"Error executing connector init code: connection to server at \"<HOST>\" (<IP>), port 5432 failed: error received from server in SCRAM exchange: Wrong password\n","message":"Connector initialization failed"}']` | 5432       | Connection failed                                                                                 | Correct Password                                                               |
| `Connection test failed. Please check your credentials and permissions.`                                                                                                                                                                                                                     | n/a        | not identified yet                                                                                | Check ssl/firewall and retry                                                   |
| `Invalid request - missing required fields,`                                                                                                                                                                                                                                                 | n/a        | Improper fields                                                                                   | Check input fields, ensure all fields are filled out, and retry                |
| `Error:[DATA_CONNECTOR_STREAMING_ENABLE_CONNECTOR_EXCEPTION] Exception in streaming enable: 424 GET`                                                                                                                                                                                         | 424        | Your sandbox is currently unavailable. Please try again in a few moments or restart your sandbox. | Restart your sandbox and try again                                             |

***

## BigQuery Errors:

| Error Message                                                                                                                                                                                              | Error Code | Root Cause                         | Fix                                                                                 |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- | :--------------------------------- | :---------------------------------------------------------------------------------- |
| `Extra data: line 1 column 7 (char 6)`                                                                                                                                                                     | n/a        | Malformed input                    | Double check input service-account-json and fix malformed errors                    |
| `Error initializing connector: ['Failed to initialize connector: {"error":"Error executing connector init code: Expecting value: line 1 column 1 (char 0)","message":"Connector initialization failed"}']` | n/a        | Connection failed                  | Double check input service-account-json and fix malformed errors                    |
| `BigQuery Error: 403 Access Denied: Table <REGION>.INFORMATION_SCHEMA.TABLES: User does not have permission to query table`                                                                                | 403        | BigQuery: Insufficient permissions | Lacking permissions to query your tables, please grant proper permissions and retry |

***

## Snowflake Errors:

| Error Message                                                                                                                                   | Error Code | Root Cause                                        | Fix                                                                                                                                                                                                                                                                                          |
| :---------------------------------------------------------------------------------------------------------------------------------------------- | :--------- | :------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Exception during connection test: Error initializing connector: ['250001 (08001): Failed to connect to DB. Contact your account administrator` | 250001     | Network or firewall blocking the connection       | Check your firewall and network configuration. See Snowflake's connectivity troubleshooting docs: [https://docs.snowflake.com/en/user-guide/client-connectivity-troubleshooting/error-messages](https://docs.snowflake.com/en/user-guide/client-connectivity-troubleshooting/error-messages) |
| `An unknown error occurred during the connection test`                                                                                          | n/a        | Too much data being sent at once                  | Connect to smaller data sources                                                                                                                                                                                                                                                              |
| `No Active Warehouse selected on snowflake`                                                                                                     | n/a        | No Active Warehouse selected on snowflake         | Select active warehouse on Snowflake                                                                                                                                                                                                                                                         |
| `Connection test failed. Please check your credentials and permissions.`                                                                        | 250003     | Snowflake Account not found                       | Correct snowflake host and username and retry                                                                                                                                                                                                                                                |
| `Connection test failed. Please check your credentials and permissions.`                                                                        | 250001     | Could be many things, usually ssl/firewall issues | See docs here: [https://docs.snowflake.com/en/user-guide/client-connectivity-troubleshooting/error-messages](https://docs.snowflake.com/en/user-guide/client-connectivity-troubleshooting/error-messages). Check your ssl and security configuration/firewall then retry                     |

***

## Supabase Errors:

| Error Message                                                                                                                                                                                                                                                              | Error Code | Root Cause                               | Fix                               |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- | :--------------------------------------- | :-------------------------------- |
| `Connection Pooler Required /Not Found`                                                                                                                                                                                                                                    | n/a        | Connection failed                        | Check username and password       |
| `Error initializing connector: ['Failed to initialize connector: {"error":"Error executing connector init code: connection to server at \"<URL>\" (<IP>), port 5432 failed: SSL connection has been closed unexpectedly\n","message":"Connector initialization failed"}']` | 5432       | Security: SSL certificate error          | SSL issue or database instability |
| `Error initializing connector: ['Failed to initialize connector: {"error":"Error executing connector init code: connection to server at \"<URL>o\" (<IP>), port 5432 failed: FATAL: password authentication failed for user`                                               | 5432       | PostgreSQL: Invalid username or password | Fix username or password          |

***

## MySQL Errors:

| Error Message                                                                                                                                                          | Error Code | Root Cause                                | Fix                                                                                            |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- | :---------------------------------------- | :--------------------------------------------------------------------------------------------- |
| `Streaming enable failed: HTTPSConnectionPool(host='premium-hub-X.spreadsheetsai.app', port=443): Read timed out. (read timeout=10)`                                   | n/a        | Network: cannot reach the database server | Verify host, port, and firewall settings, and ensure the database allows external connections. |
| `Connection timed out while trying to reach the service. Please check your host, port, and firewall settings, and ensure the service is accessible from your network.` | n/a        | Network: Cannot reach the database server | Verify host, port, and that the database allows external connections.                          |
| `Connection test failed. Please check your credentials and permissions.`                                                                                               | n/a        | Authentication or network failure         | Check username/password and verify database user permissions                                   |
