4.8. Spring Boot 自動設定
Spring Boot で aws2-kinesis を使用する場合は、自動設定をサポートするために、次の Maven 依存関係を必ず使用してください。
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-aws2-kinesis-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-aws2-kinesis-starter</artifactId>
</dependency>
コンポーネントは、以下に記載される 40 のオプションをサポートします。
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| camel.component.aws2-kinesis-firehose.access-key | Amazon AWS Access Key。 | String | |
| camel.component.aws2-kinesis-firehose.amazon-kinesis-firehose-client | このエンドポイントのすべてのリクエストに使用する Amazon Kinesis Firehose クライアント。オプションは、software.amazon.awssdk.services.firehose.FirehoseClient タイプです。 | FirehoseClient | |
| camel.component.aws2-kinesis-firehose.autowired-enabled | 自動ワイヤリングが有効になっているかどうか。これは、コンポーネントで設定される一致するタイプのインスタンスが 1 つあるかどうかを検出するためにレジストリーを検索することで、自動ワイアリングオプションに使用されます (オプションは自動ワイアとマーク付けされる必要があります)。これは、JDBC データソース、JMS 接続ファクトリー、AWS クライアントなどの自動設定に使用できます。 | true | Boolean |
| camel.component.aws2-kinesis-firehose.cbor-enabled | このオプションは、実行中に CBOR_ENABLED プロパティーを設定します。 | true | Boolean |
| camel.component.aws2-kinesis-firehose.configuration | コンポーネントの設定。オプションは org.apache.camel.component.aws2.firehose.KinesisFirehose2Configuration タイプです。 | KinesisFirehose2Configuration | |
| camel.component.aws2-kinesis-firehose.enabled | aws2-kinesis-firehose コンポーネントの自動設定を有効にするかどうか。これはデフォルトで有効になっています。 | Boolean | |
| camel.component.aws2-kinesis-firehose.lazy-start-producer | 最初のメッセージでプロデューサーをレイジーに起動すべきかどうか。レイジーに起動することで、起動時に producer が失敗し、それによりルートが失敗する可能性がある状況で、CamelContext およびルートの起動を許可します。レイジーな起動を延期すると、Camel のルーティングエラーハンドラー経由でメッセージのルーティング中に起動の失敗を処理できます。最初のメッセージが処理されるときに、producer の作成および起動に若干時間がかかり、合計処理時間が長くなる可能性があることに注意してください。 | false | Boolean |
| camel.component.aws2-kinesis-firehose.operation | ユーザーがレコードだけを送信したくない場合に行う操作。 | KinesisFirehose2Operations | |
| camel.component.aws2-kinesis-firehose.override-endpoint | エンドポイントをオーバーライドする必要性を設定します。このオプションは uriEndpointOverride オプションと併用する必要があります。 | false | Boolean |
| camel.component.aws2-kinesis-firehose.proxy-host | Kinesis Firehose クライアントをインスタンス化するときにプロキシーホストを定義するには。 | String | |
| camel.component.aws2-kinesis-firehose.proxy-port | Kinesis Firehose クライアントをインスタンス化するときにプロキシーポートを定義するには。 | Integer | |
| camel.component.aws2-kinesis-firehose.proxy-protocol | Kinesis Firehose クライアントをインスタンス化するときにプロキシープロトコルを定義するには。 | Protocol | |
| camel.component.aws2-kinesis-firehose.region | Kinesis Firehose クライアントが機能する必要があるリージョン。このパラメーターを使用する場合、設定には小文字のリージョン名を指定します (例 ap-east-1)。名前 Region.EU_WEST_1.id() を使用する必要があります。 | String | |
| camel.component.aws2-kinesis-firehose.secret-key | Amazon AWS Secret Key。 | String | |
| camel.component.aws2-kinesis-firehose.trust-all-certificates | エンドポイントをオーバーライドするときにすべての証明書を信頼する場合。 | false | Boolean |
| camel.component.aws2-kinesis-firehose.uri-endpoint-override | オーバーライドする URI エンドポイントを設定します。このオプションは overrideEndpoint オプションと組み合わせて使用する必要があります。 | String | |
| camel.component.aws2-kinesis-firehose.use-default-credentials-provider | デフォルトのクレデンシャルプロバイダー経由でクレデンシャルをロードすること、または静的クレデンシャルが渡されることを Kinesis Firehose クライアントは想定すべきかどうかを設定します。 | false | Boolean |
| camel.component.aws2-kinesis.access-key | Amazon AWS Access Key。 | String | |
| camel.component.aws2-kinesis.amazon-kinesis-client | このエンドポイントに対するすべての要求に使用する Amazon Kinesis クライアント。オプションは、software.amazon.awssdk.services.kinesis.KinesisClient タイプです。 | KinesisClient | |
| camel.component.aws2-kinesis.autowired-enabled | 自動ワイヤリングが有効になっているかどうか。これは、コンポーネントで設定される一致するタイプのインスタンスが 1 つあるかどうかを検出するためにレジストリーを検索することで、自動ワイアリングオプションに使用されます (オプションは自動ワイアとマーク付けされる必要があります)。これは、JDBC データソース、JMS 接続ファクトリー、AWS クライアントなどの自動設定に使用できます。 | true | Boolean |
| camel.component.aws2-kinesis.bridge-error-handler | コンシューマーの Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、コンシューマーが受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、consumer は org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | false | Boolean |
| camel.component.aws2-kinesis.cbor-enabled | このオプションは、実行中に CBOR_ENABLED プロパティーを設定します。 | true | Boolean |
| camel.component.aws2-kinesis.configuration | コンポーネントの設定。オプションは org.apache.camel.component.aws2.kinesis.Kinesis2Configuration タイプです。 | Kinesis2Configuration | |
| camel.component.aws2-kinesis.enabled | aws2-kinesis コンポーネントの自動設定を有効にするかどうか。これはデフォルトで有効になっています。 | Boolean | |
| camel.component.aws2-kinesis.iterator-type | Kinesis ストリーム内でレコードの取得を開始する場所を定義します。 | ShardIteratorType | |
| camel.component.aws2-kinesis.lazy-start-producer | 最初のメッセージでプロデューサーをレイジーに起動すべきかどうか。レイジーに起動することで、起動時に producer が失敗し、それによりルートが失敗する可能性がある状況で、CamelContext およびルートの起動を許可します。レイジーな起動を延期すると、Camel のルーティングエラーハンドラー経由でメッセージのルーティング中に起動の失敗を処理できます。最初のメッセージが処理されるときに、producer の作成および起動に若干時間がかかり、合計処理時間が長くなる可能性があることに注意してください。 | false | Boolean |
| camel.component.aws2-kinesis.max-results-per-request | 各ポーリングでフェッチされる最大レコード数。 | 1 | Integer |
| camel.component.aws2-kinesis.override-endpoint | エンドポイントをオーバーライドする必要性を設定します。このオプションは uriEndpointOverride オプションと併用する必要があります。 | false | Boolean |
| camel.component.aws2-kinesis.proxy-host | Kinesis クライアントをインスタンス化する際にプロキシーホストを定義します。 | String | |
| camel.component.aws2-kinesis.proxy-port | Kinesis クライアントをインスタンス化する際にプロキシーポートを定義します。 | Integer | |
| camel.component.aws2-kinesis.proxy-protocol | Kinesis クライアントをインスタンス化する際にプロキシープロトコルを定義します。 | Protocol | |
| camel.component.aws2-kinesis.region | Kinesis Firehose クライアントが機能する必要があるリージョン。このパラメーターを使用する場合、設定には小文字のリージョン名を指定します (例 ap-east-1)。名前 Region.EU_WEST_1.id() を使用する必要があります。 | String | |
| camel.component.aws2-kinesis.resume-strategy | AWS Kinesis の再開戦略を定義します。デフォルトの戦略は、指定されている場合は、sequenceNumber を読み取ります。オプションは org.apache.camel.component.aws2.kinesis.consumer.KinesisResumeStrategy タイプです。 | KinesisResumeStrategy | |
| camel.component.aws2-kinesis.secret-key | Amazon AWS Secret Key。 | String | |
| camel.component.aws2-kinesis.sequence-number | ポーリングを開始するシーケンス番号。iteratorType が AFTER_SEQUENCE_NUMBER または AT_SEQUENCE_NUMBER に設定されている場合に必要です。 | String | |
| camel.component.aws2-kinesis.shard-closed | シャード (shard) が閉じられた場合の動作を定義します。使用できる値は ignore、silent、および fail です。ignore の場合、メッセージはログに記録され、consumer は最初から再起動します。silent の場合は、ログには記録されず、consumer は最初から起動します。fail の場合は、ReachedClosedStateException が発生します。 | Kinesis2ShardClosedStrategyEnum | |
| camel.component.aws2-kinesis.shard-id | Kinesis ストリームでどの shardId からレコードを取得するかを定義します。 | String | |
| camel.component.aws2-kinesis.trust-all-certificates | エンドポイントをオーバーライドするときにすべての証明書を信頼する場合。 | false | Boolean |
| camel.component.aws2-kinesis.uri-endpoint-override | オーバーライドする URI エンドポイントを設定します。このオプションは overrideEndpoint オプションと組み合わせて使用する必要があります。 | String | |
| camel.component.aws2-kinesis.use-default-credentials-provider | デフォルトのクレデンシャルプロバイダー経由でクレデンシャルをロードすること、または静的クレデンシャルが渡されることを Kinesis クライアントは想定すべきかどうかを設定します。 | false | Boolean |