Documentação do Oracle Cloud Infrastructure

Criando um Stream

Configure e crie um stream no serviço Streaming.

Antes de publicar mensagens em um stream ou consumir mensagens de um stream, você deve primeiro criar um stream. Ao criar um stream, considere suas estratégias de particionamento e segurança. Para revisar os requisitos de criação e gerenciamento de streams, consulte Conceitos Básicos do Streaming.

    1. Na página de lista Streams, selecione Criar stream. Se precisar de ajuda para localizar a página de lista, consulte Listando Streams.
    2. Especifique as informações a seguir:
      • Nome do stream: Informe um nome para o stream. O nome não precisa ser exclusivo no compartimento, mas deve ser exclusivo para o pool de streams. O nome do fluxo não pode ser alterado. Evite inserir informações confidenciais.
      • Compartimento: Selecione o compartimento no qual criar o stream.
      • Tags: (Opcional) Adicione uma ou mais tags ao stream.

        Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deverá ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore esta opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.

    3. Selecione o pool de streams que conterá o seu stream.
      • Se o compartimento tiver um pool de streams existente, você poderá selecioná-lo.
      • Se não existir um pool de streams no compartimento, você poderá selecionar uma das seguintes opções:
        • Selecione Criar um pool de streams padrão automaticamente. Um pool de streams padrão é criado para você quando você cria o stream.
        • Selecione Criar novo pool de streams e configure o pool de streams. Para obter instruções, consulte a etapa 5 em Criando um Pool de Streams.
    4. Forneça valores para Definir configurações de stream:
      • Retenção (em horas): Informe o número de horas (de 24 a 168) para reter as mensagens neste fluxo. O valor padrão é 24.

      • Número de partições: Informe o número de partições para o fluxo. O número máximo é baseado nos limites da sua tenancy.

        Os valores máximos de Taxa de gravação total e Taxa de leitura total do fluxo são exibidos à medida que você ajusta o número de partições.

    5. Selecione Criar.

  • Para obter informações sobre como usar a CLI, consulte Interface de Linha de Comando (CLI). Para obter uma lista completa de flags e opções disponíveis para comandos da CLI, consulte a Referência da Linha de Comando.

    Observação

    Os exemplos nesta seção usam a sintaxe completa para todos os parâmetros, por exemplo --compartment-id. Para alguns parâmetros, há versões reduzidas que você pode usar, como -c. Consulte a ajuda on-line da CLI para obter exemplos de um parâmetro abreviado associado a um comando.

    Você pode criar um stream em um compartimento ou em um pool de streams. Os parâmetros --compartment-id e --stream-pool-id não podem ser especificados ao mesmo tempo.

    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>

    Por exemplo: 

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

  • Use a operação de API CreateStream para criar streams.

    Para obter informações sobre como usar a API e assinar solicitações, consulte a documentação da API REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte SDKs e a CLI.

Usando SDKs do OCI

Para criar um stream, use o método createStream do StreamAdminClient.

Consulte o Developer Guide to Streaming para obter exemplos de SDK detalhados.

Usando o Resource Manager e o Terraform

Use o recurso oci_streaming_stream nas configurações do Terraform para criar um stream em um compartimento.

Por exemplo: 

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

O Resource Manager é um serviço do OCI (Oracle Cloud Infrastructure) que permite automatizar o processo de provisionamento dos seus recursos do OCI. Usando o Terraform, o serviço Resource Manager ajuda a instalar, configurar e gerenciar recursos por meio do modelo "infraestrutura como código".

Uma configuração Terraform codifica sua infraestrutura em arquivos de configuração declarativos. A configuração define os recursos que você pretende provisionar, variáveis e instruções específicas para provisionar os recursos

Você pode usar o Resource Manager ou a CLI do Terraform com o provedor Terraform do OCI para ver como seus streams e pools de streams são representados nos arquivos de configuração do Terraform.

Para obter mais informações sobre como gravar configurações para uso com o Resource Manager, consulte Configurações do Terraform para o Resource Manager e a Configuração do Terraform.