View a markdown version of this page

Eine Amazon S3-Lieferung erstellen - 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.

Eine Amazon S3-Lieferung erstellen

Erstellen Sie eine Lieferung, die Datensätze aus einem Amazon Kinesis Data Streams-Stream an einen Amazon 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 geliefert, gestapelt in Objekten mit optimaler Größe, mit konfigurierbarer Komprimierung und einer von Ihnen definierten S3-Schlüsselstruktur.

Anmerkung

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

Verwendung der AWS-Managementkonsole

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

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

  3. Schritt 1: Quellkonfiguration. Geben Sie unter Lieferdetails einen Liefernamen 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-Ziel-Buckets für allgemeine Zwecke.

    • 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-Speicherklasse.

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

    • Aktualität der Daten — 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, Servicezugriff (die IAM-Rolle), eine optionale Warteschlange, Protokollzustellung und Tags. Wählen Sie Weiter aus.

  6. Schritt 4: Prüfen und erstellen. Überprüfen Sie Ihre Konfiguration und wählen Sie dann Lieferung erstellen aus. Die Bereitstellung wechselt nach Abschluss der Bereitstellung von CREATING zu ACTIVE.

Verwendung der AWS CLI

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

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

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

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