キューの概要

キュー・サービスには、次のような利点があります。

アプリケーション分離

キューは、イベント駆動型アーキテクチャを使用してアプリケーションとシステムを分離するのに役立ちます。分離により、個々のアプリケーション・コンポーネントを個別にスケーリングでき、新しいアプリケーション・コンポーネントが構築されると、キューを公開またはサブスクライブできるようになります。

キュー・サービスでは、次の概念が使用されます。

メッセージ

メッセージは、文字列の形式でペイロードを含むキュー内の要素です。文字列は、XML、JSON、CSV、Base64-encodedバイナリ・メッセージ、gzipなどの圧縮形式など、任意の形式にできます。プロデューサとコンシューマは、メッセージ形式に同意する必要があります。各メッセージは個別に処理されます。

プロデューサ

キューにメッセージを送信するクライアント。

コンシューマ

キューからメッセージを受信するクライアント。コンシューマは、メッセージの受信後にキューからメッセージを削除することも担当します。

チャンネル

オンデマンドで作成できるキュー内の一時的な宛先。メッセージはキュー内の特定のチャネルにパブリッシュでき、コンシューマは特定のチャネルからメッセージを取得できます。詳細は、チャネルを参照してください。

最大保持期間

メッセージがコンシューマによって削除されない場合、システムによって自動的に削除されるまでキューがメッセージを保持する時間の長さ。最大保持期間は、キュー・レベルで10秒から7日までの値に構成できます。デフォルト値は1日です。

配信数

リクエストに応じてメッセージがコンシューマに配信される回数。

配信最大試行回数

デッド レター キュー(DLQ)に送信されるまでに、メッセージがコンシューマに配信され、更新または削除されない回数。配信最大試行回数は、キュー・レベルで1から20の値に構成できます。詳細は、配信数を参照してください。

ポーリング・タイムアウト

メッセージが消費されるまでコンシューマが待機する時間の長さ。ポーリング・タイムアウトを長くすると、コンシューマがキューのメッセージをリクエストする回数が減りますが、レスポンスは消費できるメッセージがないことを示します。ポーリング・タイムアウトは、キュー・レベルで0から30秒の値に構成でき、コンシューマはメッセージのリクエスト時に値を設定できます。デフォルト値は30秒です詳細は、ロング・ポーリングを参照してください。

表示タイムアウト

あるコンシューマがキューから受信したメッセージが他のコンシューマに表示されない時間の長さ。表示タイムアウトは、キュー・レベルで1秒から12時間の値に構成でき、コンシューマはメッセージのリクエスト時に値を設定できます。デフォルト値は30秒です詳細は、メッセージのロックを参照してください。

表示可能メッセージ

キュー内の現在の消費可能メッセージ数。

処理中のメッセージ

コンシューマに配信されたがまだ削除されていないメッセージの数。処理中のメッセージは、表示タイムアウトが経過するまで再配信できません。

配信不能キュー

メッセージが正常に消費されておらず、構成された最大配信試行回数よりも多く配信試行されている場合、メッセージは配信不能キュー(DLQ)に転送されます。詳細は、配信不能キューを参照してください。

キュー・サービスでは、次の保証が提供されます。

• 正常に公開されたメッセージは、削除されるか保持期間が経過するまで恒久的であることが保証されます。メッセージの公開は、キュー・サービスがプロデューサに確認応答を返した場合、成功と見なされます。レスポンスが受信されたかどうかは関係ありません。
• 表示タイムアウト内のメッセージは、そのタイムアウトが期限切れになるまで別のコンシューマに配信されないことが保証されます。
• メッセージは、保持期間が終了するまでキュー・サービスによって削除されません。保持期間中、コンシューマはメッセージを処理および削除できます。

Oracle Cloud Infrastructureの各サービスは、すべてのインタフェース(コンソール、SDKまたはCLI、およびREST API)で、認証および認可のためにIAMと統合されます。

組織の管理者は、グループ、コンパートメントおよびポリシーを設定して、どのユーザーがどのサービスおよびリソースにアクセスできるかと、そのアクセス権のタイプを制御する必要があります。たとえば、ポリシーは、ユーザー、グループおよびコンパートメントを作成できるユーザー、または仮想デプロイメントを作成および管理できるユーザーを制御します。

• 新しい管理者は、ポリシーの開始を参照してください。
• このサービスのポリシー記述の詳細は、キュー・ポリシーを参照してください。
• 他のサービスのリソースのポリシー記述の詳細は、ポリシー・リファレンスを参照してください。

キューには、コンソール(ブラウザベースのインタフェース)、Oracle Cloud Infrastructure CLIまたはREST APIを使用してアクセスできます。

このガイドでは、3つすべての方法の手順について説明します。

• OCIコンソールは、使いやすいブラウザベースのインタフェースです。コンソールにアクセスするには、サポートされているブラウザを使用する必要があります。
• REST APIでは、ほとんどの機能が提供されます。ただしプログラミングの専門知識が必要です。APIリファレンスとエンドポイントに、エンドポイントの詳細と、キューAPIなど、使用可能なAPIリファレンス・ドキュメントへのリンクがあります。
• OCIでは、キューと対話するSDKが提供されます。
• コマンド・ライン・インタフェース(CLI)では、クイック・アクセスとフル機能の両方が提供されます。プログラミングは必要ありません。
• OCI CLIまたはREST APIを使用するには、環境を設定するか、Oracle Cloud Infrastructureクラウド・シェルを使用できます。
  • クラウド・シェルでCLIまたはREST APIを使用するには、コンソールにサインインします。クラウド・シェルの使用およびCLIコマンド・リファレンスを参照してください。
  • 環境にOCI CLIをインストールするには、CLIのインストールのクイックスタートのステップに従います。
  • REST APIを使用する場合は、REST APIドキュメントおよびAPIリファレンスとエンドポイントを参照してください。

Oracle Cloud Infrastructureにサインアップする場合、サービス制限のセットがテナンシに対して構成されます。サービス制限は、リソースに対して設定された割当てまたは許容量です。キュー・リソースの次のサービス制限を確認します。

サービス制限の詳細、および制限拡大のリクエスト方法については、サービス制限を参照してください。リソースまたはリソース・ファミリにコンパートメント固有の制限を設定するために、管理者は、コンパートメント割当て制限を使用できます。