Skip to content


This article is designed to help you troubleshoot some of the typical errors that you may encounter while configuring and using destinations for Batch.

General troubleshooting steps for connection issues for pipeline creation

When facing connection failure after creating a pipeline, here are some troubleshooting actions you can take:

  • Check credentials: Ensure that the credentials used for the pipeline are correct. Verify that the username, password, access keys, or any other authentication details are accurate and have not expired or been revoked.
  • Review the network configuration: Confirm that the network configuration is properly set up. Check if the required ports (e.g., for database connections) are open, and any firewalls or security groups allow the necessary traffic.
  • Verify endpoint or URL: Double-check the endpoint or URL provided for the destination system. Make sure it is accurate and accessible. For example, in the case of a database, ensure that the hostname or IP address is correct.
  • Test connection outside the pipeline: Attempt to establish a connection manually from the same machine or network where the pipeline is running. Use the same credentials and network settings to verify if the connection can be established outside of the pipeline context. This can help identify any network or authentication issues.
  • Inspect error messages: Pay attention to any error messages or logs provided by the pipeline or the destination system. They may contain specific details about the connection failure, such as authentication errors or network timeouts. Analyzing these messages can provide valuable insights into the root cause of the problem.
  • Check system status and availability: Verify the status and availability of the destination system. For example, check if the database server or API service is running and accessible. Monitor any service status pages or announcements for any known issues or outages.
  • Contact support or consult documentation: If the issue persists and you have exhausted the available troubleshooting steps, reach out to the Support team of the pipeline provider or consult their documentation. They can offer further guidance and assistance based on their specific platform and integration.

Amazon Redshift

Redshift connection error

The I/O connection errors you are experiencing between Matillion and your Redshift cluster are likely due to timeout issues. When Matillion attempts to connect to your Redshift cluster for a connection check or data loading, if the connection remains idle for a longer duration, the server may close the connection, resulting in an I/O error.

Here are some steps you can take to address this issue:

  • Increase timeout settings: Review the timeout settings on both your Redshift cluster and the network components between Matillion and the Redshift cluster. You may need to increase the timeout values to allow for longer running queries or data loading processes. Consult the Redshift documentation for instructions on adjusting the timeout settings.
  • Optimize data loading: If the I/O errors occur during data loading operations, consider optimizing the data loading process to reduce the time required. This could involve breaking down larger data loads into smaller batches, improving data extraction or transformation processes, or utilizing Redshift's COPY command options for more efficient loading.
  • Enable TCP keep-alive: Enabling TCP keep-alive can help maintain the connection between Matillion and Redshift by periodically sending packets to keep the connection active. This can prevent idle connections from being closed due to inactivity. Review the Redshift documentation for instructions on enabling TCP keep-alive for your cluster.
  • Check network connectivity: Ensure that there are no network issues impacting the connection between Matillion and your Redshift cluster. Verify the network configuration, firewall settings, and any network devices (routers, load balancers) that may be interrupting or terminating connections prematurely.
  • Monitor query performance: Keep track of the query performance within Redshift and identify any long-running queries that could contribute to timeouts. Optimize those queries by adding appropriate indexes, redistributing data, or reevaluating the query structure.
  • Contact support: If the issue persists or you require further assistance, reach out to Matillion Support or AWS support for more specialized guidance on troubleshooting and resolving the I/O connection errors.

Insufficient table/schema privileges

When encountering insufficient table privileges in Matillion when connecting to Amazon Redshift, it is essential to ensure that the database user authorizing the connection has all the necessary privileges. The following steps can help address this issue:

  • Review Documentation: Refer to the Matillion documentation for Amazon Redshift setup to understand the required privileges for the database user. The documentation provides detailed information on the necessary permissions and privileges.
  • Check User Permissions: Verify that the database user used for the connection has the appropriate privileges. The user should have permissions to perform necessary actions such as creating tables, executing queries, and loading data into the Redshift cluster.
  • Grant Required Privileges: If the user lacks the necessary privileges, you can grant the required permissions to the user. To grant privileges, you need administrative access to the Redshift cluster or the appropriate privileges to modify user permissions.
    • Connect to your Redshift cluster using a tool that allows executing SQL queries (e.g., SQL Workbench/J, pgAdmin, AWS CLI).
    • Use the appropriate SQL command, such as GRANT, to grant the required privileges to the user. For example, you may need to grant SELECT, INSERT, UPDATE, DELETE, or CREATE privileges on specific tables or the entire schema.
  • Test the Connection: After granting the necessary privileges, attempt to establish the connection from Matillion to Amazon Redshift using the authorized user. Verify that the connection is successful and Matillion can perform the desired operations on the Redshift cluster.

By reviewing the Matillion documentation, checking and granting the required privileges to the database user, and testing the connection, you can ensure that the user has sufficient table privileges to work with Amazon Redshift through Matillion.

Pipeline failure due to connection timeout

When encountering a pipeline failure with a "Connection Timeout" error while using MDL with Amazon Redshift, the following suggested actions can help resolve the issue:

  • Verify instance availability: Check the status of your Amazon Redshift instance and start it if it is currently stopped or unavailable.
  • Configure cluster accessibility: Review the network configuration of your Amazon Redshift cluster. Ensure that the cluster is publicly accessible or configured to allow connections from the desired network sources.
  • Allow Matillion IP addresses: Read the documentation or support resources provided by Matillion to obtain the list of IP addresses used by the platform. Allow these IP addresses in your Amazon Redshift security group or network ACLs to allow the connection.

Connection fail

When encountering a "Connection fail" while creating pipeline in MDL, it's important to verify that the correct database is entered in the Destination Settings page. Here's how you can address this issue:

  • Verify the database name: Double-check the database name specified in the settings. Ensure that the database name matches the actual name of the database you want to connect to in your target system (e.g., Amazon Redshift, PostgreSQL, etc.).
  • Check for typos or case sensitivity: Pay attention to any typos or case sensitivity in the database name. Ensure that the name is entered exactly as it appears in your target system. Some databases are case-sensitive, so the capitalization of letters must match.
  • Confirm database existence: Validate that the database actually exists in your target system. Check the database management interface or command-line tools of your database system to ensure the specified database is present.
  • Test the connection: After verifying the database name, test the connection to confirm that MDL can successfully connect to the target system. Use the provided testing or connection validation features in MDL to ensure the connection is established without errors.

Delta Lake on Databricks loading errors

When encountering loading errors with Databricks Delta Lake as your destination in MDL, it's important to ensure that you're using an Amazon S3 bucket located in the same AWS region as your Hub account.