Einrichten Ihrer Amazon S3-Verbindung

Dieser Artikel beschreibt die Schritte zur Erstellung einer Amazon S3-Verbindung für Dataflow Gen2 und Pipelines in Microsoft Fabric. Amazon S3-Quell- und Zielunterstützung in Dataflow Gen2 befindet sich in der Vorschau.

Unterstützte Authentifizierungstypen

Der Amazon S3-Connector unterstützt die folgenden Authentifizierungstypen jeweils für den Kopiervorgang bzw. Dataflow Gen2.

Authentifizierungstyp Kopieren Dataflow Gen2
Zugriffsschlüssel √ √

Richten Sie Ihre Verbindung für Dataflow Gen2 (Vorschau) ein

Verwenden Sie Amazon S3, um Dateien in einen Datenfluss einzulesen oder vorbereitete Abfrageergebnisse in einen Bucket zu schreiben. Das von der Verbindung verwendete Konto benötigt die Berechtigung, auf den Zielbucket zuzugreifen und die entsprechenden Objekte zu lesen oder zu schreiben.

Der folgende Walkthrough zur Quellverbindung verwendet die Access Key-Authentifizierung und setzt Data Gateway auf (keines).

Daten aus Amazon S3 lesen

  1. Öffnen Sie Ihren Dataflow Gen2 im Power Query-Editor.
  2. Wählen Sie auf StartDaten abrufen und dann Amazon S3 aus.
  3. Geben Sie unter "Mit Datenquelle verbinden" die Bucket-URL unter URL ein, zum Beispiel https://mybucket.s3.us-east-2.amazonaws.com. Verwenden Sie die URL für Ihren eigenen Bucket und Ihre eigene Region.
  4. Wählen Sie eine bestehende Verbindung aus oder wählen Sie Neue Verbindung erstellen und geben Sie einen Verbindungsnamen ein.
  5. Für eine neue Verbindung wählen Sie Access Key unter Authentifizierungsart. Geben Sie die Zugangsschlüssel-ID und den geheimen Zugangsschlüssel ein. Das RoleARN-Feld ist für die Authentifizierung des Service-Principals gedacht; lassen Sie es für diese Access-Key-Anleitung leer.
  6. Legen Sie das für die Daten geeignete Datenschutzniveau fest. Weitere Informationen finden Sie unter Power Query-Datenschutzebenen.
  7. Wählen Sie Weiter, wählen Sie die zu lesenden Dateien aus und fahren Sie mit Power Query fort, um Ihre Daten vorzubereiten.

Screenshot des Amazon S3-Quell-Verbindungsdialogs in Dataflow Gen2, der die Bucket-URL, die Authentifizierung des Zugriffsschlüssels und leere Anmeldeformularfelder zeigt.

Bewahren Sie Zugriffsschlüssel in den Anmeldefeldern der Verbindung auf. Gib keine Anmeldeinformationen in Abfragetexte ein und füge sie nicht in Screenshots ein.

Amazon S3 als Datenziel verwenden

Important

Um Amazon S3 als Dataflow Gen2-Datenziel über ein lokales Datengateway zu verwenden, benötigen Sie die Gateway-Version vom November 2026 (Version 3000.342.0) oder höher. Für Aktualisierungsanweisungen siehe Lokales Datengateway aktualisieren.

Konfigurieren Sie das Ziel in der Abfrage, deren Ergebnisse Sie exportieren möchten:

  1. Wählen Sie die vorbereitete Abfrage im Power Query-Editor aus und wählen Sie dann Datenziel hinzufügen>Amazon S3.
  2. Wählen Sie eine Amazon S3-Verbindung mit Schreibzugriff auf den Ziel-Bucket aus oder erstellen Sie eine solche.
  3. Wählen Sie einen Unterordner im Ziel-Bucket aus und konfigurieren Sie den Dateinamen sowie das vom Zielort angebotene Dateiformat. Für die aktuelle Root-Ordner-Beschränkung siehe Bekanntes Problem: Schreiben auf die Bucket-Root.
  4. Überprüfen Sie die Zieleinstellungen und schließen Sie dann die Einrichtung ab.
  5. Wählen Sie Speichern und Ausführen. Überprüfen Sie nach Abschluss der Aktualisierung die generierte Datei im Ziel-Bucket.

Amazon S3 ist ein dateibasiertes Ziel, kein Datenbanktabellenziel. Zu Dateieinstellungen siehe Dateibasierte Ziele einrichten. Für Ausführungsstatus und Fehler siehe Aktualisierungsverlauf anzeigen und Ihre Datenflüsse überwachen.

Bekanntes Problem: Schreiben an die Bucket-Wurzel

Während der Dataflow Gen2-Zielvorschau fehlschlägt das direkte Schreiben an die Bucket-Root, wenn die Amazon S3-Verbindung eine Root-Bucket-URL verwendet.

Um dieses Problem zu umgehen, wählen Sie einen Unterordner im Bucket als Zielordner statt des Root-Ordners aus.

Richten Sie Ihre Verbindung in einer Pipeline ein.

Die folgende Tabelle enthält eine Zusammenfassung der Eigenschaften, die für eine Pipelineverbindung erforderlich sind:

Name BESCHREIBUNG Erforderlich Eigenschaft Kopieren
Verbindungsname Ein Name für Ihre Verbindung. Ja ✓
Verbindungstyp Wählen Sie Amazon S3 für Ihren Verbindungstyp aus. Ja ✓
Datenquellenpfad Geben Sie die Endpunkt-URL Ihres Kontos für Amazon S3 ein. Ja ✓
Authentication Zugriffsschlüssel Ja Zugriffsschlüssel

Führen Sie die folgenden Schritte aus, um Ihre Verbindung in einer Pipeline einzurichten:

  1. Navigieren Sie für die Data Factory-Pipeline zur Seite Neue Verbindung, um die Verbindungsdetails zu konfigurieren und die Verbindung zu erstellen.

    Screenshot der neuen Verbindungsseite.

    Sie haben zwei Möglichkeiten, zu dieser Seite zu gelangen:

    • Navigieren Sie im Kopier-Assistenten zu dieser Seite, nachdem Sie den Konnektor ausgewählt haben.
    • Gehen Sie in der Pipeline zu dieser Seite, nachdem Sie im Abschnitt „Connection“ die Option „+ New“ und anschließend den Konnektor ausgewählt haben.
  2. Angeben des neuen Verbindungsnamens, Typs, Datenquellenpfads

    Screenshot, der zeigt, wie man eine neue Verbindung einrichtet.

  3. Geben Sie im Bereich Neue Verbindung das folgende Feld an:

    • URL: Geben Sie die Kontoendpunkt-URL Ihrer Amazon S3-Daten an.
  4. Wählen Sie unter Authentifizierungsmethode Ihre Authentifizierungsmethode aus der Dropdownliste aus, und schließen Sie die entsprechende Konfiguration ab. Der Amazon S3-Connector unterstützt die folgenden Authentifizierungstypen:

    • Zugriffsschlüssel

    Screenshot mit dem Authentifizierungstyp für Amazon S3.

    • Zugriffsschlüssel-ID: Geben Sie die ID des geheimen Zugriffsschlüssels an.
    • Geheimer Zugangsschlüssel: Geben Sie den geheimen Zugangsschlüssel selbst an.

    Screenshot mit dem Authentifizierungstyp des Zugangsschlüssels für Amazon S3.

  5. Legen Sie optional die Datenschutzstufe fest, die Sie anwenden möchten. Zulässige Werte sind Organisatorisch, Datenschutz und Öffentlich. Weitere Informationen finden Sie in der Power Query-Dokumentation unter Den Datenschutzstufen.

  6. Wählen Sie Erstellen aus, um die Verbindung zu erstellen. Wenn alle Anmeldeinformationen korrekt sind, wird Ihre Erstellung erfolgreich getestet und gespeichert. Wenn das nicht korrekt ist, schlägt die Erstellung mit Fehlern fehl.

    Screenshot zeigt die Verbindungsseite.