remove ensureCreated (#37)

Author: jordan-smith721

source/includes/code-examples/quick-reference.cs

@@ -7,7 +7,6 @@
 // Replace the placeholder with your connection URI
 var client = new MongoClient("<Your connection URI>");
 var db = PlanetDbContext.Create(client.GetDatabase("sample_planets"));
-db.Database.EnsureCreated();
 // end-create-instance
 
 void FindOne()

source/includes/fundamentals/code-examples/configure/ConfigureEFProvider.cs

@@ -10,7 +10,6 @@
     new DbContextOptionsBuilder<MyDbContext>().UseMongoDB(mongoClient, "<Database Name>");
 
 var db = new MyDbContext(dbContextOptions.Options);
-db.Database.EnsureCreated();
 
 // Add a new customer and save it to the database
 db.Customers.Add(new Customer() { name = "John Doe", Order = "1 Green Tea" });

source/includes/fundamentals/code-examples/configure/UseMongoDB.cs

@@ -3,5 +3,4 @@
 var dbContextOptions =
     new DbContextOptionsBuilder<MyDbContext>().UseMongoDB(mongoClient, "<Database Name");
 
-var db = new MyDbContext(dbContextOptions.Options);
-db.Database.EnsureCreated();
+var db = new MyDbContext(dbContextOptions.Options);

source/includes/quick-start/Program.cs

@@ -13,7 +13,6 @@
 }
 var client = new MongoClient(connectionString);
 var db = MflixDbContext.Create(client.GetDatabase("sample_mflix"));
-db.Database.EnsureCreated();
 
 var movie = db.Movies.First(m => m.Title == "Back to the Future");
 Console.WriteLine(movie.Plot);

source/upgrade.txt

@@ -72,6 +72,14 @@ Version 8.1.0 Breaking Changes
   creating the collection or database
   implicitly.
 
+  .. note::
+
+     Calling the ``EnsureCreated()`` or ``EnsureCreatedAsync()`` method throws
+     an error if your application is running on a
+     :atlas:`shared cluster </reference/free-shared-limitations/>`.
+     Applications running on free and shared clusters should not call these
+     methods. 
+
   If you don't want to ensure :wikipedia:`optimistic concurrency
   <Optimistic_concurrency_control>` with transactions, you can
   disable automatic transactions by setting ``Database.AutoTransactionBehavior =