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.
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>"
}
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.