View a markdown version of this page

Daten in AWS Data Exchange - AWS Data Exchange User Guide
ObjekteÜberarbeitungenDatensätzeTags (Markierungen)

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Daten in AWS Data Exchange

Die Daten sind AWS Data Exchange mithilfe von drei Bausteinen organisiert:

Diese drei Bausteine bilden die Grundlage des Produkts, das Sie mithilfe der AWS Data Exchange Konsole oder der AWS Data Exchange API verwalten.

Um Datensätze zu erstellen, anzuzeigen, zu aktualisieren oder zu löschen, können Sie die AWS Data Exchange Konsole, AWS Command Line Interface (AWS CLI), Ihren eigenen REST-Client oder eines der AWS SDKs verwenden. Weitere Informationen zur programmgesteuerten Verwaltung von AWS Data Exchange Datensätzen finden Sie in der AWS Data Exchange API-Referenz.

Objekte

Ressourcen sind die Daten, in denen sie enthalten sind. AWS Data Exchange

Die Art des Assets definiert, wie die Daten mithilfe der Datensätze, Datenzuschüsse oder Produkte, die sie enthalten, an den Empfänger oder Abonnenten übermittelt werden.

Bei einem Asset kann es sich um eines der folgenden Elemente handeln:

  • Eine auf Ihrem lokalen Computer gespeicherte Datei

  • Eine Datei, die als Objekt in Amazon Simple Storage Service (Amazon S3) gespeichert ist

  • Eine in Amazon API Gateway erstellte REST-API

  • Ein Amazon Redshift-Datensatz

  • Eine AWS Lake Formation Datenerlaubnis (Vorschau)

  • Ein Amazon S3-Datenzugriffsdatensatz

Objektstruktur

Vermögenswerte haben die folgenden Parameter:

  • DataSetId— Die ID des Datensatzes, der dieses Asset enthält.

  • RevisionId— Die ID der Revision, die dieses Asset enthält.

  • Id— Eine eindeutige ID, die bei der Erstellung des Assets generiert wird.

  • Arn— Eine eindeutige Kennung für einen AWS Ressourcennamen.

  • CreatedAtund UpdatedAt — Datum und Zeitstempel für die Erstellung und letzte Aktualisierung des Assets.

  • AssetDetails— Informationen über das Asset.

  • AssetType— Entweder ein Snapshot eines Amazon S3-Objekts, einer Amazon API Gateway-API, eines Amazon Redshift-Datensatzes oder eines Amazon S3-Datensatzes.

Beispiel Ressource: Ressource
{
    "Name": "automation/cloudformation.yaml",
    "Arn": "arn:aws:dataexchange:us-east-1::data-sets/29EXAMPLE24b82c6858af3cEXAMPLEcf/revisions/bbEXAMPLE74c02f4745c660EXAMPLE20/assets/baEXAMPLE660c9fe7267966EXAMPLEf5",
    "Id": "baEXAMPLE660c9fe7267966EXAMPLEf5",
    "CreatedAt": "2019-10-17T21:31:29.833Z",
    "UpdatedAt": "2019-10-17T21:31:29.833Z",
    "AssetType": "S3_SNAPSHOT",
    "RevisionId": "bbEXAMPLE74c02f4745c660EXAMPLE20",
    "DataSetId": "29EXAMPLE24b82c6858af3cEXAMPLEcf",
    "AssetDetails": {
        "S3SnapshotAsset": {
            "Size": 9423
        }
    }
}

Arten von Vermögenswerten

Datensatz für Dateien

Mithilfe von Dateien können Abonnenten auf eine Kopie des Datensatzes als berechtigten Datensatz zugreifen und die Assets exportieren.

Ein Datensatzbesitzer kann mithilfe der AWS Data Exchange Konsole Dateien sowohl importieren als auch exportieren, und zwar programmgesteuert über die AWS CLI eigene REST-Anwendung oder eines der AWS SDKs. Weitere Informationen zum Importieren von Amazon S3-Assets finden Sie unter. Importing AWS Data Exchange Ressourcen aus einem S3-Bucket Weitere Informationen zum Exportieren von Assets finden Sie unterExporting AWS Data Exchange Vermögenswerte in einem S3-Bucket.

API-Assets

Mit API-Assets können Datenempfänger oder Abonnenten die API einsehen und die API-Spezifikation als berechtigten Datensatz herunterladen. Sie können auch API-Aufrufe an AWS Data Exchange verwaltete Endpunkte tätigen, die dann per Proxy an die Endpunkte weitergeleitet werden. API-owner

Ein Datensatzbesitzer, der über eine bestehende Amazon API Gateway-API verfügt, kann mithilfe der AWS Data Exchange Konsole ein API-Asset hinzufügen, programmgesteuert über das oder eines der AWS CLI SDKs. AWS Weitere Informationen zum Importieren von API-Assets finden Sie unter. Importing AWS Data Exchange Ressourcen aus einer Amazon API Gateway-API

Anmerkung

Derzeit wird der SendApiAsset Vorgang für die folgenden SDKs nicht unterstützt:

  • SDK für .NET

  • AWS SDK für C++

  • SDK für Java 2.x

Besitzer von Datensätzen, die noch keine Amazon API Gateway-API haben, müssen eine erstellen, bevor sie ihrem Produkt ein API-Asset hinzufügen können. Weitere Informationen finden Sie unter Entwickeln einer REST-API in API Gateway im Amazon API Gateway Developer Guide.

Ressourcen zur gemeinsamen Nutzung von Amazon Redshift

Mit Amazon Redshift-Datashare-Assets erhalten Empfänger Lesezugriff, um die Daten in Amazon Redshift abzufragen, ohne Daten extrahieren, transformieren und laden zu müssen.

Weitere Informationen zum Importieren von Amazon Redshift-Datashare-Assets finden Sie unter. Importing AWS Data Exchange Vermögenswerte von einem AWS Data Exchange Datenaustausch für Amazon Redshift

AWS Lake Formation Datenerlaubnis (Vorschau)

Mit AWS Lake Formation Datenberechtigungsressourcen können Empfänger oder Abonnenten auf alle Datenbanken, Tabellen oder Spalten zugreifen und diese abfragen, die den angegebenen Tags zugeordnet sind.

Datensatzbesitzer müssen ihre Daten erstellen und kennzeichnen, bevor sie die Tags als Teil eines AWS Data Exchange Assets importieren. Weitere Informationen zum Importieren von Lake Formation-Datenberechtigungen finden Sie unterImporting AWS Data Exchange Vermögenswerte von AWS Lake Formation (Vorschau).

Amazon-S3-Datenzugriff

Mit Amazon S3-Datenzugriffsressourcen können Empfänger oder Abonnenten direkt auf die Daten des Anbieters zugreifen und diese verwenden, ohne Datenkopien erstellen oder verwalten zu müssen. Besitzer von Datensätzen können Amazon S3 zusätzlich AWS Data Exchange zu ihren vorhandenen Amazon S3-Buckets einrichten, um den direkten Zugriff auf einen gesamten S3-Bucket oder bestimmte Präfixe und Amazon S3-Objekte gemeinsam zu nutzen.

Überarbeitungen

Eine Revision ist ein Container für ein oder mehrere Assets.

Sie verwenden Revisionen, um Daten in Amazon S3 zu aktualisieren. Sie können beispielsweise eine Sammlung von CSV-Dateien oder eine einzelne CSV-Datei und ein Wörterbuch gruppieren, um eine Revision zu erstellen. Sobald neue Daten verfügbar sind, erstellen Sie Revisionen und fügen Elemente hinzu. Nachdem Sie die Revision mithilfe der AWS Data Exchange Konsole erstellt und abgeschlossen haben, ist diese Revision sofort für Abonnenten verfügbar. Weitere Informationen finden Sie unter Veröffentlichung eines neuen Produkts in AWS Data Exchange.

Beachten Sie Folgendes:

  • Um abgeschlossen zu werden, muss eine Revision mindestens ein Asset enthalten.

  • Es liegt in Ihrer Verantwortung, sicherzustellen, dass die Vermögenswerte korrekt sind, bevor Sie Ihre Überarbeitung abschließen.

  • Eine endgültige Revision, die für mindestens eine Datenquelle oder ein Produkt veröffentlicht wurde, kann nicht rückgängig gemacht oder in irgendeiner Weise geändert werden. (Außer im Rahmen des Revisionswiderrufs)

  • Nachdem die Überarbeitung abgeschlossen ist, wird sie automatisch für Ihre Datenzuschüsse oder Produkte veröffentlicht.

Struktur der Revision

Revisionen haben die folgenden Parameter:

  • DataSetId— Die ID des Datensatzes, der diese Revision enthält.

  • Comment— Ein Kommentar zur Revision. Dieses Feld kann 128 Zeichen lang sein.

  • Finalized— Entweder wahr oder falsch. Wird verwendet, um anzuzeigen, ob die Revision abgeschlossen ist.

  • Id— Die eindeutige Kennung für die Revision, die bei ihrer Erstellung generiert wurde.

  • Arn— Eine eindeutige Kennung für einen AWS Ressourcennamen.

  • CreatedAt— Datum und Zeitstempel für die Erstellung der Revision. Überarbeitungen mit einem Titel werden zum Zeitpunkt der Veröffentlichung erstellt.

  • UpdatedAt— Datum und Zeitstempel für die letzte Aktualisierung der Revision.

  • Revoked— Ein Status, der angibt, dass Abonnenten der Zugriff auf die Revision entzogen wurde.

  • RevokedAt— Datum und Zeitstempel, die angeben, wann Abonnenten der Zugriff auf die Revision entzogen wurde.

  • RevocationComment— Ein erforderlicher Kommentar, um die Abonnenten über den Grund zu informieren, warum ihnen der Zugriff auf die Revision entzogen wurde. Die erforderliche Mindestzeichenlänge ist 10. Dieses Feld kann zwischen 10 und 512 Zeichen lang sein.

  • SourceID— Die Revisions-ID der eigenen Revision, die der aktuell betrachteten Revision mit dem Titel entspricht. Dieser Parameter wird zurückgegeben, wenn ein Revisionsbesitzer die entsprechende Kopie seiner eigenen Revision betrachtet.

Beispiel Ressource für Revisionen

        {
            "UpdatedAt": "2019-10-11T14:13:31.749Z",
            "DataSetId": "1EXAMPLE404460dc9b005a0d9EXAMPLE2f",
            "Comment": "initial data revision",
            "Finalized": true,
            "Id": "e5EXAMPLE224f879066f9999EXAMPLE42",
            "Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/1EXAMPLE404460dc9b005a0d9EXAMPLE2f/revisions/e5EXAMPLE224f879066f9999EXAMPLE42",
            "CreatedAt": "2019-10-11T14:11:58.064Z"
        }

Datensätze

Ein Datensatz in AWS Data Exchange ist eine Sammlung von Daten, die sich im Laufe der Zeit ändern können.

Wenn Empfänger oder Abonnenten auf einen Dateidatensatz zugreifen, greifen sie auf eine bestimmte Version des Datensatzes zu. Diese Struktur ermöglicht es Anbietern, die in Datensätzen verfügbaren Daten im Laufe der Zeit zu ändern, ohne sich um Änderungen an historischen Daten kümmern zu müssen.

Wenn Empfänger oder Abonnenten auf einen API-Datensatz zugreifen, greifen sie auf einen Datensatz zu, der API-Assets enthält, die es Abonnenten ermöglichen, API-Aufrufe an AWS Data Exchange verwaltete Endpunkte zu tätigen, die dann per Proxy an die Endpunkte der Anbieter weitergeleitet werden.

Wenn Empfänger oder Abonnenten auf einen Amazon Redshift-Datensatz zugreifen, greifen sie auf einen Datenaustausch für Amazon Redshift zu. AWS Data Exchange Diese Datenfreigabe gewährt Abonnenten schreibgeschützten Zugriff auf die Schemas, Tabellen, Ansichten und benutzerdefinierten Funktionen, die der Datenbesitzer zu den Datenfreigaben hinzugefügt hat.

Wenn Empfänger oder Abonnenten auf einen Datensatz mit AWS Lake Formation Datenberechtigungen zugreifen, greifen sie auf die Datenbanken, Tabellen und and/or Spalten zu, die mit einem vom Eigentümer des Datensatzes angegebenen gekennzeichnet sind. LF-tag

Wenn Empfänger oder Abonnenten auf einen Amazon S3-Datenzugriffsdatensatz zugreifen, erhalten sie schreibgeschützten Zugriff auf gemeinsam genutzte Amazon S3-Objekte, die in den Amazon S3-Buckets des Anbieters gehostet werden. Empfänger oder Abonnenten können diese Daten direkt mit anderen verwenden. AWS-Services

Um Datensätze zu erstellen, anzuzeigen, zu aktualisieren oder zu löschen, können Anbieter die AWS Data Exchange Konsole, die AWS CLI, Ihren eigenen REST-Client oder eines der AWS SDKs verwenden. Weitere Informationen zur programmgesteuerten Verwaltung von AWS Data Exchange Datensätzen finden Sie in der AWS Data Exchange API-Referenz.

Datensets in Besitz

Ein Datensatz gehört dem Konto, das ihn erstellt hat. Eigene Datensätze können anhand des origin Parameters identifiziert werden, der auf gesetzt istOWNED.

Berechtigte Datensätze

Bei berechtigten Datensätzen handelt es sich um eine schreibgeschützte Ansicht der eigenen Datensätze eines Absenders. Datensätze, die berechtigt sind, werden zum Zeitpunkt der Erstellung der Datengewährung oder der Produktveröffentlichung erstellt und Empfängern oder Abonnenten zur Verfügung gestellt, die über eine aktive Datengewährung oder ein Abonnement für das Produkt verfügen. Berechtigte Datensätze können anhand des origin Parameters identifiziert werden, der auf gesetzt istENTITLED.

Als Empfänger können Sie Ihre berechtigten Datensätze über die AWS Data Exchange API oder in der AWS Data Exchange Konsole einsehen und mit ihnen interagieren.

Als Datensatzbesitzer haben Sie auch Zugriff auf die berechtigte Datensatzansicht, die Ihren Empfängern oder Abonnenten angezeigt wird. Sie können dies über die AWS Data Exchange API tun oder indem Sie den Namen des Datensatzes auf der Datengewährungs- oder Produktseite in der AWS Data Exchange Konsole auswählen.

Typen von Datensätzen

Die folgenden Datensatztypen werden unterstützt in AWS Data Exchange:

Dateien (Datensatz)

Ein Dateien-Datensatz ist ein Datensatz, der Flatfiles enthält, die von Amazon S3 zugelassen sind.

Als Empfänger oder Abonnent können Sie Daten entweder lokal (auf Ihren Computer herunterladen) oder in Ihren Amazon S3-Bucket exportieren.

Als Eigentümer eines Datensatzes können Sie jede Art von Flatfile aus Ihrem Amazon S3-Bucket importieren und zum Datensatz hinzufügen.

API-Datensatz

Ein API-Datensatz ist ein Datensatz, der API-Assets enthält. API-Assets ermöglichen es Empfängern oder Abonnenten, API-Aufrufe an AWS Data Exchange verwaltete Endpunkte zu tätigen, die dann per Proxy an die Endpunkte des Datensatzes weitergeleitet werden.

Als Eigentümer eines Datensatzes erstellen Sie eine API in Amazon API Gateway und fügen sie dem Datensatz hinzu, um den Zugriff auf Ihre API bei der Erstellung einer Datenerteilung oder einem Abonnement zu lizenzieren.

Amazon Redshift-Datensatz

Ein Amazon Redshift-Datensatz enthält AWS Data Exchange Datenfreigaben für Amazon Redshift. Wenn Sie einen Datensatz mit Datenfreigaben abonnieren, werden Sie als Nutzer des Datashares hinzugefügt. Dadurch erhalten Sie schreibgeschützten Zugriff auf die Schemas, Tabellen, Ansichten und benutzerdefinierten Funktionen, die der Datensatzbesitzer den Datensätzen hinzugefügt hat.

Als Datensatzbesitzer können Sie aus dem Datashare in Amazon Redshift eine Datenbank erstellen und dann Live-Daten abfragen, ohne Dateien zu extrahieren, zu transformieren und zu laden. Sie erhalten automatisch Zugriff auf die Datenfreigabe, wenn Ihre Datengewährung oder Ihr Abonnement aktiviert wird, und verlieren den Zugriff, wenn eine dieser Optionen abgelaufen ist.

Als Eigentümer eines Datensatzes erstellen Sie in Amazon Redshift eine Datenfreigabe und fügen sie dem Datensatz hinzu, um den Zugriff auf Ihre Datenfreigabe bei der Erstellung oder beim Abonnement einer Datenfreigabe zu lizenzieren.

Amazon S3-Datensatz für den Datenzugriff

Mit AWS Data Exchange Amazon S3-Datenzugriff können Datenempfänger oder Abonnenten direkt aus den Amazon S3-Buckets der Datensatzbesitzer auf Datendateien von Drittanbietern zugreifen.

Wenn Sie ein Produkt AWS Data Exchange für Amazon S3 für den Datenzugriff abonnieren, AWS Data Exchange wird automatisch Folgendes ausgeführt:

  • Stellt einen Amazon S3-Zugangspunkt bereit. Amazon S3 Access Point ist eine Funktion von Amazon S3, die den Datenaustausch mit einem Amazon S3-Bucket vereinfacht.

  • Aktualisiert die S3 Access Point-Ressourcenrichtlinien, um Ihnen nur Lesezugriff zu gewähren.

AWS Data Exchange Bei Amazon S3 können Datensatzbesitzer den direkten Zugriff auf einen gesamten Amazon S3-Bucket oder bestimmte Präfixe und Amazon S3-Objekte gemeinsam nutzen. Darüber hinaus AWS Data Exchange kann es zur automatischen Verwaltung von Datenzuschüssen, Abonnements, Ansprüchen, Rechnungen und Zahlungen verwendet werden.

AWS Lake Formation Datensatz (Vorschau)

Ein AWS Lake Formation Datensatz ist ein Datensatz, der AWS Lake Formation Datenberechtigungsressourcen enthält.

Als Datenempfänger oder Abonnent können Sie die Ihnen zur Verfügung gestellten Daten in Ihrem verwalten AWS Lake Formation. Nachdem Sie Ressourcenlinks in Ihrem erstellt haben AWS Lake Formation, können Sie die Daten mithilfe von Analysediensten wie Amazon Athena abfragen.

Als Eigentümer eines Datensatzes taggen Sie Ihre Daten mithilfe von LF-tags in AWS Lake Formation und importieren diese Tags als Assets, wenn Sie Ihren Datensatz erstellen.

AWS-Regionen und Datensätze

Ihre Datensätze können in jedem unterstützten Format enthalten sein AWS-Region, aber alle Datensätze in einem einzigen Datenpaket oder Produkt müssen sich in derselben Datei befinden AWS-Region.

Struktur des Datensatzes

Datensätze haben die folgenden Parameter:

  • Name— Der Name des Datensatzes. Dieser Wert kann bis zu 256 Zeichen lang sein.

  • Description— Eine Beschreibung für den Datensatz. Dieser Wert kann bis zu 16.348 Zeichen lang sein.

  • AssetType— Definiert die Art der Assets, die der Datensatz enthält.

  • Origin— Eine Eigenschaft, die den Datensatz Owned nach Konto (für Anbieter) oder Entitled nach Konto (für Abonnenten) definiert.

  • Id— Eine ID, die den Datensatz eindeutig identifiziert. Datensatz-IDs werden bei der Datensatzerstellung generiert. Datensätze, die berechtigt sind, haben eine andere ID als der ursprüngliche Datensatz.

  • Arn— Eine eindeutige Kennung für einen AWS Ressourcennamen.

  • CreatedAtund UpdatedAt — Datum und Zeitstempel für die Erstellung und letzte Aktualisierung des Datensatzes.

Anmerkung

Als Datensatzbesitzer können Sie einige Eigenschaften für eigene Datensätze ändern, z. B. den Namen oder die Beschreibung. Durch das Aktualisieren von Eigenschaften in einem eigenen Datensatz werden die Eigenschaften im entsprechenden berechtigten Datensatz nicht aktualisiert.

Beispiel Ressource für Datensätze
{
    "Origin": "OWNED", 
    "AssetType": "S3_SNAPSHOT", 
    "Name": "MyDataSetName", 
    "CreatedAt": "2019-09-09T19:31:49.704Z", 
    "UpdatedAt": "2019-09-09T19:31:49.704Z", 
    "Id": "fEXAMPLE1fd9a5c8b0d2e6fEXAMPLEe1", 
    "Arn": "arn:aws:dataexchange:us-east-2:123456789109:data-sets/fEXAMPLE1fd9a5c8b0d2e6fEXAMPLEe1", 
    "Description": "This is my data set's description that describes the contents of the data set."
}

Bewährte Verfahren für Datensätze

Beachten Sie als Eigentümer eines Datensatzes beim Erstellen und Aktualisieren von Datensätzen die folgenden bewährten Methoden:

  • Der Name des Datensatzes ist in der Datenbescheinigung oder in den Produktdetails im Katalog sichtbar. Wir empfehlen Ihnen, einen kurzen, aussagekräftigen Namen zu wählen, damit Kunden den Inhalt des Datensatzes leicht verstehen.

  • Die Beschreibung ist für Empfänger oder Abonnenten sichtbar, die über eine aktive Datengewährung oder ein Abonnement für das Produkt verfügen. Wir empfehlen, dass Sie Informationen zur Netzabdeckung sowie zu den Funktionen und Vorteilen des Datensatzes angeben.

Tags (Markierungen)

Sie können Ihren eigenen Datensätzen und deren Revisionen Tags hinzufügen. Wenn Sie Tagging verwenden, können Sie auch die tagbasierte Zugriffskontrolle in AWS Identity and Access Management (IAM) -Richtlinien verwenden, um den Zugriff auf diese Datensätze und Revisionen zu kontrollieren.

Datensätze, die berechtigt sind, können nicht mit Tags versehen werden. Die Tags eigener Datensätze und ihre Revisionen werden nicht an die entsprechenden Versionen weitergegeben. Insbesondere Empfänger oder Abonnenten, die nur Lesezugriff auf berechtigte Datensätze und Revisionen haben, sehen die Tags des ursprünglichen Datensatzes nicht.

Anmerkung

Derzeit unterstützen Assets und Jobs das Tagging nicht.