Stream erstellen

Konfigurieren und erstellen Sie einen Stream im Streaming-Service.

Vor dem Veröffentlichen von Nachrichten in einem Stream oder dem Konsumieren von Nachrichten aus einem Stream müssen Sie zunächst einen Stream erstellen. Bedenken Sie beim Erstellen eines Streams Ihre Strategien für Partitionierung und Sicherheit. Informationen zu den Anforderungen zum Erstellen und Verwalten von Streams finden Sie unter Erste Schritte mit Streaming.

    1. Wählen Sie auf der Listenseite Streams die Option Streampool erstellen aus. Wenn Sie Hilfe beim Suchen der Listenseite benötigen, finden Sie weitere Informationen unter Streams auflisten.
    2. Gehen Sie folgendermaßen vor, um einen Stream zu erstellen:
      • Streamname: Geben Sie einen Namen für den Stream ein. Der Name muss nicht im Compartment eindeutig sein, muss aber im Streampool eindeutig sein. Der Streamname kann nicht geändert werden. Vermeiden Sie die Eingabe von vertraulichen Informationen.
      • Compartment: Wählen Sie das Compartment aus, in dem der Stream erstellt werden soll.
      • Streampool: Wählen Sie den Streampool aus, der den Stream enthält.

        Wenn für das Compartment ein Streampool vorhanden ist, können Sie ihn auswählen.

        Wenn im Compartment kein Streampool vorhanden ist, wählen Sie Neuen Streampool erstellen aus, und konfigurieren Sie den Streampool. Weitere Anweisungen finden Sie in Schritt 5 unter Streampool erstellen.

    3. Geben Sie Werte für Streameinstellungen definieren an:
      • Aufbewahrung (in Stunden): Geben Sie an, wie viele Stunden (24 bis 168) Nachrichten in diesem Stream aufbewahrt werden sollen. Der Standardwert ist 24.
      • Anzahl Partitionen: Geben Sie die Anzahl der Partitionen für den Stream ein. Die maximale Anzahl basiert auf den Limits für Ihren Mandanten.

        Die maximalen Werte für Schreibrate gesamt und Leserate gesamt für den Stream werden angezeigt, wenn Sie die Anzahl der Partitionen anpassen.

    4. (Optional) Fügen Sie dem Stream mindestens ein Tag hinzu: Wählen Sie Erweiterte Optionen anzeigen aus, um den Abschnitt Tags hinzufügen anzuzeigen.
      Wenn Sie über Berechtigungen zum Erstellen einer Ressource verfügen, sind Sie auch berechtigt, Freiform-Tags auf diese Ressource anzuwenden. Um ein definiertes Tag anzuwenden, müssen Sie über die Berechtigungen verfügen, den Tag-Namespace zu verwenden. Weitere Informationen zum Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Sie Tags anwenden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
    5. Klicken Sie auf Erstellen.
  • Informationen zur Verwendung der CLI finden Sie unter Befehlszeilenschnittstelle (CLI). Eine vollständige Liste der Kennzeichen und Optionen, die für CLI-Befehle verfügbar sind, finden Sie in der Befehlszeilenreferenz.

    Hinweis

    In den Beispielen in diesem Abschnitt wird die vollständige Syntax für alle Parameter verwendet. Beispiel: --compartment-id. Bei einigen Parametern sind Kurzversionen vorhanden, die Sie stattdessen verwenden können, wie -c. In der CLI-Onlinehilfe finden Sie Beispiele für einen verkürzten Parameter, der einem Befehl zugeordnet ist.

    Sie können einen Stream in einem Compartment oder einem Streampool erstellen. Die Parameter --compartment-id und --stream-pool-id können nicht gleichzeitig angegeben werden.

    oci streaming admin stream create --name <stream_name> --partitions <number_of_partitions> --compartment-id <compartment_OCID>
    oci streaming admin stream create --name <stream_name> --partitions <number_of_partitions> --stream-pool-id <stream_pool_OCID>

    Beispiel:

    oci streaming admin stream create --name MyStream --partitions 5 --compartment-id ocid1.tenancy.oc1..exampleuniqueID
    {
      "data": {
        "compartment-id": "ocid1.tenancy.oc1..exampleuniqueID",
        "defined-tags": {},
        "freeform-tags": {},
        "id": "ocid1.stream.oc1.phx.exampleuniqueID",
        "lifecycle-state": "CREATING",
        "lifecycle-state-details": null,
        "messages-endpoint": "https://cell-1.streaming.us-phoenix-1.oci.oraclecloud.com",
        "name": "MyStream",
        "partitions": 5,
        "retention-in-hours": 24,
        "stream-pool-id": "ocid1.streampool.oc1.phx.exampleuniqueID",
        "time-created": "2020-11-02T19:12:22.385000+00:00"
      },
      "etag": "\"d72d8103-f1ae-442a-822d-10f86cd097c5-25e61a9b-cc08-4fad-9908-40c9636d31d8\""
    }
  • Verwenden Sie den API-Vorgang CreateStream, um Streams zu erstellen.

    Informationen zur Verwendung der API und zu Signieranforderungen finden Sie unter REST-API-Dokumentation und Sicherheitszugangsdaten. Informationen zu SDKs finden Sie unter SDKs und die CLI.

Mit OCI-SDKs

Um einen Stream zu erstellen, verwenden Sie die createStream -Methode von StreamAdminClient.

Detaillierte SDK-Beispiele finden Sie in der Entwicklerdokumentation für Streaming.

Mit Resource Manager und Terraform

Verwenden Sie die Ressource oci_streaming_stream in Terraform-Konfigurationen, um einen Stream in einem Compartment zu erstellen.

Beispiel:

resource "oci_streaming_stream" "stream" {
  compartment_id     = var.compartment_ocid
  name               = "<stream_name>"
  partitions         = "<number_of_partitions>"
  retention_in_hours = "<retention_in_hours>"
}
Informationen zu Resource Manager und Terraform

Resource Manager ist ein Oracle Cloud Infrastructure-(OCI-)Service, mit dem Sie das Provisioning Ihrer OCI-Ressourcen automatisieren können. Mithilfe von Terraform unterstützt Sie Resource Manager bei der Installation, Konfiguration und Verwaltung von Ressourcen über das "Infrastructure-as-Code"-Modell.

Eine Terraform-Konfiguration kodifiziert Ihre Infrastruktur in deklarativen Konfigurationsdateien. Die Konfiguration definiert die Ressourcen, die Sie bereitstellen möchten, sowie Variablen und spezifische Anweisungen für das Provisioning der Ressourcen.

Mit Resource Manager oder der Terraform-CLI mit dem OCI-Terraform-Provider können Sie sehen, wie Ihre Streams und Streampools in Terraform-Konfigurationsdateien dargestellt werden.

Weitere Informationen zum Schreiben von Konfigurationen für Resource Manager finden Sie unter Terraform-Konfigurationen für Resource Manager und Terraform-Konfiguration.