Freigabe verwenden

Sobald die Provider die Objekte gemeinsam verwenden, müssen die Empfänger einige Schritte ausführen, um die Freigabe zu nutzen.

Verwenden Sie die Seite "Freigabe konsumieren", um die folgenden Vorgänge auszuführen:
  • Verbrauchsfreigabe - Überblick:

    Um Datenfreigaben zu nutzen, müssen Sie sie abonnieren und Ansichten von Tabellen erstellen, die in der Livefreigabe enthalten sind.

  • Versionierte Freigabe konsumieren:

    Als Empfänger müssen Sie Ihr Freigabeprofil herunterladen, den Datenfreigabeanbieter abonnieren, die Freigaben registrieren und externe Tabellen auf Ihren Freigaben erstellen. Das Datenfreigabe-Tool autorisiert den Zugriff mit dem JSON-Profil, das mit der Aktivierungs-E-Mail an den Empfänger gesendet wird. Nachdem der Zugriff erteilt wurde, verknüpft das Data Share-Tool die gemeinsam verwendeten Objekte mit dem Datenlinktool, in dem der Consumer den Datenlinkjob ausführen und auf die vom Provider gemeinsam verwendeten Objekte zugreifen kann.

  • Live Share konsumieren:

    Auf diese Weise können Sie als Empfänger Live-Daten aus der Datenbank konsumieren.

  • Details der Share Provider-Entity anzeigen:

    Verwenden Sie das Symbol Aktionen rechts neben dem Entitätseintrag "Live Share" oder "Delta Share Provider", um Details zu der von Ihnen erstellten Entität "Live Share" oder "Delta Share Provider" anzuzeigen.

Freigabe - Überblick

Die Konsume-Freigabe bietet einen Überblick über die Liste der Share-Provider, sucht nach Share-Providern und fügt einen Share-Provider hinzu.

Gehen Sie wie folgt zu der Seite "Freigabe konsumieren":
  • Wählen Sie im Menü "Data Studio" im Menü "Datenfreigabe" die Option Freigabe konsumieren aus.
  • Klicken Sie auf der Seite "Datenfreigabe" auf das Widget Freigabe verrechnen, das im Abschnitt "Provider und Consumer" vorhanden ist.

Die Seite "Gemeinsam verwenden" enthält:Beschreibung von consum-share-new.png folgt
Beschreibung der Abbildung consum-share-new.png

  1. Verfügbare Livefreigabeprovider in den letzten 7 Tagen

    In diesem Bereich wird die Liste der verfügbaren Live Share Provider angezeigt, die Sie in den letzten 7 Tagen erstellt haben. Sie können jedes der Felder nach Ihren Wünschen aktualisieren. Sie können Live Share auch mit dem Pluszeichen (+) rechts neben den unter Verfügbare Shares in den letzten 7 Tagen aufgeführten Shares abonnieren.

  2. Feld Abonnierten Freigabeprovider suchen

    Sie können nach dem von Ihnen erstellten Freigabeempfänger suchen, indem Sie den Namen des abonnierten Freigabeanbieters eingeben. Geben Sie den Namen des abonnierten Freigabeproviders ein, z.B. REVIEW_PROVIDER, und klicken Sie auf das Symbol Lupe, um die Suche abzuschließen. Das Tool "Teilen" zeigt die Suchergebnisse im Anzeigebereich an.

  3. Wählen Sie + Freigabeprovider abonnieren aus, um einen neuen Freigabeprovider zu abonnieren. Weitere Informationen zu diesem Symbol finden Sie unter Anbieter abonnieren.
  4. Meine Sharing-ID

    Eine Sharing-ID ist ein eindeutiger Provider für Ihre Autonomous Database. Kopieren Sie diese ID in die Zwischenablage, und fügen Sie sie im Assistenten Freigabeempfänger erstellen in das Feld "Freigabe-ID" ein. Dadurch kann ein Live Share mit einem Share-Provider geteilt werden.

  5. Symbolleiste

    Die Symbolleiste besteht aus den Optionen "Sortieren nach", "Seitengröße", "Aktualisieren" und "Entityansicht".

  6. Nach Einstellungen sortieren

    Wenn Sie Sortierwerte mit dem Steuerelement "Sortieren nach" in der Symbolleiste festlegen, werden die Einstellungen in kleinen Feldern unter der Symbolleiste angezeigt. Sie können eine Einstellung löschen, indem Sie auf das Symbol X im Feld klicken. Sie können die Einstellungen auch ändern, indem Sie zum Steuerelement "Sortieren nach" in der Symbolleiste zurückkehren.

  7. Anzeigebereich

    Im Bereich unter dem Feld "Mitarbeiter für gemeinsame Nutzung von Verbrauchern suchen" werden die von einer Suche zurückgegebenen Entitys angezeigt, die den im Bereich "Filter" festgelegten Filterkriterien entsprechen. Sie können die Entitys sortieren, indem Sie auf die Schaltfläche Sortieren nach klicken und dann Sortierwerte festlegen.

Versionierte Freigabe konsumieren

Führen Sie diese Schritte aus, um Ihnen freigegebene versionierte Daten in Oracle Autonomous Database zur Verfügung zu stellen. Mit Ihnen über Delta Sharing geteilte Daten sind nicht automatisch verfügbar und können in Autonomous Database nicht erkannt werden.

Sie müssen mehrere grundlegende Schritte ausführen, um die bereitgestellten Datenfreigaben zu abonnieren und darauf zuzugreifen. Hier die erforderlichen Schritte:
  • Laden Sie das JSON-Profil herunter.
  • Abonnieren Sie den Datenfreigabeprovider.
  • Registrieren Sie Aktien, die Ihnen zur Verfügung gestellt werden.
  • Erstellen Sie externe Tabellen auf Ihren Shares.

Informationen zum JSON-Profil

Profildateien sind JSON-Dateien, die Zugangsdaten eines Benutzers für den Zugriff auf einen Delta Sharing Server enthalten. Auf diese Weise können Sie sich beim Delta-Sharing-Server authentifizieren und die Datenfreigaben ermitteln, auf die Sie zugreifen können. Laden Sie das Profil mit der URL herunter, die in der Einladungs-E-Mail enthalten ist, die vom Datenfreigabeprovider gesendet wurde.

Nachdem das Share-Tool ein Share-Objekt erstellt hat, erhält der Empfänger eine Aktivierungs-E-Mail mit dem Betreff Oracle Autonomous Database Data Share.



Um auf die Freigabe zuzugreifen, müssen Sie die gemeinsam verwendeten Objekte mit dem JSON-Profil für die persönliche Autorisierung registrieren.

Sie können auf den Profillink klicken, um das JSON-Profil herunterzuladen. Wenn Sie auf den Profillink klicken, wird ein neuer Bildschirm im Browser mit der Schaltfläche Profilinformationen abrufen angezeigt (siehe unten):

Beschreibung von json-profile.png folgt
Beschreibung der Abbildung json-profile.png
Wählen Sie Profilinformationen abrufen aus, um das JSON-Profil herunterzuladen und eine Verbindung zum Freigabeprovider herzustellen.
Hinweis

Sie können nur einmal auf die Schaltfläche Profilinformationen abrufen klicken und den Link zur Kurzanleitung anzeigen. Mit dem Freigabetool können Sie Profilinformationen abrufen nicht zweimal auswählen. Wenn Sie zweimal darauf klicken, wird ein Bildschirm angezeigt, der die Liste der Ursachen für den Fehler beim Herunterladen des Profils anzeigt.
Das folgende Profil ist ein Beispiel für das JSON-Profil, das Sie herunterladen.
{  "
        shareCredentialsVersion ": 1, 
        "endpoint": "https://myhost.us.example.com/ords/prov/_delta_sharing/", 
        "tokenEndpoint": "http://myhost.us.example.com:1234/ords/pdbdba/oauth/token", 
        "bearerToken": "-xxxxxxxxxxxxxxxxxxxxx", 
        "expirationTime": "2023-01-13T07:53:11.073Z", 
        "clientID": "xxxxxxxxxxxxxxxxxxxxxx..", 
        "clientSecret": "xxxxxxxxxxxxxxxxxxxx.."}
Das Profil speichert die Zugangsdaten in einem verschlüsselten Format. Die Parameter mit ihrer Beschreibung sind:
  • shareCredentialsVersion: Die Version der von Ihnen veröffentlichten Freigabe.
  • Endpunkt: Gibt den Freigabeendpunkt an.
  • tokenEndpoint: Gibt den Tokenendpunkt an. Der Share-Toolclient aktualisiert mit dem Tokenendpunkt den Timeout für das Bearer-Token, wenn Sie die Freigabe mit Oracle verwenden.
  • bearerToken: Dies ist eine kryptische Zeichenfolge, die der Authentifizierungsserver als Antwort auf eine Anmeldeanforderung generiert.
  • expirationTime: Dies ist die Zeit, die für das Ablaufen der Authentifizierung benötigt wird.
  • ClientID: Gibt die öffentliche ID an, die der Authentifizierungsserver generiert, wenn Sie die Instanz zur Authentifizierung registrieren.
  • clientSecret: Gibt eine Secret-ID an, die der Authentifizierungsserver zur Autorisierung generiert.
Kopieren Sie den JSON-Inhalt des Profils in einen Notizblock. Sie benötigen diese JSON unten, um Ihren Share-Provider zu abonnieren.
Hinweis

Stellen Sie sicher, dass Sie das vollständige JSON-Inhaltsprofil kopieren, einschließlich der linken und der rechten geschweiften Klammer.

Sicherheitsverbesserungen

Als Share-Empfänger müssen Sie eine Access-Control-Liste (ACL) für den Rechner des Share-Providers einrichten, indem Sie die Prozedur APPEND_HOST_ACE als ADMIN-Benutzer oder als anderer privilegierter Benutzer verwenden. Dadurch können Sie über das Internet auf die Freigabe zugreifen.

Hinweis

Dies muss geschehen, bevor Sie mit dem Assistenten zum Hinzufügen von Share Provider einen Access Control-Eintrag (ACE) zur Access Control-Liste (ACL) des Hosts (d.h. Share-Provider) hinzufügen. Den Hostnamen finden Sie im JSON-Profil, das Sie im vorherigen Schritt heruntergeladen haben.

Beispiel: Wenn Sie einem Datenbankbenutzer A_SHARE_USER den Zugriff auf die Endpunkte auf einem benannten Host (Share-Provider) gewähren möchten, müssen Sie im SQL Worksheet Editor als Administrator eine PL/SQL-Prozedur ausführen. Extrahieren Sie als Voraussetzung den Hostnamen aus der Endpunkteigenschaft im JSON-Profil "Delta Sharing", wie im obigen Beispiel angegeben. Der Hostname aus dem Beispiel lautet myhost.us.example.com.

BEGIN 
        dbms_network_acl_admin.append_host_ace(    
        host =>'myhost.us.example.com', 
        lower_port=>443,    
        upper_port=>443,
        ace => xs$ace_type(      
        privilege_list => xs$name_list('http', 'http_proxy'),      
        principal_name =>'A_SHARE_USER',
        principal_type => xs_acl.ptype_db)); 
        COMMIT;
        END;        
        /

Im Folgenden sind die Parameter mit ihrer Beschreibung aufgeführt:

  • host- Gibt den Namen oder die IP-Adresse des Hosts an. Beim Host- oder Domainnamen muss nicht zwischen Groß- und Kleinschreibung unterschieden werden.
  • Unterer Port - Gibt den unteren Port eines optionalen TCP-Portbereichs an.
  • Oberer Port - Gibt den oberen Port eines optionalen TCP-Portbereichs an.
  • ace: Der Access Control-Eintrag.
  • Berechtigungsliste - Gibt die Liste der Netzwerkberechtigungen an, die erteilt oder abgelehnt werden sollen.
  • principal_name: Es handelt sich um den Principal (Datenbankbenutzer oder -rolle), dem die Berechtigung erteilt oder verweigert wird. Groß- und Kleinschreibung muss beachtet werden.
  • principal_type: Gibt den verwendeten Principal-Typ an.

Weitere Informationen zu den DBMS_NETWORK_ACL_ADMIN-Packageunterprogrammen finden Sie im Dokument PL/SQL Packages and Types Reference.

Erteilen Sie dem Benutzer eine ACL am lokalen ORDS-Endpunkt. Sie benötigen dies, um Inhaber-Token für lokal erstellte Aktien zu generieren.
PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

In diesem Prozess laden Sie das JSON-Profil des Providers für die Konfiguration und die Zugangsdaten, um den Zugriff auf die Empfänger zu ermöglichen.

  1. Öffnen Sie die Seite "Freigabe konsumieren", und klicken Sie auf + Freigabeprovider abonnieren, um in der Dropdown-Liste die Option Delta-Freigabeprovider abonnieren auszuwählen. Daraufhin wird das Dialogfeld "Mitarbeiter freigeben" geöffnet.
  2. Geben Sie im Bereich "Providereinstellungen" des Dialogfelds "Freigabeprovider registrieren" die folgenden Details an:Beschreibung von abonnement-share-provider-version-providersettings.png folgt
    Beschreibung der Abbildung "abonnement-share-provider-version-providersettings.png"
    • Providername: Provider.
    • Beschreibung: Fügen Sie eine Beschreibung hinzu. Dies ist ein fakultatives Feld.

    Wählen Sie im Abschnitt "Quelle freigeben" die Option Delta-Share-Provider-JSON aus.

    Unter "JSON-Feld für Shareprovider" können Sie das JSON-Profil wie folgt freigeben:
    • Aus Datei: Wählen Sie diese Option aus, und klicken Sie auf den Drop-Bereich mit dem Titel "Delta Share Profile JSON". Wenn Sie auf den Bereich klicken, wird das lokale Repository geöffnet, in dem Sie das heruntergeladene JSON-Profil auswählen können.
    • JSON: Sie können diese Option auswählen und den JSON-Inhalt des kopierten Profils in den Notizblock einfügen.

    Laden Sie die JSON-Profildatei hoch, und erstellen Sie ein Shareproviderabonnement.

    Klicken Sie auf Weiter, um zur Registerkarte "Shares hinzufügen" zu gelangen.
  3. Auf der Registerkarte "Shares hinzufügen" des Dialogfelds wird die Liste der verfügbaren Shares angezeigt. Klicken Sie auf das Share, das Sie aus den verfügbaren Shares konsumieren möchten, und wählen Sie eine der verfügbaren Optionen aus:Beschreibung von abonnement-share-provider-version-addshares.png folgt
    Beschreibung der Abbildung subscription-share-provider-version-addshares.png
    • >: Mit dieser Option können Sie das verfügbare Share in ausgewählte Shares verschieben.
    • <: Wählen Sie diese Option aus, um das ausgewählte Share aus den ausgewählten Shares zu entfernen.
    • >>: Mit dieser Option können Sie alle Shares in den Bildschirm "Ausgewählte Shares" verschieben.
    • <<: Wählen Sie diese Option aus, um alle ausgewählten Freigaben aus den ausgewählten Freigaben zu entfernen.
  4. Klicken Sie auf Abonnieren, um die Freigabe hinzuzufügen. Wenn der Provider erfolgreich erstellt wurde, wird eine Bestätigungsaufforderung angezeigt. Nachdem der Provider erfolgreich erstellt wurde, wird jetzt der Bildschirm "Cloud-Objekt verknüpfen" der Seite "Dataload" angezeigt.

  5. Sie können den Namen des Share-Providers im Feld "Cloud-Speicherort" anzeigen. Die Freigabe wird im Speicherort der Quelldatei mit den Dateien angezeigt, die Sie der Freigabe hinzufügen.Beschreibung von link-cloud-object.png folgt
    Beschreibung der Abbildung link-cloud-object.png

    Erweitern Sie den Warenkorb des Ordners "Freigeben", ziehen Sie die freigegebene Datei per Drag-and-Drop aus der Quelle in den Warenkorb von Data Link.

    Wählen Sie im Datenlinkkorb die Option Starten aus, um den Datenlinkjob auszuführen.

  6. Zeigen Sie die erstellten Tabellen aus Database Actions an.
    • Klicken Sie im Navigationspfad auf Database Actions, um zum Database Actions-Launchpad zurückzukehren.
    • Klicken Sie auf die SQL-Kachel.
    • Wählen Sie die externe Tabelle, und ziehen Sie sie per Drag-and-Drop in das Arbeitsblatt.

      Die SQL Select-Anweisung für die Tabelle wird angezeigt. Diese SQL-Anweisung kann ausgeführt werden, um die gemeinsam verwendeten Daten zu konsumieren.

      Beschreibung von xt_sql.png folgt
      Beschreibung der Abbildung xt_sql.png

Live-Freigabe konsumieren

Live-Daten, die über Datenfreigabe mit Ihnen geteilt werden, sind nicht automatisch für den Verbrauch verfügbar.

Um Live-Datenfreigaben zu nutzen, müssen Sie sie abonnieren und Ansichten von Tabellen erstellen, die in der Livefreigabe enthalten sind. Die Views können mit SQL-Skripten abgefragt werden.

  1. Öffnen Sie die Seite "Freigabe konsumieren", und klicken Sie auf + Freigabeprovider abonnieren, um in der Dropdown-Liste die Option Livefreigabeprovider abonnieren zu wählen. Daraufhin wird das Dialogfeld "Mitarbeiter freigeben" geöffnet.
  2. Geben Sie im Bereich "Providereinstellungen" des Dialogfelds "Provider abonnieren" die folgenden Details an:Beschreibung von abonnement-live-share-provider.png folgt
    Beschreibung der Abbildung abonniert-live-share-provider.png

    Wählen Sie im Abschnitt "Freigabequelle" die Option Aus Livefreigabeprovidern auswählen aus, und wählen Sie den Provider in der Dropdown-Liste aus.

    Geben Sie im Feld "Freigabeanbieterdetails" Folgendes ein:
    • Providername: Geben Sie den Namen des Providers an.
    • Beschreibung: Geben Sie eine Beschreibung des Providers ein.

    Klicken Sie auf Weiter, um zur Registerkarte "Shares hinzufügen" zu gelangen.

  3. Auf der Registerkarte "Shares hinzufügen" des Dialogfelds wird die Liste der verfügbaren Shares angezeigt. Klicken Sie auf die Freigabe, die Sie aus den verfügbaren Anteilen konsumieren möchten, und wählen Sie eine der verfügbaren Optionen aus:Beschreibung von add-shares.png folgt
    Beschreibung der Abbildung add-shares.png
    • >: Mit dieser Option können Sie das verfügbare Share in ausgewählte Shares verschieben.
    • <: Wählen Sie diese Option aus, um das ausgewählte Share aus den ausgewählten Shares zu entfernen.
    • >>: Mit dieser Option können Sie alle Shares in den Bildschirm "Ausgewählte Shares" verschieben.
    • <<: Wählen Sie diese Option aus, um alle ausgewählten Freigaben aus den ausgewählten Freigaben zu entfernen.

    Klicken Sie auf Abonnieren, um die Freigabe hinzuzufügen. Wenn der Provider erfolgreich erstellt wurde, wird eine Bestätigungsaufforderung angezeigt. Nachdem der Provider erfolgreich erstellt wurde, wird jetzt der Bildschirm "Cloud-Objekt verknüpfen" der Seite "Dataload" angezeigt.

  4. Sie können den Namen des Share-Providers im Feld "Cloud-Speicherort" anzeigen. Die Freigabe wird im Speicherort der Quelldatei mit den Dateien angezeigt, die Sie der Freigabe hinzufügen.Beschreibung von link-cloud-object.png folgt
    Beschreibung der Abbildung link-cloud-object.png

    Erweitern Sie den Warenkorb des Ordners "Freigeben", ziehen Sie die freigegebene Datei per Drag-and-Drop aus der Quelle in den Warenkorb von Data Link.

    Wählen Sie im Datenlinkkorb die Option Starten aus, um den Datenlinkjob auszuführen.

Details der Freigabeproviderentität anzeigen

Um Details zur Entity "Provider teilen" anzuzeigen, klicken Sie rechts neben dem Entityeintrag "Provider freigeben" auf das Symbol Aktionen, und klicken Sie dann auf Details anzeigen.

Die Details für alle Entitys umfassen die Abschnitte "Historie" und "Auswirkung".

Für eine bestimmte Share Provider-Entity können Sie die folgenden Aktionen im Kontextmenü Aktionen ausführen.

  • Details anzeigen: Siehe Details der Share-Provider-Entity anzeigen.
  • Shares verwalten: Öffnet das Dialogfeld "Shares für Share-Provider verwalten". Hier werden die Freigaben aufgeführt, die Sie für den Empfänger freigeben möchten. Sie können die Liste der Shares bearbeiten, die Sie mit dem Empfänger teilen möchten. Klicken Sie auf OK, um die Änderungen zu speichern, oder wählen Sie Abbrechen aus, um den Bearbeitungsprozess zu verwerfen.
  • Umbenennen: Benennt den Providernamen um. Wählen Sie Ja aus, um Änderungen vorzunehmen. Klicken Sie andernfalls auf Nein.
  • Löschen: Entfernt die Share Provider-Entity.
  • Tabellen laden: Sie werden zur Seite "Daten laden" geleitet, auf der die Registerkarte "Teilen" ausgewählt ist.
  • Tabellen verknüpfen: Sie werden zur Seite "Daten verknüpfen" geleitet, auf der die Registerkarte "Teilen" ausgewählt ist, um das zugehörige Linkobjekt anzuzeigen und auszuführen. Verschieben Sie die freigegebenen Daten per Drag-and-Drop, um sie dem Datenlinkjob hinzuzufügen.