Area: Ingestion
Sub-Area: Snowflake
Issue
Snowflake connector encounters authentication failures, connection timeouts, or configuration errors. This is commonly related to deprecated authentication methods, incorrect credentials, or network connectivity issues.
Common Error Messages:
Authentication type PASSWORD is deprecated and will be removed
Solution
Note: For DataHub Cloud customers, infrastructure-level changes (Kubernetes, AWS resources, operating system configurations) are managed by DataHub Support. The solutions below focus on configuration changes that customers can implement.
- Update authentication method:
- Snowflake is deprecating username/password authentication
- Switch to key-pair authentication or OAuth:
source:
type: snowflake
config:
account_id: "your_account"
warehouse: "your_warehouse"
username: "your_username"
authentication_type: "KEY_PAIR_AUTHENTICATOR"
private_key_path: "/path/to/private_key.p8"
private_key_password: "${SNOWFLAKE_PRIVATE_KEY_PASSWORD}"
- Verify Snowflake permissions:
- Ensure the service account has usage permissions on the warehouse
- Grant access to ACCOUNT_USAGE schema for metadata extraction:
GRANT IMPORTED PRIVILEGES ON DATABASE snowflake TO ROLE datahub_role;
Check network connectivity:
- Verify the Snowflake account URL is correct
- Confirm firewall rules allow outbound HTTPS connections to Snowflake
- Test connectivity using SnowSQL or another Snowflake client
Review connection parameters:
- Ensure
account_idincludes region and cloud provider if needed (e.g.,account_name.region.cloud) - Verify warehouse name is correct and the service account can use it
- Check role configuration if using role-based access control
- Ensure
Additional Notes
Always backup your DataHub configuration before making changes. Test solutions in a non-production environment when possible.
Related Documentation
Related Tickets
- 5720, 5839, 5809, 5674, 5583, 4963, 5899, 5732
Tags:
snowflake, connector, troubleshooting