Conectar-se à API do Azure Cosmos DB for SQL no Microsoft Purview

Este artigo descreve o processo de registro e verificação da instância da API do Azure Cosmos DB for SQL no Microsoft Purview, incluindo instruções para autenticar e interagir com a origem do banco de dados do Azure Cosmos DB

Recursos compatíveis

Recursos de digitalização

Outros recursos

Para classificações, rótulos de confidencialidade, políticas, linhagem de dados e exibição ao vivo, consulte a lista de recursos com suporte.

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 um Leitor de Dados para registrar uma fonte e gerenciá-la no portal de governança do Microsoft Purview. Consulte nossa página de permissões do Microsoft Purview para obter detalhes.

Registrar

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

Passos 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:

   • Navegar diretamente e https://web.purview.azure.com selecionar sua conta do Microsoft Purview.
   • Abra o portal do Azure, pesquise e selecione a conta do Microsoft Purview. Selecione o botão do portal de governança do Microsoft Purview .

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

   

3. Crie a hierarquia da coleção usando o menu Coleções e atribua permissões a subcoleçõ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 da API do Azure Cosmos DB for SQL e selecione Continuar

   

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

   

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

   

Examinar

Autenticação para uma verificação

Para ter acesso para verificar a fonte de dados, é necessário configurar um método de autenticação na conta de armazenamento do banco de dados do Azure Cosmos DB.

Só há uma maneira de configurar a autenticação do banco de dados do Azure Cosmos DB:

Chave da Conta – os segredos podem ser criados dentro de um Azure Key Vault para armazenar credenciais, a fim de 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, uma senha de logon do 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 do banco de dados do Azure Cosmos DB

2. Selecione as chaves de configurações >

   

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

   

4. Navegue até seu cofre de chaves

   

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

   

6. Insira o Nome e o Valor como a chave de 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 sua verificação.

Criar a verificação

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

2. Navegue até o Mapa de dados -->Sources para exibir a hierarquia de coleções

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.

5. Escolha o runtime de integração do Azure se sua origem for acessível publicamente, um runtime de integração de rede virtual gerenciada se estiver usando uma rede virtual gerenciada ou um runtime de integração auto-hospedada se sua origem estiver em uma rede virtual privada. Para obter mais informações sobre qual runtime de integração usar, consulte o artigo Escolha a configuração de runtime de integração correta.

6. Escolha a coleção apropriada para a verificação e selecione + Novo em Credencial

   

7. Selecione a conexão apropriada do cofre de chaves e o nome do segredo que foi usado durante a criação da chave de conta. Escolher o método de autenticação como chave da conta

   

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

   

Escopo e execução da verificação

1. Você pode definir o escopo de sua digitalizaçã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, 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. Analise a verificação e selecione Salvar e executar.

   

Visualizando a Varredura

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 status da última execução será atualizado para Em andamento e, em seguida, Concluído depois que a verificação inteira for executada com êxito

   

   

Gerenciando a verificação

As verificações podem ser gerenciadas ou executadas novamente após a conclusão.

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

   

2. Você pode executar a verificação novamente, editá-la, excluir a verificação

   

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

   

Próximas etapas

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

• Insights sobre o patrimônio de dados no Microsoft Purview
• Linhagem no Microsoft Purview
• Pesquisar no Catálogo unificado