Azure Purview Scanning-Clientbibliothek für Python– Version 1.0.0b2

Artikel
04/05/2023

Azure Purview Scanning ist ein vollständig verwalteter Clouddienst, dessen Benutzer Ihre Daten in Ihrem Datenbestand (auch als Katalog bezeichnet) scannen können. Bei der Überprüfung wird vom Katalog nach einem vom Benutzer angegebenen Zeitplan direkt eine Verbindung mit einer Datenquelle hergestellt.

Scannen Ihrer Daten in Ihren Katalog
Untersuchen Ihrer Daten
Extrahieren von Schemas aus Ihren Daten

Verlassen Sie sich bei der Verwendung dieser Bibliothek stark auf die Dokumentation des Diensts und unsere Clientdokumentation.

Quellcode | Paket (PyPI) | API-Referenzdokumentation| Produktdokumentation

Haftungsausschluss

Die Unterstützung von Azure SDK-Python-Paketen für Python 2.7 endet am 1. Januar 2022. Weitere Informationen und Antworten finden Sie unter https://github.com/Azure/azure-sdk-for-python/issues/20691.

Erste Schritte

Voraussetzungen

Für die Verwendung dieses Pakets ist Python 2.7 bzw. 3.6 oder höher erforderlich.
Sie müssen über ein Azure-Abonnement und eine Purview verfügen, um dieses Paket verwenden zu können.

Erstellen einer Purview-Ressource

Befolgen Sie diese Anweisungen, um Ihre Purview-Ressource zu erstellen.

Installieren des Pakets

Installieren Sie die Azure Purview Scanning-Clientbibliothek für Python mit pip:

pip install azure-purview-scanning

Authentifizieren des Clients

Um Anmeldeinformationen für Azure Active Directory-Token (AAD) zu verwenden, geben Sie eine Instanz des gewünschten Anmeldeinformationstyps an, der aus der azure-identity-Bibliothek abgerufen wird.

Um sich bei AAD zu authentifizieren, müssen Sie zuerst pip installieren azure-identity und die AAD-Authentifizierung für Ihre Purview-Ressource aktivieren.

Nach dem Setup können Sie auswählen, welche Art von Anmeldeinformationen aus azure.identity verwendet werden soll. Beispielsweise kann DefaultAzureCredential verwendet werden, um den Client zu authentifizieren:

Legen Sie die Werte der Client-ID, mandanten-ID und des geheimen Clientschlüssels der AAD-Anwendung als Umgebungsvariablen fest: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET

Verwenden Sie die zurückgegebenen Tokenanmeldeinformationen, um den Client zu authentifizieren:

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)

Wichtige Begriffe

Client

Dieses Paket bietet Anforderungsgeneratoren, sodass Sie HTTP-Anforderungen erstellen und diese Anforderungen mithilfe der -Methode an den send_request Dienst senden können. Weitere Informationen zur Verwendung von Request Builders und unseren Kunden finden Sie hier.

Beispiele

Im folgenden Abschnitt erfahren Sie, wie Sie Ihren Client initialisieren und authentifizieren und dann alle Ihre Datenquellen auflisten.

Auflisten aller Datenquellen

Auflisten aller Datenquellen

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)

Problembehandlung

Allgemein

Der Purview Scanning-Client löst ausnahmen aus, die in [Azure Core][azure_core] definiert sind, wenn Sie ihre Antworten aufrufen .raise_for_status() .

Protokollierung

Diese Bibliothek verwendet die Standardprotokollbibliothek für die Protokollierung. Grundlegende Informationen zu HTTP-Sitzungen (URLs, Header usw.) werden auf INFO-Ebene protokolliert.

Eine ausführliche Protokollierung auf der Ebene DEBUG, einschließlich Anforderungs-/Antworttexten und vollständiger Header, kann auf einem Client mit dem Schlüsselwortargument logging_enable aktiviert werden:

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)

logging_enable Auf ähnliche Weise kann die detaillierte Protokollierung für einen einzelnen send_request Aufruf aktiviert werden, auch wenn sie für den Client nicht aktiviert ist:

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

Nächste Schritte

Weitere generische Beispiele finden Sie in unserer Clientdokumentation.

Mitwirken

Beiträge und Vorschläge für dieses Projekt sind willkommen. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. Weitere Informationen finden Sie unter cla.microsoft.com.

Wenn Sie einen Pull Request (PR) übermitteln, überprüft ein CLA-Bot automatisch, ob Sie eine Lizenzvereinbarung bereitstellen und den PR entsprechend ergänzen müssen (z.B. mit einer Bezeichnung oder einem Kommentar). Führen Sie einfach die Anweisungen des Bots aus. Sie müssen dies nur einmal für alle Repositorys ausführen, die unsere CLA verwenden.

Für dieses Projekt gelten die Microsoft-Verhaltensregeln für Open Source (Microsoft Open Source Code of Conduct). Weitere Informationen finden Sie in den häufig gestellten Fragen zum Verhaltenskodex. Sie können sich auch an opencode@microsoft.com wenden, wenn Sie weitere Fragen oder Anmerkungen haben.

Share via