apache/dolphinscheduler · error · UnsupportedOperationException

Zeppelin AdHocDataSourceClient is not supported

Error message

Zeppelin AdHocDataSourceClient is not supported

What it means

Hard unsupported-operation sentinel in ZeppelinDataSourceChannel.createAdHocDataSourceClient: the Zeppelin datasource stores the Zeppelin REST endpoint credentials for the Zeppelin task plugin and deliberately provides no ad-hoc JDBC query client, so any ad-hoc query path over a Zeppelin datasource always throws.

Source

Thrown at dolphinscheduler-datasource-plugin/dolphinscheduler-datasource-zeppelin/src/main/java/org/apache/dolphinscheduler/plugin/datasource/zeppelin/ZeppelinDataSourceChannel.java:30

 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

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

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 ZeppelinDataSourceChannel implements DataSourceChannel {

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

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

View on GitHub (pinned to 02eac45a1b)

Solutions

1. Use Zeppelin datasources only with the Zeppelin task plugin
2. Use a SQL datasource (MySQL, Hive, etc.) for ad-hoc query features
3. Implement AdHocDataSourceClient in ZeppelinDataSourceChannel to add support

When it happens

Trigger: Thrown at dolphinscheduler-datasource-plugin/dolphinscheduler-datasource-zeppelin/src/main/java/org/apache/dolphinscheduler/plugin/datasource/zeppelin/ZeppelinDataSourceChannel.java:30 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/b8c980d4198b7daa. Report an issue: GitHub.