Documentazione di Oracle Cloud Infrastructure

Creazione di un flusso

Configurare e creare un flusso nel servizio di streaming.

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

    1. Nella pagina elenco Stream, selezionare Crea flusso. Per assistenza nella ricerca della pagina elenco, vedere Elenca flussi.
    2. Immettere le informazioni riportate di seguito.
      • 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 fornire informazioni riservate.
      • Compartimento: selezionare il compartimento in cui creare il flusso.
      • Tag: (facoltativo) aggiungere una o più tag al flusso.

        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.

    3. 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, è possibile selezionare una delle opzioni riportate di seguito.
        • Selezionare Creazione automatica di un pool dei flussi predefinito. Quando si crea il flusso, viene creato automaticamente un pool di flussi predefinito.
        • Selezionare Crea nuovo pool di flussi e configurare il pool di flussi. Per istruzioni, vedere il passo 5 in Creazione di un pool di flussi.
    4. 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 n. di partizioni per il flusso. Il numero massimo dipende dai limiti per la tenancy inuso.

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

    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.