Unable to download file from Azure blob java

Question

Unable to download file from Azure blob java

Zelin Wang (US) 20

Hi community members,

I am trying to download file that contains asian characters in blob path but has StorageException. the api i am using is downloadFile("temp/document/9795ccd9-4a41-4bf1-80d5-43774cac0c89/*我愛中國.*pdf"). The api itself path format has no issues while downloading normal english file name but it only has issues while downloading file with foreign language names. Could you help me to resolve this? thank you so much!

Vinod Kumar Reddy Chilupuri 4,185 Reputation points Microsoft External Staff Moderator

2024-10-17T09:49:51.97+00:00
Hi Zelin Wang (US),

Welcome to Microsoft Q&A, thanks for posting your query.

The problem you are encountering with the downloading files that contain Asian characters in the blob path is due to encoding issue. Blob Storage path that includes non-ASCII characters, such as from Asian languages need to be properly encoded to function correctly. If the file path included such characters and isn't correctly encoded, it may result in "Storage Exception".

Here are the few steps to follow.

Ensure that the file name in the API call is URL-encoded. You can use standard encoded libraries available in most programming languages to convert these characters to URL format. In Java you can use URLEncoder to encode the blob path.

Ensure that the Azure Storage API you are using supports Unicode characters.

Check the containers path sometimes, the problem may arise from how the path is resolved on the sever side or the client side. Ensure that the path is being correctly managed after applying URL encoding. this can prevent the errors when the file name is with special characters.

Ensure that the characters in the file path comply with Azure's naming conventions for blobs.

Reference:

https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-download-java

Naming and Referencing Containers, Blobs, and Metadata - Azure Storage | Microsoft Learn

Please let us know if you have any further queries. I’m happy to assist you further.
Vinod Kumar Reddy Chilupuri 4,185 Reputation points Microsoft External Staff Moderator

2024-10-18T05:30:47.3066667+00:00

Hi Zelin Wang (US),

Just checking to see if the above solution helped. If this answers your query, please don’t forget to "Up-Vote" for the same, which might be beneficial to other community members reading this thread. If you have any further query do let us know.
Zelin Wang (US) 20 Reputation points

2024-10-18T16:11:23.5966667+00:00
Hi @Vinod Kumar Reddy Chilupuri Thank you for giving me the detailed answers, i tried to encode the blob path with but still no luck. I assumption is when i upload the same file to blob i didn't do the encode and there is NO errors or issues in upload, but if I encode the same file name during upload process, will azure blob recognize the encoded file name? Do i need to encode the file name during upload first even though the upload is successful?

URLEncoder.encode(fileName, "UTF-8")
Zelin Wang (US) 20 Reputation points

2024-10-18T19:36:49.85+00:00
CloudBlockBlob blob = container.getBlockBlobReference(blobPath); blob.downloadToFile("/tmp//document/0000000-00-000-0000000/%E4%B8%AD%E6%96%87%E7%89%88.pdf");

I converted the filename into encoded path on server side(The path works well with other normal english names). Above is the code but it still throws me translateException. Is this the right format to path into downloadToFile function? Thank you in advance!
Vinod Kumar Reddy Chilupuri 4,185 Reputation points Microsoft External Staff Moderator

2024-10-22T01:04:18.0433333+00:00

Hi Zelin Wang (US),

Just checking to see if the above solution helped. If this answers your query, please don’t forget to "Up-Vote", which might be beneficial to other community members reading this thread. If you have any further query do let us know.
Vinod Kumar Reddy Chilupuri 4,185 Reputation points Microsoft External Staff Moderator

2024-10-23T01:16:08.85+00:00

Hi Zelin Wang (US),

Just checking to see if the above solution helped. If this answers your query, please don’t forget to "Up-Vote", which might be beneficial to other community members reading this thread. If you have any further query do let us know.
Zelin Wang (US) 20 Reputation points

2024-10-23T23:59:57.4766667+00:00

Hi Vinod, thank you for providing detailed solutions for me!! Actually it turns out that downloadFile still works without encoding Asian characters. what a surprise! But i will double check and test more. But i will still try your solution if it failed! Thank you again!
Vinod Kumar Reddy Chilupuri 4,185 Reputation points Microsoft External Staff Moderator

2024-10-24T01:08:49.0866667+00:00

Hi Zelin Wang (US),

Please "Accept the Answer" which helped you solve your query. Which might be beneficial to other community members reading this thread. If you have any further query do let us know.

Accepted answer

0 additional answers

Your answer

Vinod Kumar Reddy Chilupuri 4,185 Reputation points Microsoft External Staff Moderator

2024-10-17T09:49:51.97+00:00

Hi Zelin Wang (US),

Welcome to Microsoft Q&A, thanks for posting your query.

The problem you are encountering with the downloading files that contain Asian characters in the blob path is due to encoding issue. Blob Storage path that includes non-ASCII characters, such as from Asian languages need to be properly encoded to function correctly. If the file path included such characters and isn't correctly encoded, it may result in "Storage Exception".

Here are the few steps to follow.

Ensure that the file name in the API call is URL-encoded. You can use standard encoded libraries available in most programming languages to convert these characters to URL format. In Java you can use URLEncoder to encode the blob path.

Ensure that the Azure Storage API you are using supports Unicode characters.

Check the containers path sometimes, the problem may arise from how the path is resolved on the sever side or the client side. Ensure that the path is being correctly managed after applying URL encoding. this can prevent the errors when the file name is with special characters.

Ensure that the characters in the file path comply with Azure's naming conventions for blobs.

Reference:

https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-download-java

Naming and Referencing Containers, Blobs, and Metadata - Azure Storage | Microsoft Learn

Please let us know if you have any further queries. I’m happy to assist you further.
Vinod Kumar Reddy Chilupuri 4,185 Reputation points Microsoft External Staff Moderator

2024-10-18T05:30:47.3066667+00:00

Hi Zelin Wang (US),

Just checking to see if the above solution helped. If this answers your query, please don’t forget to "Up-Vote" for the same, which might be beneficial to other community members reading this thread. If you have any further query do let us know.
Zelin Wang (US) 20 Reputation points

2024-10-18T16:11:23.5966667+00:00

Hi @Vinod Kumar Reddy Chilupuri Thank you for giving me the detailed answers, i tried to encode the blob path with but still no luck. I assumption is when i upload the same file to blob i didn't do the encode and there is NO errors or issues in upload, but if I encode the same file name during upload process, will azure blob recognize the encoded file name? Do i need to encode the file name during upload first even though the upload is successful?

URLEncoder.encode(fileName, "UTF-8")
Zelin Wang (US) 20 Reputation points

2024-10-18T19:36:49.85+00:00

CloudBlockBlob blob = container.getBlockBlobReference(blobPath); blob.downloadToFile("/tmp//document/0000000-00-000-0000000/%E4%B8%AD%E6%96%87%E7%89%88.pdf");

I converted the filename into encoded path on server side(The path works well with other normal english names). Above is the code but it still throws me translateException. Is this the right format to path into downloadToFile function? Thank you in advance!
Vinod Kumar Reddy Chilupuri 4,185 Reputation points Microsoft External Staff Moderator

2024-10-22T01:04:18.0433333+00:00

Hi Zelin Wang (US),

Just checking to see if the above solution helped. If this answers your query, please don’t forget to "Up-Vote", which might be beneficial to other community members reading this thread. If you have any further query do let us know.
Vinod Kumar Reddy Chilupuri 4,185 Reputation points Microsoft External Staff Moderator

2024-10-23T01:16:08.85+00:00

Hi Zelin Wang (US),

Just checking to see if the above solution helped. If this answers your query, please don’t forget to "Up-Vote", which might be beneficial to other community members reading this thread. If you have any further query do let us know.
Zelin Wang (US) 20 Reputation points

2024-10-23T23:59:57.4766667+00:00

Hi Vinod, thank you for providing detailed solutions for me!! Actually it turns out that downloadFile still works without encoding Asian characters. what a surprise! But i will double check and test more. But i will still try your solution if it failed! Thank you again!
Vinod Kumar Reddy Chilupuri 4,185 Reputation points Microsoft External Staff Moderator

2024-10-24T01:08:49.0866667+00:00

Hi Zelin Wang (US),

Please "Accept the Answer" which helped you solve your query. Which might be beneficial to other community members reading this thread. If you have any further query do let us know.

Answer 1

Hi Zelin Wang (US),

The "TranslateException" you are seeing due to the issue with the Azure Storage SDK or due to the connection to Azure Blob Storage.

Here are few steps to follow.

Check whether the blob blobPath is URL-encoded properly. Non-ASCII characters need to be properly encoded to ensure they are transmitted over HTTP without any errors.
The path you are using in the downloadToFile method should not contain double slashes (//). This will raise the issues when the file is being created. Use only single slash (/).
Check the BlobPath variable is correctly is pointing to the blob you want to download. Verify it through a console output can help that it is encoded properly and matches the actual blob path within the container.
Check that the container and the blob exists in Azure Blob Storage. You can use the Azure Portal or Azure Storage Explorer to check if the blob exists and check you have the correct permissions to access it.
Check the connection details that your connection string, account name, key are valid. You can create a CloudStorageAccount and a CloudBlobClient to check if you're able to connect properly. If there is any issue with the connection, it will cause exceptions during blob access.

By ensuring that the blob path is properly URL-encoded and correcting the file path format, you should be able to resolve the "TranslateException" and successfully download the file with Asian characters in its name.

Upload: No need to encode the file name, as Azure handles non-ASCII characters without issues.
Download/Access: Ensure the blob path is URL-encoded (especially for non-ASCII characters) to avoid errors during access.

Please let us know if you have any further queries. I’m happy to assist you further.

Please do not forget to "Accept the answer” and “up-vote” wherever the information provided helps you, this can be beneficial to other community members.

Share via

Unable to download file from Azure blob java

0 additional answers

Your answer