search

Azure-Samples / azure-cosmos-db-mongodb-golang-getting-started

This sample shows you how to use the Azure Cosmos DB for MongoDB API and Go language (Golang) to create, retrieve, update, and delete a document in a collection.
MIT License
13 stars 13 forks source link

Don't use an UNMAINTAINED driver #3

Open christianhujer opened 5 years ago

christianhujer commented 5 years ago

The sample uses this driver: https://github.com/go-mgo/mgo/ The documentation clearly says that this driver is UNMAINTAINED.

The sample is referred to from the Azure documentation: https://azure.microsoft.com/en-in/resources/samples/azure-cosmos-db-mongodb-golang-getting-started/

This means that effectively, the Azure documentation recommends an UNMAINTAINED driver. That is very misleading, even harmful, for teams. My team wasted a lot of time trying to get this sample to work and run, just to figure out that in a lot of situations, the driver simply doesn't work. So they asked me to look into this, and I figured that this driver should have never been used in the first place, because it's UNMAINTAINED. Can't blame my team, as it just trusted the Azure documentation.

jflam commented 5 years ago

Is there a driver that someone could recommend in lieu of mgo?

jflam commented 5 years ago

I created PR #5 to update the sample to use the community supported version of mgo.

@christopheranderson can you help get this merged as it looks like the author no longer works here? Thx!

TheRegan commented 5 years ago

I've written an updated version of this using the officially supported MongoDB Go Driver. You can find it on github here: https://github.com/TheRegan/golang-azure-cosmosdb and there is a supporting blog post here: https://medium.com/@The_Regan/how-to-use-azure-cosmos-db-with-golang-using-mongodbs-official-go-driver-ccbb5db54c46