Conectar-se ao Azure Cosmos DB para API SQL no Microsoft Purview

Este artigo descreve o processo para registrar e examinar a instância da API do Azure Cosmos DB no Microsoft Purview, incluindo instruções para autenticar e interagir com a fonte de banco de dados do Azure Cosmos DB

Recursos compatíveis

** Há suporte para linhagem se o conjunto de dados for usado como fonte/coletor no Data Factory atividade Copy

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.

• Uma conta ativa do Microsoft Purview.

• Você precisará ser um Administrador de Fonte de Dados e Leitor de Dados para registrar uma fonte e gerenciá-la no portal de governança do Microsoft Purview. Consulte nossa página Permissões do Microsoft Purview para obter detalhes.

Registrar

Esta seção permitirá que você registre a instância da API do Azure Cosmos DB para SQL e configure um mecanismo de autenticação apropriado para garantir a verificação bem-sucedida da fonte de dados.

Etapas para se registrar

É importante registrar a fonte de dados no Microsoft Purview antes de configurar uma verificação para a fonte de dados.

1. Abra o portal de governança do Microsoft Purview por:

   • Navegando diretamente para https://web.purview.azure.com e selecionando sua conta do Microsoft Purview.
   • Abrindo o portal do Azure, pesquisando e selecionando a conta do Microsoft Purview. Selecione o botão portal de governança do Microsoft Purview .

2. Navegar até o Mapa de Dados --> Coleções

   

3. Criar a hierarquia Collection usando o menu Coleções e atribuir permissões a subcolleções individuais, conforme necessário

   

4. Navegue até a coleção apropriada no menu Fontes e selecione o ícone Registrar para registrar um novo banco de dados do Azure Cosmos DB

   

5. Selecione a fonte de dados do Azure Cosmos DB para API SQL e selecione Continuar

   

6. Forneça um nome adequado para a fonte de dados, selecione a assinatura relevante do Azure, o nome da conta do Cosmos DB e a coleção e selecione Aplicar

   

7. A conta de armazenamento de banco de dados do Azure Cosmos DB será mostrada na Coleção selecionada

   

Examinar

Autenticação para uma verificação

Para ter acesso à verificação da fonte de dados, um método de autenticação na conta de armazenamento de banco de dados do Azure Cosmos DB precisa ser configurado.

Há apenas uma maneira de configurar a autenticação para o Banco de Dados do Azure Cosmos DB:

Chave de Conta – Segredos podem ser criados dentro de um Key Vault do Azure para armazenar credenciais para permitir o acesso do Microsoft Purview para verificar fontes de dados com segurança usando os segredos. Um segredo pode ser uma chave de conta de armazenamento, senha de logon SQL ou uma senha.

Usando a Chave da Conta para verificação

Você precisa obter sua chave de acesso e armazenar no cofre de chaves:

1. Navegue até sua conta de armazenamento de banco de dados do Azure Cosmos DB

2. Selecionar Chaves de Configurações >

   

3. Copie sua chave e salve-a separadamente para as próximas etapas

   

4. Navegue até o cofre de chaves

   

5. Selecione Segredos de Configurações > e selecione + Gerar/Importar

   

6. Insira o Nome e o Valor como a chave da sua conta de armazenamento e selecione Criar para concluir

   

7. Se o cofre de chaves ainda não estiver conectado ao Microsoft Purview, você precisará criar uma nova conexão do cofre de chaves

8. Por fim, crie uma nova credencial usando a chave para configurar a verificação.

Criando a verificação

1. Abra sua conta do Microsoft Purview e selecione o portal de governança Open Microsoft Purview

2. Navegue até o mapa de dados -->Fontes para exibir a hierarquia de coleção

3. Selecione o ícone Nova Verificação no banco de dados do Azure Cosmos registrado anteriormente

   

4. Forneça um nome para a verificação, escolha a coleção apropriada para a verificação e selecione + Novo em Credencial

   

5. Selecione a conexão apropriada do key vault e o nome segredo usado durante a criação da Chave da Conta. Escolher método de autenticação como Chave de Conta

   

6. Selecione Testar conexão. Em uma conexão bem-sucedida, selecione Continuar

   

Escopo e execução da verificação

1. Você pode escopo sua verificação para pastas e subpastas específicas escolhendo os itens apropriados na lista.

   

2. Em seguida, selecione um conjunto de regras de verificação. Você pode escolher entre o padrão do sistema, os conjuntos de regras personalizados existentes ou criar um novo conjunto de regras embutido.

   

   

3. Você pode selecionar as regras de classificação a serem incluídas na regra de verificação

   

   

4. Escolha o gatilho de verificação. Você pode configurar uma agenda ou executar a verificação uma vez.

   

5. Examine a verificação e selecione Salvar e executar.

   

Exibição de verificação

1. Navegue até a fonte de dados na Coleção e selecione Exibir Detalhes para marcar o status da verificação

   

2. Os detalhes da verificação indicam o progresso da verificação no último status de execução e o número de ativos verificados e classificados

   

3. O último status de execução será atualizado para Em andamento e concluído depois que a verificação inteira for executada com êxito

   

   

Gerenciando a verificação

Os exames podem ser gerenciados ou executados novamente após a conclusão.

1. Selecione o nome De verificação para gerenciar a verificação

   

2. Você pode executar a verificação novamente, editar a verificação, excluir a verificação

   

3. Você pode executar uma verificação completa novamente

   

Próximas etapas

Agora que você registrou sua origem, siga os guias a seguir para saber mais sobre o Microsoft Purview e seus dados.

• Insights do Data Estate no Microsoft Purview
• Linhagem no Microsoft Purview
• Pesquisar Catálogo de Dados