[HDFS-12202] Provide new set of FileSystem API to bypass external attribute provider

• Type: New Feature
• Status: Resolved
• Priority: Major
• Resolution: Won't Fix
• Component/s: hdfs, hdfs-client
• Assignee: Yongjun Zhang
• Reporter: Yongjun Zhang
• Created: 26/Jul/17 19:44
• Updated: 30/Aug/17 00:02
• Resolved: 16/Aug/17 06:59

Description

HDFS client uses

  /**
   * Return a file status object that represents the path.
   * @param f The path we want information from
   * @return a FileStatus object
   * @throws FileNotFoundException when the path does not exist
   * @throws IOException see specific implementation
   */
  public abstract FileStatus getFileStatus(Path f) throws IOException;

  /**
   * List the statuses of the files/directories in the given path if the path is
   * a directory.
   * <p>
   * Does not guarantee to return the List of files/directories status in a
   * sorted order.
   * <p>
   * Will not return null. Expect IOException upon access error.
   * @param f given path
   * @return the statuses of the files/directories in the given patch
   * @throws FileNotFoundException when the path does not exist
   * @throws IOException see specific implementation
   */
  public abstract FileStatus[] listStatus(Path f) throws FileNotFoundException,
                                                         IOException;

to get FileStatus of files.

When external attribute provider (INodeAttributeProvider) is enabled for a cluster, the external attribute provider is consulted to get back some relevant info (including ACL, group etc) and returned back in FileStatus,

There is a problem here, when we use distcp to copy files from srcCluster to tgtCluster, if srcCluster has external attribute provider enabled, the data we copied would contain data from attribute provider, which we may not want.

Create this jira to add a new set of interface for distcp to use, so that distcp can copy HDFS data only and bypass external attribute provider data.

The new set API would look like

 /**
   * Return a file status object that represents the path.
   * @param f The path we want information from
   * @param bypassExtAttrProvider if true, bypass external attr provider
   *        when it's in use.
   * @return a FileStatus object
   * @throws FileNotFoundException when the path does not exist
   * @throws IOException see specific implementation
   */
  public FileStatus getFileStatus(Path f,
      final boolean bypassExtAttrProvider) throws IOException;

  /**
   * List the statuses of the files/directories in the given path if the path is
   * a directory.
   * <p>
   * Does not guarantee to return the List of files/directories status in a
   * sorted order.
   * <p>
   * Will not return null. Expect IOException upon access error.
   * @param f
   * @param bypassExtAttrProvider if true, bypass external attr provider
   *        when it's in use.
   * @return
   * @throws FileNotFoundException
   * @throws IOException
   */
  public FileStatus[] listStatus(Path f,
      final boolean bypassExtAttrProvider) throws FileNotFoundException,
                                                  IOException;

So when bypassExtAttrProvider is true, external attribute provider will be bypassed.

Thanks.

Issue Links

• relates to: HDFS-12357 Let NameNode to bypass external attribute provider for special user
• relates to: HDFS-12294 Let distcp to bypass external attribute provider when calling getFileStatus etc at source cluster