ピボット ツールは、既存のフィールドの個別値を使用してロング データセットをワイド データセットに変換し、新しいフィールドを作成します。
例
ピボット ツールは次のようなシナリオで使用できます。
- 多くのレコードと少数のフィールドを含む長いデータセットがあり、このデータセットを少数のレコードと多くのフィールドを持つ形式に変換したいと考えています。
- 複数年にわたる現場での観測地のレコードを含むデータセットがあり、年ごとに値を集計したいと考えています。
パラメーター
次の表に、ピボット ツールのパラメーターの概要を示します。
| パラメーター | 説明 |
|---|---|
入力データセット | ピボットするデータセット。 |
入力フィールド | 出力データセット内の一意のレコードを定義するために使用する 1 つ以上のフィールド。 一致する値を持つレコードは、集約関数を使用して集約されます。 |
ピボット フィールド | 出力データセットの新しいフィールドに変換する値を含むフィールド。 |
値フィールド | 新しいレコードの値を決定するのに使用するフィールド。 |
集約関数 | 新しい値の計算に使用する関数。 |
使用上の注意
[入力データセット] パラメーターを使用して、ピボットされるデータセットを特定します。
[入力フィールド] パラメーターを使用して、グループ化する値を含む 1 つ以上のフィールドを特定します。 指定したフィールドからの一意の値が、出力データセット内のレコードになります。 [入力フィールド] と [ピボット フィールド] または [値フィールド] の両方に同じフィールドを指定することはできません。
[ピボット フィールド] パラメーターを使用して、出力データセット内の新しいフィールド名の作成に使用される値を含むフィールドを特定します。
[集約関数] パラメーターは、グループ化されたレコードの値がどのように計算されるかを決定するために使用されます。 次の集計関数を使用できます。
- [合計] - フィールド内の数値の合計。 [null, 1, 3] の合計は 4 です。
- [最小] - 数値または日付フィールドの最小値。 [0, 2, null] の最小値は 0 です。
- [最大] - 数値または日付フィールドの最大値。 [0, 2, null] の最大値は 2 です。
- [平均] - 数値の平均。 [0, 2, null] の平均は 1 です。
- [標準偏差] - 数値フィールドの標準偏差。 [null, 1, 1, 1] の標準偏差は 0 です。
- [個数] - 非 NULL 値の数。 任意のタイプのフィールドで使用できます。 [null, "hello", "world"] の数は 2 です。
- [すべて] - 任意のタイプのフィールドのサンプル値。
出力
ツールの出力は、次のフィールドと値を含むデータセットです。
- [入力フィールド] パラメーターを使用して指定したすべてのフィールド。 出力には、フィールドまたはフィールドの組み合わせで見つかった一意の値ごとに 1 つのレコードが含まれます。
- [ピボット フィールド] パラメーターを使用して指定したフィールドの各個別値の新しいフィールド。 これらのフィールドには、[値フィールド] パラメーターを使用して指定したフィールドの集約値が含まれます。 たとえば、ピボット フィールドに 2 つの個別値 California と Washington が含まれており、[Mean] と [Any] の集約関数を計算すると、結果には 4 つの新しいフィールド、MEAN_California、ANY_California、MEAN_Washington、ANY_Washington が含まれます。
[ピボット フィールド] に NULL 値が含まれている場合、null というフィールドが追加されます。 [ピボット フィールド] に空の文字列が含まれている場合、_ というフィールドが追加されます。
制限事項
ピボット ツールの既知の制限事項は以下のとおりです。
- フィールド名では大文字と小文字が区別されません。[ピボット フィールド] パラメーターに、大文字と小文字が異なる一致するテキスト値が含まれている場合、重複を避けるために出力フィールドの名前が変更されます。
- 不正な文字が含まれているか、数字で始まるフィールド名は名前が変更されます。 [ピボット フィールド] パラメーターに、名前を変更すると競合する複数の値が含まれている場合、重複を避けるために名前が変更されます。
- [ピボット フィールド] パラメーターでは、最大 1,000 個の個別値がサポートされます。 1,000 を超える個別値が見つかった場合、エラーが発生します。
- ピボットは、新しいフィールド値を決定するために入力データセット全体をスキャンする必要があります。 下流方向ツールのパフォーマンスで問題が発生する場合は、入力データセットのサイズを制限することを検討してください。
ライセンス要件
次のライセンスと構成が必要です。
- Creator または Professional ユーザー タイプ
- 公開者、ファシリテーター、管理者ロール、またはそれと同等のカスタム ロール
Data Pipelines の要件の詳細については、要件をご参照ください。