Samouczek: tworzenie notesu Jupyter w usłudze Azure Cosmos DB for NoSQL w celu analizowania i wizualizowania danych (wersja zapoznawcza)

DOTYCZY: NoSQL

Ostrzeżenie

Funkcja notesów Jupyter Notebooks usługi Azure Cosmos DB zostanie wycofana 30 marca 2024 r. Nie będzie można używać wbudowanych notesów Jupyter z konta usługi Azure Cosmos DB. Zalecamy korzystanie z obsługi notesów Jupyter lub preferowanego klienta notesów programu Visual Studio Code.

W tym samouczku przedstawiono sposób używania funkcji notesów Jupyter Notebooks usługi Azure Cosmos DB do importowania przykładowych danych detalicznych do konta usługi Azure Cosmos DB for NoSQL. Zobaczysz, jak używać poleceń magicznych usługi Azure Cosmos DB do uruchamiania zapytań, analizowania danych i wizualizowania wyników.

Wymagania wstępne

• Istniejące konto usługi Azure Cosmos DB for NoSQL.
  • Jeśli masz istniejącą subskrypcję platformy Azure, utwórz nowe konto.
  • Brak subskrypcji platformy Azure? Możesz wypróbować usługę Azure Cosmos DB bezpłatnie bez konieczności korzystania z karty kredytowej.

Tworzenie nowego notesu

W tej sekcji utworzysz bazę danych, kontener usługi Azure Cosmos i zaimportujesz dane detaliczne do kontenera.

1. Przejdź do konta usługi Azure Cosmos DB i otwórz Eksploratora danych.

2. Wybierz pozycję Nowy notes.

   

3. W wyświetlonym oknie dialogowym potwierdzenia wybierz pozycję Utwórz.

   Uwaga

   Zostanie utworzony tymczasowy obszar roboczy umożliwiający pracę z notesami Jupyter Notebook. Po wygaśnięciu sesji wszystkie notesy w obszarze roboczym zostaną usunięte.

4. Wybierz jądro, którego chcesz użyć dla notesu.

Python

C#

Napiwek

Po utworzeniu nowego notesu możesz zmienić jego nazwę na podobną do VisualizeRetailData.ipynb.

Tworzenie bazy danych i kontenera przy użyciu zestawu SDK

Python

1. Rozpocznij w domyślnej komórce kodu.

2. Zaimportuj wszystkie wymagane pakiety na potrzeby tego samouczka.

   import azure.cosmos
   from azure.cosmos.partition_key import PartitionKey
   

3. Utwórz bazę danych o nazwie RetailIngest przy użyciu wbudowanego zestawu SDK.

   database = cosmos_client.create_database_if_not_exists('RetailIngest')
   

4. Utwórz kontener o nazwie WebsiteMetrics z kluczem /CartIDpartycji .

   container = database.create_container_if_not_exists(id='WebsiteMetrics', partition_key=PartitionKey(path='/CartID'))
   

5. Wybierz pozycję Uruchom , aby utworzyć bazę danych i zasób kontenera.

   

C#

1. Rozpocznij w domyślnej komórce kodu.

2. Zaimportuj wszystkie wymagane pakiety na potrzeby tego samouczka.

   using Microsoft.Azure.Cosmos;
   

3. Utwórz nowe wystąpienie typu klienta przy użyciu wbudowanego zestawu SDK.

   var cosmosClient = new CosmosClient(Cosmos.Endpoint, Cosmos.Key);
   

4. Utwórz bazę danych o nazwie RetailIngest.

   Database database = await cosmosClient.CreateDatabaseIfNotExistsAsync("RetailIngest");
   

5. Utwórz kontener o nazwie WebsiteMetrics z kluczem /CartIDpartycji .

   Container container = await database.CreateContainerIfNotExistsAsync("WebsiteMetrics", "/CartID");
   

6. Wybierz pozycję Uruchom , aby utworzyć bazę danych i zasób kontenera.

   

Importowanie danych przy użyciu poleceń magic

1. Dodaj nową komórkę kodu.

2. W komórce kodu dodaj następujące polecenie magic, aby przekazać dane JSON z tego adresu URL do istniejącego kontenera: https://cosmosnotebooksdata.blob.core.windows.net/notebookdata/websiteData.json

   %%upload --databaseName RetailIngest --containerName WebsiteMetrics --url https://cosmosnotebooksdata.blob.core.windows.net/notebookdata/websiteData.json
   

3. Wybierz pozycję Uruchom aktywną komórkę , aby uruchomić polecenie tylko w tej konkretnej komórce.

   

   Uwaga

   Wykonanie polecenia importu powinno potrwać od 5 do 10 sekund.

4. Obserwuj dane wyjściowe z polecenia run. Upewnij się, że zaimportowano 2654 dokumenty.

   Documents successfully uploaded to WebsiteMetrics
   Total number of documents imported:
     Success: 2654
     Failure: 0
   Total time taken : 00:00:04 hours
   Total RUs consumed : 27309.660000001593
   

Wizualizacja danych

Python

1. Utwórz kolejną nową komórkę kodu.

2. W komórce kodu użyj zapytania SQL, aby wypełnić ramkę danych Biblioteki Pandas.

   %%sql --database RetailIngest --container WebsiteMetrics --output df_cosmos
   SELECT c.Action, c.Price as ItemRevenue, c.Country, c.Item FROM c
   

3. Wybierz pozycję Uruchom aktywną komórkę , aby uruchomić polecenie tylko w tej konkretnej komórce.

4. Utwórz kolejną nową komórkę kodu.

5. W komórce kodu wyprowadź 10 pierwszych elementów z ramki danych.

   df_cosmos.head(10)
   

6. Wybierz pozycję Uruchom aktywną komórkę , aby uruchomić polecenie tylko w tej konkretnej komórce.

7. Zwróć uwagę na dane wyjściowe uruchomienia polecenia .

   	Akcja	ItemRevenue	Kraj	Produkt
   0	Zakupione	19.99	Macedonia	Koszula z guzikiem
   1	Wyświetlono	12,00	Papua Nowa Gwinea	Naszyjnik
   2	Wyświetlono	25.00	Słowacja (Republika Słowacka)	Sweter kardiganowy
   3	Zakupione	14.00	Senegal	Przerzucanie butów Flop
   4	Wyświetlono	50.00	Panama	Szorty denimowe
   5	Wyświetlono	14.00	Senegal	Przerzucanie butów Flop
   6	Dodano	14.00	Senegal	Przerzucanie butów Flop
   7	Dodano	50.00	Panama	Szorty denimowe
   8	Zakupione	33,00	Autonomia Palestyńska	Czerwony górny
   9	Wyświetlono	30.00	Malta	Zielony sweter

8. Utwórz kolejną nową komórkę kodu.

9. W komórce kodu zaimportuj pakiet pandas , aby dostosować dane wyjściowe ramki danych.

   import pandas as pd
   pd.options.display.html.table_schema = True
   pd.options.display.max_rows = None
   
   df_cosmos.groupby("Item").size()
   

10. Wybierz pozycję Uruchom aktywną komórkę , aby uruchomić polecenie tylko w tej konkretnej komórce.

11. W danych wyjściowych wybierz opcję Wykres liniowy, aby wyświetlić inną wizualizację danych.

    

C#

1. Utwórz nową komórkę kodu.

2. W komórce kodu utwórz nową klasę języka C#, aby reprezentować element w kontenerze.

   public class Record
   {
     public string Action { get; set; }
     public decimal Price { get; set; }
     public string Country { get; set; }
     public string Item { get; set; }
   }
   

3. Utwórz kolejną nową komórkę kodu.

4. W komórce kodu dodaj kod, aby wykonać zapytanie SQL przy użyciu zestawu SDK , przechowując dane wyjściowe zapytania w zmiennej typu List<T> o nazwie results.

   using System.Collections.Generic;
   
   var query = new QueryDefinition(
       query: "SELECT c.Action, c.Price, c.Country, c.Item FROM c"
   );
   
   FeedIterator<Record> feed = container.GetItemQueryIterator<Record>(
       queryDefinition: query
   );
   
   var results = new List<Record>();
   while (feed.HasMoreResults)
   {
       FeedResponse<Record> response = await feed.ReadNextAsync();
       foreach (Record result in response)
       {
           results.Add(result);
       }
   }
   

5. Utwórz kolejną nową komórkę kodu.

6. W komórce kodu utwórz słownik, dodając unikatowe permutacje pola Element jako klucz i dane w polu Cena jako wartość.

   var dictionary = new Dictionary<string, decimal>();
   
   foreach(var result in results)
   {
       dictionary.TryAdd (result.Item, result.Price); 
   }
   
   dictionary
   

7. Wybierz pozycję Uruchom aktywną komórkę , aby uruchomić polecenie tylko w tej konkretnej komórce.

8. Obserwuj dane wyjściowe przy użyciu unikatowych kombinacji pól Item (Element ) i Price (Cena ).

   ...
   Denim Jacket:31.99
   Fleece Jacket:65
   Sandals:12
   Socks:3.75
   Sandal:35.5
   Light Jeans:80
   ...
   

9. Utwórz kolejną nową komórkę kodu.

10. W komórce kodu wyprowadź zmienną wyników .

    results
    

11. Wybierz pozycję Uruchom aktywną komórkę , aby uruchomić polecenie tylko w tej konkretnej komórce.

12. W danych wyjściowych wybierz opcję Pole Plot , aby wyświetlić inną wizualizację danych.

    

Utrwalanie notesu

1. W sekcji Notesy otwórz menu kontekstowe notesu utworzonego na potrzeby tego samouczka i wybierz pozycję Pobierz.

   

   Napiwek

   Aby trwale zapisać swoją pracę, zapisz notesy w repozytorium GitHub lub pobierz notesy na komputer lokalny przed zakończeniem sesji.

Następne kroki

• Dowiedz się więcej o funkcji Notesów Jupyter w usłudze Azure Cosmos DB
• Importowanie notesów z usługi GitHub do konta usługi Azure Cosmos DB for NoSQL
• Zapoznaj się z często zadawanymi pytaniami dotyczącymi obsługi notesu Jupyter Notebook