apache/hadoop · error · UnsupportedOperationException

OutputDataStream is not implemented for ProvidedReplica

Error message

OutputDataStream is not implemented for ProvidedReplica

What it means

Error "OutputDataStream is not implemented for ProvidedReplica" thrown in apache/hadoop.

Source

Thrown at hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/datanode/ProvidedReplica.java:208

        } else {
          ins = remoteFS.open(new Path(getRemoteURI()));
        }
      } catch (UnsupportedOperationException e) {
        throw new IOException("PathHandle specified, but unsuported", e);
      }

      ins.seek(fileOffset + seekOffset);
      return new BoundedInputStream(
          new FSDataInputStream(ins), getBlockDataLength());
    } else {
      throw new IOException("Remote filesystem for provided replica " + this +
          " does not exist");
    }
  }

  @Override
  public OutputStream getDataOutputStream(boolean append) throws IOException {
    throw new UnsupportedOperationException(
        "OutputDataStream is not implemented for ProvidedReplica");
  }

  @Override
  public URI getMetadataURI() {
    return null;
  }

  @Override
  public OutputStream getMetadataOutputStream(boolean append)
      throws IOException {
    return null;
  }

  @Override
  public boolean blockDataExists() {
    if(remoteFS != null) {
      try {

View on GitHub (pinned to 2add963021)

Solutions

1. Do not open output streams on provided replicas; provided storage is read-only in HDFS.
2. Write data through normal HDFS blocks instead of the provided storage mount.

When it happens

Trigger: Code attempts to obtain an OutputDataStream for a ProvidedReplica, which is read-only.

Common situations: A write stream was requested for a read-only provided replica. Provided storage does not support writes; write to HDFS-managed storage instead.

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