Updated deployment instructions, WIP on first app

Author: codingbandit

07_Create_First_Cosmos_DB_Project/README.md

@@ -4,16 +4,14 @@ This section will cover how to create your first Cosmos DB project. We'll use a
 
 ## Emulator support
 
-Azure Cosmos DB has an emulator that can be used to develop code locally. The emulator supports the API for NoSQL and the API for NoSQL. The use of the emulator does not require an Azure subscription, nor does it incur any costs, so it is ideal for local development and testing. The Azure Cosmos DB emulator can also be utilized with unit tests in a [GitHub Actions CI workflow](https://learn.microsoft.com/azure/cosmos-db/how-to-develop-emulator?tabs=windows%2Cpython&pivots=api-mongodb#use-the-emulator-in-a-github-actions-ci-workflow).
+Azure Cosmos DB has an emulator that can be used to develop code locally. The emulator supports the API for NoSQL and the API for MongoDB. The use of the emulator does not require an Azure subscription, nor does it incur any costs, so it is ideal for local development and testing. The Azure Cosmos DB emulator can also be utilized with unit tests in a [GitHub Actions CI workflow](https://learn.microsoft.com/azure/cosmos-db/how-to-develop-emulator?tabs=windows%2Cpython&pivots=api-mongodb#use-the-emulator-in-a-github-actions-ci-workflow).
 
 There is not 100% feature parity between the emulator and the cloud service. Visit the [Azure Cosmos DB emulator](https://learn.microsoft.com/azure/cosmos-db/emulator) documentation for more details.
 
-For Windows machines, the emulator can be installed via an installer. There is a Windows container using Docker available. However, it does not currently support the API for Mongo DB. A Docker image is also available for Linux that does support the API for Mongo DB.
+For Windows machines, the emulator can be installed via an installer or by using a Docker container. A Docker image is also available for Linux-based machines.
 
 Learn more about the pre-requisites and installation of the emulator [here](https://learn.microsoft.com/azure/cosmos-db/how-to-develop-emulator?tabs=windows%2Cpython&pivots=api-mongodb).
 
->**NOTE**: When using the Azure CosmosDB emulator using the API for MongoDB it must be started with the [MongoDB endpoint options enabled](https://learn.microsoft.com/azure/cosmos-db/how-to-develop-emulator?tabs=windows%2Cpython&pivots=api-mongodb#start-the-emulator) at the command-line.
-
 **The Azure Cosmos DB emulator does not support vector search. To complete the vector search and AI-related labs, a Azure Cosmos DB for NoSQL account in Azure is required.**
 
 ## Authentication
@@ -24,93 +22,60 @@ Authentication to Azure Cosmos DB API for Mongo DB uses a connection string. The
 
 The splash screen or **Quickstart** section of the Cosmos DB Emulator will display the connection string. Access this screen through the following URL: `https://localhost:8081/_explorer/index.html`.
 
-![The Azure Cosmos DB emulator screen displays with the local host url, the Quickstart tab, and the Mongo connection string highlighted.](media/emulator_connection_string.png)
+![The Azure Cosmos DB emulator screen displays with the local host url, the Quickstart tab, and the connection string highlighted.](media/emulator_connection_string.png)
 
 ### Retrieving the connection string from the Azure portal
 
-Retrieve the connection string from the Azure portal by navigating to the Azure Cosmos DB account and selecting the **Connection String** menu item on the left-hand side of the screen. The connection string contains tokens for the username and password that must be replaced with the username and password used when provisioning the Azure Cosmos DB API for NoSQL service.
+Retrieve the connection string from the Azure portal by navigating to the Azure Cosmos DB account and expanding the **Settings** menu item on the left-hand side of the screen. Locate the **Primary Connection String**, and select the icon to make it visible. Copy the connection string and paste it in notepad for future reference.
 
-![The Azure CosmosDb API for NoSQL Connection strings screen displays with the copy button next to the connection string highlighted.](media/azure_connection_string.png)
+![The Azure Cosmos DB API for NoSQL Connection strings screen displays with the copy button next to the connection string highlighted.](media/azure_connection_string.png)
 
 ## Lab - Create your first Cosmos DB for the NoSQL application
 
-Using a notebook, we'll create a Cosmos DB for the NoSQL application in this lab using the **pymongo** library and the Python language. Both the Azure Cosmos DB Emulator and Azure Cosmos DB account in Azure are supported for completion of this lab.
+Using a notebook, we'll create a Cosmos DB for the NoSQL application in this lab using the **azure-cosmos** library and the Python language. Both the Azure Cosmos DB Emulator and Azure Cosmos DB account in Azure are supported for completion of this lab.
 
 >**Note**: It is highly recommended to use a [virtual environment](https://python.land/virtual-environments/virtualenv) for all labs.
 
 Please visit the lab repository to complete [this lab](../Labs/lab_1_first_application.ipynb).
 
 The following concepts are covered in detail in this lab:
 
-### Creating a MongoDB database client
+### Creating a database client
 
-The `pymongo` library is used to create a MongoDB database client. The client enables both DDL (data definition language) and DML (data manipulation language) operations.
+The `azure-cosmos` library is used to create a Cosmos DB API for NoSQL database client. The client enables both DDL (data definition language) and DML (data manipulation language) operations.
 
 ```python
-client = pymongo.MongoClient(CONNECTION_STRING)
+client = cosmos_client.CosmosClient(HOST, {'masterKey': MASTER_KEY} )
 ```
 
 ### Creating a database
 
-When using the `pymongo` client, the creation of a database is automatic when referenced. No specific api calls to create a database are required, if a database already exists, a reference to the database is returned.
-
->**Note:**: That the creation of databases and containers are lazy, meaning they will not be created until a document is inserted into a container.
+The `create_database` method is used to create a database. If the database already exists, an exception is thrown, therefore verify the database already exists before creating it.
 
 ```python
-db = client.cosmic_works
+client.create_database(id=id)
 ```
 
 ### Creating a container
 
-Similar behavior to the creation of a database is experienced when creating a container. If the container does not exist, it will be created once a document is inserted into the container.
-
-```python
-collection = db.products
-```
+In progress
 
 ### Creating a document
 
-The `insert_one` method is used to insert a document into a container. The document is a dictionary object.
-
-```python
-# Insert the JSON into the database, and retrieve the inserted/generated ID
-product_id = collection.insert_one(product_json).inserted_id
-```
+In progress
 
 ### Reading a document
 
-The `find_one` method is used to retrieve a single document from a container. The method returns a dictionary object.
-
-```python
-retrieved_document = collection.find_one({"_id": product_id})
-```
+In progress
 
 ### Updating a document
 
-The `find_one_and_update` method is used to update a single document in a container. The method returns a dictionary object.
-
-```python
-update_result = collection.find_one_and_update(
-    {"_id": product_id},
-    {"$set": {"name": retrieved_product.name}},
-    return_document=pymongo.ReturnDocument.AFTER
-)
-```
+In progress
 
 ### Deleting a document
 
-The `delete_one` method is used to delete a single document from a container.
-
-```python
-delete_result = collection.delete_one({"_id": product_id})
-```
+In progress
 
 ### Querying documents
 
-The `find` method is used to query documents from a container. The method returns a cursor object.
-
-```python
-# Print all documents that have a category name of "Components, Saddles"
-for result in collection.find({"categoryName": "Components, Saddles"}):
-    pprint(result)
-```
+In progress

07_Create_First_Cosmos_DB_Project/media/azure_connection_string.png

@@ -19,11 +19,7 @@ cd Labs
 cd deploy
 ```
 
-Open the `azuredeploy.parameters.json` file, then edit the `mongoDbPassword` to a password you wish to use for the MongoDB Admin User:
-
-![editing the azuredeploy.parameters.json file with mongoDBPassword parameter highlighted](images/editor-azuredeploy-parameters-json-password.png)
-
-When the Azure Bicep template is deployed, this parameters file will be used to configure the Mongo DB Password and other parameters when provisioning the Azure resources.
+Open the `azuredeploy.parameters.json` file, and inspect the values, modify as deemed appropriate.
 
 ## Login to Azure
 
@@ -59,3 +55,7 @@ New-AzResourceGroupDeployment -ResourceGroupName cosmos-devguide-rg -TemplateFil
 > ````powershell
 > Update-AzCosmosDBAccount -ResourceGroupName <resource-group-name> -Name <account-name> -Capabilities @{name="EnableNoSQLVectorSearch"}
 > ````
+
+## Enroll with the DiskANN early preview
+
+To enroll in the DiskANN early preview, fill the following form [Azure Cosmos DB for NoSQL DiskANN Early Preview](https://forms.office.com/pages/responsepage.aspx?id=v4j5cvGGr0GRqy180BHbR7M9usLEDhFDufzz-8echE9UREtCOVhQWkZLVlhTRlNBM0lLUkdRTEwxUy4u&route=shorturl) and a member of the Cosmos DB team will reach out to you.