Azure.Storage.Files.DataLake download APIs are not a feature parity with Azure.Storage.Blobs

[seanmcc-msft]

Today, we support the following Azure.Storage.Blob download APIs:

• Response<BlobDownloadResult> DownloadContent(BlobDownloadOptions options = default, CancellationToken cancellationToken = default)
• Task<Response<BlobDownloadResult>> DownloadContentAsync(BlobDownloadOptions options = default, CancellationToken cancellationToken)
• Response<BlobDownloadStreamingResult> DownloadStreaming(BlobDownloadOptions options = default, CancellationToken cancellationToken = default)
• Task<Response<BlobDownloadStreamingResult>> DownloadStreamingAsync(BlobDownloadOptions options = default, CancellationToken cancellationToken = default)
• public virtual Response DownloadTo(Stream destination, BlobDownloadToOptions options, CancellationToken cancellationToken = default)
• Task<Response> DownloadToAsync(Stream destination, BlobDownloadToOptions options, CancellationToken cancellationToken = default)
• Response DownloadTo(string path, BlobDownloadToOptions options, CancellationToken cancellationToken = default)
• Task<Response> DownloadToAsync(string path, BlobDownloadToOptions options, CancellationToken cancellationToken = default)

In Azure.Storage.Files.DataLake, we only support the following:

• Response<FileDownloadInfo> Read(DataLakeFileReadOptions options = default, CancellationToken cancellationToken = default)
• Task<Response<FileDownloadInfo>> ReadAsync(DataLakeFileReadOptions options = default, CancellationToken cancellationToken = default)
• `Response ReadTo(string path, DataLakeFileReadToOptions options = default, CancellationToken cancellationToken = default)
• Task<Response> ReadToAsync(string path, DataLakeFileReadToOptions options = default, CancellationToken cancellationToken = default)
• Response ReadTo(Stream destination, DataLakeFileReadToOptions options = default, CancellationToken cancellationToken = default)
• Task<Response> ReadToAsync(Stream destination,DataLakeFileReadToOptions options = default, CancellationToken cancellationToken = default)

We need to do the following:

• Deprecate DataLakeFileClient.Read() and .ReadAsync() and replace with .ReadContent() and .ReadContentAsync(), returning new classes similar to BlobDownloadResult
• Add DataLakeFileClient.ReadStreaming() and .ReadStreamingAsync()

This is from email thread "RE: QQ about managed API"

[github-actions[bot]]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @xgithubtriage.