View a markdown version of this page

Erstellen Sie eine Amazon S3 S3-Lieferung - Amazon Kinesis Data Streams
Verwendung der AWS-ManagementkonsoleVerwendung der AWS CLI

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.

Erstellen Sie eine Amazon S3 S3-Lieferung

Erstellen Sie eine Lieferung, die Datensätze aus einem Amazon Kinesis Data Streams Streams-Stream an einen Amazon S3 S3-Bucket für allgemeine Zwecke sendet. Sie können eine Lieferung mit dem AWS-Managementkonsole oder dem AWS CLI erstellen. Datensätze werden in ihrem Quellformat, gebündelt in Objekten mit optimaler Größe, mit konfigurierbarer Komprimierung und einer von Ihnen definierten S3-Schlüsselstruktur geliefert.

Anmerkung

Bevor Sie eine Lieferung erstellen, müssen Sie die Voraussetzungen unter erfüllenErste Schritte mit der S3-Allzweckbereitstellung, einschließlich der unter beschriebenen Rolle für die Ausführung des IAM-Dienstes. IAM-Berechtigungen für die Datenbereitstellung

Verwendung der AWS-Managementkonsole

  1. Öffnen Sie die Kinesis-Konsole unterhttps://console.aws.amazon.com/kinesis.

  2. Wählen Sie im Navigationsbereich S3 General Purpose Delivery und dann Create delivery aus.

  3. Schritt 1: Quellkonfiguration. Geben Sie unter Lieferdetails einen Namen für die Lieferung ein. Wählen Sie unter Quelle den On-Demand Stream aus, aus dem die Lieferung erfolgen soll. Es werden nur On-Demand Streams angezeigt. Wählen Sie Weiter aus.

  4. Schritt 2: Zielkonfiguration. Wählen Sie ein Datensatzformat (JSON, STRING oder BYTE_ARRAY) und geben Sie dann das Ziel an:

    • S3-Bucket-ARN — der ARN des Amazon S3 S3-Ziel-Allzweck-Buckets.

    • Erwarteter Bucket-Besitzer — die 12-stellige AWS-Konto ID des erwarteten Bucket-Besitzers.

    • Komprimierungstyp — wählen Sie GZIP, ZSTD oder None.

    • Speicherklasse — wählen Sie optional eine Amazon S3 S3-Speicherklasse.

    • Vorlage für Ausgabeschlüssel — Definieren Sie optional die Amazon S3 S3-Objektschlüsselstruktur. Details hierzu finden Sie unter Vorlage für einen S3-Ausgabeschlüssel für die Amazon S3-Lieferung.

    • Datenaktualität — die maximale Pufferzeit in Sekunden, bevor Datensätze geliefert werden (mindestens 300, maximal 900).

    Wählen Sie Weiter aus.

  5. Schritt 3: Zusätzliche Konfiguration. Konfigurieren Sie Verschlüsselung, Dienstzugriff (die IAM-Rolle), eine optionale Warteschlange für unzustellbare Briefe, Protokollzustellung und Tags. Wählen Sie Weiter aus.

  6. Schritt 4: Überprüfen und erstellen. Überprüfen Sie Ihre Konfiguration und wählen Sie dann Lieferung erstellen aus. Die Lieferung wechselt von CREATING zu ACTIVE, nachdem die Bereitstellung abgeschlossen ist.

Verwendung der AWS CLI

Verwenden Sie den create-channel Befehl, um eine Amazon S3 S3-Lieferung zu erstellen, die Datensätze an einen allgemeinen Amazon S3 S3-Bucket mit JSON-Format und GZIP-Komprimierung sendet: 

aws kinesis create-channel \
    --channel-name "my-s3-delivery" \
    --service-execution-role-arn "arn:aws:iam::111122223333:role/my-channel-role" \
    --stream-configuration-list '[
        {
            "StreamARN": "arn:aws:kinesis:us-east-1:111122223333:stream/my-stream",
            "RecordConfiguration": {
                "RecordFormatType": "JSON"
            }
        }
    ]' \
    --s3-destination-configuration '{
        "DataFreshnessInSeconds": 300,
        "StorageConfiguration": {
            "BucketARN": "arn:aws:s3:::amzn-s3-demo-destination-bucket",
            "ExpectedBucketOwner": "111122223333",
            "CompressionType": "GZIP",
            "StorageClass": "STANDARD"
        }
    }'

Der Befehl gibt den Kanal ARN (ChannelARN) zurück. Verwenden Sie ihn zusammendescribe-channel, um zu überprüfen, ob die Lieferung den Status ACTIVE erreicht. Siehe Beschreiben Sie eine Amazon S3 S3-Lieferung. Informationen zum Anpassen der Amazon S3 S3-Objektschlüsselstruktur finden Sie unterVorlage für einen S3-Ausgabeschlüssel für die Amazon S3-Lieferung.

API-Referenz — siehe CreateChannel Amazon Kinesis Data Streams API-Referenz.