Administración de recursos de Azure Cosmos DB mediante el Explorador de Azure Storage

  • Artículo
  • 11 minutos para leer

SE APLICA A: SQL API Cassandra API Gremlin API Table API Azure Cosmos DB API para MongoDB

Puede usar el Explorador de Azure Storage para conectarse a Azure Cosmos DB. Le permite conectarse a cuentas de Azure Cosmos DB hospedadas en Azure y nubes independientes desde Windows, macOS o Linux.

Ahora puede usar la misma herramienta para administrar las diferentes entidades de Azure en un solo lugar. Puede administrar entidades de Azure Cosmos DB, manipular datos, actualizar procedimientos y desencadenadores almacenados, además de otras entidades de Azure como los blobs y las colas de Storage. Actualmente, el Explorador de Azure Storage admite cuentas de Cosmos que estén configuradas para las API de SQL, MongoDB, Graph y Table.

Nota

La integración de Azure Cosmos DB con Explorador de Storage ha quedado en desuso. Cualquier funcionalidad existente no se quitará durante un año como mínimo a partir de esta versión. En su lugar, debe usar Azure Portal, la aplicación de escritorio de Azure Portal o el Explorador de Azure Cosmos DB independiente. Las opciones alternativas contienen muchas características nuevas que actualmente no se admiten en Explorador de Storage.

Requisitos previos

Una cuenta de Cosmos con las API de SQL o Azure Cosmos DB para MongoDB. Si no tiene una cuenta, puede crear una gratis en Azure Portal. Consulte Azure Cosmos DB: Compilación de una aplicación web de SQL API con .NET y Azure Portal para más información.

Instalación

Para instalar los bits más recientes del Explorador de Azure Storage, consulte Explorador de Azure Storage. Se admiten las versiones de Windows, Linux y macOS.

Conexión a una suscripción de Azure

  1. Después de instalar el Explorador de Azure Storage, seleccione el icono de complemento en el panel izquierdo.

    Captura de pantalla que muestra el icono de complemento en el panel izquierdo.

  2. Seleccione Add an Azure Account (Agregar una cuenta de Azure) y seleccione Iniciar sesión.

    Captura de pantalla de la ventana Conectar a Azure Storage que muestra el botón de radio Agregar una cuenta de Azure seleccionado y el menú desplegable Entorno de Azure.

  3. En el cuadro de diálogo Inicio de sesión de Azure, seleccione Iniciar sesión y luego escriba las credenciales de Azure.

    Captura de pantalla de la ventana Iniciar sesión que muestra dónde escribir sus credenciales para su suscripción de Azure.

  4. Seleccione la suscripción en la lista y luego seleccione Aplicar.

    Captura de pantalla del panel Administración de cuentas, que muestra una lista de suscripciones y el botón Aplicar.

    El panel del Explorador se actualiza y muestra las cuentas de la suscripción seleccionada.

    Captura de pantalla del panel Explorador, actualizado para mostrar las cuentas de la suscripción seleccionada.

    La cuenta de Cosmos DB está conectada a su suscripción de Azure.

Uso de una cadena de conexión para conectarse a Azure Cosmos DB

Puede usar una cadena de conexión para conectarse a una instancia de Azure Cosmos DB. Este método solo es compatible con Table API y la API de SQL. Siga estos pasos para conectarse con una cadena de conexión:

  1. Busque Local and Attached (Locales y conectados) en el árbol de la izquierda, haga clic con el botón derecho en Cuentas de Cosmos DB y seleccione Conectarse a Cosmos DB.

    Captura de pantalla que muestra el menú desplegable después de hacer clic con el botón derecho, con la conexión a Azure Cosmos DB resaltada.

  2. En la ventana Conectarse a Cosmos DB:

    1. Seleccione la API en el menú desplegable.

    2. Pegue la cadena de conexión en el cuadro Cadena de conexión. Para más información sobre cómo recuperar la cadena de conexión principal, consulte Obtención de la cadena de conexión.

    3. Especifique una Etiqueta de cuenta y luego seleccione siguiente para comprobar el resumen.

    4. Seleccione Conectar para conectar la cuenta de Azure Cosmos DB.

      Captura de pantalla de la ventana Conectarse a Cosmos DB, donde se muestra el menú desplegable API, el cuadro Cadena de conexión y el cuadro Etiqueta de cuenta.

Nota

Si el Explorador de Azure Storage muestra que la cadena de conexión de Azure Cosmos DB tiene un formato no válido, asegúrese de que la cadena de conexión tenga un punto y coma (;) al final. Un ejemplo de una cadena de conexión de Azure Cosmos DB válida sería: AccountEndpoint=https://accountname.documents.azure.com:443;AccountKey=accountkey==;

Uso de un emulador local para conectarse a Azure Cosmos DB

Siga estos pasos para conectarse a Azure Cosmos DB con un emulador. Este método solo admite cuentas de SQL.

  1. Instale Emulador de Cosmos DB y ábralo. Para más información sobre cómo instalar el emulador, consulte Emulador de Cosmos DB.

  2. Busque Local and Attached (Locales y conectados) en el árbol de la izquierda, haga clic con el botón derecho en Cuentas de Cosmos DB y seleccione Conectarse a Emulador de Cosmos DB.

    Captura de pantalla que muestra el menú que aparece después de hacer clic con el botón derecho, con la opción Conectarse a Emulador de Cosmos DB resaltada.

  3. En la ventana Conectarse a Cosmos DB:

    1. Pegue la cadena de conexión en el cuadro Cadena de conexión. Para más información sobre cómo recuperar la cadena de conexión primaria, vea Obtener la cadena de conexión.

    2. Especifique una Etiqueta de cuenta y luego seleccione siguiente para comprobar el resumen.

    3. Seleccione Conectar para conectar la cuenta de Azure Cosmos DB.

      Captura de pantalla de la ventana Conectarse a Cosmos DB, donde se muestra el cuadro Cadena de conexión y el cuadro Etiqueta de cuenta.

Administración de recursos de Azure Cosmos DB

Use las siguientes operaciones para administrar una cuenta de Azure Cosmos DB:

  • Abrir la cuenta en Azure Portal.
  • Agregar el recurso a la lista de acceso rápido.
  • Buscar y actualizar recursos.
  • Crear y eliminar bases de datos.
  • Crear y eliminar colecciones.
  • Crear, editar, eliminar y filtrar documentos.
  • Administrar procedimientos almacenados, desencadenadores y funciones definidas por el usuario.

Tareas de acceso rápido

Puede hacer clic con el botón derecho en una suscripción en el panel Explorador para realizar muchas tareas de acción rápida, por ejemplo:

  • Haga clic con el botón derecho en una cuenta o una base de datos de Azure Cosmos DB y seleccione Abrir en el portal para administrar el recurso en el explorador en Azure Portal.

    Captura de pantalla que muestra el menú que aparece después de hacer clic con el botón derecho, con la opción Abrir en el portal resaltada.

  • Haga clic con el botón derecho en una cuenta, una base de datos o una colección de Azure Cosmos DB y seleccione Agregar a Acceso rápido para agregarla al menú de acceso rápido.

  • Buscar desde aquí permite realizar búsquedas de palabras clave en la ruta de acceso seleccionada.

    Captura de pantalla que muestra el cuadro de búsqueda resaltado.

Administración de bases de datos y recopilaciones

Crear una base de datos

  1. Haga clic con el botón derecho en la cuenta de Azure Cosmos DB y seleccione Crear base de datos.

    Captura de pantalla que muestra el menú que aparece después de hacer clic con el botón derecho, con la opción Crear base de datos resaltada.

  2. Escriba el nombre de la base de datos y presione Entrar para finalizar.

Eliminación de una base de datos

  1. Haga clic con el botón derecho en la base de datos y seleccione Eliminar base de datos.

    Captura de pantalla que muestra el menú que aparece después de hacer clic con el botón derecho, con la opción Eliminar base de datos resaltada.

  2. Seleccione Sí en la ventana emergente. Se elimina el nodo de la base de datos y la cuenta de Azure Cosmos DB se actualiza automáticamente.

    Captura de pantalla de la ventana de confirmación con el botón Sí resaltado.

Creación de una colección

  1. Haga clic con el botón derecho en la base de datos y seleccione Crear colección.

    Captura de pantalla que muestra el menú que aparece después de hacer clic con el botón derecho, con la opción Crear colección resaltada.

  2. En la ventana Crear colección, escriba la información solicitada, como Id. de colección y Capacidad de almacenamiento, etc. Seleccione Aceptar para finalizar.

    Captura de pantalla de la ventana Crear colección que muestra el cuadro Id. de colección y los botones de Capacidad de almacenamiento.

  3. Seleccione Sin límite para poder especificar una clave de partición y, después, seleccione Aceptar para finalizar.

    Nota

    Si se usa una clave de partición al crear una colección, una vez completada la creación no se podrá cambiar el valor de la clave de partición de la colección.

    Captura de pantalla de la ventana Crear colección, que muestra la opción Sin límite seleccionada como Capacidad de almacenamiento y el cuadro Clave de partición resaltado.

Eliminación de una colección

  • Haga clic con el botón derecho en la colección, seleccione Eliminar colección y luego seleccione Sí en la ventana emergente.

    Se elimina el nodo de colección y la base de datos se actualiza automáticamente.

    Captura de pantalla que muestra el menú que aparece después de hacer clic con el botón derecho, con la opción Eliminar colección resaltada.

Administración de documentos

Crear y modificar documentos

  • Abra Documentos en el panel izquierdo, seleccione Nuevo documento, edite el contenido en el panel derecho y seleccione Guardar.

  • También puede actualizar un documento existente y luego seleccionar Guardar. Para descartar los cambios, seleccione Descartar.

    Captura de pantalla que muestra la opción Documentos resaltada en el panel izquierdo. En el panel derecho están resaltadas las opciones Nuevo documento, Guardar y Descartar.

Eliminar un documento

  • Haga clic en el botón Eliminar para eliminar el documento seleccionado.

Consulta de documentos

  • Para editar el filtro de documento, escriba una Consulta SQL y seleccione Aplicar.

    Captura de pantalla del panel derecho que muestra los botones Filtrar y Aplicar, el número de identificación y el cuadro consulta resaltados.

Administración de gráficos

Creación y modificación de un vértice

  • Para crear un vértice, abra Grafo en el panel izquierdo, seleccione Nuevo vértice, edite el contenido y seleccione Aceptar.

  • Para modificar un vértice existente, seleccione el icono del lápiz del panel derecho.

    Captura de pantalla que muestra la opción Grafo seleccionada en el panel izquierdo y la opción Nuevo vértice y el icono de lápiz resaltados en el panel derecho.

Eliminación de un grafo

  • Para eliminar un vértice, seleccione el icono de la papelera que junto al nombre.

Filtro de grafos

  • Para editar el filtro de grafos, escriba una consulta de Gremlin y seleccione Aplicar filtro.

    Captura de pantalla que muestra la opción Grafo seleccionada en el panel izquierdo y la opción Aplicar filtro y el cuadro consulta resaltados en el panel derecho.

Administración de tablas

Cree y modifique una tabla

  • Para crear una tabla:

    1. En el panel izquierdo, abra Entidades y seleccione Agregar.

    2. En el cuadro de diálogo Agregar entidad, edite el contenido.

    3. Seleccione el botón Agregar propiedad para agregar una propiedad.

    4. Seleccione Insertar.

      Captura de pantalla que muestra la opción Entidades resaltada en el panel izquierdo y las opciones Agregar, Editar, Agregar propiedad e Insertar resaltadas en el panel derecho.

  • Para modificar una tabla, seleccione Editar, modifique el contenido y seleccione Actualizar.

Importación y exportación de una tabla

  • Para importarla, seleccione el botón Importar y elija una tabla existente.

  • Para exportarla, seleccione el botón Exportar y elija un destino.

    Captura de pantalla que muestra los botones Importar y Exportar resaltados en el panel derecho.

Eliminación de entidades

  • Seleccione las entidades y, luego, el botón Eliminar.

    Captura de pantalla que muestra el botón Eliminar resaltado en el panel derecho y una ventana emergente de confirmación con el valor Sí resaltado.

Consultar una tabla

  • Seleccione el botón Consulta, especifique una condición de consulta y seleccione el botón Ejecutar consulta. Para cerrar el panel de consulta, seleccione el botón Cerrar consulta.

    Captura de pantalla del panel derecho que muestra el botón Ejecutar consulta y el botón Cerrar consulta resaltados.

Administrar procedimientos almacenados, desencadenadores y UDF

  • Para crear un procedimiento almacenado:

    1. En el árbol de la izquierda, haga clic con el botón derecho en Procedimientos almacenados y seleccione Crear procedimiento almacenado.

      Captura de pantalla del panel izquierdo que muestra el menú que aparece después de hacer clic con el botón derecho, con la opción Crear procedimiento almacenado resaltada.

    2. Escriba un nombre en el lado izquierdo, escriba los scripts de procedimiento almacenado en el panel derecho y seleccione Crear.

  • Para modificar un procedimiento almacenado existente, haga doble clic en el procedimiento, realice la actualización y seleccione Actualizar para guardar. También puede seleccionar Descartar para cancelar el cambio.

  • Las operaciones para Desencadenadores y UDF son similares a las de Procedimientos almacenados.

Solución de problemas

A continuación se muestran soluciones a problemas comunes que surgen al usar Azure Cosmos DB en el Explorador de Storage.

Problemas de inicio de sesión

En primer lugar, reinicie la aplicación para ver si se corrige el problema. Si el problema persiste, continúe con la solución de problemas.

Certificado autofirmado de cadena de certificados

Existen varias razones por las que puede ver este error, las dos más comunes son:

  • Está detrás de un proxy transparente. Alguien, como el departamento de TI, intercepta el tráfico HTTPS, lo descifra y luego lo cifra mediante un certificado autofirmado.

  • Está ejecutando software, como software antivirus. El software inserta un certificado TLS/SSL autofirmado en los mensajes HTTPS que se reciben.

Cuando el Explorador de Storage encuentra un certificado autofirmado, no sabe si el mensaje HTTPS que recibe se ha alterado. Pero si tiene una copia del certificado autofirmado, puede indicar al Explorador de Storage que confíe en él. Si no está seguro de quién insertó el certificado, puede seguir estos pasos para intentar averiguarlo:

  1. Instale OpenSSL:

    • Windows: Cualquiera de las versiones ligeras es correcta.
    • En macOS y Linux: debe estar incluido en el sistema operativo.

  2. Ejecute OpenSSL:

    • Windows: Vaya al directorio de instalación y, luego, en /bin/ , haga doble clic en openssl.exe.
    • Mac y Linux: Ejecute openssl desde un terminal.

  3. Ejecute s_client -showcerts -connect microsoft.com:443.

  4. Busque certificados autofirmados. Si no está seguro de cuáles son autofirmados, busque cualquier lugar en el que el asunto ("s:") y el emisor ("i:") sean el mismo.

  5. Si encuentra certificados autofirmados, copie y pegue todo el contenido desde ---BEGIN CERTIFICATE--- a ---END CERTIFICATE--- (inclusive) en un nuevo archivo .CER para cada uno de los certificados.

  6. Abra el Explorador de Storage y vaya a Editar > Certificados SSL > Importar certificados. Use el selector de archivos para buscar, seleccionar y abrir los archivos .CER que creó.

Si no encuentra ningún certificado autofirmado, puede enviar comentarios para obtener más ayuda.

No se pueden recuperar las suscripciones

Si no puede recuperar las suscripciones después de iniciar sesión, pruebe estas sugerencias:

  • Compruebe que la cuenta tiene acceso a las suscripciones. Para ello, inicie sesión en Azure Portal.

  • Asegúrese de que ha iniciado sesión en el entorno correcto:

  • Si está detrás de un proxy, asegúrese de que ha configurado correctamente el proxy del Explorador de Storage.

  • Quite la cuenta y agréguela de nuevo.

  • Intente eliminar los siguientes archivos del directorio de inicio (como: C:\Users\ContosoUser) y, después, intente volver a agregar la cuenta:

    • .adalcache
    • .devaccounts
    • .extaccounts

  • Presione la tecla F12 para abrir la consola del desarrollador. Observe la consola para ver los mensajes de error al iniciar sesión.

    Captura de pantalla de la consola de herramientas de desarrollo, que muestra la opción Consola resaltada.

No se puede ver la página de autenticación

Si no puede ver la página de autenticación:

  • En función de la velocidad de la conexión, la página de inicio de sesión puede tardar unos minutos en cargarse. Espere al menos un minuto antes de cerrar el cuadro de diálogo de autenticación.
  • Si está detrás de un proxy, asegúrese de que ha configurado correctamente el proxy del Explorador de Storage.
  • En la consola de herramientas de desarrollo (F12), observe las respuestas para ver si puede encontrar alguna pista para saber por qué no funciona la autenticación.

No se puede quitar una cuenta

Si no puede quitar una cuenta, o si el vínculo para volver a autenticar no hace nada:

  • Intente eliminar los siguientes archivos del directorio de inicio y vuelva a agregar la cuenta:

    • .adalcache
    • .devaccounts
    • .extaccounts

  • Si desea quitar recursos de Storage conectados a SAS, elimine:

    • Carpeta %AppData%/StorageExplorer para Windows
    • /Users/<su_nombre>/Library/Application SUpport/StorageExplorer para macOS
    • ~/.config/StorageExplorer para Linux

    Nota

    Si elimina estos archivos, tendrá que volver a escribir todas sus credenciales.

Problema de proxy HTTP/HTTPS

No se pueden mostrar los nodos de Azure Cosmos DB en el árbol de la izquierda cuando se configura un proxy HTTP/HTTPS en ASE. Puede usar el Explorador de datos de Azure Cosmos DB en Azure Portal como solución alternativa.

Problema de nodo "Development" (Desarrollo) en nodo "Local and Attached" (Locales y conectados)

No se produce ninguna respuesta después de seleccionar el nodo Desarrollo en el nodo Local and Attached (Locales y conectados) en el árbol de la izquierda. Este comportamiento es normal.

Captura de pantalla que muestra el nodo Desarrollo seleccionado.

Error al conectar una cuenta de Azure Cosmos DB en el nodo Local and Attached (Locales y conectados)

Si ve el siguiente error después de conectar una cuenta de Azure Cosmos DB en nodo Local and Attached (Locales y conectados), asegúrese de que usa la cadena de conexión correcta.

Captura de pantalla de la ventana emergente del error No se han podido recuperar los recursos secundarios, que indica getaddrinfo ENOTFOUND.

Error al expandir el nodo de Azure Cosmos DB

Es posible que vea el siguiente error al intentar expandir los nodos del árbol de la izquierda.

Captura de pantalla de la ventana emergente del error No se han podido recuperar los recursos secundarios, que indica que no se puede conectar a esta cuenta de Cosmos DB.

Pruebe estas sugerencias:

  • Compruebe si el aprovisionamiento de la cuenta de Azure Cosmos DB está en curso. Inténtelo de nuevo cuando la cuenta se haya creado correctamente.
  • Si la cuenta se encuentra en los nodos Acceso rápido o Local and Attached (Locales y conectados), compruebe si la cuenta se ha eliminado. Si es así, tiene que quitar manualmente el nodo.

Pasos siguientes