Conexión y administración de MongoDB en Microsoft Purview

  • Artículo

En este artículo se describe cómo registrar MongoDB y cómo autenticar e interactuar con MongoDB en Microsoft Purview. Para obtener más información sobre Microsoft Purview, lea el artículo introductorio.

Funciones admitidas

Extracción de metadatos Examen completo Examen incremental Examen con ámbito Clasificación Etiquetar Directiva de acceso Linaje Uso compartido de datos Vista en vivo
Sí Sí No Sí No No No No No No

Las versiones admitidas de MongoDB son 2.6 a 5.1.

Al examinar el origen de MongoDB, Microsoft Purview admite la extracción de metadatos técnicos, entre los que se incluyen:

  • Servidor
  • Databases
  • Colecciones que incluyen el esquema
  • Vistas que incluyen el esquema

Durante el examen, Microsoft Purview recupera y analiza documentos de ejemplo para inferir el esquema de colección o vista. El tamaño de ejemplo es configurable.

Al configurar el examen, puede elegir examinar una o varias bases de datos de MongoDB por completo, o limitar aún más el examen a un subconjunto de colecciones que coincidan con los nombres o patrones de nombre especificados.

Limitaciones conocidas

Cuando se elimina el objeto del origen de datos, actualmente el examen posterior no quitará automáticamente el recurso correspondiente en Microsoft Purview.

Requisitos previos

Registrarse

En esta sección se describe cómo registrar MongoDB en Microsoft Purview mediante el portal de gobernanza de Microsoft Purview.

Pasos para registrarse

Para registrar un nuevo origen de MongoDB en el catálogo de datos, haga lo siguiente:

  1. Vaya a su cuenta de Microsoft Purview en el portal de gobernanza de Microsoft Purview.
  2. Seleccione Mapa de datos en el panel de navegación izquierdo.
  3. Seleccione Registrar.
  4. En Registrar orígenes, seleccione MongoDB. Seleccione Continuar.

En la pantalla Registrar orígenes (MongoDB), haga lo siguiente:

  1. Escriba un nombre que indique que el origen de datos aparecerá en el catálogo.

  2. Escriba el nombre del servidor . Especifique un nombre para identificar de forma única la instancia de MongoDB en su empresa. Por ejemplo, host para la implementación independiente, MyReplicaSetName para el conjunto de réplicas, MyClusterName para el clúster particionado. Este valor se usará en el nombre completo del recurso y no se puede cambiar.

  3. Seleccione una colección o cree una nueva (opcional).

  4. Termine de registrar el origen de datos.

    opciones de orígenes de registro

Examinar

Siga los pasos siguientes para examinar MongoDB para identificar automáticamente los recursos. Para obtener más información sobre el examen en general, consulte nuestra introducción a los exámenes y la ingesta.

Autenticación para un examen

El tipo de autenticación admitido para un origen de MongoDB es autenticación básica.

Creación y ejecución de un examen

Para crear y ejecutar un nuevo examen, haga lo siguiente:

  1. En el Centro de administración, seleccione Entornos de ejecución de integración. Asegúrese de que está configurado un entorno de ejecución de integración autohospedado. Si no está configurado, siga estos pasos para crear un entorno de ejecución de integración autohospedado.

  2. Vaya a Orígenes.

  3. Seleccione el origen de MongoDB registrado.

  4. Seleccione + Nuevo examen.

  5. Proporcione los detalles siguientes:

    1. Nombre: nombre del examen

    2. Conectar a través del entorno de ejecución de integración: seleccione el entorno de ejecución de integración autohospedado que se usa para realizar el examen.

    3. Credencial: seleccione la credencial para conectarse al origen de datos. Asegúrese de:

      • Seleccione Autenticación básica al crear una credencial.
      • Proporcione el nombre de usuario que se usa para conectarse a MongoDB en el campo De entrada Nombre de usuario.
      • Almacene la contraseña de usuario usada para conectarse a MongoDB en la clave secreta.

    4. Cadena de conexión: especifique la cadena de conexión de MongoDB que se usa para conectarse a MongoDB, excepto el nombre de usuario y la contraseña. Por ejemplo, mongodb://mongodb0.example.com:27017,mongodb1.example.com:27017/?replicaSet=myRepl.

    5. Bases de datos: especifique una lista de bases de datos de MongoDB que se van a importar. La lista puede tener uno o varios nombres de base de datos separados por punto y coma (;), por ejemplo, database1; database2.

    6. Colecciones: subconjunto de colecciones que se van a importar expresadas como una lista separada por punto y coma de colecciones, por ejemplo, collection1; collection2. Todas las colecciones se importan si la lista está vacía.

      Los patrones de nombres de colección aceptables que usan la sintaxis de expresiones DE SQL LIKE incluyen el uso de %. Por ejemplo: : A%; %B; %C%; D

      • Empezar con A o
      • Terminar con B o
      • Contener C o
      • D igual

      El uso de NOT y caracteres especiales no es aceptable.

    7. Número de documentos de ejemplo: número de documentos de ejemplo que se van a analizar para la extracción de esquemas. El valor predeterminado es 10.

    8. Memoria máxima disponible (aplicable cuando se usa el entorno de ejecución de integración autohospedado): memoria máxima (en GB) disponible en la máquina virtual del cliente que usarán los procesos de examen. Depende del tamaño del origen de MongoDB que se va a examinar.

      examen de MongoDB

  6. Seleccione Probar conexión para validar las configuraciones.

  7. Seleccione Continuar.

  8. Elija el desencadenador de examen. Puede configurar una programación o ejecutar el examen una vez.

  9. Revise el examen y seleccione Guardar y ejecutar.

Visualización de los exámenes y las ejecuciones de examen

Para ver los exámenes existentes:

  1. Vaya al portal de gobernanza de Microsoft Purview. En el panel izquierdo, seleccione Mapa de datos.
  2. Seleccione el origen de datos. Puede ver una lista de exámenes existentes en ese origen de datos en Exámenes recientes o puede ver todos los exámenes en la pestaña Exámenes .
  3. Seleccione el examen que tiene los resultados que desea ver. En el panel se muestran todas las ejecuciones de examen anteriores, junto con el estado y las métricas de cada ejecución de examen.
  4. Seleccione el identificador de ejecución para comprobar los detalles de la ejecución del examen.

Administrar los exámenes

Para editar, cancelar o eliminar un examen:

  1. Vaya al portal de gobernanza de Microsoft Purview. En el panel izquierdo, seleccione Mapa de datos.

  2. Seleccione el origen de datos. Puede ver una lista de exámenes existentes en ese origen de datos en Exámenes recientes o puede ver todos los exámenes en la pestaña Exámenes .

  3. Seleccione el examen que desea administrar. Después, podrá:

    • Edite el examen seleccionando Editar examen.
    • Para cancelar un examen en curso, seleccione Cancelar ejecución del examen.
    • Para eliminar el examen, seleccione Eliminar examen.

Nota:

  • La eliminación del examen no elimina los recursos de catálogo creados a partir de exámenes anteriores.
  • El recurso ya no se actualizará con los cambios de esquema si la tabla de origen ha cambiado y vuelve a examinar la tabla de origen después de editar la descripción en la pestaña Esquema de Microsoft Purview.

Siguientes pasos

Ahora que ha registrado su origen, siga las guías siguientes para obtener más información sobre Microsoft Purview y sus datos.