Bibliothèque cliente analyse Azure Purview pour Python - version 1.0.0b2

Article
04/05/2023

Analyse Azure Purview est un service cloud entièrement managé dont les utilisateurs peuvent analyser vos données dans votre patrimoine de données (également appelé catalogue). L’analyse est un processus par lequel le catalogue se connecte directement à une source de données selon une planification spécifiée par l’utilisateur.

Analyser vos données dans votre catalogue
Examiner vos données
Extraire des schémas de vos données

Veuillez vous fier fortement à la documentation du service et à notre documentation cliente pour utiliser cette bibliothèque

| Code source Package (PyPI) | Documentation de référence sur les| API Documentation produit

Clause d’exclusion de responsabilité

La prise en charge des packages Python du SDK Azure pour Python 2.7 prend fin le 1er janvier 2022. Pour obtenir plus d’informations et poser des questions, reportez-vous à https://github.com/Azure/azure-sdk-for-python/issues/20691

Prise en main

Prérequis

Python 2.7 ou 3.6 ou version ultérieure est requis pour utiliser ce package.
Vous devez disposer d’un abonnement Azure et d’un Purview pour utiliser ce package.

Créer une ressource Purview

Suivez ces instructions pour créer votre ressource Purview

Installer le package

Installez la bibliothèque de client Analyse Azure Purview pour Python avec pip :

pip install azure-purview-scanning

Authentifier le client

Pour utiliser des informations d’identification de jeton Azure Active Directory (AAD), fournissez une instance du type d’informations d’identification souhaité obtenue à partir de la bibliothèque azure-identity .

Pour vous authentifier auprès d’AAD, vous devez d’abord installer azure-identity pip et activer l’authentification AAD sur votre ressource Purview

Après l’installation, vous pouvez choisir le type d’informations d’identification d’azure.identity à utiliser. Par exemple, DefaultAzureCredential peut être utilisé pour authentifier le client :

Définissez les valeurs de l’ID client, de l’ID de locataire et de la clé secrète client de l’application AAD en tant que variables d’environnement : AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET

Utilisez les informations d’identification de jeton retournées pour authentifier le client :

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)

Concepts clés

Client

Ce package offre des générateurs de requêtes afin que vous puissiez générer des requêtes http et envoyer ces requêtes au service à l’aide de la send_request méthode . Pour plus d’informations sur l’utilisation des générateurs de demandes et de nos clients, consultez ici.

Exemples

La section suivante vous montre comment initialiser et authentifier votre client, puis répertorier toutes vos sources de données.

Répertorier toutes les sources de données

Répertorier toutes les sources de données

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)

Dépannage

Général

Le client d’analyse Purview déclenche des exceptions définies dans [Azure Core][azure_core] si vous appelez .raise_for_status() vos réponses.

Journalisation

Cette bibliothèque utilise la bibliothèque de journalisation standard pour la journalisation. Les informations de base sur les sessions HTTP (URL, en-têtes, etc.) sont enregistrées au niveau INFO.

La journalisation détaillée de niveau DEBUG, comprenant le corps de la demande et/ou de la réponse et les en-têtes non rédigés, peut être activée sur un client à l’aide de l’argument de mot clé logging_enable :

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)

De même, logging_enable peut activer la journalisation détaillée pour un seul send_request appel, même si elle n’est pas activée pour le client :

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

Étapes suivantes

Pour obtenir des exemples plus génériques, consultez notre documentation cliente.

Contribution

Ce projet accepte les contributions et les suggestions. La plupart des contributions vous demandent d’accepter un contrat de licence de contribution (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez réellement, les droits d’utilisation de votre contribution. Pour plus d’informations, consultez cla.microsoft.com.

Quand vous envoyez une demande de tirage (pull request), un bot CLA détermine automatiquement si vous devez fournir un contrat CLA et agrémenter la demande de tirage de façon appropriée (par exemple, avec une étiquette ou un commentaire). Suivez simplement les instructions fournies par le bot. Vous ne devez effectuer cette opération qu’une seule fois sur tous les dépôts utilisant notre contrat CLA.

Ce projet a adopté le Code de conduite Open Source de Microsoft. Pour plus d’informations, consultez les Questions fréquentes (FAQ) sur le code de conduite ou envoyez vos questions ou vos commentaires à opencode@microsoft.com.

Partager via