apache/hadoop · error · UnsupportedOperationException

The target file system " + tgtFs.getScheme() + " does not su

Error message

The target file system " + tgtFs.getScheme() + " does not support snapshot.

What it means

Error "The target file system " + tgtFs.getScheme() + " does not support snapshot." thrown in apache/hadoop.

Source

Thrown at hadoop-tools/hadoop-distcp/src/main/java/org/apache/hadoop/tools/DistCpSync.java:169

    }

    return true;
  }

  /**
   * Check if the source and target filesystems support snapshots.
   */
  private void checkFilesystemSupport(Path sourceDir, Path targetDir,
      FileSystem srcFs, FileSystem tgtFs) throws IOException {
    if (!srcFs.hasPathCapability(sourceDir,
        CommonPathCapabilities.FS_SNAPSHOTS)) {
      throw new UnsupportedOperationException(
          "The source file system " + srcFs.getScheme()
              + " does not support snapshot.");
    }
    if (!tgtFs.hasPathCapability(targetDir,
        CommonPathCapabilities.FS_SNAPSHOTS)) {
      throw new UnsupportedOperationException(
          "The target file system " + tgtFs.getScheme()
              + " does not support snapshot.");
    }
    try {
      getSnapshotDiffReportMethod(srcFs);
    } catch (NoSuchMethodException e) {
      throw new UnsupportedOperationException(
          "The source file system " + srcFs.getScheme()
              + " does not support getSnapshotDiffReport",
          e);
    }
    try {
      getSnapshotDiffReportMethod(tgtFs);
    } catch (NoSuchMethodException e) {
      throw new UnsupportedOperationException(
          "The target file system " + tgtFs.getScheme()
              + " does not support getSnapshotDiffReport",
          e);

View on GitHub (pinned to 2add963021)

Solutions

1. Enable snapshots on the target directory, or use a target filesystem supporting snapshots.
2. Run without -diff/-rdiff if the target cannot hold snapshots.

When it happens

Trigger: distcp sync targets a destination filesystem without snapshot support.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/hadoop@2add963021 (2026-08-22). Data as JSON: /api/errors/06385a35424e3db0. Report an issue: GitHub.