S3パス形式の設定

Last updated on February 4, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要​

S3パス形式により、データが保存されるS3パスを柔軟に定義できます。

S3パス形式​

S3パス形式には、静的形式と動的形式があります。静的形式はS3パスにそのまま記述され、動的形式はデータ値として記述されます。動的形式には以下の10個のフィールドがあります：

  • {eventType}: イベントタイプのプロパティで、game-telemetryまたはjustice-eventになります。

  • {namespace}: ネームスペースのプロパティで、データのネームスペースに従います。

  • {realm}: レルムのプロパティで、環境名になります。

  • {topic}: トピックのプロパティで、Kafkaトピックのソースに従います。

  • {eventName}: イベント名のプロパティで、データのイベント名に従います。

  • {yyyy}: 時刻形式の年プロパティ。結果例：2023

  • {MM}: 時刻形式の月プロパティ。結果例：06

  • {dd}: 時刻形式の日プロパティ。結果例：19

  • {hh}: 時刻形式の時プロパティ。結果例：24

  • {mm}: 時刻形式の分プロパティ。結果例：00,15,30,45。デフォルトは15分ローテーションで、これがS3パーティション期間です。

デフォルト値​

以下はデフォルトのS3パス形式の値です。

{eventType}/realm/{realm}/topics/{topic}/year={yyyy}/month={MM}/day={dd}/hour={hh}/minute={mm}/{topic}.json

デフォルト形式は以下のような結果になります。

game-telemetry/realm/dev/topics/analytics_game_telemetry.dev.accelbyte.gameEvent/year=2023/month=06/day=15/hour=09/minute=45/analytics_game_telemetry.dev.accelbyte.gameEvent-000001.json

設定例​

値の例：

accelbyte/event={eventType}/environment={realm}/namespace={namespace}/topic={topic}/event_name={eventName}/year={yyyy}/month={MM}/day={dd}/hour={hh}/file-{topic}-{namespace}.json

結果の例： これらのサンプル値は以下の結果を生成します。

accelbyte/event=game-telemetry/environment=dev/namespace=accelbyte/event=analytics_game_telemetry.dev.accelbyte.gameEvent/event_name=gameEvent/year=2023/month=06/day=15/hour=09/file-analytics_game_telemetry.dev.accelbyte.gameEvent-accelbyte-000001.json

この場合、accelbyte/event=、environment=、namespace=、topic=、event_name=、year=、month=、day=、hour=の値は静的形式であり、{eventType}、{realm}、{namespace}、{topic}、{yyyy}、{MM}、{dd}、{hh}の値は動的形式です。

S3パーティション期間​

S3パーティション期間は、分単位でデータがS3オブジェクトにどのようにパーティション分割されるかを決定します。分パーティションはデフォルトで15分に設定されています。1分から60分まで設定可能です。

注記

分パスが含まれている場合のみ設定可能です

値の例：

  • S3パス形式

    accelbyte/event={eventType}/environment={realm}/namespace={namespace}/topic={topic}/event_name={eventName}/year={yyyy}/month={MM}/day={dd}/hour={hh}/minute={mm}/file-{topic}-{namespace}.json

  • S3パーティション期間：15

結果の例：

accelbyte/event=game-telemetry/environment=dev/namespace=accelbyte/event=analytics_game_telemetry.dev.accelbyte.gameEvent/event_name=gameEvent/year=2023/month=06/day=15/hour=09/minute=15/file-analytics_game_telemetry.dev.accelbyte.gameEvent-accelbyte-000001.json
accelbyte/event=game-telemetry/environment=dev/namespace=accelbyte/event=analytics_game_telemetry.dev.accelbyte.gameEvent/event_name=gameEvent/year=2023/month=06/day=15/hour=09/minute=30/file-analytics_game_telemetry.dev.accelbyte.gameEvent-accelbyte-000002.json
に最終更新
On this page