Skip to content

Latest commit

 

History

History
73 lines (45 loc) · 4.03 KB

enable-notebooks.md

File metadata and controls

73 lines (45 loc) · 4.03 KB
title description author ms.service ms.topic ms.date ms.author
Enable notebooks in the Azure Cosmos DB account (preview)
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.
deborahc
cosmos-db
how-to
09/22/2019
dech

Enable notebooks for Azure Cosmos DB accounts (preview)

Important

Built-in notebooks for Azure Cosmos DB are currently available in the following Azure regions: Australia East, East US, East US 2, North Europe, South Central US, Southeast Asia, UK South, West Europe and West US 2. To use notebooks, create a new account with notebooks or enable notebooks on an existing account in one of these regions.

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.

  2. Select Create a resource > Databases > Azure Cosmos DB.

  3. On the Create Azure Cosmos DB Account page, select Notebooks.

    :::image type="content" source="media/enable-notebooks/create-new-account-with-notebooks.png" alt-text="Select notebooks option in Azure Cosmos DB Create blade":::

  4. Select Review + create. You can skip the Network and Tags option.

  5. 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.

    :::image type="content" source="media/enable-notebooks/create-new-account-with-notebooks-complete.png" alt-text="The Azure portal Notifications pane":::

  6. Select Go to resource to go to the Azure Cosmos DB account page.

    :::image type="content" source="../../includes/media/cosmos-db-create-dbaccount/azure-cosmos-db-account-created-3.png" alt-text="The Azure Cosmos DB account page":::

  7. Navigate to the Data Explorer pane. You should now see your notebooks workspace.

    :::image type="content" source="media/enable-notebooks/new-notebooks-workspace.png" alt-text="New Azure Cosmos DB notebooks workspace":::

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.

  2. Select Enable Notebooks.

    :::image type="content" source="media/enable-notebooks/enable-notebooks-workspace.png" alt-text="Create a new notebooks workspace in Data Explorer":::

  3. This will prompt you to create a new notebooks workspace. Select Complete setup.

  4. 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.

:::image type="content" source="media/enable-notebooks/select-getting-started-notebook.png" alt-text="View GettingStarted.ipynb notebook":::

To run the notebook:

  1. Select the first code cell that contains Python code.

  2. Select Run to run the cell. You can also use Shift + Enter to run the cell.

  3. Refresh the resource pane to see the database and container that has been created.

    :::image type="content" source="media/enable-notebooks/run-first-notebook-cell.png" alt-text="Run getting started notebook":::

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.

:::image type="content" source="media/enable-notebooks/create-or-upload-new-notebook.png" alt-text="Create or upload a new notebook":::

Next steps