Azure Purview Scanning-Clientbibliothek für .NET – Version 1.0.0-beta.2
Azure Purview Scanning ist ein vollständig verwalteter Clouddienst, dessen Benutzer Ihre Daten in Ihren Datenbestand (auch als Ihr 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 stark auf die Dokumentation des Diensts und unsere Protokollclientdokumentation, um diese Bibliothek zu verwenden.
Quellcode | Paket (NuGet) | Produktdokumentation
Erste Schritte
Installieren des Pakets
Installieren Sie die Azure Purview Scanning-Clientbibliothek für .NET mit NuGet:
dotnet add package Azure.Analytics.Purview.Scanning --prerelease
Voraussetzungen
- Sie benötigen ein Azure-Abonnement und eine Purview-Ressource , um dieses Paket verwenden zu können.
Authentifizieren des Clients
Verwenden von Azure Active Directory
In diesem Dokument wird die Verwendung von DefaultAzureCredential zur Authentifizierung über Azure Active Directory veranschaulicht. Alle von Azure.Identity angebotenen Anmeldeinformationen werden jedoch akzeptiert. Weitere Informationen zu anderen Anmeldeinformationen finden Sie in der Dokumentation zu Azure.Identity .
Nachdem Sie Ihre Anmeldeinformationen ausgewählt und konfiguriert haben, können Sie Instanzen von PurviewScanningClient
erstellen.
var credential = new DefaultAzureCredential();
var client = new PurviewScanningClient(new Url("https://<my-account-name>.scan.purview.azure.com"), credential);
Wichtige Begriffe
Protokollmethoden
Vorgänge, die vom Purview Scanning SDK für .NET verfügbar gemacht werden, verwenden Protokollmethoden , um die zugrunde liegenden REST-Vorgänge verfügbar zu machen. Weitere Informationen zur Verwendung von SDK-Clients, die Protokollmethoden verwenden, finden Sie in unserer Dokumentation.
Threadsicherheit
Wir garantieren, dass alle Client-instance Methoden threadsicher und unabhängig voneinander sind (Richtlinie). Dadurch wird sichergestellt, dass die Empfehlung, Clientinstanzen wiederzuverwenden, immer sicher ist, auch threadsübergreifend.
Zusätzliche Konzepte
Clientoptionen | Zugreifen auf die Antwort | Vorgänge | mit langer AusführungsdauerBehandeln von Fehlern | Diagnose | Spott | Clientlebensdauer
Beispiele
Im folgenden Abschnitt erfahren Sie, wie Sie Ihren Client initialisieren und authentifizieren und dann alle Datenquellen auflisten.
Auflisten aller Datenquellen
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"));
Problembehandlung
Einrichten der Konsolenprotokollierung
Die einfachste Möglichkeit, die Protokolle anzuzeigen, besteht darin, die Konsolenprotokollierung zu aktivieren. Verwenden Sie die AzureEventSourceListener.CreateConsoleLogger-Methode, um einen Azure SDK-Protokolllistener zu erstellen, der Nachrichten an die Konsole ausgibt.
// Setup a listener to monitor logged events.
using AzureEventSourceListener listener = AzureEventSourceListener.CreateConsoleLogger();
Weitere Informationen zu anderen Protokollierungsmechanismen finden Sie hier.
Nächste Schritte
Dieses Client-SDK macht Vorgänge mithilfe von Protokollmethoden verfügbar. Weitere Informationen zur Verwendung von SDK-Clients, die Protokollmethoden verwenden, finden Sie in unserer Dokumentation.
Mitwirken
Weitere Informationen zum Erstellen, Testen und Mitwirken zu dieser Bibliothek finden Sie im CONTRIBUTING.md .
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 .NET