Nawiązywanie połączeń z wystąpieniami usługi Azure Cosmos DB i wykonywanie na nich zapytań przy użyciu programu Visual Studio Code

Visual Studio Code to wszechstronny edytor kodu dla systemów Linux, macOS i Windows obsługujący wiele rozszerzeń. W tym przewodniku szybkiego startu pokazano, jak nawiązać połączenie z usługą Azure Cosmos DB for NoSQL i Azure Cosmos DB for MongoDB za pomocą programu Visual Studio Code. Obejmuje ona wykonywanie podstawowych operacji bazy danych, w tym wykonywanie zapytań, wstawianie, aktualizowanie i usuwanie danych.

Prerequisites

• Konto usługi Azure Cosmos DB for NoSQL skonfigurowane przy użyciu bazy danych i kontenera. Skorzystaj z dowolnego z tych przewodników szybkiego startu, aby skonfigurować zasób.
  • Portal
  • Azure CLI

Instalowanie rozszerzenia

Aby połączyć dane w usłudze Azure Cosmos DB w programie Visual Studio i zarządzać nimi, najpierw zainstaluj rozszerzenie Azure Databases .

1. Otwórz program Visual Studio Code.
2. Uzyskaj dostęp do okienka Rozszerzenia , wybierając pozycję Wyświetl > rozszerzenia lub używając skrótu Ctrl + Shift + X w systemie Windows i poleceń + Shift + X w systemie macOS.
3. Na pasku wyszukiwania wpisz DocumentDB for Visual Studio Code i wybierz rozszerzenie. Następnie wybierz pozycję Zainstaluj.
4. Po zakończeniu instalacji załaduj ponownie program Visual Studio Code, jeśli zostanie wyświetlony monit.

Nawiązywanie połączenia z usługą Azure Cosmos DB for NoSQL

1. W programie Visual Studio Code przejdź do okienka Platformy Azure (wybierz ikonę platformy Azure na pasku działań).

2. Zaloguj się do konta usługi Azure Cosmos DB for NoSQL za pomocą identyfikatora Entra firmy Microsoft:

   Uwaga / Notatka

   Użyj kontroli dostępu opartej na rolach Microsoft Entra ID podczas uzyskiwania dostępu do Twoich zasobów usługi Azure Cosmos DB.

3. Po zalogowaniu się w widoku drzewa platformy Azure znajdź subskrypcję platformy Azure i przejdź do szczegółów usługi Azure Cosmos DB.

4. Wybierz istniejące konto lub kliknij prawym przyciskiem myszy, aby utworzyć nowy zasób.

Wykonywanie zapytań i wyświetlanie danych

W poniższych krokach użyj edytora zapytań, aby wykonać zapytanie i wyświetlić wyniki zapytania:

1. W menu dla swojej kolekcji kliknij kolekcję prawym przyciskiem myszy, aby otworzyć Edytor zapytań w wersji zapoznawczej.

   

2. Uruchom zapytanie podane w edytorze zapytań, aby wyświetlić dane w widoku tabeli:

   

3. Eksplorowanie danych w innych obsługiwanych widokach:

   • Widok JSON: zobacz strukturę danych pierwotnych.

     

   • Widok drzewa: eksplorowanie zagnieżdżonych danych jest łatwe.

     

Wyświetlanie metryk zapytań i indeksów

W edytorze zapytań wyświetl więcej metryk zapytań i indeksów, aby lepiej zoptymalizować wydajność zapytań.

1. Wybierz kartę Statystyki obok zapytania Wyniki.

2. Aby uzyskać więcej informacji na temat definicji metryk, zobacz dokumentację metryk zapytań.

Wstawianie, edytowanie i usuwanie dokumentów

• Edytowanie dokumentów w czasie rzeczywistym: natychmiastowe dodawanie, wyświetlanie, edytowanie i usuwanie dokumentów z zmianami odzwierciedlanymi w czasie rzeczywistym.

• Importowanie z formatu JSON: szybkie ładowanie danych z plików JSON.

Eksportowanie wyników zapytania

• Wyniki pobierania: pobierz wyniki zapytania do plików CSV lub JSON.

Treści powiązane

• Rozpocznij pracę z interfejsem programowania aplikacji dla NoSQL
• Szybki start z Node.js
• Przewodnik Szybki start dla języka Python
• Przewodnik Szybki start dla języka Java
• Go: Szybki Start

Prerequisites

• Konto usługi Azure Cosmos DB for NoSQL skonfigurowane przy użyciu bazy danych i kontenera.
• Konsola MongoDB (mongosh) zainstalowana dla interakcji z wierszem polecenia (jest opcjonalne, ale zalecane).

Instalowanie rozszerzenia

Aby nawiązać połączenie z danymi w usłudze Azure Cosmos DB i zarządzać nimi, musisz zainstalować rozszerzenie Azure Databases dla programu Visual Studio Code.

1. Otwórz program Visual Studio Code.
2. Uzyskaj dostęp do okienka Rozszerzenia , wybierając pozycję Wyświetl > rozszerzenia lub używając skrótu Ctrl + Shift + X w systemie Windows i poleceń + Shift + X w systemie macOS.
3. Na pasku wyszukiwania wpisz DocumentDB for Visual Studio Code i wybierz rozszerzenie. Następnie wybierz pozycję Zainstaluj.
4. Po zakończeniu instalacji załaduj ponownie program Visual Studio Code, jeśli zostanie wyświetlony monit.

Nawiązywanie połączenia z obciążeniem roboczym MongoDB

Teraz nawiąż połączenie z obciążeniem MongoDB w usłudze Azure Cosmos DB dla MongoDB.

1. W panelu Obszar roboczy rozwiń sekcję Konta bazy danych MongoDB.

2. W tym miejscu możesz wyświetlić wszystkie konta bazy danych MongoDB. Połącz się z nowym kontem bazy danych MongoDB przy użyciu swoich poświadczeń.

   Uwaga / Notatka

   Wszystkie pomyślnie połączone klastry Bazy danych MongoDB pozostaną wymienione w sekcji Konta bazy danych MongoDB, nawet po zamknięciu programu Visual Studio Code.

Intuicyjne Zarządzanie danymi

Łatwe zarządzanie bazami danych w programie Visual Studio Code:

• Tworzenie i usuwanie baz danych/kolekcji: tworzenie lub usuwanie baz danych i kolekcji przy użyciu menu kontekstowego na koncie, bazie danych lub kolekcji w panelu zasobów.

• Importowanie z formatu JSON: szybkie importowanie danych z plików JSON do kolekcji.

  • Inicjowanie importu
    1. Kliknij prawym przyciskiem myszy nazwę kolekcji w widoku zasobu i wybierz polecenie Importuj dokumenty do kolekcji.
    2. Alternatywnie otwórz widok kolekcji, klikając pozycję Dokumenty kolekcji, a następnie wybierz przycisk Importuj .
  • Wybieranie pliku JSON
    1. Przejdź do lokalizacji pliku *.json zawierającego Twoje dane.
    2. Potwierdź, aby rozpocząć proces importowania.

• Eksportuj dane: zapisz kolekcje lub wyniki zapytania jako dane JSON na potrzeby tworzenia kopii zapasowej lub udostępniania.

  • Zainicjuj eksport:
    • Opcja 1
      1. Kliknij prawym przyciskiem myszy nazwę kolekcji w widoku zasobu i wybierz polecenie Eksportuj dokumenty z kolekcji , aby wyeksportować całą kolekcję.
    • Opcja 2
      1. Otwórz widok kolekcji, klikając pozycję Dokumenty kolekcji, a następnie wybierz przycisk Eksportuj .
      2. Wybierz opcję wyeksportowania całej kolekcji lub wyników bieżącego zapytania.
  • Określ plik docelowy:
    1. Wprowadź nazwę i lokalizację docelowego pliku *.json.
    2. Potwierdź eksport, aby rozpocząć zapisywanie danych.

• Edytowanie dokumentów w czasie rzeczywistym: błyskawiczne dodawanie, wyświetlanie, edytowanie i usuwanie dokumentów przy użyciu aktualizacji w czasie rzeczywistym.

  • Otwórz edycję dokumentu:
    • Uzyskaj dostęp do opcji edycji dokumentów bezpośrednio w widoku kolekcji. Te kontrolki znajdują się wygodnie nad widokiem danych, aby ułatwić dostęp.
  • Dostępne akcje:
    • Dodaj: Utwórz nowe dokumenty w kolekcji.
    • Widok: Wyświetl zawartość wybranego dokumentu.
    • Edytuj: edytuj zawartość wybranych dokumentów.
    • Usuń: Usuń wybrane dokumenty, a zmiany zostaną natychmiast odzwierciedlone.

Zaawansowane narzędzia zapytań

Bezproblemowe uruchamianie i uściślinie zapytań:

• Natychmiastowe wyniki: natychmiastowe wyświetlanie wyników zapytania w preferowanym formacie — tabela, kod JSON lub widok drzewa.

  • Łatwe przełączanie widoków przy użyciu menu rozwijanego Widok .

• Wykonywanie zapytań bezpośrednio: pisanie i wykonywanie zapytań bazy danych MongoDB z funkcjami takimi jak wyróżnianie składni i autouzupełnianie.

  • Aby uruchomić zapytanie, wybierz przycisk Znajdź zapytanie lub naciśnij w Ctrl/Cmd+Enter edytorze zapytań.

Uwaga / Notatka

Obecnie obsługiwane są tylko zapytania filtrów wyszukiwania, z rozszerzonymi możliwościami zapytań, które zostaną wkrótce dodane.

Elastyczne widoki danych

Eksplorowanie danych przy użyciu wielu widoków dla różnych perspektyw:

• Widok JSON: zobacz nieprzetworzoną strukturę danych JSON.

  

• Widok drzewa: bezproblemowa nawigacja i eksploracja zagnieżdżonych danych.

  

• Widok tabeli: szybkie skanowanie danych i zagłębianie się w zagnieżdżone dokumenty.

  • Aby przejść do szczegółów: znajdź wpisy z ikoną {} , która wskazuje obiekty osadzone. Kliknij dwukrotnie, aby rozwinąć i wyświetlić zawartość.

  • Aby wrócić: Wróć do poprzednich poziomów, korzystając z okruszków nawigacyjnych poniżej widoku tabeli.

  

Integracja z Mongo Shell

Dostępna jest funkcja wiersza polecenia:

• Uruchom mongosh: Wykonaj zaawansowane polecenia MongoDB bezpośrednio w Visual Studio Code.

Uwaga / Notatka

Powłoka bazy danych MongoDB (mongosh) nie jest dołączona do rozszerzenia . Należy zainstalować ją oddzielnie i skonfigurować ręcznie.

Zarządzanie klastrami

Bądź na bieżąco z zasobami:

• Wyświetl szczegóły klastra: sprawdź warstwę klastra, wersję serwera i użycie zasobów.

• Zarządzanie tagami: organizowanie klastrów przy użyciu tagów synchronizowanych z witryną Azure Portal.