ストリームの作成

ストリームにメッセージを公開するか、ストリームからメッセージを消費する前に、まずストリーミング・サービスにストリームを作成する必要があります。

ストリームの作成および管理の要件を確認するには、ストリーミングの開始を参照してください。

1. コンソールのストリーミング・サービスにアクセスします。
2. 「ストリーミング」ページで、「ストリームの作成」をクリックします。
3. オプションを入力してストリームを作成します。
  - ストリーム名: ストリームの名前を入力します。この名前はコンパートメント内で一意である必要はありませんが、ストリーム・プールに対して一意である必要があります。ストリーム名は変更できません。機密情報の入力は避けてください。
  - コンパートメント: ストリームを作成するコンパートメントを選択します。
  - ストリーム・プール: ストリームを格納するストリーム・プールを選択します。
    コンパートメントに既存のストリーム・プールがある場合は、それを選択できます。
    ストリーム・プールがコンパートメントに存在しない場合は、「新規ストリーム・プールの作成」をクリックしてストリーム・プールを構成します。手順については、ストリーム・プールの作成のステップ5を参照してください。
4. 「ストリーム設定の定義」に値を指定します:
  - 保持(時間): このストリームでメッセージを保持する時間(24から168)を入力します。デフォルト値は24です。
  - パーティション数: ストリームのパーティションの数を入力します。最大数は、テナンシの上限に基づきます。
    
    パーティション数を調整すると、ストリームの最大「Total Write Rate」および「Total Read Rate」の値が表示されます。
5. (オプション)「拡張オプションの表示」をクリックして、タグを定義します。
  リソースを作成する権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済のタグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかが不明な場合は、このオプションをスキップするか、管理者に連絡してください。タグは後で適用できます。
6. 「作成」をクリックします。

CLIの使用の詳細は、コマンド・ライン・インタフェース(CLI)を参照してください。CLIコマンドで使用できるフラグおよびオプションの完全なリストは、コマンドライン・リファレンスを参照してください。

ノート

この項の例では、すべてのパラメータの完全な構文を使用しています(たとえば、--compartment-id)。一部のパラメータでは、-cなど、かわりに使用できる短縮バージョンがあります。コマンドに関連付けられている短縮パラメータのインスタンスについては、CLIのオンライン・ヘルプを参照してください。

コンパートメントまたはストリーム・プールにストリームを作成できます。--compartment-idパラメータと--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>

例:

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

CreateStream API操作を使用してストリームを作成します。

APIの使用およびリクエストの署名の詳細は、REST APIのドキュメントおよびセキュリティ資格証明を参照してください。SDKの詳細は、SDKおよびCLIを参照してください。

Oracle Cloud Infrastructureドキュメント

ストリームの作成