Azure Purview Scanning-Clientbibliothek für Python– Version 1.0.0b2
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
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.
Azure SDK for Python