实例解析：HDFS实体间IPC接口和stream接口之间的配合

问题导读：
1.getBlockLocations的作用是什么？
2.5个HDFS流程是如何体现HDFS实体间IPC接口和stream接口之间配合的？






本文主要介绍5个典型的HDFS流程，这些流程充分体现了HDFS实体间IPC接口和stream接口之间的配合。


1. Client和NN      Client到NN有大量的元数据操作，比如修改文件名，在给定目录下创建一个子目录，这些操作一般只涉及Client和NN的交互，通过IPC调用ClientProtocol进行。创建子目录的逻辑流程如下图：




      从图中可见，创建子目录这种操作并没有涉及DN。因为元数据会被NN持久化到edits中，因此在持久化结束之后，这个调用就会被成功返回。复习一下：NN维护了HDFS的文件系统目录树和文件与数据块的对应关系，和数据块与DN的对应关系。因此，创建目录仅仅是在NN上也就很容易理解了。
     一些更为复杂的操作，如使用

DistributedFileSystem.setReplication()
复制代码

来增加文件的副本数，再如通过

DistributedFileSystem.delete()
复制代码

来删除HDFS上的文件，都需要DN配合执行一些动作。其中DistributedFileSystem源码在hadoop-hdfs-project\hadoop-hdfs\src\main\java\org\apache\hadoop\hdfs\DistributedFileSystem.java

/****************************************************************
 * Implementation of the abstract FileSystem for the DFS system.
 * This object is the way end-user code interacts with a Hadoop
 * DistributedFileSystem.
 *
 *****************************************************************/
@InterfaceAudience.LimitedPrivate({ "MapReduce", "HBase" })
@InterfaceStability.Unstable
public class DistributedFileSystem extends FileSystem {
  private Path workingDir;
  private URI uri;

  DFSClient dfs;
  private boolean verifyChecksum = true;
  
  static{
    HdfsConfiguration.init();
  }
复制代码

以客户端删除HDFS文件为例，操作在NN上执行完成后，DN存放的文件内容的数据块也必须删除。但是，NN在执行delete()方法时，它只标记需要删除的数据块（当然，delete的操作日志也会被持久化），而不会主动联系DN去立即删除这些数据。当保存着这些数据块的DN在向NN发送心跳时，NN会通过心跳应答携带DatanodeCommand命令来通知DN删除数据。也就是说，被删除的数据块在Client接到成功的响应后，会在一段时间后才能真正删除，NN和DN永远只维护简单的主从关系。NN永远不会主动发起向DN的调用。NN只能通过DN心跳应答中携带DatanodeCommand的指令对DN进行管理。






2. Client读文件     使用Java API读取文件的源码如下：

FileSystem hdfs = FileSystem.get(new Configuration());
Path path = new Path("/testfile");// reading
FSDataInputStream dis = hdfs.open(path);
byte[] writeBuf = new byte[1024];
int len = dis.read(writeBuf);
System.out.println(new String(writeBuf, 0, len, "UTF-8"));
dis.close();

hdfs.close();
复制代码

   下图显示了HDFS在读取文件时，Client，NN和DN发生的事件和这些事件的顺序：





步骤1的源码：

public FSDataInputStream open(Path f, final int bufferSize)
      throws IOException {
    statistics.incrementReadOps(1);
    Path absF = fixRelativePart(f);
    return new FileSystemLinkResolver<FSDataInputStream>() {
      @Override
      public FSDataInputStream doCall(final Path p)
          throws IOException, UnresolvedLinkException {
        return new HdfsDataInputStream(
            dfs.open(getPathName(p), bufferSize, verifyChecksum));
      }
      @Override
      public FSDataInputStream next(final FileSystem fs, final Path p)
          throws IOException {
        return fs.open(p, bufferSize);
      }
    }.resolve(this, absF);
  }
复制代码

可见open返回的是HdfsDataInputStream。dfs为hadoop-hdfs-project\hadoop-hdfs\src\main\java\org\apache\hadoop\hdfs\DFSClient.java。HdfsDataInputStream继承自FSDataInputStream。构造是并没有额外的处理。

public class HdfsDataInputStream extends FSDataInputStream {
  public HdfsDataInputStream(DFSInputStream in) throws IOException {
    super(in);
  }
复制代码

FSDataInputStream继承自DFSInputStream。

DFSInputStream(DFSClient dfsClient, String src, int buffersize, boolean verifyChecksum
                 ) throws IOException, UnresolvedLinkException {
    this.dfsClient = dfsClient;
    this.verifyChecksum = verifyChecksum;
    this.buffersize = buffersize;
    this.src = src;
    this.cachingStrategy =
        dfsClient.getDefaultReadCachingStrategy();
    openInfo();
  }

  /**
   * Grab the open-file info from namenode
   */
  synchronized void openInfo() throws IOException, UnresolvedLinkException {
    lastBlockBeingWrittenLength = fetchLocatedBlocksAndGetLastBlockLength();
    int retriesForLastBlockLength = dfsClient.getConf().retryTimesForGetLastBlockLength;
    while (retriesForLastBlockLength > 0) {
      // Getting last block length as -1 is a special case. When cluster
      // restarts, DNs may not report immediately. At this time partial block
      // locations will not be available with NN for getting the length. Lets
      // retry for 3 times to get the length.
      if (lastBlockBeingWrittenLength == -1) {
        DFSClient.LOG.warn("Last block locations not available. "
            + "Datanodes might not have reported blocks completely."
            + " Will retry for " + retriesForLastBlockLength + " times");
        waitFor(dfsClient.getConf().retryIntervalForGetLastBlockLength);
        lastBlockBeingWrittenLength = fetchLocatedBlocksAndGetLastBlockLength();
      } else {
        break;
      }
      retriesForLastBlockLength--;
    }
    if (retriesForLastBlockLength == 0) {
      throw new IOException("Could not obtain the last block locations.");
    }
  }
复制代码

fetchLocatedBlocksAndGetLastBlockLength通过调用getLocatedBlocks实现了示意图中的步骤二：

  private long fetchLocatedBlocksAndGetLastBlockLength() throws IOException {
    final LocatedBlocks newInfo = dfsClient.getLocatedBlocks(src, 0);
    if (DFSClient.LOG.isDebugEnabled()) {
      DFSClient.LOG.debug("newInfo = " + newInfo);
    }
    if (newInfo == null) {
      throw new IOException("Cannot open filename " + src);
    }

    if (locatedBlocks != null) {
      Iterator<LocatedBlock> oldIter = locatedBlocks.getLocatedBlocks().iterator();
      Iterator<LocatedBlock> newIter = newInfo.getLocatedBlocks().iterator();
      while (oldIter.hasNext() && newIter.hasNext()) {
        if (! oldIter.next().getBlock().equals(newIter.next().getBlock())) {
          throw new IOException("Blocklist for " + src + " has changed!");
        }
      }
    }
    locatedBlocks = newInfo;
    long lastBlockBeingWrittenLength = 0;
    if (!locatedBlocks.isLastBlockComplete()) {
      final LocatedBlock last = locatedBlocks.getLastLocatedBlock();
      if (last != null) {
        if (last.getLocations().length == 0) {
          if (last.getBlockSize() == 0) {
            // if the length is zero, then no data has been written to
            // datanode. So no need to wait for the locations.
            return 0;
          }
          return -1;
        }
        final long len = readBlockLength(last);
        last.getBlock().setNumBytes(len);
        lastBlockBeingWrittenLength = len; 
      }
    }

    currentNode = null;
    return lastBlockBeingWrittenLength;
  }
复制代码

你可能会说步骤二调用的是getBlockLocations。看以下的代码：

@VisibleForTesting
  public LocatedBlocks getLocatedBlocks(String src, long start, long length)
      throws IOException {
    return callGetBlockLocations(namenode, src, start, length);
  }

  /**
   * @see ClientProtocol#getBlockLocations(String, long, long)
   */
  static LocatedBlocks callGetBlockLocations(ClientProtocol namenode,
      String src, long start, long length) 
      throws IOException {
    try {
      return namenode.getBlockLocations(src, start, length);
    } catch(RemoteException re) {
      throw re.unwrapRemoteException(AccessControlException.class,
                                     FileNotFoundException.class,
                                     UnresolvedPathException.class);
    }
  }
复制代码

  然后就可以开始读文件的数据了。通过NameNode.getBlockLocations的远程调用接口获得了文件开始部分的数据块的保存位置。对于文件中的每个块，NN返回保存着该副本的DN的地址。注意，这些DN根据它们与Client的距离进行了简单的排序（利用了网络的拓扑信息）。


      Client调用HdfsDataInputStream的read方法读取文件数据时，DFSInputStream对象会通过和DN间的读数据stream接口，和最近的DN建立连接。Client反复调用read方法，数据会通过DN和Client的连接上的数据包返回Client。当到达块的末端时，DFSInputStream会关闭和DN的连接。并通过getBlockLocations()远程方法获得保存着下一个数据块的DN信息，严格来说，在对象没有缓存该数据块的位置时，才会使用这个远程方法。这就是上图中的步骤五。然后重复上述过程。

      另外，由于NameNode.getBlockLocations()不会一次返回文件的所有的数据块信息，DFSInputStream可能需要多次调用该远程方法，检索下一组数据块的位置信息。对于使用者来说，它读取的是一个连续的数据流，上面所讲的联系不同的DN，多次定位数据块的过程，都是透明的。当使用者完成数据读取任务后，通过FSDataInputStream.close()关系数据流。即图中的步骤六。

     如果DN发生了错误，如节点停机或者网络出现故障，那么Client会尝试连接下一个Block的位置。同时它会记住出现故障的那个DN，不会再进行徒劳的尝试。在数据的应答中，不单包含了数据，还包含了数据的校验和，Client会检查数据的一致性，如果发现了校验错误，它会将这个信息报告给NN；同时，尝试从别的DN读取另外一个副本的内容。由Client在读取数据时进行数据完整性检查，可以降低DN的负载，均衡各个节点的计算能力。
     这样的设计其实可以给我们一个很好的设计大型分布式系统的例子。通过一些有效的设计，将计算和网络等分散到各个节点上，这样可以最大程度的保证scalability。


3. Client写文件  
即使不考虑出现错误的情况，写文件也是HDFS最复杂的流程。本节通过创建一个新文件并向文件写入数据，结束后关闭这个文件为例，分析文件写入时各个节点之间的配合。




      Client调用DistributedFileSystem.create()创建文件（上图中的步骤一），这时DistributedFileSystem创建了DFSOutputStream，并由RPC，让NN执行同名的方法，在文件系统的命名空间创建一个新文件。NN创建新文件时，需要执行检查，包括NN是否处理正常工作状态，被创建的文件不存在，Client是否有在父目录中创建文件的权限等。通过检查后，NN会构建一个新文件，记录创建操作到编辑日志edits中。RPC结束后，DistributedFileSystem将该DFSOutputStream对象包装到FSDataOutputStream实例中，返回Client。

 @Override
  public FSDataOutputStream create(final Path f, final FsPermission permission,
    final EnumSet<CreateFlag> cflags, final int bufferSize,
    final short replication, final long blockSize, final Progressable progress,
    final ChecksumOpt checksumOpt) throws IOException {
    statistics.incrementWriteOps(1);
    Path absF = fixRelativePart(f);
    return new FileSystemLinkResolver<FSDataOutputStream>() {
      @Override
      public FSDataOutputStream doCall(final Path p)
          throws IOException, UnresolvedLinkException {
        return new HdfsDataOutputStream(dfs.create(getPathName(p), permission,
            cflags, replication, blockSize, progress, bufferSize, checksumOpt),
            statistics);
      }
      @Override
      public FSDataOutputStream next(final FileSystem fs, final Path p)
          throws IOException {
        return fs.create(p, permission, cflags, bufferSize,
            replication, blockSize, progress, checksumOpt);
      }
    }.resolve(this, absF);
  }
复制代码

关键的调用点有DFSClient.create:

 /**
   * Same as {@link #create(String, FsPermission, EnumSet, boolean, short, long,
   * Progressable, int, ChecksumOpt)} with the addition of favoredNodes that is
   * a hint to where the namenode should place the file blocks.
   * The favored nodes hint is not persisted in HDFS. Hence it may be honored
   * at the creation time only. HDFS could move the blocks during balancing or
   * replication, to move the blocks from favored nodes. A value of null means
   * no favored nodes for this create
   */
  public DFSOutputStream create(String src, 
                             FsPermission permission,
                             EnumSet<CreateFlag> flag, 
                             boolean createParent,
                             short replication,
                             long blockSize,
                             Progressable progress,
                             int buffersize,
                             ChecksumOpt checksumOpt,
                             InetSocketAddress[] favoredNodes) throws IOException {
    checkOpen();
    if (permission == null) {
      permission = FsPermission.getFileDefault();
    }
    FsPermission masked = permission.applyUMask(dfsClientConf.uMask);
    if(LOG.isDebugEnabled()) {
      LOG.debug(src + ": masked=" + masked);
    }
    String[] favoredNodeStrs = null;
    if (favoredNodes != null) {
      favoredNodeStrs = new String[favoredNodes.length];
      for (int i = 0; i < favoredNodes.length; i++) {
        favoredNodeStrs[i] = 
            favoredNodes[i].getHostName() + ":" 
                         + favoredNodes[i].getPort();
      }
    }
    final DFSOutputStream result = DFSOutputStream.newStreamForCreate(this,
        src, masked, flag, createParent, replication, blockSize, progress,
        buffersize, dfsClientConf.createChecksum(checksumOpt), favoredNodeStrs);
    beginFileLease(src, result);
    return result;
  }
复制代码

在步骤三Client写入数据时，由于create()调用创建了一个空文件，所以，DFSOutputStream实例首先需要想NN申请数据块，addBlock()方法成功执行后，返回一个LocatedBlock对象。该对象包含了新数据块的数据块标识和版本好，同时，它的成员变量locs提供了数据流管道的信息，通过上述信息，DFSOutputStream就可以和DN连接，通过些数据接口建立数据流管道。Client写入FSDataOutputStream流中的数据，被分成一个一个的文件包，放入DFSOutputStream对象的内部队列。该队列中的文件包最后打包成数据包，发往数据流管道，流经管道上的各个DN，并持久化，确认包逆流而上，从数据流管道依次发往Client，当Client收到应答时，它将对应的包从内部队列删除。

public class LocatedBlock {

  private ExtendedBlock b;
  private long offset;  // offset of the first byte of the block in the file
  private DatanodeInfo[] locs;
  /** Storage ID for each replica */
  private String[] storageIDs;
  // Storage type for each replica, if reported.
  private StorageType[] storageTypes;
  // corrupt flag is true if all of the replicas of a block are corrupt.
  // else false. If block has few corrupt replicas, they are filtered and 
  // their locations are not part of this object
  private boolean corrupt;
  private Token<BlockTokenIdentifier> blockToken = new Token<BlockTokenIdentifier>();
  /**
   * List of cached datanode locations
   */
  private DatanodeInfo[] cachedLocs;

  // Used when there are no locations
  private static final DatanodeInfo[] EMPTY_LOCS = new DatanodeInfo[0];
复制代码

DFSOutputStream在写完一个数据块后，数据流管道上的节点，会通过和NN的DatanodeProtocol远程接口的blockReceived()方法，向NN提交数据块。如果数据队列还有等到输出的数据，DFSOutputStream会再次调用addBlock()，为文件添加新的数据块。
     Client完成数据的写入后，会调用close()方法关闭流，关闭流意味着Client不会再向流中写入数据。所以，当DFSOutputStream数据队列的文件包都收到应答后，就可以使用ClientProtocol.complete()方法通知NN关闭文件，完成一次正常的文件写入。
     如果在文件写入期间DN发生故障，则会执行下面的操作（注意，这些操作对于写入数据的Client是透明的）：

• 数据流管道会被关闭，已经发送到管道但是还没有收到确认的文件包，会被重新添加到DFSOutputStream的输出队列，这样就保证了无路数据流管道的哪个DN发生故障，都不会丢失数据。当前正常工作的DN的数据块会被赋予一个新的版本号，并通知NN。这样，失败的DN在从故障恢复过来以后，上面只有部分数据的Block会因为版本号和NN保存的版本号不匹配而被删除。
• 在数据流管道中删除错误的DN并建立新的管道，继续写数据到正常工作的DN。
• 文件关闭后，NN会发现该Block的副本数没有达到要求，会选择一个新的DN并复制Block，创建新的副本。DN的故障只会影响一个Block的写操作，后续Block的写入不会受到影响。
  

4. DataNode的启动与心跳机制      

本节讨论DN的启动及其与NN之间的交互。包括DN从启动到进入正常工作状态的注册，Block上报，以及正常工作过程中的心跳等与NN相关的远程调用。这部分虽然只涉及DatanodeProtocol的接口，但是有助于进一步理解DN与NN的关系。
      正常启动的DN或者为升级而启动的DN，都会向NN发送远程调用versionRequest()，进行必要的版本检查。这里的版本检查，只涉及构建版本号，保证它们间的HDFS版本是一致的。




     在版本检查结束后，DN会接着通过远程调用register()，向NN注册。DatanodeProtocol.register()的主要工作也是检查，确认该DN是NN所管理集群的成员。也就是说，用户不能把某一个集群中的某个node直接注册到另外一个集群中去，保证了整个系统的数据一致性。
     注册成功后，DN会将它所管理的所有Block的信息，通过blockRequest()方法上报到NN（步骤三），以帮助NN建立HDFS文件数据块到DN的映射关系。在此后，DN才正式的提供服务。
　由于NN和DN是简单的主从关系，DN需要每隔一段时间发送心跳到NN（步骤四和步骤五）。如果NN长时间收不到DN的心跳，它会认为DN已经失效。如果NN需要一些DN需要配合的动作，则会通过sendHeartbeat()的方法返回。该返回值是一个DatanodeCommand数组，它是NN的指令。
     应该说，DN和NN的交互逻辑非常简单。大部分是通过DN到NN的心跳来完成的。但是考虑到一定规模的HDFS集群，一个NN会管理上千个DN，这样的设计也就非常自然了。


5. SNN节点的元数据合并      

当Client对HDFS的文件目录进行修改时，NN都会在edits中留下记录，以保证在系统出现问题时，通过日志可以进行恢复。

    fsimage是某一个时刻的检查点（checkpoint）。由于fsimage很大，因此不会在每次的元数据修改都写入到它里边，而只是存在到edits中。在系统启动时，会首先状态最近时刻的fsimage，然后在通过edits，恢复系统的最新状态。

    当时如果edits太大，那么节点启动时将用很长的时间来执行日志的每一个操作，使得系统恢复最近的状态。在启动恢复的这段时间，服务是不可用的。为了避免edits多大，增加集群的可用时间，HDFS引入了第二名字节点，即SNN（Secondary　NameNode）。SNN不是NN的standby，它只是辅助NN完成合并（merge）fsimage和edits。过程涉及NamenodeProtocol和NN与SNN之间的流式接口。




    该过程由SNN发起，首先通过远程方法NamenodeProtocol.getEditLogSize()获得NN上edits的大小。如果日志很小，SNN就会在指定的时间后重新检查。否则，继续通过远程接口rollEditLog()，启动一次检查点的过程。这时，NN需要创建一个新的编辑日志edits.new，后续对元数据的改动，都会记录到这个新日志中。而原有的fsimage和edits，会由SNN通过HTTP下载到本地（步骤三和步骤四），在内存中进行merge。合并的结果就是fsimage.ckpt。然后SNN通过HTTP接口通知NN fsimage已经准备好。NN会通过HTTP get获取merge好的fsimage。在NN下载完成后，SNN会通过NamenodeProtocol.rollFsImage()，完成这次检查点。NN在处理这个远程方法时，会用fsimage.ckpt 覆盖原来的fsimage，并且将新的edits.new改名为edit。




转载自：http://blog.csdn.net/lhb19891029/article/details/24475829