Zarządzanie danymi za pomocą Eksploratora danych usługi Azure Cosmos DB

DOTYCZY: NoSQL MongoDB Kasandra Gremlin Stół

Eksplorator danych usługi Azure Cosmos DB to internetowy interfejs, który umożliwia wyświetlanie danych przechowywanych w usłudze Azure Cosmos DB i zarządzanie nimi.

Dedykowany Eksplorator danych usługi Azure Cosmos DB (https://cosmos.azure.com) ma kilka kluczowych zalet w porównaniu do środowiska Eksploratora danych w witrynie Azure Portal, w tym:

• Obszar pełnoekranowy umożliwiający przeglądanie danych, uruchamianie zapytań i obserwowanie wyników zapytań
• Możliwość udostępniania użytkownikom bez dostępu do witryny Azure Portal lub subskrypcji platformy Azure w przypadku możliwości odczytu lub odczytu i zapisu danych w kontenerach
• Możliwość udostępniania wyników zapytań użytkownikom, którzy nie mają dostępu do subskrypcji platformy Azure lub witryny Azure Portal

Wymagania wstępne

• Istniejące konto usługi Azure Cosmos DB.
  • Jeśli nie masz subskrypcji platformy Azure, wypróbuj bezpłatnie usługę Azure Cosmos DB.

Uzyskiwanie dostępu do Eksploratora danych bezpośrednio przy użyciu subskrypcji platformy Azure

Możesz użyć dostępu bezpośrednio do Eksploratora danych i użyć istniejących poświadczeń, aby szybko rozpocząć pracę z narzędziem.

1. Przejdź do https://cosmos.azure.com.

2. Wybierz pozycję Zaloguj. Zaloguj się przy użyciu istniejących poświadczeń, które mają dostęp do konta usługi Azure Cosmos DB.

3. Następnie wybierz subskrypcję platformy Azure i konto docelowe z menu Wybierz konto bazy danych.

   

Uzyskiwanie dostępu do Eksploratora danych z witryny Azure Portal przy użyciu subskrypcji platformy Azure

Jeśli masz już doświadczenie w pracy z witryną Azure Portal, możesz przejść bezpośrednio z poziomu eksploratora danych w portalu do autonomicznego Eksploratora danych.

1. Zaloguj się do Portalu Azure.

2. Przejdź do istniejącego konta usługi Azure Cosmos DB.

3. W menu zasobów wybierz pozycję Eksplorator danych.

4. Następnie wybierz opcję otwórz menu Pełnoekranowe .

   

5. W oknie dialogowym Otwieranie pełnego ekranu wybierz pozycję Otwórz.

Dostosowywanie widoków danych za pomocą selektora kolumn niestandardowych

Selektor kolumn niestandardowych w Eksploratorze danych usługi Azure Cosmos DB umożliwia dostosowanie widoków danych przez wybranie określonych kolumn, które są najbardziej istotne dla analizy podczas korzystania z interfejsu API NoSQL. Wcześniej w widoku elementy Eksploratora danych można było zobaczyć tylko kolumny klucza partycji i identyfikatora. Teraz dzięki tej nowej funkcji możesz wybrać jedną lub wiele właściwości z dokumentu i utworzyć dodatkowe kolumny, aby łatwo wyświetlać dane. 

1. Zaloguj się do Portalu Azure.

2. Przejdź do istniejącego konta usługi Azure Cosmos DB.

3. W menu zasobów wybierz pozycję Eksplorator danych.

4. Następnie (opcjonalnie) wybierz opcję otwórz menu Pełnoekranowe .

   

5. W oknie dialogowym Otwieranie pełnego ekranu wybierz pozycję Otwórz.

6. Po otwarciu Eksploratora danych otwórz kolekcję, której chcesz wykonać zapytanie, wybierz pozycję Elementy.

7. Kliknij menu wielokropka w prawym górnym rogu dowolnej kolumny, wybierz pozycję Edytuj kolumnę

8. Wybierz kolumny, które chcesz wyświetlić i zapisz ustawienia.

9. Widok danych będzie teraz odzwierciedlać tylko wybrane kolumny, co ułatwia skupienie się na odpowiednich danych.

10. Usuwanie kolumny niestandardowej

11. Po otwarciu Eksploratora danych otwórz kolekcję, której chcesz wykonać zapytanie, wybierz pozycję Elementy.

12. Kliknij menu wielokropka w prawym górnym rogu dowolnej kolumny, wybierz pozycję Usuń kolumnę.

13. Sortuj widok kolumny rosnąco lub malejąco

14. Po otwarciu Eksploratora danych otwórz kolekcję, której chcesz wykonać zapytanie, wybierz pozycję Elementy.

15. Kliknij menu wielokropka w prawym górnym rogu dowolnej kolumny, wybierz pozycję Usuń kolumnę.

16. Resetowanie widoku kolumny

17. Po otwarciu Eksploratora danych otwórz kolekcję, której chcesz wykonać zapytanie, wybierz pozycję Elementy.

18. Kliknij menu wielokropka w prawym górnym rogu dowolnej kolumny, wybierz pozycję Edytuj kolumnę.

19. Wybierz pozycję Resetuj, aby powrócić do widoku domyślnego. Możesz też wyczyścić ustawienia Historia filtru, Kolumny i Widokportu, wybierając ikonę koła zębatego w prawym górnym menu Globalnym Eksploratora danych i wybierając pozycję Wyczyść historię.

Korzystanie z historii filtrów

Historia filtrów umożliwia szybkie ponowne przejrzenie i zastosowanie poprzednich filtrów. Pozwala to zaoszczędzić na powtarzalnym zadaniu ręcznego odtworzenia filtrów dla zapytań cyklicznych. Za pomocą funkcji Historia filtrów możesz uzyskać dostęp do dziennika poprzednich filtrów i ponownie zastosować je za pomocą prostego kliknięcia.  Ta funkcja jest szczególnie przydatna dla użytkowników, którzy wykonują regularne analizy podobnych zestawów danych.

1. Stosowanie zapisanego filtru

2. Po otwarciu Eksploratora danych otwórz kolekcję, której chcesz wykonać zapytanie, wybierz pozycję Elementy.

3. Kliknij pozycję Edytuj filtr.

4. Zastosuj filtr do danych tak, jak zwykle.

Po zastosowaniu filtru filtr zostanie automatycznie zapisany i dodany do listy Filtr domyślny w oknie filtru Lista rozwijana.

1. Aby ponownie zastosować poprzedni filtr, kliknij przycisk Edytuj filtr.

2. Wyczyść dowolny filtr w oknie filtru. Ten krok jest wymagany do wyświetlania zapisanych filtrów.

3. Kliknij listę rozwijaną w oknie filtru i wybierz odpowiedni filtr z listy.

4. Wybierz pozycję Zastosuj filtr

5. Wyczyść historię filtru

6. W Eksploratorze danych kliknij ikonę koła zębatego w prawym górnym rogu Eksploratora danych, aby uzyskać dostęp do ustawień

7. Wybierz przycisk Wyczyść historię

8. Potwierdź, że chcesz wyczyścić historię.  Obejmowało to pozycje rozdzielającej kolumny filtru, kolumny niestandardowe i układ karty.

Zmienianie widoku okna zapytania

Wprowadziliśmy nową funkcję w widoku zapytania, która umożliwia przełączanie się między widokami poziomymi i pionowymi dla panelu zapytań i wyników. Możesz łatwo przełączać się między tymi widokami, wybierając opcję "Widoki" w menu paska poleceń.

1. Zapisywanie preferencji widoku okna zapytania

2. W Eksploratorze danych kliknij ikonę koła zębatego w prawym górnym rogu Eksploratora danych, aby uzyskać dostęp do ustawień.

3. Wybierz pozycję "Widok wyników zapytania domyślnego" z menu rozwijanego.

4. Wybierz widok poziomy lub pionowy.

5. Kliknij przycisk Zapisz, aby zastosować ustawienia.

Konfigurowanie progu jednostki żądania

W Eksploratorze danych można skonfigurować limit jednostek żądań na sekundę (RU/s), które są używane przez zapytania. Ta funkcja służy do kontrolowania kosztów i wydajności w jednostkach żądań (RU) zapytań. Ta funkcja może również automatycznie anulować zapytania o wysokich kosztach.

1. Uruchom polecenie w eksploratorze dla docelowego konta usługi Azure Cosmos DB.

2. Wybierz opcję menu Ustawienia.

   

3. W oknie dialogowym Ustawienia skonfiguruj, czy chcesz włączyć wartość progową ru i rzeczywistą wartość progową ru.

   

   > [!TIP]
   

   Próg jednostek RU jest włączany automatycznie z wartością domyślną 5000 jednostek RU.

Używanie z uwierzytelnianiem firmy Microsoft Entra

Uwierzytelnianie oparte na usłudze Microsoft Entra można użyć w eksploratorze, włączając je za pośrednictwem konfiguracji. Aby uzyskać więcej informacji na temat kontroli dostępu opartej na rolach, zobacz przewodnik po zabezpieczeniach.

1. Uruchom polecenie w eksploratorze dla docelowego konta usługi Azure Cosmos DB.

2. Wybierz opcję menu Ustawienia.

3. W oknie dialogowym Ustawienia skonfiguruj, czy chcesz Enable Entra ID (RBAC) użyć jednej z trzech możliwych wartości:

	opis
Automatyczne (ustawienie domyślne)	Kontrola dostępu oparta na rolach (RBAC) jest automatycznie używana, jeśli uwierzytelnianie oparte na kluczach jest wyłączone dla twojego konta. W przeciwnym razie Eksplorator danych używa uwierzytelniania opartego na kluczach dla żądań danych.
Prawda	Kontrola dostępu oparta na rolach jest zawsze używana w przypadku żądań danych. Jeśli kontrola dostępu oparta na rolach nie jest poprawnie skonfigurowana dla konta lub tożsamości, żądania kończą się niepowodzeniem.
Fałsz	Uwierzytelnianie oparte na kluczach jest zawsze używane na potrzeby żądań danych. Jeśli uwierzytelnianie oparte na kluczach jest wyłączone, żądania kończą się niepowodzeniem.

Uwaga

Zmiana tego ustawienia na opcję używającą uwierzytelniania opartego na kluczach może wyzwolić żądanie pobrania klucza podstawowego w imieniu zalogowanej tożsamości.

4. Eksplorator danych zaloguje się automatycznie przy użyciu konta. Może to spowodować wyświetlenie krótkiego okna podręcznego bez monitowania o wpis poświadczeń. Jeśli automatyczne logowanie nie powiedzie się lub jeśli wyskakujące okienka zostaną zablokowane w przeglądarce, przed wykonaniem żądań danych musisz użyć przycisku Logowania dla RBAC identyfikatora entra (znajdującego się na pasku poleceń Eksploratora danych) i zezwolić na wyskakujące okienka dla Eksploratora danych.

   Napiwek

   Eksplorator danych usługi Azure Cosmos DB obsługuje również opcję ręcznego ustawiania wartości Enable Entra ID (RBAC) parametru https://cosmos.azure.com?feature.enableAadDataPlane=true na True przy użyciu adresu URL.

Znane problemy

Poniżej przedstawiono kilka obecnie znanych problemów:

• Elementy przeglądania zawierające identyfikator UUID nie są obsługiwane w Eksploratorze danych. To ograniczenie nie ma wpływu na ładowanie kontenerów, tylko wyświetlanie pojedynczych elementów lub zapytań zawierających te elementy. Aby wyświetlić te elementy i zarządzać nimi, użytkownicy powinni nadal używać tych samych zestawów SDK/narzędzi, które zostały pierwotnie użyte do utworzenia tych elementów.

• Błędy HTTP 401 mogą wystąpić z powodu niewystarczających uprawnień kontroli dostępu opartej na rolach dla konta Microsoft Entra ID. Ten warunek może być spełniony, szczególnie jeśli konto ma rolę niestandardową. Wszystkie role niestandardowe muszą mieć Microsoft.DocumentDB/databaseAccounts/listKeys/* akcję dołączona do korzystania z Eksploratora danych.

Następny krok

Wprowadzenie do zapytań