ApsaraDB RDS:ST_AsHMT

構文

bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, int4 value default 1, boolean point_mode default false);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, int4 value);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, int4 value, boolean point_mode);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, float8 value);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, float8 value, boolean point_mode);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, int4 value, cstring config);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, float8 value, cstring config);

バリアントの選択：

• ジオメトリのカウント (value 引数なし): デフォルトで value=1 と point_mode=false が設定されている最初のバリアントを使用します。

• int4 列の合計 (例: カウント、数量)：int4 value バリアントを使用します。合計が 2,147,483,647 を超える可能性がある場合は、オーバーフローを避けるため、代わりに float8 value を使用します。

• float8 列の合計 (例：メトリック、比率)：float8 value バリアントを使用します。

• 高度な集約 (min、max、avg、または JSON によるポイントモード)：cstring config バリアントを使用します。

戻り値

protobuf ベースのバイナリデータマトリックス (bytea) を返します。proto スキーマは以下の通りです。

syntax = "proto2";
option optimize_for = LITE_RUNTIME;

message HMT {
    required Type type = 1;       // data value type
    required uint32 rows = 2;     // rows of matrix
    required uint32 columns = 3;  // columns of matrix
    required uint32 srid = 4;
    required float  xmin = 5;     // xmin
    required float  ymin = 6;     // ymin
    required float  xmax = 7;     // xmax
    required float  ymax = 8;     // ymax

    oneof matrix {
        intMatrix intValues = 10;
        doubleMatrix doubleValues = 11;
    }

    message intMatrix {
        repeated sint32 values = 12 [packed = true];
    }

    message doubleMatrix {
        repeated double values = 13 [packed = true];
    }

    enum Type {
        INT32 = 0;
        DOUBLE = 1;
    }
}

マトリックスのレイアウト：

• type は、入力 value パラメーターによって決定されます。int4 の場合は INT32、float8 の場合は DOUBLE になります。

• rows と columns は、それぞれ height と width パラメーターに対応します。

• 値は、標準的なイメージ座標規則に一致するよう、X 軸は昇順、Y 軸は降順で、行ごとに格納されます。

戻り値を配列表現に変換する方法については、「ST_HMTAsArray」をご参照ください。

パラメーター

注意事項

SRID が不一致の場合の動作: geometry_set の空間参照が extent の空間参照と異なる場合、この関数は extent の空間参照をデータに適用します。 関数を呼び出す前に両方が同じ SRID を使用することを確認するには、サンプルジオメトリで ST_SRID() を実行し、その結果を extent に埋め込まれている SRID と比較します。

int4 オーバーフロー: int4 値 を使用して合計を計算する場合、値は int32 の範囲 (–2,147,483,648～2,147,483,647) に制限されます。合計がこの範囲を超える可能性があるデータについては、代わりに float8 の列または式を渡してください。

例

すべての例では、次のコマンドで作成されたテストテーブルを使用します：

CREATE TABLE test_table AS
SELECT i num,
    ST_SetSrid(st_makepoint((i-0.5)::numeric, (i-0.5)::numeric), 4326) geom,
    i*100::int4 weight,
    i*i*i::float8 volume
FROM generate_series(1, 10) i;

SELECT ST_AsHMT(geom,
    ST_MakeEnvelope(0, 0, 10, 10, 4326),  -- extent
    1024,                                  -- width, in pixels
    800                                    -- height, in pixels
)
FROM test_table;
---------
\x080010a0061880083284...

SELECT ST_AsHMT(geom,
    ST_MakeEnvelope(0, 0, 10, 10, 4326),  -- extent
    1024,                                  -- width
    800,                                   -- height
    weight                                 -- value column
)
FROM test_table;
---------
\x080010a0061880...

SELECT ST_AsHMT(geom,
    ST_MakeEnvelope(0, 0, 10, 10, 4326),  -- extent
    1024,                                  -- width
    800,                                   -- height
    weight / volume * 1.2                  -- float8 expression
)
FROM test_table;
---------
\x080110a0061880083a85...

SELECT ST_AsHMT(geom,
    ST_MakeEnvelope(0, 0, 10, 10, 4326),  -- extent
    1024,                                  -- width, in pixels
    800,                                   -- height
    1::integer,                            -- value
    true                                   -- point mode
)
FROM test_table;
---------
\x080010a0061880083...

SELECT ST_AsHMT(geom,
    ST_MakeEnvelope(0, 0, 10, 10, 4326),  -- extent
    1024,                                  -- width, in pixels
    800                                    -- height
)
FROM test_table
WHERE num < 5;
---------
\x080010a00618...

SELECT ST_AsHMT(the_geom,
    ST_MakeEnvelope(0, 0, 10, 10, 4326),  -- extent
    256,                                   -- width, in pixels
    256,                                   -- height
    weight,
    '{"type":"avg"}'::cstring)
FROM test_table;
---------
\x080010a00618...

SELECT ST_AsHMT(the_geom,
    ST_MakeEnvelope(0, 0, 10, 10, 4326),  -- extent
    256,                                   -- width, in pixels
    256,                                   -- height
    weight,
    '{"type":"min", "point_mode":true}'::cstring)
FROM test_table;
---------
\x080010a00618...

次のステップ

• ST_HMTAsArray — HMT バイナリ値を配列表現に変換