Azure-docs: Link to `how to` is incorrect

Created on 15 Apr 2019  Â·  8Comments  Â·  Source: MicrosoftDocs/azure-docs

Getting Started with Azure Table Storage in .NET this links to documentation on how to Get Started with Cosmos DB table storage (https://docs.microsoft.com/en-us/azure/cosmos-db/tutorial-develop-table-dotnet). This is not the same as Azure table storage which is in a Blob. The article does have a note about it covering table storage as well but the examples seem to be very specific to Cosmos DB.


Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

assigned-to-author cosmos-dsvc cosmosdb-tablsubsvc doc-bug triaged

Most helpful comment

The link is correct. Azure Storage Table and Cosmos DB Table have compatible APIs. The same SDK can be used for both, and the documentation in the target link indeed provides instructions and samples for both cases.
One thing we can fix is the link text itself, so that it indicates the target provides instructions for both Cosmos DB and Azure Storage Table. For example, we can use the target page title: "Get started with Azure Cosmos DB Table API and Azure Table storage using the .NET SDK".

All 8 comments

@Layla-P Thank you for making us aware of this issue. We will investigate and update the document as appropriate.

@wmengmsft Can you provide feedback on this? In the Next Steps section, the bullet item Getting Started with Azure Table Storage in .NET links to a Cosmos DB Table API tutorial and not a Table Storage tutorial. Should this be the case? I can fix this if there is another link than the one currently in place.

The link is correct. Azure Storage Table and Cosmos DB Table have compatible APIs. The same SDK can be used for both, and the documentation in the target link indeed provides instructions and samples for both cases.
One thing we can fix is the link text itself, so that it indicates the target provides instructions for both Cosmos DB and Azure Storage Table. For example, we can use the target page title: "Get started with Azure Cosmos DB Table API and Azure Table storage using the .NET SDK".

The tutorial isn't clear on how to execute this with Azure table storage though. My table doesn't have a connection string - it only has a URL. So it falls down on more or lest the first bit of code where we use the CreateStorageAccountFromConnectionString() method.

Now I know that I need to go into the Azure Storage itself (not the tables), find access keys and grab the connection string from there. This is not clear in the tutorial and could be a real blocker to a user.

@Layla-P Thank you for the additional feedback. I am assigning to the content owner to evaluate and update as appropriate. PR #73197 is still outstanding for merge approval. An additional detail with regard to where to find access keys would be very helpful. The official Configure Azure Storage connection strings does not cover this explicitly either.

@Layla-P both Cosmos DB account and Table storage accounts have connection strings available in Azure portal. You can get them from the connection string/keys or access keys blade. Connection strings are pretty much in the same location for all Azure services.

I made a minor update to the above doc to callout it table storage too. We will now close this issue if there aren't any further questions.

please-close

We will now proceed to close this thread. If there are further questions regarding this matter, please comment and we will gladly continue the discussion.

Was this page helpful?
0 / 5 - 0 ratings