Uso del Explorador de Azure Cosmos DB para administrar los datos

  • Artículo

SE APLICA A: NoSQL MongoDB Cassandra Gremlin Table

El Explorador de Azure Cosmos DB es una interfaz independiente basada en web que permite ver y administrar los datos almacenados en Azure Cosmos DB. El Explorador de Azure Cosmos DB es equivalente a la sección existente Explorador de datos que está disponible en Azure Portal para cuentas de Azure Cosmos DB.

El Explorador de Azure Cosmos DB tiene algunas ventajas clave en comparación con el Explorador de datos, entre las que se incluyen:

  • Bienes raíces de pantalla completa para examinar datos, ejecutar consultas y observar los resultados de la consulta
  • Capacidad de proporcionar a los usuarios sin acceso a Azure Portal o a una suscripción de Azure funcionalidades de lectura o escritura a través de datos en contenedores
  • Capacidad de compartir resultados de consulta con usuarios que no tienen acceso a una suscripción de Azure o a Azure Portal

Requisitos previos

Acceso al Explorador directamente mediante la suscripción de Azure

Puede usar el acceso directamente al Explorador y usar sus credenciales existentes para empezar a trabajar rápidamente con la herramienta.

  1. Vaya a https://cosmos.azure.com.

  2. Seleccione Iniciar sesión. Inicie sesión con las credenciales existentes que tengan acceso a la cuenta de Azure Cosmos DB.

  3. A continuación, seleccione la suscripción de Azure y la cuenta de destino en el menú Seleccionar una cuenta de base de datos.

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

Acceso al Explorador desde Azure Portal mediante la suscripción de Azure

Si ya está familiarizado con Azure Portal, puede navegar directamente desde el Explorador de datos en el portal al Explorador independiente.

  1. Inicie sesión en Azure Portal.

  2. Vaya a la cuenta de Azure Cosmos DB existente.

  3. En el menú de recursos, seleccione Explorador de datos.

  4. A continuación, seleccione la opción de menú Abrir pantalla completa.

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

  5. En el cuadro de diálogo Abrir pantalla completa, seleccione Abrir.

Conceder a otra persona acceso al Explorador mediante una cadena de conexión

Use la clave de lectura-escritura o solo lectura para conceder a otro usuario acceso a su cuenta de Azure Cosmos DB. Este método funciona incluso si el usuario no tiene acceso a una suscripción de Azure o a Azure Portal.

  1. Inicie sesión en Azure Portal.

  2. Vaya a la cuenta de Azure Cosmos DB existente.

  3. En el menú de recursos, seleccione Registros.

  4. En la páginaclaves, seleccione la opción Claves de lectura y escritura o Claves de solo lectura. A continuación, copie el valor del campo Cadena de conexión principal. Se usará este valor en un paso posterior.

    Descripción
    Claves de lectura y escritura Proporciona acceso para ver y modificar las bases de datos, contenedores, consultas y otros recursos asociados a esa cuenta específica
    Clave de solo lectura Proporciona acceso para ver bases de datos, contenedores, consultas y otros recursos asociados a esa cuenta específica

    Sugerencia

    Si desea compartir los resultados de una consulta con sus compañeros de equipo que no tienen acceso a una suscripción de Azure o a Azure Portal, puede proporcionarles el valor de solo lectura .

  5. Ahora, haga que el otro usuario vaya a https://cosmos.azure.com.

  6. Seleccione Conectar a su cuenta con la cadena de conexión. A continuación, haga que el usuario escriba la cadena de conexión copiada anteriormente y seleccione Conectar.

Configuración del umbral de unidad de solicitud

En el Explorador, puede configurar un límite para las unidades de solicitud por segundo (RU/s) que usan las consultas. Use esta funcionalidad para controlar el costo y el rendimiento en las unidades de solicitud (RU) de las consultas. Esta funcionalidad también puede cancelar automáticamente consultas de alto costo.

  1. Comience en el Explorador para la cuenta de Azure Cosmos DB de destino.

  2. Seleccione la opción de menú Configuración.

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

  3. En el cuadro de diálogo Configuración, configure si desea Habilitar el umbral de RU y el valor real del Umbral de RU.

    Screenshot of the individual settings to configure the request unit threshold

    Sugerencia

    El umbral de RU se habilita automáticamente con un valor predeterminado de 5000RU.

Problemas conocidos

Estos son algunos problemas conocidos actualmente:

  • Los elementos de exploración que contienen un UUID no se admiten en el Explorador de datos. Esta limitación no afecta a la carga de contenedores, solo la visualización de elementos o consultas individuales que incluyen estos elementos. Para ver y administrar estos elementos, los usuarios deben seguir usando las mismas herramientas o SDK que se usaron originalmente para crear estos elementos.

  • Los errores HTTP 401 pueden producirse debido a que no hay permisos de control de acceso basados en rol suficientes para la cuenta de Microsoft Entra ID. Esta condición puede ser cierta especialmente si la cuenta tiene un rol personalizado. Los roles personalizados deben tener la acción Microsoft.DocumentDB/databaseAccounts/listKeys/* incluida para usar el Explorador.

Paso siguiente

Introducción a las consultas