Share via

Azure Purview Share-Clientbibliothek für .NET – Version 1.0.0-beta.3

  • Artikel

Microsoft Purview Data Sharing ermöglicht die direkte Freigabe von Daten aus Azure Data Lake Storage Gen2- und Azure Storage-Konten, sowohl innerhalb als auch zwischen Organisationen.

Datenanbieter können Microsoft Purview Data Sharing verwenden, um ihre Daten direkt mit anderen Benutzern und Partnern (als Datenverbraucher bezeichnet) ohne Duplizierung von Daten zu teilen, während sie ihre Freigabeaktivitäten in Microsoft Purview zentral verwalten.

Für Datenverbraucher bietet Microsoft Purview Data Sharing nahezu Echtzeitzugriff auf Daten, die von einem Anbieter für sie freigegeben werden.

Zu den wichtigsten Funktionen, die von Microsoft Purview Data Sharing bereitgestellt werden, gehören:

  • Freigeben von Daten innerhalb der Organisation oder für Partner und Kunden außerhalb der Organisation (innerhalb desselben Azure-Mandanten oder über verschiedene Azure-Mandanten hinweg)
  • Freigeben von Daten aus ADLS Gen2 oder Blobspeicher ohne Datenduplizierung
  • Freigeben von Daten für mehrere Empfänger
  • Zugreifen auf freigegebene Daten nahezu in Echtzeit.
  • Verwalten Sie Freigabebeziehungen, und verfolgen Sie für jedes ADLSGen2- oder Blob Storage-Konto nach, mit wem die Daten freigegeben werden.
  • Beenden Sie den Freigabezugriff jederzeit.
  • Flexibles Benutzererlebnis über das Microsoft Purview-Governanceportal oder über REST-APIs

Weitere Informationen zu diesem Produkt finden Sie in den folgenden Ressourcen.

Quellcode | Paket (NuGet) | Produktdokumentation

Erste Schritte

Installieren des Pakets

Installieren Sie die Microsoft Purview Share-Clientbibliothek für .NET mit NuGet:

dotnet add package Azure.Analytics.Purview.Sharing --prerelease

Voraussetzungen

Authentifizieren des Clients

Verwenden von Azure Active Directory

In diesem Beispiel 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 SentSharesClienterstellen.

Wichtige Begriffe

Datenanbieter: Ein Datenanbieter ist die Person, die eine Freigabe erstellt, indem sie eine Datenquelle auswählt, welche Dateien und Ordner freigegeben werden sollen und für wen sie freigegeben werden sollen. Microsoft Purview sendet dann eine Einladung an jeden Datenconsumer.

Datenverbraucher: Ein Datenverbraucher ist die Person, die die Einladung akzeptiert, indem sie ein Zielspeicherkonto in ihrem eigenen Azure-Abonnement angibt, das sie für den Zugriff auf die freigegebenen Daten verwenden wird.

Protokollmethoden

Vorgänge, die von der Purview Share-Clientbibliothek 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 Azure 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 über Threads hinweg.

Zusätzliche Konzepte

Clientoptionen | Zugreifen auf die Antwort | Vorgänge | mit langer AusführungsdauerBehandeln von Fehlern | Diagnose | Spott | Clientlebensdauer

##Examples

Beispiele für Datenanbieter

Die folgenden Codebeispiele veranschaulichen, wie Datenanbieter das Microsoft Azure Java SDK for Purview Sharing verwenden können, um ihre Freigabeaktivität zu verwalten.

Erstellen eines Gesendeten Freigabeclients

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);

Erstellen einer gesendeten Freigabe

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);

var data = new
{
    shareKind = "InPlace",
    properties = new
    {
        artifact = new
        {
            storeKind = "AdlsGen2Account",
            storeReference = new
            {
                referenceName = "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Storage/storageAccounts/sharerStorageAccount",
                type = "ArmResourceReference"
            },
            properties = new
            {
                paths = new[]
               {
                    new
                    {
                        containerName = "containerName",
                        senderPath = "senderPath",
                        receiverPath = "receiverPath"
                    }
                }
            }
        },
        displayName = "displayName",
        description = "description",
    }
};

Operation<BinaryData> createResponse = await sentShareClient.CreateOrReplaceSentShareAsync(WaitUntil.Completed, "sentShareId", RequestContent.Create(data));

Abrufen einer gesendeten Freigabe

Nach dem Erstellen einer gesendeten Freigabe können Datenanbieter sie abrufen.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);

Response response = await sentShareClient.GetSentShareAsync("sentShareId");

Auflisten gesendeter Freigaben

Datenanbieter können auch eine Liste der gesendeten Freigaben abrufen, die sie erstellt haben.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);

List<BinaryData> response = await sentShareClient.GetAllSentSharesAsync("referenceName").ToEnumerableAsync();

Erstellen einer Freigabe-Einladung für einen Benutzer

Nach dem Erstellen einer gesendeten Freigabe kann der Datenanbieter Einladungen an Consumer erweitern, die dann die freigegebenen Daten anzeigen können. In diesem Beispiel wird eine Einladung auf eine Person erweitert, indem ihre E-Mail-Adresse angegeben wird.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);

var data = new
{
    invitationKind = "User",
    properties = new
    {
        TargetEmail = "receiver@microsoft.com",
        Notify = true,
    }
};

Response response = await sentShareClient.CreateSentShareInvitationAsync("sentShareId", "sentShareInvitationId", RequestContent.Create(data));

Erstellen einer Freigabe-Einladung zu einem Dienst

Datenanbieter können Einladungen auch auf Dienste oder Anwendungen erweitern, indem sie die Mandanten- und Objekt-ID des Diensts angeben. Die Objekt-ID, die zum Senden einer Einladung an einen Dienst verwendet wird, muss die Objekt-ID sein, die der Unternehmensanwendung (nicht der Anwendungsregistrierung) zugeordnet ist.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);

var data = new
{
    invitationKind = "Service",
    properties = new
    {
        TargetActiveDirectoryId = "targetActiveDirectoryId",
        TargetObjectId = "targetObjectId",
    }
};

Response response = await sentShareClient.CreateSentShareInvitationAsync("sentShareId", "sentShareInvitationId", RequestContent.Create(data));

Abrufen einer gesendeten Freigabe-Einladung

Nach dem Erstellen einer gesendeten Freigabe-Einladung können Datenanbieter sie abrufen.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);

Response response = await sentShareClient.GetSentShareInvitationAsync("sentShareId", "sentShareInvitationId");

Auflisten gesendeter Freigabeseinladungen

Datenanbieter können auch eine Liste der gesendeten Freigabeseinladungen abrufen, die sie erstellt haben.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);

List<BinaryData> sentShareInvitations = await sentShareClient.GetAllSentShareInvitationsAsync("sentShareId").ToEnumerableAsync();

Löschen einer gesendeten Freigabe-Einladung

Datenanbieter können auch eine Liste der gesendeten Freigabeseinladungen abrufen, die sie erstellt haben.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);

Operation operation = await sentShareClient.DeleteSentShareInvitationAsync(WaitUntil.Completed, "sentShareId", "sentShareInvitationId");

Löschen einer gesendeten Freigabe

Eine gesendete Freigabe kann vom Datenanbieter gelöscht werden, um die Freigabe seiner Daten für alle Datenverbraucher zu beenden.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);

Operation operation = await sentShareClient.DeleteSentShareAsync(WaitUntil.Completed, "sentShareId");

Beispiele für Datenverbraucher

Die folgenden Codebeispiele veranschaulichen, wie Datenverbraucher das Microsoft Azure Java SDK for Purview Sharing verwenden können, um ihre Freigabeaktivität zu verwalten.

Erstellen eines Empfangsfreigabeclients

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);

Listen getrennter empfangener Freigaben

Um mit der Anzeige der für sie freigegebenen Daten zu beginnen, muss ein Daten consumer zuerst eine Liste der getrennten empfangenen Freigaben abrufen. Innerhalb dieser Liste können sie eine abgetrennte empfangene Freigabe identifizieren, die angefügt werden soll.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);

List<BinaryData> createResponse = await receivedSharesClient.GetAllDetachedReceivedSharesAsync().ToEnumerableAsync();

Anfügen einer empfangenen Freigabe

Sobald der Datenverbraucher eine empfangene Freigabe identifiziert hat, kann er die empfangene Freigabe an einen Ort anfügen, an dem er auf die freigegebenen Daten zugreifen kann. Wenn die empfangene Freigabe bereits angefügt ist, werden die freigegebenen Daten am angegebenen neuen Speicherort zugänglich gemacht.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);

var data = new
{
    shareKind = "InPlace",
    properties = new
    {
        sink = new
        {
            storeKind = "AdlsGen2Account",
            storeReference = new
            {
                referenceName = "/subscriptions/suscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Storage/storageAccounts/receiverStorageAccount",

                type = "ArmResourceReference"
            },
            properties = new
            {
                containerName = "containerName",
                folder = "folder",
                mountPath = "mountPath",
            }
        },
        displayName = "displayName",
    }
};

Operation<BinaryData> createResponse = await receivedSharesClient.CreateOrReplaceReceivedShareAsync(WaitUntil.Completed, "receivedShareId", RequestContent.Create(data));

Abrufen einer empfangenen Freigabe

Ein Datenverbraucher kann eine einzelne empfangene Freigabe abrufen.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);

Response operation = await receivedSharesClient.GetReceivedShareAsync("receivedShareId");

Listen angefügter empfangener Freigaben

Datenverbraucher können auch eine Liste ihrer angefügten empfangenen Freigaben abrufen.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);

List<BinaryData> createResponse = await receivedSharesClient.GetAllAttachedReceivedSharesAsync("referenceName").ToEnumerableAsync();

Löschen einer empfangenen Freigabe

Datenverbraucher können auch eine Liste ihrer angefügten empfangenen Freigaben abrufen.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);

Operation operation = await receivedSharesClient.DeleteReceivedShareAsync(WaitUntil.Completed, "receivedShareId");

Beispiele für die Freigabe von Resouce

Die folgenden Codebeispiele veranschaulichen, wie Sie das Microsoft Azure Java SDK for Purview Sharing verwenden, um Freigaberessourcen anzuzeigen. Eine Freigaberessource ist die zugrunde liegende Ressource, von der ein Anbieter Daten oder das Ziel, an das ein Consumer freigegebene Daten anfügt.

Ressourcen auflisten

Eine Liste von Freigaberessourcen kann abgerufen werden, um alle Ressourcen innerhalb eines Kontos anzuzeigen, in dem Freigabeaktivitäten stattgefunden haben.

var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var shareResourcesClient = new ShareResourcesClient(endPoint, credential);

List<BinaryData> createResponse = await shareResourcesClient.GetAllShareResourcesAsync().ToEnumerableAsync();

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.

Aufrufe