ストリーム レイヤー の設定を行います

カタログでレイヤーを作成するときに、ストリーム レイヤー設定を構成できます。

スループット

スループットは、 100 kbps （ KB/ 秒）単位で設定できます。最小設定は、 100 kbps のインバウンドおよび 100 kbps のアウトバウンドです。

インバウンドスループットのデフォルト値は 1000 kbps （ KB/ 秒）で、デフォルトのアウトバウンドスループットは 4000 kbps （ KB/ 秒）です。 インバウンドには最大 32800 kbps （ 1 秒あたりのキロバイト数）、アウトバウンドには最大 65500 kbps （ 1 秒あたりのキロバイト数）を指定できます。

レイヤーに入るデータの最大スループット、およびレイヤーから出るデータの最大スループットを個別に指定できます。

HERE platform は、インバウンドレートがインバウンドスループットを超えると、インバウンドメッセージのスロットリングを開始します。 すべてのコンシューマへの合計アウトバウンドレートがアウトバウンドスループットを超えると、アウトバウンドメッセージのスロットリングが開始されます。 スロットリングが発生すると、サービスの応答が遅れますが、メッセージはドロップされません。 スロットリングが発生していることを示す特別な HTTP 応答はありません。 唯一の兆候は、サービスのスローダウンです。

HERE Marketplace のカタログの最大アウトバウンドスループットは 2000 kbps （ KB/ 秒）です。

アウトバウンドスループットは、少なくとも予想される消費者数（ユーザーおよびパイプライン） × インバウンドスループットに設定することをお勧めします。 一部の消費者が最近のデータを「リプレイ」した場合、出力レートが高くなることがあります。 インバウンドスループットは、アウトバウンドスループットを超えることはできません。 存在する場合、コンシューマーはプロデューサーが提供するすべてのデータを読み取ることはできません。

ストリーム パーティション 並列化

ストリームパーティションの並列化によって、同じコンシューマグループ内の何人のコンシューマが同じレイヤーのデータを並列に利用できるかが決まります。 ストリームパーティション並列化の値を指定すると、作成される内部ストリームパーティションの数が決まります。 最小値は 1 ストリームパーティションで、最大値は 32 ストリームです。

スループット の入力、 スループットの出力、 並列化を行うことをお勧めします。 スループット入力とスループット出力のみを指定した場合、スループット入力を最も近い Mbps 値に切り上げて並列化が計算されます。 たとえば 、のスループットが 最大 500 kbps ( キロバイト / 秒 ) の場合、並列化は 1 になります。 並列化の値のみを指定した場合、次の式を使用してスループット値が計算されます。

Throughput in = min(round(parallelization*1024/100)*100,32000) KBps

Throughput out = min(round(parallelization*2048/100)*100,65500) KBps

スループットイン、スループットアウト、並列化の値を指定しない場合、次のデフォルト値が使用されます。

• スループット : 1000 kbps ( キロバイト / 秒 )
• スループット : 4000 kbps ( キロバイト / 秒 )
• 並列化 : 4.

保持

ストリーム レイヤーには、存続時間の値（ Time-to-Live または TTL ）を設定できます。 TTL 値は、メッセージが使用可能なままになる最小時間を定義します。 TTL 時間が経過すると、メッセージはレイヤから削除されますが、 TTL 設定で指定された保持時間に正確には削除されません。 メッセージは、 TTL 時間が経過してからしばらくシステムに残ることがあります。 TTL 設定を超えるデータストレージの使用料は請求されません。

TTL 値は、レイヤーにパブリッシュされたすべてのメッセージに適用されます。

データプロデューサーが消費者に最近のデータを再生 ( 再利用 ) することを期待する場合は、より大きい TTL 値を指定すると便利です。 たとえば、レイヤーに車両センサのデータが保存されており、消費者が異なるアルゴリズムの結果を比較して特定の道路または車両の状態を特定しようとしています。 消費者は最近 3 時間、数回データを消費する必要があります。 この場合、 4 時間以上の TTL が適しています。 別の例では、 1 時間ごとに、過去 1 時間に受信したすべてのデータを使用しています。 この場合、 TTL は 1 時間以上設定する必要があります。 TTL を大きくする最終的な使用例は、処理によってエラーが発生した場合に、公開されたメッセージを消費者が再処理できるようにすることです。

TTL 値の有効範囲は 10 分 ～ 3 日です。 デフォルト値は 1 時間です。 TTL をミリ秒単位で指定します。

コンテンツタイプ

コンテンツタイプは、レイヤー内のデータの種類を特定するために使用するメディアタイプを指定します。

コンテンツのエンコード

コンテンツのエンコード設定では、圧縮を使用してレイヤーに保存されているデータのサイズを削減するかどうかを指定します。 圧縮を有効にするには 、 gzip を指定します。

データを圧縮することで、ストレージのサイズ、 I/O の転送、読み取りのコストを最適化できます。 ただし、データを圧縮すると、実際の圧縮で余分な CPU サイクルが発生します。 レイヤーの圧縮を有効にするかどうかを決定する場合は、圧縮のメリットとコストの両方を考慮してください。

一部の形式、特にテキスト、 XML 、 JSON 、 GeoJSON などのテキスト形式では、圧縮率が非常に高くなります。 JPEG または PNG 画像など、他のデータ形式はすでに圧縮されているため、再度 gzip で圧縮してもサイズは小さくなりません。 多くの場合、ペイロードのサイズを増やすこともあります。 Protobuf などの汎用バイナリ形式の場合、圧縮率は実際のコンテンツおよびメッセージサイズに応じて異なります。 実際のデータの圧縮率をテストして、圧縮が有益かどうかを確認することをお勧めします。

寄木細工には圧縮を使用しないでください。 圧縮によって blob データへのランダムなアクセスが切断されます。この圧縮は、寄木細工のデータを効率的に読み取るために必要です。

レイヤーに SDII データが含まれている場合、 ingest API の /layers/<layerID>/sdiimessagelist エンドポイントは圧縮をサポートしていないことに注意してください。 したがって、 SDII データを含むレイヤーの圧縮を有効にする場合は、 ingest API の汎用エンドポイント (/layers/<layerID>) を使用する必要があり、すべての圧縮および圧縮解除をアプリケーションで処理する必要があります。

データ クライアント ライブラリを使用して圧縮レイヤーからデータの読み取りまたは書き込みを行う場合、圧縮および圧縮解除は自動的に処理されます。

Data API を使用して圧縮レイヤーからデータを読み書きする場合は、レイヤーに書き込む前にデータを圧縮する必要があります。 データを読み取る場合、受信したデータは gzip 形式であるため、解凍の責任はお客様にあります。

スキーマ

スキーマを指定すると、他のユーザーがデータをどのように使用するかを定義して、他のユーザーとデータを共有できます。 詳細については 、「スキーマ」を参照してください。

カバレッジ

このレイヤーがカバーする地理的領域。 この設定では、プラットフォームポータルのレイヤーのカバレッジマップで強調表示する世界の領域を制御します。

2 文字の ISO 3166-1 アルファ 2 コードを使用して、国と地域のリストを指定します。 任意で、国のサブディビジョンの ISO 3166-2 コードを使用して、 2 文字の国のサブディビジョンコードを追加できます。 たとえば、ドイツの場合は「 D 」、ブラジルの場合は「 BR 」、香港の場合は「 CN-HK 」を指定できます。