Použití Průzkumníka služby Azure Cosmos DB ke správě dat

PLATÍ PRO: NoSQL MongoDB Cassandra Gremlin Tabulka

Průzkumník služby Azure Cosmos DB je samostatné webové rozhraní, které umožňuje zobrazit a spravovat data uložená ve službě Azure Cosmos DB. Průzkumník služby Azure Cosmos DB je ekvivalentem existující části Průzkumník dat, která je k dispozici na webu Azure Portal pro účty Azure Cosmos DB.

Průzkumník služby Azure Cosmos DB má v porovnání s Průzkumníkem dat několik klíčových výhod, mezi které patří:

  • Nemovitosti na celé obrazovce pro procházení dat, spouštění dotazů a sledování výsledků dotazů
  • Možnost poskytovat uživatelům bez přístupu k webu Azure Portal nebo k funkcím čtení nebo zápisu do předplatného Azure přes data v kontejnerech
  • Možnost sdílet výsledky dotazů s uživateli, kteří nemají přístup k předplatnému Azure nebo webu Azure Portal

Požadavky

Přímý přístup k Průzkumníku pomocí předplatného Azure

K rychlému zahájení práce s nástrojem můžete použít přímý přístup k Průzkumníku a použít stávající přihlašovací údaje.

  1. Přejděte na https://cosmos.azure.com.

  2. Vyberte Přihlásit se. Přihlaste se pomocí stávajících přihlašovacích údajů, které mají přístup k účtu služby Azure Cosmos DB.

  3. V dalším kroku vyberte své předplatné Azure a cílový účet v nabídce Vybrat účet databáze.

    Screenshot of the 'Select a Database Account' menu in the Explorer.

Přístup k Průzkumníku z webu Azure Portal pomocí předplatného Azure

Pokud jste už s webem Azure Portal spokojení, můžete přejít přímo z Průzkumníka dat na portálu do samostatného Průzkumníka.

  1. Přihlaste se na portál Azure.

  2. Přejděte k existujícímu účtu služby Azure Cosmos DB.

  3. V nabídce prostředků vyberte Průzkumník dat.

  4. V dalším kroku vyberte možnost otevřít nabídku Na celou obrazovku.

    Screenshot of the Data Explorer page with the 'Open Full Screen' option highlighted.

  5. V dialogovém okně Otevřít celou obrazovku vyberte Otevřít.

Udělení přístupu k Průzkumníku někomu jinému pomocí připojovací řetězec

Pomocí klíče jen pro čtení nebo jen pro čtení dejte jinému uživateli přístup k vašemu účtu služby Azure Cosmos DB. Tato metoda funguje i v případě, že uživatel nemá přístup k předplatnému Azure nebo webu Azure Portal.

  1. Přihlaste se na portál Azure.

  2. Přejděte k existujícímu účtu služby Azure Cosmos DB.

  3. V nabídce prostředků vyberte Klíče.

  4. Na stránce klíče vyberte možnost Klíče pro čtení i zápis nebo Klíče jen pro čtení. Potom zkopírujte hodnotu pole Primary Připojení ion String. Tuto hodnotu použijete v pozdějším kroku.

    Popis
    Klíč pro čtení i zápis Poskytuje přístup k zobrazení a úpravám databází, kontejnerů, dotazů a dalších prostředků přidružených k určitého účtu.
    Klíč jen pro čtení Poskytuje přístup k zobrazení databází, kontejnerů, dotazů a dalších prostředků přidružených k určitého účtu.

    Tip

    Pokud chcete sdílet výsledky dotazu se svými členy týmu, kteří nemají přístup k předplatnému Azure nebo webu Azure Portal, můžete je poskytnout jen pro čtení.

  5. Teď přejděte k https://cosmos.azure.comjinému uživateli .

  6. Vyberte Připojení ke svému účtu pomocí připojovací řetězec. Potom požádejte uživatele, aby dříve zkopíroval připojovací řetězec a vyberte Připojení.

Konfigurace prahové hodnoty jednotek žádosti

V Průzkumníku můžete nakonfigurovat omezení jednotek žádostí za sekundu (RU/s), které dotazy používají. Pomocí této funkce můžete řídit náklady a výkon v jednotkách žádostí (RU) vašich dotazů. Tato funkce může také automaticky rušit dotazy s vysokými náklady.

  1. Začněte v Průzkumníkovi pro cílový účet služby Azure Cosmos DB.

  2. Vyberte možnost nabídky Nastavení.

    Screenshot of an Data Explorer page with the 'Open Settings' option highlighted.

  3. V dialogovém okně Nastavení nakonfigurujte, jestli chcete povolit prahovou hodnotu RU a skutečnou prahovou hodnotu RU.

    Screenshot of the individual settings to configure the request unit threshold

    Tip

    Prahová hodnota RU je povolena automaticky s výchozí hodnotou 5 000 RU.

Známé problémy

Tady je několik aktuálně známých problémů:

  • Procházení položek obsahujících UUID se v Průzkumníku dat nepodporuje. Toto omezení nemá vliv na načítání kontejnerů, pouze prohlížení jednotlivých položek nebo dotazů, které obsahují tyto položky. Pokud chcete tyto položky zobrazit a spravovat, měli by uživatelé dál používat stejné nástroje nebo sady SDK, které byly původně použity k vytvoření těchto položek.

  • K chybám HTTP 401 může dojít kvůli nedostatečným oprávněním řízení přístupu na základě role pro váš účet Microsoft Entra ID. Tato podmínka může být pravdivá zejména v případě, že má účet vlastní roli. Aby bylo možné používat Průzkumníka, musí mít Microsoft.DocumentDB/databaseAccounts/listKeys/* všechny vlastní role zahrnutou akci.

Další krok