Merge pull request #89373 from deborahc/dech-notebook-docs

First commit of enabling notebooks article

Author: ShannonLeavitt

articles/cosmos-db/TOC.yml

@@ -679,6 +679,10 @@
       - name: Streaming with Apache Kafka and Cosmos DB
         href: /azure/hdinsight/apache-kafka-spark-structured-streaming-cosmosdb
         maintainContext: true 
+    - name: Built-in Jupyter notebooks
+      items:
+      - name: Enable notebooks
+        href: enable-notebooks.md
     - name : Server-side programming
       items:
       - name: Write stored procedures, triggers, & UDFs

articles/cosmos-db/enable-notebooks.md

@@ -0,0 +1,65 @@
+---
+title: Enable notebooks in the Azure Cosmos DB account
+description: Azure Cosmos DB's built-in notebooks enable you to analyze and visualize your data from within the Portal. This article describes how to enable this feature for Cosmos accounts. 
+author: deborahc
+ms.service: cosmos-db
+ms.topic: conceptual
+ms.date: 09/22/2019
+ms.author: dech
+
+---
+
+# Enable notebooks for Azure Cosmos DB accounts
+
+Built-in Jupyter notebooks in Azure Cosmos DB enable you to analyze and visualize your data from the Azure portal. This article describes how to enable this feature for your Azure Cosmos DB account.
+
+## Enable notebooks in a new Cosmos account
+1. Sign into the [Azure portal](https://portal.azure.com/).
+1. Select **Create a resource** > **Databases** > **Azure Cosmos DB**.
+1. On the **Create Azure Cosmos DB Account** page, select **Notebooks**. 
+ 
+    ![Select notebooks option in Azure Cosmos DB Create blade](media/enable-notebooks/create-new-account-with-notebooks.png)
+1. Select **Review + create**. You can skip the **Network** and **Tags** option. 
+1. Review the account settings, and then select **Create**. It takes a few minutes to create the account. Wait for the portal page to display **Your deployment is complete**. 
+
+    ![The Azure portal Notifications pane](media/enable-notebooks/create-new-account-with-notebooks-complete.png)
+1. Select **Go to resource** to go to the Azure Cosmos DB account page. 
+
+    ![The Azure Cosmos DB account page](../../includes/media/cosmos-db-create-dbaccount/azure-cosmos-db-account-created-3.png)
+
+1. Navigate to the **Data Explorer** pane. You should now see your notebooks workspace.
+
+    ![New Azure Cosmos DB notebooks workspace](media/enable-notebooks/new-notebooks-workspace.png)
+
+## Enable notebooks in an existing Cosmos account
+You can also enable notebooks on existing accounts. This step needs to be done only once per account.
+
+1. Navigate to the **Data Explorer** pane in your Cosmos account.
+1. Select **Enable Notebooks**.
+
+    ![Create a new notebooks workspace in Data Explorer](media/enable-notebooks/enable-notebooks-workspace.png)
+1. This will prompt you to create a new notebooks workspace. Select **Complete setup.**
+1. Your account is now enabled to use notebooks!
+
+## Create and run your first notebook
+
+To verify that you can use notebooks, select one of notebooks under Sample Notebooks. This will save a copy of the notebook to your workspace and open it.
+
+In this example, we'll use **GettingStarted.ipynb**. 
+
+![View GettingStarted.ipynb notebook](media/enable-notebooks/select-getting-started-notebook.png)
+
+To run the notebook:
+1. Select the first code cell that contains Python code. 
+1. Select **Run** to run the cell. You can also use **Shift + Enter** to run the cell.
+1. Refresh the resource pane to see the database and container that has been created.
+
+    ![Run getting started notebook](media/enable-notebooks/run-first-notebook-cell.png)
+
+You can also select **New Notebook** to create a new notebook or upload an existing notebook  (.ipynb) file by selecting **Upload File** from the **My Notebooks** menu. 
+
+![Create or upload a new notebook](media/enable-notebooks/create-or-upload-new-notebook.png)
+
+## Next steps
+
+- Learn about the benefits of [Azure Cosmos DB Jupyter notebooks](cosmosdb-jupyter-notebooks.md)