プロダクションから Amazon SQS へのメッセージの送信
InterSystems IRIS は、相互運用プロダクションに Amazon SQS 送信アダプタを使用するビジネス・オペレーションが含まれる場合に Amazon SQS プロデューサになります。このアダプタにより、ビジネス・オペレーションは Amazon SQS キューにメッセージを送信できます。プロダクションを Amazon SQS プロデューサとして使用する場合には、送信アダプタを利用する組み込みのビジネス・オペレーションを使用する、またはアダプタを使用する独自のビジネス・オペレーションを構築するという、2 つのオプションがあります。
アダプタの詳細
Amazon SQS 送信アダプタは、クラス EnsLib.AmazonSQS.OutboundAdapterOpens in a new tab です。
送信アダプタを使用するカスタムのビジネス・オペレーションの構築に関する一般情報は、"ビジネス・オペレーションの定義" を参照してください。
Amazon SQS メッセージの送信
送信アダプタにより Amazon SQS に送信されるメッセージのクラスは EnsLib.AmazonSQS.MessageOpens in a new tab です。このクラスには、以下を含め、メッセージを定義するためのいくつかのプロパティが含まれます。
-
queue は、プロデューサがメッセージを送信する Amazon SQS キューを定義します。
-
body は、メッセージのコンテンツを定義します。
このクラスがメッセージ・オブジェクト・プロパティを介して利用できるメッセージ識別子の詳細な説明は、Amazon SQS のドキュメントOpens in a new tabを参照してください。
messageAttributes プロパティを使用して、メッセージのカスタム・メタデータを指定することもできます。messageAttributes プロパティは、%External.Messaging.SQSMessageAttribute オブジェクトの %ListOfObjects コレクションを受け入れます。SQS メッセージ属性オブジェクトの作成に関する詳細なガイダンスについては、Amazon SQS API に関するドキュメントを参照してください。メッセージ属性を使用してカスタム・メタデータを添付する場合の一般情報は、Amazon SQS のドキュメントOpens in a new tabを参照してください。
送信アダプタの SendMessage() メソッドは、唯一の引数として EnsLib.AmazonSQS.MessageOpens in a new tab オブジェクトを取り、そのメッセージを Amazon SQS サーバに送信します。例えば、カスタムのビジネス・オペレーションは、以下を含めることにより、アダプタのメソッドを呼び出すことができます。
Do ..Adapter.SendMessage(pRequest)
組み込みのビジネス・オペレーション
送信アダプタを使用するカスタムのビジネス・オペレーションを構築するのではなく、管理ポータルを使用して、プロダクションに単に EnsLib.AmazonSQS.OperationOpens in a new tab を追加し、必要な設定を定義するだけです。このビジネス・オペレーションは、プロダクション内の別のビジネス・ホストから要求を受信すると、アダプタの SendMessage() メソッドを呼び出します。この要求には、EnsLib.AmazonSQS.MessageOpens in a new tab のタイプの Amazon SQS メッセージを含める必要があります。
ビジネス・オペレーションのプロダクションへの追加に関する基本情報は、"ビジネス・ホストの追加" を参照してください。
一般的な AWS 設定
SQS 送信アダプタは、一般的な AWS プロパティを含む一般的なアダプタ・クラスを拡張します。これらの AWS プロパティは、送信アダプタを使用するビジネス・オペレーションをプロダクションに追加する際、管理ポータルでビジネス・オペレーションの [AWS] 設定を使用して設定できます。
-
CredentialsFile — 空白の場合、Amazon は既定の認証情報プロバイダ・チェーンOpens in a new tabを使用して、SQS へのアクセスに必要な認証情報を取得します。AWS 認証情報ファイルを使用する場合は、そのパス名を入力します。
-
リージョン — アクセスする AWS リージョンを指定します。リージョンのリストは、"Amazon Regions, Availability Zones, and Local ZonesOpens in a new tab" を参照してください。
関連項目
-
Amazon SQS メッセージング API の使用法 (プロダクションなしで使用する場合)