fix: unify the schema modules in emqx_bridge_pgsql

This commit is contained in:
Kjell Winblad 2023-11-23 18:50:19 +01:00
parent b8f510d956
commit 64c015cf6f
6 changed files with 193 additions and 252 deletions

View File

@ -28,7 +28,7 @@ conn_bridge_examples(Method) ->
#{ #{
<<"matrix">> => #{ <<"matrix">> => #{
summary => <<"Matrix Bridge">>, summary => <<"Matrix Bridge">>,
value => emqx_bridge_pgsql_schema:values_conn_bridge_examples(Method, matrix) value => emqx_bridge_pgsql:values_conn_bridge_examples(Method, matrix)
} }
} }
]. ].
@ -42,28 +42,28 @@ roots() -> [].
fields("post") -> fields("post") ->
emqx_bridge_pgsql:fields("post", matrix); emqx_bridge_pgsql:fields("post", matrix);
fields("config_connector") -> fields("config_connector") ->
emqx_bridge_pgsql_schema:fields("config_connector"); emqx_bridge_pgsql:fields("config_connector");
fields(action) -> fields(action) ->
{matrix, {matrix,
hoconsc:mk( hoconsc:mk(
hoconsc:map(name, hoconsc:ref(emqx_bridge_pgsql_schema, pgsql_action)), hoconsc:map(name, hoconsc:ref(emqx_bridge_pgsql, pgsql_action)),
#{ #{
desc => <<"Matrix Action Config">>, desc => <<"Matrix Action Config">>,
required => false required => false
} }
)}; )};
fields("put_bridge_v2") -> fields("put_bridge_v2") ->
emqx_bridge_pgsql_schema:fields(pgsql_action); emqx_bridge_pgsql:fields(pgsql_action);
fields("get_bridge_v2") -> fields("get_bridge_v2") ->
emqx_bridge_pgsql_schema:fields(pgsql_action); emqx_bridge_pgsql:fields(pgsql_action);
fields("post_bridge_v2") -> fields("post_bridge_v2") ->
emqx_bridge_pgsql_schema:fields(pgsql_action); emqx_bridge_pgsql:fields(pgsql_action);
fields("put_connector") -> fields("put_connector") ->
emqx_bridge_pgsql_schema:fields("config_connector"); emqx_bridge_pgsql:fields("config_connector");
fields("get_connector") -> fields("get_connector") ->
emqx_bridge_pgsql_schema:fields("config_connector"); emqx_bridge_pgsql:fields("config_connector");
fields("post_connector") -> fields("post_connector") ->
emqx_bridge_pgsql_schema:fields("config_connector"); emqx_bridge_pgsql:fields("config_connector");
fields(Method) -> fields(Method) ->
emqx_bridge_pgsql:fields(Method). emqx_bridge_pgsql:fields(Method).
@ -87,7 +87,7 @@ bridge_v2_examples(Method) ->
#{ #{
<<"matrix">> => #{ <<"matrix">> => #{
summary => <<"Matrix Action">>, summary => <<"Matrix Action">>,
value => emqx_bridge_pgsql_schema:values({Method, matrix}) value => emqx_bridge_pgsql:values({Method, matrix})
} }
} }
]. ].

View File

@ -1,83 +1,91 @@
%%-------------------------------------------------------------------- %%--------------------------------------------------------------------
%% Copyright (c) 2022-2023 EMQ Technologies Co., Ltd. All Rights Reserved. %% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
%%-------------------------------------------------------------------- %%--------------------------------------------------------------------
-module(emqx_bridge_pgsql). -module(emqx_bridge_pgsql).
-include_lib("emqx_connector/include/emqx_connector.hrl").
-include_lib("emqx_postgresql/include/emqx_postgresql.hrl").
-include_lib("typerefl/include/types.hrl"). -include_lib("typerefl/include/types.hrl").
-include_lib("emqx/include/logger.hrl").
-include_lib("hocon/include/hoconsc.hrl"). -include_lib("hocon/include/hoconsc.hrl").
-include_lib("epgsql/include/epgsql.hrl").
-include_lib("snabbkaffe/include/snabbkaffe.hrl").
-include_lib("emqx_resource/include/emqx_resource.hrl"). -include_lib("emqx_resource/include/emqx_resource.hrl").
-import(hoconsc, [mk/2, enum/1, ref/2]).
-export([
conn_bridge_examples/1,
values/2,
fields/2
]).
-export([ -export([
namespace/0, namespace/0,
roots/0, roots/0,
fields/1, fields/1,
desc/1 desc/1,
values/2,
fields/2
]). ]).
-define(DEFAULT_SQL, << %% Examples
"insert into t_mqtt_msg(msgid, topic, qos, payload, arrived) " -export([
"values (${id}, ${topic}, ${qos}, ${payload}, TO_TIMESTAMP((${timestamp} :: bigint)/1000))" bridge_v2_examples/1,
>>). conn_bridge_examples/1
]).
%% ------------------------------------------------------------------------------------------------- %% Exported for timescale and matrix bridges
%% api -export([
values/1,
values_conn_bridge_examples/2
]).
conn_bridge_examples(Method) -> -define(PGSQL_HOST_OPTIONS, #{
[ default_port => ?PGSQL_DEFAULT_PORT
#{ }).
<<"pgsql">> => #{
summary => <<"PostgreSQL Bridge">>,
value => values(Method, pgsql)
}
}
].
values(_Method, Type) ->
#{
enable => true,
type => Type,
name => <<"foo">>,
server => <<"127.0.0.1:5432">>,
database => <<"mqtt">>,
pool_size => 8,
username => <<"root">>,
password => <<"******">>,
sql => ?DEFAULT_SQL,
local_topic => <<"local/topic/#">>,
resource_opts => #{
worker_pool_size => 8,
health_check_interval => ?HEALTHCHECK_INTERVAL_RAW,
batch_size => ?DEFAULT_BATCH_SIZE,
batch_time => ?DEFAULT_BATCH_TIME,
query_mode => async,
max_buffer_bytes => ?DEFAULT_BUFFER_BYTES
}
}.
%% -------------------------------------------------------------------------------------------------
%% Hocon Schema Definitions %% Hocon Schema Definitions
namespace() -> "bridge_pgsql". namespace() -> "bridge_pgsql".
roots() -> []. roots() ->
[].
fields("config_connector") ->
emqx_postgresql_connector_schema:fields("config_connector");
fields(config) ->
fields("config_connector") ++
fields(action);
fields(action) ->
{pgsql,
hoconsc:mk(
hoconsc:map(name, hoconsc:ref(emqx_bridge_pgsql, pgsql_action)),
#{
desc => <<"PostgreSQL Action Config">>,
required => false
}
)};
fields(action_parameters) ->
[
{sql,
hoconsc:mk(
binary(),
#{desc => ?DESC("sql_template"), default => default_sql(), format => <<"sql">>}
)}
] ++
emqx_connector_schema_lib:prepare_statement_fields();
fields(pgsql_action) ->
emqx_bridge_v2_schema:make_producer_action_schema(hoconsc:ref(?MODULE, action_parameters));
%% TODO: All of these needs to be fixed
fields("put_bridge_v2") ->
fields(pgsql_action);
fields("get_bridge_v2") ->
fields(pgsql_action);
fields("post_bridge_v2") ->
fields(pgsql_action);
fields("config") -> fields("config") ->
[ [
{enable, mk(boolean(), #{desc => ?DESC("config_enable"), default => true})}, {enable, hoconsc:mk(boolean(), #{desc => ?DESC("config_enable"), default => true})},
{sql, {sql,
mk( hoconsc:mk(
binary(), binary(),
#{desc => ?DESC("sql_template"), default => ?DEFAULT_SQL, format => <<"sql">>} #{desc => ?DESC("sql_template"), default => default_sql(), format => <<"sql">>}
)}, )},
{local_topic, {local_topic,
mk( hoconsc:mk(
binary(), binary(),
#{desc => ?DESC("local_topic"), default => undefined} #{desc => ?DESC("local_topic"), default => undefined}
)} )}
@ -94,6 +102,12 @@ fields("get") ->
fields("post", Type) -> fields("post", Type) ->
[type_field(Type), name_field() | fields("config")]. [type_field(Type), name_field() | fields("config")].
type_field(Type) ->
{type, hoconsc:mk(hoconsc:enum([Type]), #{required => true, desc => ?DESC("desc_type")})}.
name_field() ->
{name, hoconsc:mk(binary(), #{required => true, desc => ?DESC("desc_name")})}.
desc("config") -> desc("config") ->
?DESC("desc_config"); ?DESC("desc_config");
desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" -> desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
@ -101,10 +115,109 @@ desc(Method) when Method =:= "get"; Method =:= "put"; Method =:= "post" ->
desc(_) -> desc(_) ->
undefined. undefined.
%% ------------------------------------------------------------------------------------------------- default_sql() ->
<<
"insert into t_mqtt_msg(msgid, topic, qos, payload, arrived) "
"values (${id}, ${topic}, ${qos}, ${payload}, TO_TIMESTAMP((${timestamp} :: bigint)/1000))"
>>.
type_field(Type) -> %% Examples
{type, mk(enum([Type]), #{required => true, desc => ?DESC("desc_type")})}.
name_field() -> bridge_v2_examples(Method) ->
{name, mk(binary(), #{required => true, desc => ?DESC("desc_name")})}. [
#{
<<"pgsql">> => #{
summary => <<"PostgreSQL Producer Action">>,
value => values({Method, bridge_v2_producer})
}
}
].
conn_bridge_examples(Method) ->
[
#{
<<"pgsql">> => #{
summary => <<"PostgreSQL Producer Bridge">>,
value => values_conn_bridge_examples(Method, pgsql)
}
}
].
values({get, PostgreSQLType}) ->
maps:merge(
#{
status => <<"connected">>,
node_status => [
#{
node => <<"emqx@localhost">>,
status => <<"connected">>
}
]
},
values({post, PostgreSQLType})
);
values({post, PostgreSQLType}) ->
maps:merge(
#{
name => <<"my_pgsql_action">>,
type => PostgreSQLType
},
values({put, PostgreSQLType})
);
values({put, PostgreSQLType}) ->
maps:merge(
#{
enable => true,
connector => <<"my_pgsql_connector">>,
resource_opts => #{
health_check_interval => "32s"
}
},
values({producer, PostgreSQLType})
);
values({producer, _PostgreSQLType}) ->
#{
<<"enable">> => true,
<<"connector">> => <<"connector_pgsql_test">>,
<<"parameters">> => #{
<<"sql">> =>
<<"INSERT INTO client_events(clientid, event, created_at) VALUES (\n ${clientid},\n ${event},\n TO_TIMESTAMP((${timestamp} :: bigint))\n)">>
},
<<"resource_opts">> => #{
<<"batch_size">> => 1,
<<"batch_time">> => <<"0ms">>,
<<"health_check_interval">> => <<"15s">>,
<<"inflight_window">> => 100,
<<"max_buffer_bytes">> => <<"256MB">>,
<<"query_mode">> => <<"async">>,
<<"request_ttl">> => <<"45s">>,
<<"start_after_created">> => true,
<<"start_timeout">> => <<"5s">>,
<<"worker_pool_size">> => 16
}
}.
values_conn_bridge_examples(_Method, Type) ->
#{
enable => true,
type => Type,
name => <<"foo">>,
server => <<"127.0.0.1:5432">>,
database => <<"mqtt">>,
pool_size => 8,
username => <<"root">>,
password => <<"******">>,
sql => default_sql(),
local_topic => <<"local/topic/#">>,
resource_opts => #{
worker_pool_size => 8,
health_check_interval => ?HEALTHCHECK_INTERVAL_RAW,
batch_size => ?DEFAULT_BATCH_SIZE,
batch_time => ?DEFAULT_BATCH_TIME,
query_mode => async,
max_buffer_bytes => ?DEFAULT_BUFFER_BYTES
}
}.
values(Method, Type) ->
values_conn_bridge_examples(Method, Type).

View File

@ -19,4 +19,4 @@ action_type_name() -> pgsql.
connector_type_name() -> pgsql. connector_type_name() -> pgsql.
schema_module() -> emqx_bridge_pgsql_schema. schema_module() -> emqx_bridge_pgsql.

View File

@ -1,172 +0,0 @@
%%--------------------------------------------------------------------
%% Copyright (c) 2023 EMQ Technologies Co., Ltd. All Rights Reserved.
%%--------------------------------------------------------------------
-module(emqx_bridge_pgsql_schema).
-include_lib("emqx_connector/include/emqx_connector.hrl").
-include_lib("emqx_postgresql/include/emqx_postgresql.hrl").
-include_lib("typerefl/include/types.hrl").
-include_lib("emqx/include/logger.hrl").
-include_lib("hocon/include/hoconsc.hrl").
-include_lib("epgsql/include/epgsql.hrl").
-include_lib("snabbkaffe/include/snabbkaffe.hrl").
-include_lib("emqx_resource/include/emqx_resource.hrl").
-export([roots/0, fields/1]).
%% Examples
-export([
bridge_v2_examples/1,
conn_bridge_examples/1
]).
%% Exported for timescale and matrix bridges
-export([
values/1,
values_conn_bridge_examples/2
]).
-define(PGSQL_HOST_OPTIONS, #{
default_port => ?PGSQL_DEFAULT_PORT
}).
roots() ->
[{config, #{type => hoconsc:ref(?MODULE, config)}}].
fields("config_connector") ->
emqx_postgresql_connector_schema:fields("config_connector");
fields(config) ->
fields("config_connector") ++
fields(action);
fields(action) ->
{pgsql,
hoconsc:mk(
hoconsc:map(name, hoconsc:ref(emqx_bridge_pgsql_schema, pgsql_action)),
#{
desc => <<"PostgreSQL Action Config">>,
required => false
}
)};
fields(action_parameters) ->
[
{sql,
hoconsc:mk(
binary(),
#{desc => ?DESC("sql_template"), default => default_sql(), format => <<"sql">>}
)}
] ++
emqx_connector_schema_lib:prepare_statement_fields();
fields(pgsql_action) ->
emqx_bridge_v2_schema:make_producer_action_schema(hoconsc:ref(?MODULE, action_parameters));
%% TODO: All of these needs to be fixed
fields("put_bridge_v2") ->
fields(pgsql_action);
fields("get_bridge_v2") ->
fields(pgsql_action);
fields("post_bridge_v2") ->
fields(pgsql_action).
default_sql() ->
<<
"insert into t_mqtt_msg(msgid, topic, qos, payload, arrived) "
"values (${id}, ${topic}, ${qos}, ${payload}, TO_TIMESTAMP((${timestamp} :: bigint)/1000))"
>>.
%% Examples
bridge_v2_examples(Method) ->
[
#{
<<"pgsql">> => #{
summary => <<"PostgreSQL Producer Action">>,
value => values({Method, bridge_v2_producer})
}
}
].
conn_bridge_examples(Method) ->
[
#{
<<"pgsql">> => #{
summary => <<"PostgreSQL Producer Bridge">>,
value => values_conn_bridge_examples(Method, pgsql)
}
}
].
values({get, PostgreSQLType}) ->
maps:merge(
#{
status => <<"connected">>,
node_status => [
#{
node => <<"emqx@localhost">>,
status => <<"connected">>
}
]
},
values({post, PostgreSQLType})
);
values({post, PostgreSQLType}) ->
maps:merge(
#{
name => <<"my_pgsql_action">>,
type => PostgreSQLType
},
values({put, PostgreSQLType})
);
values({put, PostgreSQLType}) ->
maps:merge(
#{
enable => true,
connector => <<"my_pgsql_connector">>,
resource_opts => #{
health_check_interval => "32s"
}
},
values({producer, PostgreSQLType})
);
values({producer, _PostgreSQLType}) ->
#{
<<"enable">> => true,
<<"connector">> => <<"connector_pgsql_test">>,
<<"parameters">> => #{
<<"sql">> =>
<<"INSERT INTO client_events(clientid, event, created_at) VALUES (\n ${clientid},\n ${event},\n TO_TIMESTAMP((${timestamp} :: bigint))\n)">>
},
<<"resource_opts">> => #{
<<"batch_size">> => 1,
<<"batch_time">> => <<"0ms">>,
<<"health_check_interval">> => <<"15s">>,
<<"inflight_window">> => 100,
<<"max_buffer_bytes">> => <<"256MB">>,
<<"query_mode">> => <<"async">>,
<<"request_ttl">> => <<"45s">>,
<<"start_after_created">> => true,
<<"start_timeout">> => <<"5s">>,
<<"worker_pool_size">> => 16
}
}.
values_conn_bridge_examples(_Method, Type) ->
#{
enable => true,
type => Type,
name => <<"foo">>,
server => <<"127.0.0.1:5432">>,
database => <<"mqtt">>,
pool_size => 8,
username => <<"root">>,
password => <<"******">>,
sql => default_sql(),
local_topic => <<"local/topic/#">>,
resource_opts => #{
worker_pool_size => 8,
health_check_interval => ?HEALTHCHECK_INTERVAL_RAW,
batch_size => ?DEFAULT_BATCH_SIZE,
batch_time => ?DEFAULT_BATCH_TIME,
query_mode => async,
max_buffer_bytes => ?DEFAULT_BUFFER_BYTES
}
}.

View File

@ -28,7 +28,7 @@ conn_bridge_examples(Method) ->
#{ #{
<<"timescale">> => #{ <<"timescale">> => #{
summary => <<"Timescale Bridge">>, summary => <<"Timescale Bridge">>,
value => emqx_bridge_pgsql_schema:values_conn_bridge_examples(Method, timescale) value => emqx_bridge_pgsql:values_conn_bridge_examples(Method, timescale)
} }
} }
]. ].
@ -42,28 +42,28 @@ roots() -> [].
fields("post") -> fields("post") ->
emqx_bridge_pgsql:fields("post", timescale); emqx_bridge_pgsql:fields("post", timescale);
fields("config_connector") -> fields("config_connector") ->
emqx_bridge_pgsql_schema:fields("config_connector"); emqx_bridge_pgsql:fields("config_connector");
fields(action) -> fields(action) ->
{timescale, {timescale,
hoconsc:mk( hoconsc:mk(
hoconsc:map(name, hoconsc:ref(emqx_bridge_pgsql_schema, pgsql_action)), hoconsc:map(name, hoconsc:ref(emqx_bridge_pgsql, pgsql_action)),
#{ #{
desc => <<"Timescale Action Config">>, desc => <<"Timescale Action Config">>,
required => false required => false
} }
)}; )};
fields("put_bridge_v2") -> fields("put_bridge_v2") ->
emqx_bridge_pgsql_schema:fields(pgsql_action); emqx_bridge_pgsql:fields(pgsql_action);
fields("get_bridge_v2") -> fields("get_bridge_v2") ->
emqx_bridge_pgsql_schema:fields(pgsql_action); emqx_bridge_pgsql:fields(pgsql_action);
fields("post_bridge_v2") -> fields("post_bridge_v2") ->
emqx_bridge_pgsql_schema:fields(pgsql_action); emqx_bridge_pgsql:fields(pgsql_action);
fields("put_connector") -> fields("put_connector") ->
emqx_bridge_pgsql_schema:fields("config_connector"); emqx_bridge_pgsql:fields("config_connector");
fields("get_connector") -> fields("get_connector") ->
emqx_bridge_pgsql_schema:fields("config_connector"); emqx_bridge_pgsql:fields("config_connector");
fields("post_connector") -> fields("post_connector") ->
emqx_bridge_pgsql_schema:fields("config_connector"); emqx_bridge_pgsql:fields("config_connector");
fields(Method) -> fields(Method) ->
emqx_bridge_pgsql:fields(Method). emqx_bridge_pgsql:fields(Method).
@ -87,7 +87,7 @@ bridge_v2_examples(Method) ->
#{ #{
<<"timescale">> => #{ <<"timescale">> => #{
summary => <<"Timescale Action">>, summary => <<"Timescale Action">>,
value => emqx_bridge_pgsql_schema:values({Method, timescale}) value => emqx_bridge_pgsql:values({Method, timescale})
} }
} }
]. ].

View File

@ -47,7 +47,7 @@ fields(config) ->
fields(action) -> fields(action) ->
{pgsql, {pgsql,
hoconsc:mk( hoconsc:mk(
hoconsc:map(name, hoconsc:ref(emqx_bridge_pgsql_schema, pgsql_action)), hoconsc:map(name, hoconsc:ref(emqx_bridge_pgsql, pgsql_action)),
#{ #{
desc => <<"PostgreSQL Action Config">>, desc => <<"PostgreSQL Action Config">>,
required => false required => false