Création d'un flux

Configurez et créez un flux dans le service Streaming.

Avant de publier des messages dans un flux de données ou d'utiliser les messages d'un flux, vous devez d'abord en créer un. Lors de la création d'un flux de données, tenez compte de vos stratégies de partitionnement et de sécurité. Pour consulter les exigences relatives à la création et à la gestion des flux de données, reportez-vous à Introduction à Streaming.

    1. Sur la page de liste Flux de données, sélectionnez Créer un pool de flux de données. Si vous avez besoin d'aide pour trouver la page de liste, reportez-vous à Liste des flux de données.
    2. Renseignez les options de création d'un flux :
      • Nom du flux de données : entrez le nom du flux de données. Le nom n'a pas besoin d'être unique dans le compartiment, mais il doit l'être dans le pool de flux de données. Il ne peut pas être modifié. Evitez de saisir des informations confidentielles.
      • Compartiment : sélectionnez le compartiment dans lequel créer le flux de données.
      • Pool de flux de données : sélectionnez le pool de flux de données qui doit contenir le flux de données.

        Si le compartiment comporte un pool de flux de données existant, vous pouvez le sélectionner.

        Si aucun pool de flux de données n'existe dans le compartiment, sélectionnez Créer un pool de flux de données et configurez-le. Pour obtenir des instructions, reportez-vous à l'étape 5 dans Création d'un pool de flux de données.

    3. Indiquez des valeurs pour Définir les paramètres de flux :
      • Conservation (en heures) : saisissez le nombre d'heures (entre 24 et 168) pendant lesquelles les messages de ce flux de données sont conservés. La valeur par défaut est 24.
      • Nombre de partitions : entrez le nombre de partitions pour le flux. Le nombre maximal dépend des limites de votre location.

        Les valeurs Total Write Rate et Total Read Rate maximales du flux de données sont affichées lorsque vous ajustez le nombre de partitions.

    4. (Facultatif) Ajoutez des balises au flux : sélectionnez Afficher les options avancées pour afficher la section Ajouter des balises.
      Si vous disposez des droits d'accès nécessaires pour créer une ressource, vous pouvez également lui appliquer des balises à forme libre. Pour appliquer une balise defined, vous devez être autorisé à utiliser la balise namespace. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas sûr d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
    5. Sélectionnez Créer.
  • Pour obtenir des informations sur l'utilisation de l'interface de ligne de commande, reportez-vous à Interface de ligne de commande (CLI). Afin d'obtenir la liste complète des indicateurs et des options disponibles pour les commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande.

    Remarque

    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, comme -c. Reportez-vous à l'aide en ligne de l'interface de ligne de commande pour connaître les paramètres abrégés associés aux commandes.

    Vous pouvez créer un flux de données dans un compartiment ou un pool de flux de données. 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 de données.

    Pour plus d'informations sur l'utilisation de l'API et la signature des demandes, reportez-vous à la documentation relative à l'API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits SDK et interface de ligne de commande.

Utilisation des kits SDK OCI

Pour créer un flux, utilisez la méthode createStream de StreamAdminClient.

Reportez-vous au guide du développeur pour Streaming afin d'obtenir des exemples de kit SDK détaillés.

Utilisation de Resource Manager et de Terraform

Utilisez la ressource oci_streaming_stream dans des configurations Terraform pour créer un flux de données 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>"
}
A propos de Resource Manager et de Terraform

Resource Manager est un service Oracle Cloud Infrastructure (OCI) qui permet d'automatiser le processus de provisionnement de vos ressources OCI. Avec Terraform, Resource Manager vous aide à installer, à configurer et à gérer des ressources via le modèle "infrastructure-as-code".

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

Vous pouvez utiliser Resource Manager ou l'interface de ligne de commande Terraform avec le fournisseur OCI Terraform pour voir comment les flux de données et les pools de flux de données sont représentés dans les fichiers de configuration Terraform.

Pour plus d'informations sur l'écriture de configurations à utiliser avec Resource Manager, reportez-vous à Configurations Terraform pour Resource Manager et à Configuration de Terraform.