Documentazione di Oracle Cloud Infrastructure

Creazione di un flusso

Configurare e creare un flusso nel servizio di streaming.

Prima di pubblicare messaggi in un flusso o di consumare messaggi da un flusso, è necessario creare un flusso. Quando si crea un flusso, prendere in considerazione le strategie di partizionamento e sicurezza. Per esaminare i requisiti per la creazione e la gestione dei flussi, vedere Guida introduttiva allo streaming.

    1. Nella pagina della lista Streams, selezionare Crea pool di flussi. Per informazioni su come trovare la pagina dell'elenco, vedere Elenco di flussi.
    2. Completare le opzioni per creare un flusso:
      • Nome flusso: immettere un nome per il flusso. Il nome non deve essere univoco all'interno del compartimento, ma deve essere univoco per il pool di flussi. Impossibile modificare il nome del flusso. Evitare di inserire informazioni riservate.
      • Compartimento: selezionare il compartimento in cui creare il flusso.
      • Pool di streaming: selezionare il pool di flussi per contenere il flusso.

        Se il compartimento dispone di un pool di flussi esistente, è possibile selezionarlo.

        Se nel compartimento non esiste alcun pool di flussi, selezionare Crea nuovo pool di flussi e configurare il pool di flussi. Per istruzioni, vedere il passo 5 nella sezione Creazione di un pool di flussi.

    3. Fornire i valori per Definisci impostazioni flusso:
      • Conservazione (in ore): immettere il numero di ore (da 24 a 168) per conservare i messaggi in questo flusso. Il valore predefinito è 24.

      • Numero di partizioni: immettere il numero di partizioni per il flusso. Il numero massimo dipende dai limiti stabiliti per la tenancy in uso.

        I valori massimi Tasso di scrittura totale e Tasso di lettura totale per il flusso vengono visualizzati quando si modifica il numero di partizioni.

    4. (Facoltativo) Aggiungere una o più tag al flusso: selezionare Mostra opzioni avanzate per visualizzare la sezione Aggiungi tag.
      Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare le tag in formato libero a tale risorsa. Per applicare una tag defined, è necessario disporre delle autorizzazioni per utilizzare la tag namespace. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa. Se non si è certi di applicare le tag, saltare questa opzione o chiedere a un amministratore. È possibile applicare le tag in un secondo momento.
    5. Selezionare Crea.

  • Per informazioni sull'uso dell'interfaccia CLI, vedere Command Line Interface (CLI). Per un elenco completo dei flag e delle opzioni disponibili per i comandi CLI, vedere Command Line Reference.

    Nota

    Gli esempi di questa sezione utilizzano la sintassi completa per tutti i parametri, ad esempio --compartment-id. Per alcuni parametri, esistono versioni abbreviate che è possibile utilizzare, ad esempio -c. Vedere la Guida in linea dell'interfaccia CLI per informazioni sulle istanze di un parametro abbreviato associato a un comando.

    È possibile creare un flusso in un compartimento o in un pool di flussi. Impossibile specificare contemporaneamente i parametri --compartment-id e --stream-pool-id.

    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>

    Ad esempio:

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

  • Utilizzare l'operazione API CreateStream per creare i flussi.

    Per informazioni sull'uso dell'API e delle richieste di firma, consulta la documentazione dell'API REST e le credenziali di sicurezza. Per informazioni sugli SDK, vedere SDK e l'interfaccia CLI.

Uso di Resource Manager e Terraform

Utilizzare la risorsa oci_streaming_stream nelle configurazioni Terraform per creare un flusso in un compartimento.

Ad esempio:

resource "oci_streaming_stream" "stream" {
  compartment_id     = var.compartment_ocid
  name               = "<stream_name>"
  partitions         = "<number_of_partitions>"
  retention_in_hours = "<retention_in_hours>"
}
Informazioni su Resource Manager e Terraform

Resource Manager è un servizio Oracle Cloud Infrastructure (OCI) che consente di automatizzare il processo di provisioning delle risorse OCI. Utilizzando Terraform, Resource Manager ti aiuta a installare, configurare e gestire le risorse attraverso il modello "infrastructure-as-code".

Una configurazione Terraform codifica l'infrastruttura nei file di configurazione dichiarativi. La configurazione definisce le risorse di cui si intende eseguire il provisioning, le variabili e le istruzioni specifiche per il provisioning delle risorse

È possibile utilizzare Resource Manager o l'interfaccia CLI Terraform con il provider OCI Terraform per vedere come i flussi e i pool di flussi sono rappresentati nei file di configurazione Terraform.

Per ulteriori informazioni sulla scrittura delle configurazioni da utilizzare con Resource Manager, vedere Configurazioni Terraform per Resource Manager e Configurazione Terraform.