apache/dolphinscheduler · error · UnsupportedOperationException

SSH PooledDataSourceClient is not supported

Error message

SSH PooledDataSourceClient is not supported

What it means

Hard unsupported-operation sentinel in SSHDataSourceChannel.createPooledDataSourceClient: the SSH datasource has no pooled JDBC client implementation, so requesting a pooled client for an SSH datasource always throws. It is a deliberate capability boundary, not a configuration failure.

Source

Thrown at dolphinscheduler-datasource-plugin/dolphinscheduler-datasource-ssh/src/main/java/org/apache/dolphinscheduler/plugin/datasource/ssh/SSHDataSourceChannel.java:35

package org.apache.dolphinscheduler.plugin.datasource.ssh;

import org.apache.dolphinscheduler.spi.datasource.AdHocDataSourceClient;
import org.apache.dolphinscheduler.spi.datasource.BaseConnectionParam;
import org.apache.dolphinscheduler.spi.datasource.DataSourceChannel;
import org.apache.dolphinscheduler.spi.datasource.PooledDataSourceClient;
import org.apache.dolphinscheduler.spi.enums.DbType;

public class SSHDataSourceChannel implements DataSourceChannel {

    @Override
    public AdHocDataSourceClient createAdHocDataSourceClient(BaseConnectionParam baseConnectionParam, DbType dbType) {
        throw new UnsupportedOperationException("SSH AdHocDataSourceClient is not supported");
    }

    @Override
    public PooledDataSourceClient createPooledDataSourceClient(BaseConnectionParam baseConnectionParam, DbType dbType) {
        throw new UnsupportedOperationException("SSH PooledDataSourceClient is not supported");
    }
}

View on GitHub (pinned to 02eac45a1b)

Solutions

1. Avoid connection-pool flows against SSH datasources; they are only for SSH task credentials
2. Choose a JDBC datasource type for pooled connections
3. Implement PooledDataSourceClient in SSHDataSourceChannel to lift the restriction

When it happens

Trigger: Thrown at dolphinscheduler-datasource-plugin/dolphinscheduler-datasource-ssh/src/main/java/org/apache/dolphinscheduler/plugin/datasource/ssh/SSHDataSourceChannel.java:35 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/dolphinscheduler@02eac45a1b (2026-09-06). Data as JSON: /api/errors/c5fa07e5f5550ac0. Report an issue: GitHub.