Skip to content

Readme content of Azure Storage File Data Lake is unclear and inconsistencey #10325

@FredGao-new

Description

@FredGao-new

Section Link
image
Suggestion:
Add CLI command:
--enable-hierarchical-namespace true
according to https://docs.microsoft.com/en-us/cli/azure/storage/account?view=azure-cli-latest#az-storage-account-create

Section Link
image
Suggestion:
url should be displayed in code format

Section Link
image
Suggestion:
Change to the following format:
${myaccount}
${myfilesystem}
${mypath}

Section Link
image
image
Suggestion:
Remove unused links
Add links for the missing sample code titles:
Rename a file
Rename a directory
Get file properties
Get directory properties

Section Links:
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-file-datalake#create-a-datalakeserviceclient
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-file-datalake#create-a-datalakefilesystemclient
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-file-datalake#create-a-datalakefileclient
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-file-datalake#create-a-datalakedirectoryclient
image
image
image
image
Suggestion:
Add comments :
// Only one "?" is needed here. If the sastoken starts with "?", please removing one "?". The sastoken created by azure portal starts with "?". Using it in Code Snippet to create client will fail.
Reason:
SASToken from Azure Cli doesn't start with "?". But in Azure portal, sastoken starts with "?". Current code snippet not work with the later one.

Section Links:
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-file-datalake#rename-a-file
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-file-datalake#rename-a-directory
Suggestion:
Add comment:
//you need to authenticate with azure identity and add role assignment "Storage Blob Data Contributor" to do the following operation.
Reason:
The sample will fail if client is constructed with SASToken.

Metadata

Metadata

Assignees

Labels

ClientThis issue points to a problem in the data-plane of the library.DocsStorageStorage Service (Queues, Blobs, Files)blocking-releaseBlocks releaseneeds-team-attentionWorkflow: This issue needs attention from Azure service team or SDK teamtest-manual-pass

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions