Known issues with Azure Data Lake Storage Gen2

This article lists the features and tools that are not yet supported or only partially supported with storage accounts that have a hierarchical namespace (Azure Data Lake Storage Gen2).

Issues and limitations with using Blob APIs

Blob APIs and Data Lake Storage Gen2 APIs can operate on the same data.

This section describes issues and limitations with using blob APIs and Data Lake Storage Gen2 APIs to operate on the same data.

  • You can't use both Blob APIs and Data Lake Storage APIs to write to the same instance of a file. If you write to a file by using Data Lake Storage Gen2 APIs, then that file's blocks won't be visible to calls to the Get Block List blob API. You can overwrite a file by using either Data Lake Storage Gen2 APIs or Blob APIs. This won't affect file properties.

  • When you use the List Blobs operation without specifying a delimiter, the results will include both directories and blobs. If you choose to use a delimiter, use only a forward slash (/). This is the only supported delimiter.

  • If you use the Delete Blob API to delete a directory, that directory will be deleted only if it's empty. This means that you can't use the Blob API delete directories recursively.

These Blob REST APIs aren't supported:

Unmanaged VM disks are not supported in accounts that have a hierarchical namespace. If you want to enable a hierarchical namespace on a storage account, place unmanaged VM disks into a storage account that doesn't have the hierarchical namespace feature enabled.

Filesystem Support in SDKs

  • .NET, Java and Python are in public preview. Other SDKs are not currently supported.
  • Get and Set ACLs operations are not currently recursive.

Filesystem Support in PowerShell and Azure CLI

Get and Set ACLs operations are not currently recursive.

Support for other Blob Storage features

The following table lists all other features and tools that are not yet supported or only partially supported with storage accounts that have a hierarchical namespace (Azure Data Lake Storage Gen2).

Feature / Tool More information
AzCopy Version-specific support

Use only the latest version of AzCopy (AzCopy v10). Earlier versions of AzCopy such as AzCopy v8.1, are not supported.
Azure Blob Storage lifecycle management policies Lifecycle management policies are supported (Preview). All access tiers are supported. The archive access tier is currently in preview. The deletion of blob snapshots is not yet supported.

There are currently some bugs affecting lifecycle management policies and the archive access tier. Sign up for the preview of lifecycle management policies and archive access tier here.
Azure Content Delivery Network (CDN) Not yet supported
Azure search Supported (Preview)
Azure Storage Explorer Version-specific support.

Use only versions 1.6.0 or higher.
There is currently a storage bug affecting version 1.11.0 that can result in authentication errors in certain scenarios. A fix for the storage bug is being rolled out, but as a workaround, we recommend that you use version 1.10.x which is available as a free download. 1.10.x is not affected by the storage bug.
Blob container ACLs Not yet supported
Blobfuse Not yet supported
Custom domains Not yet supported
Storage Explorer in the Azure portal Limited support. ACLs are not yet supported.
Diagnostic logging Diagnostic logs are supported (Preview).

Enabling logs in the Azure portal is not currently supported. Here's an example of how to enable the logs by using PowerShell.

$storageAccount = Get-AzStorageAccount -ResourceGroupName <resourceGroup> -Name <storageAccountName>

Set-AzStorageServiceLoggingProperty -Context $storageAccount.Context -ServiceType Blob -LoggingOperations read,write,delete -RetentionDays <days>.

Make sure to specify Blob as the value of the -ServiceType parameter as shown in this example.

Currently, Azure Storage Explorer can't be used for viewing diagnostic logs. To view logs, please use AzCopy or SDKs.
Immutable storage Not yet supported

Immutable storage gives the ability to store data in a WORM (Write Once, Read Many) state.
Object-level tiers Cool and archive tiers are supported. The archive tier is in preview. All other access tiers are not yet supported.

There are currently some bugs affecting the archive access tier. Sign up for the preview of the archive access tier here.
Static websites Not yet supported

Specifically, the ability to serve files to Static websites.
Third party applications Limited support

Third party applications that use REST APIs to work will continue to work if you use them with Data Lake Storage Gen2.
Applications that call Blob APIs will likely work.
Soft Delete Not yet supported
Versioning features Not yet supported

This includes soft delete, and other versioning features such as snapshots.