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