org.apache.hadoop.fs.s3a.s3guard

Class S3Guard

java.lang.Object

org.apache.hadoop.fs.s3a.s3guard.S3Guard

@InterfaceAudience.Private
 @InterfaceStability.Unstable
public final class S3Guard
extends Object

Logic for integrating MetadataStore with S3A. Most of the methods here were deleted when the S3Guard feature was removed.

Method Summary

Modifier and Type	Method and Description
static boolean	allowAuthoritative(org.apache.hadoop.fs.Path p, S3AFileSystem fs, Collection<String> authPaths) Is the path for the given FS instance authoritative?
static boolean	checkNoS3Guard(URI fsURI, org.apache.hadoop.conf.Configuration conf) Assert that the FS is not configured to use an unsupported S3Guard option.
static Collection<String>	getAuthoritativePaths(S3AFileSystem fs)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

checkNoS3Guard

public static boolean checkNoS3Guard(URI fsURI,
                                     org.apache.hadoop.conf.Configuration conf)
                              throws org.apache.hadoop.fs.PathIOException

Assert that the FS is not configured to use an unsupported S3Guard option. the empty/null option is preferred. if the local store or null store is requested, the configuration is allowed. request for a DynamoDB or other store class will raise an exception.

Parameters:

fsURI - FileSystem URI

conf - configuration

Returns:

true if an option was set but ignored

Throws:

org.apache.hadoop.fs.PathIOException - if an unsupported metastore was found.

getAuthoritativePaths

public static Collection<String> getAuthoritativePaths(S3AFileSystem fs)

allowAuthoritative

public static boolean allowAuthoritative(org.apache.hadoop.fs.Path p,
                                         S3AFileSystem fs,
                                         Collection<String> authPaths)

Is the path for the given FS instance authoritative?

Parameters:

p - path

fs - filesystem

authPaths - possibly empty list of authoritative paths

Returns:

true iff the path is authoritative