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

Artigo
08/23/2023

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

Extração de metadados	Verificação Completa	Verificação Incremental	Verificação em escopo	Classificação	Rotulamento	Política de Acesso	Linhagem	Compartilhamento de dados	Exibição ao vivo
Sim	Sim	Não	Sim	Sim	Sim	Não	Não**	Não	Não

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

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 .
Navegar até o Mapa de Dados --> Coleções
Criar a hierarquia Collection usando o menu Coleções e atribuir permissões a subcolleções individuais, conforme necessário
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
Selecione a fonte de dados do Azure Cosmos DB para API SQL e selecione Continuar
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
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.

Observação

Você precisa implantar um recurso do cofre de chaves do Azure em sua assinatura e atribuir o MSI da conta do Microsoft Purview com a permissão de acesso necessária a segredos dentro do cofre de chaves do Azure.

Usando a Chave da Conta para verificação

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

Navegue até sua conta de armazenamento de banco de dados do Azure Cosmos DB
Selecionar Chaves de Configurações >
Copie sua chave e salve-a separadamente para as próximas etapas
Navegue até o cofre de chaves
Selecione Segredos de Configurações > e selecione + Gerar/Importar
Insira o Nome e o Valor como a chave da sua conta de armazenamento e selecione Criar para concluir
Se o cofre de chaves ainda não estiver conectado ao Microsoft Purview, você precisará criar uma nova conexão do cofre de chaves
Por fim, crie uma nova credencial usando a chave para configurar a verificação.

Criando a verificação

Abra sua conta do Microsoft Purview e selecione o portal de governança Open Microsoft Purview
Navegue até o mapa de dados -->Fontes para exibir a hierarquia de coleção
Selecione o ícone Nova Verificação no banco de dados do Azure Cosmos registrado anteriormente
Forneça um nome para a verificação, escolha a coleção apropriada para a verificação e selecione + Novo em Credencial
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
Selecione Testar conexão. Em uma conexão bem-sucedida, selecione Continuar

Escopo e execução da verificação

Você pode escopo sua verificação para pastas e subpastas específicas escolhendo os itens apropriados na lista.
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.
Você pode selecionar as regras de classificação a serem incluídas na regra de verificação
Escolha o gatilho de verificação. Você pode configurar uma agenda ou executar a verificação uma vez.
Examine a verificação e selecione Salvar e executar.

Exibição de verificação

Navegue até a fonte de dados na Coleção e selecione Exibir Detalhes para marcar o status da verificação
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
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.

Selecione o nome De verificação para gerenciar a verificação
Você pode executar a verificação novamente, editar a verificação, excluir a verificação
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.