Compartir a través de

Uso del Explorador de datos de Azure Cosmos DB para administrar los datos

  • Artículo

SE APLICA A: NoSQL MongoDB Cassandra Gremlin Table

El Explorador de datos de Azure Cosmos DB es una interfaz basada en web que permite ver y administrar los datos almacenados en Azure Cosmos DB.

El Explorador de datos de Azure Cosmos DB dedicado (https://cosmos.azure.com) tiene algunas ventajas clave en comparación con la experiencia del Explorador de datos de Azure Portal, 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 directamente al Explorador de datos mediante la suscripción de Azure

Puede usar el acceso directamente al Explorador de datos y usar las 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.

    Recorte de pantalla del menú

Acceso al Explorador de datos 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 de datos 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.

    Captura de pantalla de la página Explorador de datos con la opción

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

Personalización de las vistas de datos con el selector de columnas personalizado

El Selector de columnas personalizados en el Explorador de datos de Azure Cosmos DB le permite personalizar las vistas de datos seleccionando columnas específicas que son más relevantes para el análisis al usar la API NoSQL. Anteriormente, en la vista de elementos del Explorador de datos, solo podía ver las columnas de clave de partición e identificador. Ahora, con esta nueva característica, puede seleccionar una o varias propiedades del documento y crear columnas adicionales para ver fácilmente los datos. 

  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, (opcional) seleccione la opción menú Abrir pantalla completa.

    Captura de pantalla de la página Explorador de datos con la opción

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

  6. Una vez en el Explorador de datos, abra la colección que desea consultar, seleccione Elementos.

  7. Haga clic en el menú de puntos suspensivos de la parte superior derecha de cualquier columna, seleccione Editar columna.

  8. Seleccione las columnas que desea mostrar y guarde la configuración.

  9. La vista de datos ahora reflejará solo las columnas seleccionadas, lo que facilita centrarse en los datos pertinentes.

  10. Quitar una columna personalizada

  11. Una vez en el Explorador de datos, abra la colección que desea consultar, seleccione Elementos.

  12. Haga clic en el menú de puntos suspensivos de la parte superior derecha de cualquier columna y seleccione Quitar columna.

  13. Ordenar la vista de columna ascendente o descendente

  14. Una vez en el Explorador de datos, abra la colección que desea consultar, seleccione Elementos.

  15. Haga clic en el menú de puntos suspensivos de la parte superior derecha de cualquier columna y seleccione Quitar columna.

  16. Restablecer la vista de columna

  17. Una vez en el Explorador de datos, abra la colección que desea consultar, seleccione Elementos.

  18. Haga clic en el menú de puntos suspensivos de la parte superior derecha de cualquier columna y seleccione Editar columna.

  19. Seleccione Restablecer para volver a la vista predeterminada. O bien, puede borrar la configuración del historial de filtros, las columnas y la ventanilla seleccionando el icono de engranaje en el menú global del Explorador de datos superior derecho y seleccionando Borrar historial.

Uso del historial de filtros

El historial de filtros le permite volver a revisar y aplicar rápidamente filtros anteriores. Esto le ahorra de la tarea repetitiva de reconstruir manualmente los filtros para las consultas periódicas. Con el Historial de filtros, puede acceder a un registro de los filtros anteriores y volver a aplicarlos con un simple clic.  Esta característica es especialmente beneficiosa para los usuarios que realizan análisis regulares en conjuntos de datos similares.

  1. Aplicar un filtro guardado

  2. Una vez en el Explorador de datos, abra la colección que desea consultar, seleccione Elementos.

  3. Haga clic en Editar filtro.

  4. Aplique un filtro a los datos como lo haría normalmente.

Después de aplicar el filtro, el filtro se guardará automáticamente y se agregará a la lista Filtro predeterminado en la ventana de filtro Desplegable.

  1. Para volver a aplicar un filtro anterior, haga clic en el botón Editar filtro.

  2. Borre cualquier filtro de la ventana de filtro. Este paso es necesario para poder ver los filtros guardados.

  3. Haga clic en la lista Desplegable en la ventana de filtro y seleccione el filtro deseado en la lista.

  4. Seleccione Aplicar filtro

  5. Borrar el historial de filtros

  6. En el Explorador de datos, haga clic en el icono de engranaje de la esquina superior derecha del Explorador de datos para acceder a la configuración.

  7. Seleccione el botón Borrar historial

  8. Confirme que desea borrar el historial.  Esto incluye posiciones de separador de columna de filtro, columnas personalizadas y diseño de pestaña.

Cambiar la vista ventana de consulta

Hemos introducido una nueva característica en la vista de consulta que permite cambiar entre vistas horizontales y verticales para el panel de consulta y resultados. Puede alternar fácilmente entre estas vistas seleccionando la opción "Vistas" en el menú de la barra de comandos.

  1. Guardar las preferencias de la vista ventana de consulta

  2. En el Explorador de datos, haga clic en el icono de engranaje de la esquina superior derecha del Explorador de datos para acceder a la configuración.

  3. Seleccione "Vista de resultados de consulta predeterminada" en el menú desplegable.

  4. Seleccione horizontal o vertical como vista predeterminada.

  5. Haga clic en Guardar para aplicar la configuración.

Configuración del umbral de unidad de solicitud

En Data Explorer, 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. Inicie en el explorador para la cuenta de Azure Cosmos DB de destino.

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

    Captura de pantalla de una página del Explorador de datos con la opción

  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.

    Recorte de pantalla de la configuración individual para configurar el umbral de unidad de solicitud.

    > [!TIP]

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

Uso con la autenticación de Microsoft Entra

Puede usar la autenticación basada en Microsoft Entra en el explorador si la habilita a través de la configuración. Para obtener más información sobre el control de acceso basado en rol, consulte la guía de seguridad.

  1. Inicie en el explorador para la cuenta de Azure Cosmos DB de destino.

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

  3. En el cuadro de diálogoConfiguración, configure si desea Enable Entra ID (RBAC) usar uno de los tres valores posibles:

Descripción
Automatic (predeterminado) El control de acceso basado en rol (RBAC) se usa automáticamente si la autenticación basada en claves está deshabilitada para su cuenta. De lo contrario, Data Explorer usa la autenticación basada en claves para las solicitudes de datos.
Verdadero El control de acceso basado en rol siempre se usa para las solicitudes de datos. Si el control de acceso basado en rol no está configurado correctamente para la cuenta o la identidad, se producirá un error en las solicitudes.
Falso La autenticación basada en claves siempre se usa para las solicitudes de datos. Si la autenticación basada en claves está deshabilitada, se producirá un error en las solicitudes.

Recorte de pantalla de la configuración de control de acceso basado en rol de Microsoft Entra ID y tres valores potenciales.

Nota:

Cambiar esta configuración a una opción que usa la autenticación basada en claves podría desencadenar una solicitud para recuperar la clave principal en nombre de la identidad que ha iniciado sesión.

  1. El Explorador de datos iniciará sesión automáticamente con su cuenta. Esto puede mostrar una breve ventana emergente sin pedirle una entrada de credencial. Si se produce un error en el inicio de sesión automático o si los elementos emergentes están bloqueados en el explorador, debe usar el botónInicio de sesión para Entra ID RBAC (ubicado en la barra de comandos del Explorador de datos) y permitir elementos emergentes para Data Explorer antes de realizar solicitudes de datos.

    Sugerencia

    El Explorador de datos de Azure Cosmos DB también admite la opción de establecer manualmente el valor de en Enable Entra ID (RBAC) True mediante la dirección URL https://cosmos.azure.com?feature.enableAadDataPlane=true.

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 Data Explorer

Paso siguiente

Introducción a las consultas