{"record":{"id":"a1dc41c8bc1f5165","repo":"apache/dolphinscheduler","slug":"ssh-adhocdatasourceclient-is-not-supported","errorCode":null,"errorMessage":"SSH AdHocDataSourceClient is not supported","messagePattern":"SSH AdHocDataSourceClient is not supported","errorType":"exception","errorClass":"UnsupportedOperationException","httpStatus":null,"severity":"error","filePath":"dolphinscheduler-datasource-plugin/dolphinscheduler-datasource-ssh/src/main/java/org/apache/dolphinscheduler/plugin/datasource/ssh/SSHDataSourceChannel.java","lineNumber":30,"sourceCode":" * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\npackage org.apache.dolphinscheduler.plugin.datasource.ssh;\n\nimport org.apache.dolphinscheduler.spi.datasource.AdHocDataSourceClient;\nimport org.apache.dolphinscheduler.spi.datasource.BaseConnectionParam;\nimport org.apache.dolphinscheduler.spi.datasource.DataSourceChannel;\nimport org.apache.dolphinscheduler.spi.datasource.PooledDataSourceClient;\nimport org.apache.dolphinscheduler.spi.enums.DbType;\n\npublic class SSHDataSourceChannel implements DataSourceChannel {\n\n    @Override\n    public AdHocDataSourceClient createAdHocDataSourceClient(BaseConnectionParam baseConnectionParam, DbType dbType) {\n        throw new UnsupportedOperationException(\"SSH AdHocDataSourceClient is not supported\");\n    }\n\n    @Override\n    public PooledDataSourceClient createPooledDataSourceClient(BaseConnectionParam baseConnectionParam, DbType dbType) {\n        throw new UnsupportedOperationException(\"SSH PooledDataSourceClient is not supported\");\n    }\n}\n","sourceCodeStart":12,"sourceCodeEnd":38,"githubUrl":"https://github.com/apache/dolphinscheduler/blob/02eac45a1b6676e639fcbfb4be2243de5771b05d/dolphinscheduler-datasource-plugin/dolphinscheduler-datasource-ssh/src/main/java/org/apache/dolphinscheduler/plugin/datasource/ssh/SSHDataSourceChannel.java#L12-L38","documentation":"Hard unsupported-operation sentinel in SSHDataSourceChannel.createAdHocDataSourceClient: the SSH datasource is only a credential holder for SSH/remote-execution tasks and cannot produce an ad-hoc query client. Any attempt to run ad-hoc SQL against an SSH datasource reaches this unconditional throw.","triggerScenarios":"Thrown at dolphinscheduler-datasource-plugin/dolphinscheduler-datasource-ssh/src/main/java/org/apache/dolphinscheduler/plugin/datasource/ssh/SSHDataSourceChannel.java:30 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use SSH datasources only with task plugins that consume SSH channels (e.g. remote shell)","Use a SQL-capable datasource for ad-hoc query features","Implement AdHocDataSourceClient in SSHDataSourceChannel if support is required"],"exampleFix":null,"handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"02eac45a1b6676e639fcbfb4be2243de5771b05d","analyzedAt":"2026-09-06T17:43:00.555Z","contentChangedAt":"2026-09-06T17:43:00.555Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}