Biblioteca de clientes de digitalização Azure Purview para Python - versão 1.0.0b2

Artigo
04/05/2023

O Azure Purview Scanning é um serviço de cloud totalmente gerido cujos utilizadores podem digitalizar os seus dados na sua propriedade de dados (também conhecido como catálogo). A digitalização é um processo pelo qual o catálogo se conecta diretamente a uma fonte de dados num horário especificado pelo utilizador.

Digitalize os seus dados no seu catálogo
Examine os seus dados
Extrair esquemas dos seus dados

Por favor, confie fortemente na documentação do serviço e nos nossos médicos clientes para usar esta biblioteca

Código fonte | Pacote (PyPI) | Documentação de| referência da API Documentação do produto

Exclusão de Responsabilidade

O suporte de pacotes Azure SDK Python para Python 2.7 termina a 01 de janeiro de 2022. Para mais informações e perguntas, consulte https://github.com/Azure/azure-sdk-for-python/issues/20691

Introdução

Pré-requisitos

Python 2.7, ou 3.6 ou mais tarde é obrigado a usar este pacote.
Você deve ter uma assinatura Azure e um Purview para usar este pacote.

Criar um recurso de competência

Siga estas instruções para criar o seu recurso Purview

Instale o pacote

Instale a biblioteca de clientes Azure Purview Scanning para Python com pip:

pip install azure-purview-scanning

Autenticar o cliente

Para utilizar uma credencial de token Azure Ative(AAD), forneça uma instância do tipo credencial pretendido obtido a partir da biblioteca de identidade azul .

Para autenticar com AAD, tem primeiro de instalar azure-identity pip e ativar a autenticação AAD no seu recurso Purview

Após a configuração, pode escolher que tipo de credencial a azul.identidade a usar. Como exemplo, o DefaultAzureCredential pode ser usado para autenticar o cliente:

Decreta os valores do ID do cliente, iD do inquilino e o segredo do cliente da aplicação AAD como variáveis ambientais: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET

Utilize a credencial simbólica devolvida para autenticar o cliente:

from azure.purview.scanning import PurviewScanningClient
from azure.identity import DefaultAzureCredential

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

Conceitos-chave

Cliente

Este pacote oferece aos construtores de pedidos para que possa construir pedidos http e enviar estes pedidos para o serviço usando o send_request método. Para mais informações sobre como usar os construtores de pedidos e os nossos clientes, consulte aqui.

Exemplos

A seguinte secção mostra-lhe como inicializar e autenticar o seu cliente e, em seguida, listar todas as suas fontes de dados.

Listar todas as fontes de dados

Listar todas as fontes de dados

from azure.purview.scanning import PurviewScanningClient
from azure.identity import DefaultAzureCredential
from azure.core.exceptions import HttpResponseError

credential = DefaultAzureCredential()
client = PurviewScanningClient(endpoint="https://<my-account-name>.scan.purview.azure.com", credential=credential)
try:
    response = client.data_sources.list_all()
    result = [item for item in response]
    print(result)
except HttpResponseError as e:
    print(e)

Resolução de problemas

Geral

O cliente de Scanning de Purview levantará exceções definidas em [Azure Core][azure_core] se recorrer às .raise_for_status() suas respostas.

Registo

Esta biblioteca utiliza a biblioteca de registos padrão para registar registos. Informações básicas sobre sessões HTTP (URLs, cabeçalhos, etc.) são registadas ao nível info.

A registo detalhado do nível DEBUG, incluindo os órgãos de pedido/resposta e os cabeçalhos não redigidos, pode ser ativado num cliente com o argumento da logging_enable palavra-chave:

import sys
import logging
from azure.identity import DefaultAzureCredential
from azure.purview.scanning import PurviewScanningClient

# Create a logger for the 'azure' SDK
logger = logging.getLogger('azure')
logger.setLevel(logging.DEBUG)

# Configure a console output
handler = logging.StreamHandler(stream=sys.stdout)
logger.addHandler(handler)

endpoint = "https://<my-account-name>.scan.purview.azure.com"
credential = DefaultAzureCredential()

# This client will log detailed information about its HTTP sessions, at DEBUG level
client = PurviewScanningClient(endpoint=endpoint, credential=credential, logging_enable=True)

Da mesma forma, logging_enable pode permitir a registo detalhado para uma única send_request chamada, mesmo quando não está habilitado para o cliente:

result = client.data_sources.list_all(logging_enable=True)

Passos seguintes

Para mais amostras genéricas, consulte os médicos dos nossos clientes.

Contribuir

Agradecemos todas as contribuições e sugestões para este projeto. A maioria das contribuições requerem que celebre um Contrato de Licença de Contribuição (CLA) no qual se declare que tem o direito de conceder e que, na verdade, concede-nos os direitos para utilizar a sua contribuição. Para mais detalhes, visite cla.microsoft.com.

Quando submete um pedido Pull, um bot do CLA determina automaticamente se tem de fornecer um CLA e decorar o PR de forma adequada (por exemplo, etiqueta, comentário). Só tem de seguir as instruções fornecidas pelo bot. Apenas terá de fazer isto uma vez em todos os repositórios com o nosso CLA.

Este projeto adotou o Microsoft Open Source Code of Conduct (Código de Conduta do Microsoft Open Source). Para mais informações consulte o Código de Conduta FAQ ou contacte opencode@microsoft.com com quaisquer perguntas ou comentários adicionais.

Partilhar via