org.apache.hadoop.fs.azure

Class NativeAzureFileSystem

java.lang.Object

org.apache.hadoop.conf.Configured

org.apache.hadoop.fs.FileSystem

org.apache.hadoop.fs.azure.NativeAzureFileSystem

All Implemented Interfaces:

Closeable, AutoCloseable, Configurable

Direct Known Subclasses:

NativeAzureFileSystem.Secure

@InterfaceAudience.Public
 @InterfaceStability.Stable
public class NativeAzureFileSystem
extends FileSystem

A FileSystem for reading and writing files stored on Windows Azure. This implementation is blob-based and stores files on Azure in their native form so they can be read by other Azure tools.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NativeAzureFileSystem.FolderRenamePending A description of a folder rename operation, including the source and destination keys, and descriptions of the files in the source folder.
static class	NativeAzureFileSystem.Secure A FileSystem for reading and writing files stored on Windows Azure.

Nested classes/interfaces inherited from class org.apache.hadoop.fs.FileSystem

FileSystem.Statistics

Field Summary

Fields

Modifier and Type	Field and Description
static org.apache.commons.logging.Log	LOG
static String	SKIP_AZURE_METRICS_PROPERTY_NAME

Fields inherited from class org.apache.hadoop.fs.FileSystem

DEFAULT_FS, FS_DEFAULT_NAME_KEY, SHUTDOWN_HOOK_PRIORITY, statistics

Constructor Summary

Constructors

Constructor and Description
NativeAzureFileSystem()
NativeAzureFileSystem(org.apache.hadoop.fs.azure.NativeFileSystemStore store)

Method Summary

Modifier and Type	Method and Description
SelfRenewingLease	acquireLease(Path path) Get a self-renewing lease on the specified file.
FSDataOutputStream	append(Path f, int bufferSize, Progressable progress) This optional operation is not yet supported.
protected void	checkPath(Path path)
void	close()
FSDataOutputStream	create(Path f, FsPermission permission, boolean overwrite, int bufferSize, short replication, long blockSize, Progressable progress)
FSDataOutputStream	createNonRecursive(Path f, boolean overwrite, int bufferSize, short replication, long blockSize, Progressable progress)
FSDataOutputStream	createNonRecursive(Path f, FsPermission permission, boolean overwrite, int bufferSize, short replication, long blockSize, Progressable progress)
FSDataOutputStream	createNonRecursive(Path f, FsPermission permission, EnumSet<CreateFlag> flags, int bufferSize, short replication, long blockSize, Progressable progress)
boolean	delete(Path path) Deprecated.
boolean	delete(Path f, boolean recursive)
boolean	delete(Path f, boolean recursive, boolean skipParentFolderLastModifidedTimeUpdate) Delete the specified file or folder.
void	deleteFilesWithDanglingTempData(Path root) Looks under the given root path for any blob that are left "dangling", meaning that they are place-holder blobs that we created while we upload the data to a temporary blob, but for some reason we crashed in the middle of the upload and left them there.
protected void	finalize()
BlockLocation[]	getFileBlockLocations(FileStatus file, long start, long len) Return an array containing hostnames, offset and size of portions of the given file.
FileStatus	getFileStatus(Path f)
AzureFileSystemInstrumentation	getInstrumentation() Gets the metrics source for this file system.
String	getScheme()
AzureNativeFileSystemStore	getStore() For unit test purposes, retrieves the AzureNativeFileSystemStore store backing this file system.
URI	getUri()
Path	getWorkingDirectory()
void	initialize(URI uri, Configuration conf)
FileStatus[]	listStatus(Path f) Retrieve the status of a given path if it is a file, or of all the contained files if it is a directory.
Path	makeAbsolute(Path path) Get the absolute version of the path (fully qualified).
boolean	mkdirs(Path f, FsPermission permission)
boolean	mkdirs(Path f, FsPermission permission, boolean noUmask)
static String	newMetricsSourceName() Creates a new metrics source name that's unique within this process.
FSDataInputStream	open(Path f, int bufferSize)
String	pathToKey(Path path) Convert the path to a key.
void	recoverFilesWithDanglingTempData(Path root, Path destination) Looks under the given root path for any blob that are left "dangling", meaning that they are place-holder blobs that we created while we upload the data to a temporary blob, but for some reason we crashed in the middle of the upload and left them there.
boolean	rename(Path src, Path dst)
void	setOwner(Path p, String username, String groupname)
void	setPermission(Path p, FsPermission permission)
void	setWorkingDirectory(Path newDir) Set the working directory to the given directory.

Methods inherited from class org.apache.hadoop.fs.FileSystem

access, addDelegationTokens, append, append, areSymlinksEnabled, cancelDeleteOnExit, canonicalizeUri, clearStatistics, closeAll, closeAllForUGI, completeLocalOutput, concat, copyFromLocalFile, copyFromLocalFile, copyFromLocalFile, copyFromLocalFile, copyToLocalFile, copyToLocalFile, copyToLocalFile, create, create, create, create, create, create, create, create, create, create, create, create, createNewFile, createSnapshot, createSnapshot, createSymlink, deleteOnExit, deleteSnapshot, enableSymlinks, exists, fixRelativePart, get, get, get, getAclStatus, getAllStatistics, getBlockSize, getCanonicalServiceName, getCanonicalUri, getChildFileSystems, getContentSummary, getDefaultBlockSize, getDefaultBlockSize, getDefaultPort, getDefaultReplication, getDefaultReplication, getDefaultUri, getDelegationToken, getFileBlockLocations, getFileChecksum, getFileChecksum, getFileLinkStatus, getFileSystemClass, getFSofPath, getHomeDirectory, getInitialWorkingDirectory, getLength, getLinkTarget, getLocal, getName, getNamed, getReplication, getServerDefaults, getServerDefaults, getStatistics, getStatistics, getStatus, getStatus, getUsed, getXAttr, getXAttrs, getXAttrs, globStatus, globStatus, isDirectory, isFile, listCorruptFileBlocks, listFiles, listLocatedStatus, listLocatedStatus, listStatus, listStatus, listStatus, listStatusIterator, listXAttrs, makeQualified, mkdirs, mkdirs, modifyAclEntries, moveFromLocalFile, moveFromLocalFile, moveToLocalFile, newInstance, newInstance, newInstance, newInstanceLocal, open, primitiveCreate, primitiveMkdir, primitiveMkdir, printStatistics, processDeleteOnExit, removeAcl, removeAclEntries, removeDefaultAcl, removeXAttr, rename, renameSnapshot, resolveLink, resolvePath, setAcl, setDefaultUri, setDefaultUri, setReplication, setTimes, setVerifyChecksum, setWriteChecksum, setXAttr, setXAttr, startLocalOutput, supportsSymlinks, truncate

Methods inherited from class org.apache.hadoop.conf.Configured

getConf, setConf

Methods inherited from class java.lang.Object

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

Field Detail

LOG

public static final org.apache.commons.logging.Log LOG

SKIP_AZURE_METRICS_PROPERTY_NAME

public static final String SKIP_AZURE_METRICS_PROPERTY_NAME

See Also:

Constant Field Values

Constructor Detail

NativeAzureFileSystem

public NativeAzureFileSystem()

NativeAzureFileSystem

public NativeAzureFileSystem(org.apache.hadoop.fs.azure.NativeFileSystemStore store)

Method Detail

getScheme

public String getScheme()

Overrides:

getScheme in class FileSystem

newMetricsSourceName

public static String newMetricsSourceName()

Creates a new metrics source name that's unique within this process.

checkPath

protected void checkPath(Path path)

Overrides:

checkPath in class FileSystem

initialize

public void initialize(URI uri,
                       Configuration conf)
                throws IOException,
                       IllegalArgumentException

Overrides:

initialize in class FileSystem

Throws:

IOException

IllegalArgumentException

pathToKey

public String pathToKey(Path path)

Convert the path to a key. By convention, any leading or trailing slash is removed, except for the special case of a single slash.

makeAbsolute

public Path makeAbsolute(Path path)

Get the absolute version of the path (fully qualified). This is public for testing purposes.

Parameters:

path -

Returns:

fully qualified path

getStore

public AzureNativeFileSystemStore getStore()

For unit test purposes, retrieves the AzureNativeFileSystemStore store backing this file system.

Returns:

The store object.

getInstrumentation

public AzureFileSystemInstrumentation getInstrumentation()

Gets the metrics source for this file system. This is mainly here for unit testing purposes.

Returns:

the metrics source.

append

public FSDataOutputStream append(Path f,
                                 int bufferSize,
                                 Progressable progress)
                          throws IOException

This optional operation is not yet supported.

Specified by:

append in class FileSystem

Throws:

IOException

create

public FSDataOutputStream create(Path f,
                                 FsPermission permission,
                                 boolean overwrite,
                                 int bufferSize,
                                 short replication,
                                 long blockSize,
                                 Progressable progress)
                          throws IOException

Specified by:

create in class FileSystem

Throws:

IOException

acquireLease

public SelfRenewingLease acquireLease(Path path)
                               throws AzureException

Get a self-renewing lease on the specified file.

Throws:

AzureException

createNonRecursive

public FSDataOutputStream createNonRecursive(Path f,
                                             FsPermission permission,
                                             boolean overwrite,
                                             int bufferSize,
                                             short replication,
                                             long blockSize,
                                             Progressable progress)
                                      throws IOException

Overrides:

createNonRecursive in class FileSystem

Throws:

IOException

createNonRecursive

public FSDataOutputStream createNonRecursive(Path f,
                                             FsPermission permission,
                                             EnumSet<CreateFlag> flags,
                                             int bufferSize,
                                             short replication,
                                             long blockSize,
                                             Progressable progress)
                                      throws IOException

Overrides:

createNonRecursive in class FileSystem

Throws:

IOException

createNonRecursive

public FSDataOutputStream createNonRecursive(Path f,
                                             boolean overwrite,
                                             int bufferSize,
                                             short replication,
                                             long blockSize,
                                             Progressable progress)
                                      throws IOException

Overrides:

createNonRecursive in class FileSystem

Throws:

IOException

delete

@Deprecated
public boolean delete(Path path)
                           throws IOException

Deprecated.

Overrides:

delete in class FileSystem

Throws:

IOException

delete

public boolean delete(Path f,
                      boolean recursive)
               throws IOException

Specified by:

delete in class FileSystem

Throws:

IOException

delete

public boolean delete(Path f,
                      boolean recursive,
                      boolean skipParentFolderLastModifidedTimeUpdate)
               throws IOException

Delete the specified file or folder. The parameter skipParentFolderLastModifidedTimeUpdate is used in the case of atomic folder rename redo. In that case, there is a lease on the parent folder, so (without reworking the code) modifying the parent folder update time will fail because of a conflict with the lease. Since we are going to delete the folder soon anyway so accurate modified time is not necessary, it's easier to just skip the modified time update.

Parameters:

f -

recursive -

skipParentFolderLastModifidedTimeUpdate - If true, don't update the folder last modified time.

Returns:

true if and only if the file is deleted

Throws:

IOException

getFileStatus

public FileStatus getFileStatus(Path f)
                         throws IOException

Specified by:

getFileStatus in class FileSystem

Throws:

IOException

getUri

public URI getUri()

Specified by:

getUri in class FileSystem

listStatus

public FileStatus[] listStatus(Path f)
                        throws IOException

Retrieve the status of a given path if it is a file, or of all the contained files if it is a directory.

Specified by:

listStatus in class FileSystem

Throws:

IOException

mkdirs

public boolean mkdirs(Path f,
                      FsPermission permission)
               throws IOException

Specified by:

mkdirs in class FileSystem

Throws:

IOException

mkdirs

public boolean mkdirs(Path f,
                      FsPermission permission,
                      boolean noUmask)
               throws IOException

Throws:

IOException

open

public FSDataInputStream open(Path f,
                              int bufferSize)
                       throws IOException

Specified by:

open in class FileSystem

Throws:

IOException

rename

public boolean rename(Path src,
                      Path dst)
               throws IOException

Specified by:

rename in class FileSystem

Throws:

IOException

getFileBlockLocations

public BlockLocation[] getFileBlockLocations(FileStatus file,
                                             long start,
                                             long len)
                                      throws IOException

Return an array containing hostnames, offset and size of portions of the given file. For WASB we'll just lie and give fake hosts to make sure we get many splits in MR jobs.

Overrides:

getFileBlockLocations in class FileSystem

Throws:

IOException

setWorkingDirectory

public void setWorkingDirectory(Path newDir)

Set the working directory to the given directory.

Specified by:

setWorkingDirectory in class FileSystem

getWorkingDirectory

public Path getWorkingDirectory()

Specified by:

getWorkingDirectory in class FileSystem

setPermission

public void setPermission(Path p,
                          FsPermission permission)
                   throws IOException

Overrides:

setPermission in class FileSystem

Throws:

IOException

setOwner

public void setOwner(Path p,
                     String username,
                     String groupname)
              throws IOException

Overrides:

setOwner in class FileSystem

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class FileSystem

Throws:

IOException

recoverFilesWithDanglingTempData

public void recoverFilesWithDanglingTempData(Path root,
                                             Path destination)
                                      throws IOException

Looks under the given root path for any blob that are left "dangling", meaning that they are place-holder blobs that we created while we upload the data to a temporary blob, but for some reason we crashed in the middle of the upload and left them there. If any are found, we move them to the destination given.

Parameters:

root - The root path to consider.

destination - The destination path to move any recovered files to.

Throws:

IOException

deleteFilesWithDanglingTempData

public void deleteFilesWithDanglingTempData(Path root)
                                     throws IOException

Looks under the given root path for any blob that are left "dangling", meaning that they are place-holder blobs that we created while we upload the data to a temporary blob, but for some reason we crashed in the middle of the upload and left them there. If any are found, we delete them.

Parameters:

root - The root path to consider.

Throws:

IOException

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable