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.

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.

   

   Napiwek

   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. Teraz wybierz opcję Login for Entra ID RBAC na pasku poleceń eksploratora.

   Napiwek

   Ten krok nie jest konieczny w przypadku korzystania z Eksploratora danych usługi Azure Cosmos DB (https://cosmos.azure.com). 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ń