Skip to content

Commit 20048c2

Browse files
committed
Updating enable notebooks article with new images, wording per feedback
1 parent b626496 commit 20048c2

File tree

7 files changed

+29
-11
lines changed

7 files changed

+29
-11
lines changed

articles/cosmos-db/TOC.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -675,6 +675,10 @@
675675
- name: Streaming with Apache Kafka and Cosmos DB
676676
href: /azure/hdinsight/apache-kafka-spark-structured-streaming-cosmosdb
677677
maintainContext: true
678+
- name: Built-in Jupyter notebooks
679+
items:
680+
- name: Enable notebooks
681+
href: enable-notebooks.md
678682
- name : Server-side programming
679683
items:
680684
- name: Write stored procedures, triggers, & UDFs

articles/cosmos-db/enable-notebooks.md

Lines changed: 25 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9,28 +9,30 @@ ms.author: dech
99

1010
---
1111

12-
# Enable notebooks in Azure Cosmos DB account
12+
# Enable notebooks for Azure Cosmos DB accounts
1313

14-
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 in your Azure Cosmos DB account.
14+
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.
1515

1616
## Enable notebooks in a new Cosmos account
17-
> [!IMPORTANT]
18-
> Notebooks are currently only supported for new Cosmos accounts.
19-
1. Sign into the [Azure Portal](https://portal.azure.com/).
17+
1. Sign into the [Azure portal](https://portal.azure.com/).
2018
1. Select **Create a resource** > **Databases** > **Azure Cosmos DB**.
2119
1. On the **Create Azure Cosmos DB Account** page, select **Notebooks**.
2220

2321
![Select notebooks option in Azure Cosmos DB Create blade](media/enable-notebooks/create-new-account-with-notebooks.png)
2422
1. Select **Review + create**. You can skip the **Network** and **Tags** option.
2523
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**.
2624

27-
![The Azure portal Notifications pane](../../includes/media/cosmos-db-create-dbaccount/azure-cosmos-db-account-created.png)
25+
![The Azure portal Notifications pane](media/enable-notebooks/create-new-account-with-notebooks-complete.png)
2826
1. Select **Go to resource** to go to the Azure Cosmos DB account page.
2927

30-
![The Azure Cosmos DB account page](../../includes/media/cosmos-db-create-dbaccount/azure-cosmos-db-account-created-2.png)
28+
![The Azure Cosmos DB account page](../../includes/media/cosmos-db-create-dbaccount/azure-cosmos-db-account-created-3.png)
3129

32-
## Create a new notebooks workspace
33-
After enabling notebooks on a new account, you will need to create your notebooks workspace. This needs to be done only once per account.
30+
1. Navigate to the **Data Explorer** pane. You should now see your notebooks workspace.
31+
32+
![New Azure Cosmos DB notebooks workspace](media/enable-notebooks/new-notebooks-workspace.png)
33+
34+
## Enable notebooks in an existing Cosmos account
35+
You can also enable notebooks on existing accounts. This step needs to be done only once per account.
3436

3537
1. Navigate to the **Data Explorer** pane in your Cosmos account.
3638
1. Select **Enable Notebooks**.
@@ -39,13 +41,25 @@ After enabling notebooks on a new account, you will need to create your notebook
3941
1. This will prompt you to create a new notebooks workspace. Select **Complete setup.**
4042
1. Your account is now enabled to use notebooks!
4143

42-
## Create your first notebook
44+
## Create and run your first notebook
45+
46+
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.
4347

44-
To verify that you can use notebooks, select one of notebooks under Sample Notebooks, e.g. **GettingStarted.ipynb**. This will save a copy of the notebook to your workspace and open it.
48+
In this example, we'll use **GettingStarted.ipynb**.
4549

4650
![View GettingStarted.ipynb notebook](media/enable-notebooks/select-getting-started-notebook.png)
4751

52+
To run the notebook:
53+
1. Select the first code cell that contains Python code.
54+
1. Select **Run** to run the cell. You can also use **Shift + Enter** to run the cell.
55+
1. Refresh the resource pane to see the database and container that has been created.
56+
57+
![Run getting started notebook](media/enable-notebooks/run-first-notebook-cell.png)
58+
4859
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.
4960

5061
![Create or upload a new notebook](media/enable-notebooks/create-or-upload-new-notebook.png)
5162

63+
## Next steps
64+
65+
- Learn about the benefits of [Azure Cosmos DB Jupyter notebooks](cosmosdb-jupyter-notebooks.md)
60.8 KB
Loading
114 KB
Loading
43.3 KB
Loading
162 KB
Loading
91.6 KB
Loading

0 commit comments

Comments
 (0)