Criando um Stream

Configure e crie um stream no serviço Streaming.

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

    1. Na página da lista Streams, selecione Criar Pool de Streams. Se precisar de ajuda para localizar a página da lista, consulte Listando Streams.
    2. Preencha as opções para criar um fluxo:
      • Nome do Stream: Digite um nome para o stream. O nome não precisa ser exclusivo no compartimento, mas deve ser exclusivo do pool de streams. O nome do stream não pode ser alterado. Evite digitar informações confidenciais.
      • Compartimento: Selecione o compartimento no qual criar o stream.
      • Pool de Streams: Selecione o pool de streams que conterá seu stream.

        Se o compartimento tiver um pool de streams existente, você poderá selecioná-lo.

        Se nenhum pool de streams existir no compartimento, 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.

    3. Forneça valores para Definir Definições de Fluxo:
      • 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 stream. 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 quando você ajusta o número de partições.

    4. (Opcional) Adicionar uma ou mais tags ao stream: Selecione Mostrar Opções Avançadas para mostrar a seção Adicionar Tags.
      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.
    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.