Biblioteca de clientes de Verificação do Azure Purview para .NET – versão 1.0.0-beta.2

Artigo
04/18/2023

A Verificação do Azure Purview é um serviço de nuvem totalmente gerenciado cujos usuários podem examinar seus dados em seu patrimônio de dados (também conhecido como seu catálogo). A verificação é um processo pelo qual o catálogo se conecta diretamente a uma fonte de dados de acordo com uma agenda especificada pelo usuário.

Examinar seus dados em seu catálogo
Examinar seus dados
Extrair esquemas de seus dados

Confie muito na documentação do serviço e nos documentos do cliente de protocolo para usar essa biblioteca

Código-fonte | Pacote (NuGet) | Documentação do produto

Introdução

Instalar o pacote

Instale a biblioteca de clientes de Verificação do Azure Purview para .NET com o NuGet:

dotnet add package Azure.Analytics.Purview.Scanning --prerelease

Pré-requisitos

Você deve ter uma assinatura do Azure e um recurso do Purview para usar esse pacote.

Autenticar o cliente

Como usar o Azure Active Directory

Este documento demonstra como usar DefaultAzureCredential para autenticar por meio do Azure Active Directory. No entanto, qualquer uma das credenciais oferecidas pelo Azure.Identity será aceita. Consulte a documentação do Azure.Identity para obter mais informações sobre outras credenciais.

Depois de escolher e configurar sua credencial, você poderá criar instâncias do PurviewScanningClient.

var credential = new DefaultAzureCredential();
var client = new PurviewScanningClient(new Url("https://<my-account-name>.scan.purview.azure.com"), credential);

Principais conceitos

Métodos de protocolo

As operações expostas pelo SDK de Verificação do Purview para .NET usam métodos de protocolo para expor as operações REST subjacentes. Saiba mais sobre como usar clientes do SDK que usam métodos de protocolo em nossa documentação.

Acesso thread-safe

Garantimos que todos os métodos de instância do cliente sejam thread-safe e independentes uns dos outros (diretriz). Isso garante que a recomendação de reutilize instâncias de cliente seja sempre segura, mesmo entre threads.

Conceitos adicionais

Exemplos

A seção a seguir mostra como inicializar e autenticar seu cliente e, em seguida, listar todas as suas fontes de dados.

Listar todas as fontes de dados

var credential = new DefaultAzureCredential();
var client = new PurviewScanningServiceClient(new Uri("https://<my-account-name>.scan.purview.azure.com"), credential);

var response = await client.GetDataSourcesAsync();
var responseDocument = JsonDocument.Parse(response.Content);
Console.WriteLine(responseDocument.RootElement.GetProperty("value"));

Solução de problemas

Configuração do registro em log do console

A maneira mais simples de ver os logs é habilitar o log do console. Para criar um ouvinte de log do SDK do Azure que gera mensagens para o console, use o método AzureEventSourceListener.CreateConsoleLogger.

// Setup a listener to monitor logged events.
using AzureEventSourceListener listener = AzureEventSourceListener.CreateConsoleLogger();

Para saber mais sobre outros mecanismos de registro em log, confira aqui.

Próximas etapas

Esse SDK do cliente expõe operações usando métodos de protocolo, você pode saber mais sobre como usar clientes SDK que usam métodos de protocolo em nossa documentação.

Participante

Consulte o CONTRIBUTING.md para obter detalhes sobre como criar, testar e contribuir para essa biblioteca.

Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um CLA (Contrato de Licença do Colaborador) declarando que você tem o direito de nos conceder, e de fato concede, os direitos de usar sua contribuição. Para obter detalhes, visite cla.microsoft.com.

Quando você envia uma solicitação de pull, um bot do CLA determina automaticamente se você precisa fornecer um CLA e preencher a PR corretamente (por exemplo, rótulo, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que usam nosso CLA.

Este projeto adotou o Código de Conduta de Software Livre da Microsoft. Para obter mais informações, confira as Perguntas frequentes sobre o Código de Conduta ou contate opencode@microsoft.com para enviar outras perguntas ou comentários.

Impressões

Compartilhar via