Création d'un flux

Configurer et créer un flux dans le service de diffusion en continu.

Avant de publier des messages dans un flux ou de consommer des messages à partir d'un flux, vous devez d'abord créer un flux. Lors de la création d'un flux, prenez en compte vos stratégies de partitionnement et de sécurité. Pour connaître les exigences relatives à la création et à la gestion des flux, voir Introduction au service de diffusion en continu.

    1. Dans la page de liste Flux, sélectionnez Créer un groupe de flux. Si vous avez besoin d'aide pour trouver la page de liste, voir Liste des flux.
    2. Complétez les options pour créer un flux :
      • Nom du flux : Entrez un nom pour le flux. Le nom n'a pas besoin d'être unique dans le compartiment, mais doit être unique au groupe de flux. Le nom du flux ne peut pas être modifié. Évitez d'entrer des informations confidentielles.
      • Compartiment : Sélectionnez le compartiment dans lequel créer le flux.
      • Groupe de flux : Sélectionnez le groupe de flux qui doit contenir votre flux.

        Si le compartiment comporte un groupe de flux existant, vous pouvez le sélectionner.

        Si aucun groupe de flux n'existe dans le compartiment, sélectionnez Créer un nouveau groupe de flux et configurez le groupe de flux. Pour obtenir des instructions, voir l'étape 5 sous Création d'un groupe de flux.

    3. Indiquez des valeurs pour Définir les paramètres de flux :
      • Conservation (en heures) : Entrez le nombre d'heures (de 24 à 168) de conservation des messages dans ce flux. La valeur par défaut est de 24.
      • Nombre de partitions : Entrez le nombre de partitions pour le flux. Le nombre maximal est basé sur les limites de votre location.

        Les valeurs maximales Taux total d'écriture et Taux total de lecture pour le flux sont affichées lorsque vous ajustez le nombre de partitions.

    4. (Facultatif) Ajoutez un ou plusieurs marqueurs au flux : Sélectionnez Afficher les options avancées pour afficher la section Ajouter des marqueurs.
      Si vous avez l'autorisation de créer une ressource, vous avez également l'autorisation d'appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
    5. Sélectionnez Créer.
  • Pour des informations sur l'utilisation de l'interface de ligne de commande, voir Interface de ligne de commande. Pour la liste complète des indicateurs et options disponibles pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

    Note

    Les exemples de cette section utilisent la syntaxe complète pour tous les paramètres, par exemple --compartment-id. Pour certains paramètres, il existe des versions abrégées, par exemple -c. Pour les instances d'un paramètre abrégé associé à une commande, voir l'aide en ligne de l'interface de ligne de commande.

    Vous pouvez créer un flux dans un compartiment ou un groupe de flux. Les paramètres --compartment-id et --stream-pool-id ne peuvent pas être spécifiés en même temps.

    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>

    Par exemple :

    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\""
    }
  • Utilisez l'opération d'API CreateStream pour créer des flux.

    Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir la documentation de l'API REST et Données d'identification de sécurité. Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.

Utilisation du gestionnaire de ressources et de Terraform

Utilisez la ressource oci_streaming_stream dans les configurations Terraform pour créer un flux dans un compartiment.

Par exemple :

resource "oci_streaming_stream" "stream" {
  compartment_id     = var.compartment_ocid
  name               = "<stream_name>"
  partitions         = "<number_of_partitions>"
  retention_in_hours = "<retention_in_hours>"
}
À propos du gestionnaire de ressources et de Terraform

Le gestionnaire de ressources est un service pour Oracle Cloud Infrastructure (OCI) qui vous permet d'automatiser le processus de provisionnement des ressources OCI. À l'aide de Terraform, le gestionnaire de ressources vous aide à installer, configurer et gérer des ressources selon le modèle "infrastructure-code".

Une configuration Terraform code l'infrastructure dans des fichiers de configuration déclaratifs. La configuration définit les ressources que vous prévoyez de provisionner, des variables et des instructions spécifiques pour le provisionnement des ressources.

Vous pouvez utiliser le gestionnaire de ressources ou l'interface de ligne de commande Terraform avec le fournisseur Terraform pour pour voir comment les flux et les groupes de flux sont représentés dans des fichiers de configuration Terraform.

Pour plus d'informations sur l'écriture de configurations à utiliser avec le gestionnaire de ressources, voir Configurations Terraform pour le gestionnaire de ressources et Configuration Terraform.