Compartir a través de


Conexión a Azure Cosmos DB para SQL API en Microsoft Purview

En este artículo se describe el proceso para registrar y examinar la instancia de API de Azure Cosmos DB para SQL en Microsoft Purview, incluidas las instrucciones para autenticarse e interactuar con el origen de la base de datos de Azure Cosmos DB.

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
No No No** No No

** El linaje se admite si el conjunto de datos se usa como origen o receptor en Data Factory actividad de copia

Requisitos previos

Registrarse

Esta sección le permitirá registrar la instancia de API de Azure Cosmos DB para SQL y configurar un mecanismo de autenticación adecuado para garantizar el examen correcto del origen de datos.

Pasos para registrarse

Es importante registrar el origen de datos en Microsoft Purview antes de configurar un examen para el origen de datos.

  1. Abra el portal de gobernanza de Microsoft Purview:

  2. Vaya al mapa de datos:> colecciones

    Captura de pantalla que navega al vínculo Orígenes en el mapa de datos

  3. Cree la jerarquía de colecciones mediante el menú Colecciones y asigne permisos a subcolecciones individuales, según sea necesario.

    Captura de pantalla que muestra el menú de recopilación para crear la jerarquía de recopilación

  4. Vaya a la colección adecuada en el menú Orígenes y seleccione el icono Registrar para registrar una nueva base de datos de Azure Cosmos DB.

    Captura de pantalla que muestra la colección usada para registrar el origen de datos

  5. Seleccione el origen de datos de La API de Azure Cosmos DB para SQL y seleccione Continuar.

    Captura de pantalla que permite seleccionar el origen de datos

  6. Proporcione un nombre adecuado para el origen de datos, seleccione la suscripción de Azure pertinente, el nombre de la cuenta de Cosmos DB y la colección y seleccione Aplicar.

    Captura de pantalla que muestra los detalles que se especificarán para registrar el origen de datos

  7. La cuenta de almacenamiento de base de datos de Azure Cosmos DB se mostrará en la colección seleccionada.

    Captura de pantalla que muestra el origen de datos asignado a la colección para iniciar el examen

Examinar

Autenticación para un examen

Para tener acceso para examinar el origen de datos, es necesario configurar un método de autenticación en la cuenta de almacenamiento de la base de datos de Azure Cosmos DB.

Solo hay una manera de configurar la autenticación para Azure Cosmos DB Database:

Clave de cuenta: los secretos se pueden crear dentro de una Key Vault de Azure para almacenar las credenciales con el fin de habilitar el acceso a Microsoft Purview para examinar orígenes de datos de forma segura mediante los secretos. Un secreto puede ser una clave de cuenta de almacenamiento, una contraseña de inicio de sesión de SQL o una contraseña.

Nota:

Debe implementar un recurso de Azure Key Vault en su suscripción y asignar la MSI de la cuenta de Microsoft Purview con el permiso de acceso necesario a los secretos dentro del almacén de claves de Azure.

Uso de la clave de cuenta para el examen

Debe obtener la clave de acceso y almacenarla en el almacén de claves:

  1. Vaya a la cuenta de almacenamiento de base de datos de Azure Cosmos DB.

  2. Seleccionar claves de configuración >

    Captura de pantalla que muestra las claves de acceso en la cuenta de almacenamiento

  3. Copie la clave y guárdela por separado para los pasos siguientes.

    Captura de pantalla que muestra las claves de acceso que se van a copiar

  4. Vaya al almacén de claves.

    Captura de pantalla que muestra el almacén de claves

  5. Seleccione Secretos de configuración > y seleccione + Generar o importar.

    Captura de pantalla que muestra la opción del almacén de claves para generar un secreto

  6. Escriba el nombre y el valor como clave de la cuenta de almacenamiento y seleccione Crear para completar

    Captura de pantalla que muestra la opción del almacén de claves para especificar los valores del secreto

  7. Si el almacén de claves aún no está conectado a Microsoft Purview, deberá crear una nueva conexión del almacén de claves.

  8. Por último, cree una credencial con la clave para configurar el examen.

Creación del examen

  1. Abra la cuenta de Microsoft Purview y seleccione el portal de gobernanza de Microsoft Purview.

  2. Vaya a Mapa de datos -->Sources para ver la jerarquía de recopilación.

  3. Seleccione el icono Nuevo examen en la base de datos de Azure Cosmos registrada anteriormente.

    Captura de pantalla que muestra la pantalla para crear un nuevo examen

  4. Proporcione un nombre para el examen, elija la colección adecuada para el examen y seleccione + Nuevo en Credencial.

    Captura de pantalla que muestra la opción Clave de cuenta para el examen

  5. Seleccione la conexión de Key Vault adecuada y el nombre del secreto que se usó al crear la clave de cuenta. Elija el método de autenticación como clave de cuenta.

    Captura de pantalla que muestra las opciones de clave de cuenta

  6. Seleccione Probar conexión. En una conexión correcta, seleccione Continuar.

    Captura de pantalla que muestra cómo probar la conexión correcta

Ámbito y ejecución del examen

  1. Para limitar el examen a carpetas y subcarpetas específicas, elija los elementos adecuados de la lista.

    Ámbito del examen

  2. A continuación, seleccione un conjunto de reglas de examen. Puede elegir entre los conjuntos de reglas personalizados predeterminados del sistema existentes o crear un nuevo conjunto de reglas alineado.

    Conjunto de reglas de examen

    Nueva regla de examen

  3. Puede seleccionar las reglas de clasificación que se incluirán en la regla de examen.

    Reglas de clasificación del conjunto de reglas de examen

    Selección del conjunto de reglas de examen

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

    Desencadenador de examen

  5. Revise el examen y seleccione Guardar y ejecutar.

    examen de revisión

Visualización del examen

  1. Vaya al origen de datos de la colección y seleccione Ver detalles para comprobar el estado del examen.

    examen de vista

  2. Los detalles del examen indican el progreso del examen en el estado De última ejecución y el número de recursos examinados y clasificados

    ver detalles del examen

  3. El estado De última ejecución se actualizará a En curso y, a continuación, se completará una vez que todo el examen se haya ejecutado correctamente.

    visualización del examen en curso

    visualización del examen completado

Administración del examen

Los exámenes se pueden administrar o ejecutar de nuevo al finalizar.

  1. Seleccione el nombre del examen para administrar el examen.

    administrar examen

  2. Puede volver a ejecutar el examen, editarlo, eliminar el examen.

    administrar opciones de examen

  3. Puede volver a ejecutar un examen completo .

    examen completo

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.