message-db 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a5cb7492519fb76355201fb499ef7133d1e097af688752f4cff51505bc51e05
-  data.tar.gz: 744a8c922d0e2aeb41f5312003c7f905207308dbc771c1d40b4f7ff35dfa8117
+  metadata.gz: 49621caad583b64239cbd8f169e5e4ce4542e8c3fb34e919feb29f2ea7e0b482
+  data.tar.gz: 6b18052ddcb2099b3deeaf0be0594fbc15c452b6a5e4db2f9ac86431cddc8742
 SHA512:
-  metadata.gz: '044912f18717a75c4276231773bbcd17d5ffe6ce82c571ee96e2f0affab918cc4e026919f10b8155f7efe94f8bd198e7efe72d06599f076b8cf5fc8bb18600ad'
-  data.tar.gz: fb2724e33cdf5d203b3f097fdb955fb909fc1e87ea6930a778c84e5b7ee579eebf1df83c9eb83d4c9cdb4a9e860e28b65c7df051b80252bd2b5b349efe6479b3
+  metadata.gz: 9d35a1ab074508046fa3c5c664687ddcc6b27e223841902175b2ddc9b5bd764926d9c016234448fd56edb1e839d066ea53fa8c50804b1c4d0ac09de44c9b8dc3
+  data.tar.gz: efc1c0ece0763d8939e5459ab733b54fe132a9a90d55ce2fc587345f8729c6ced5067913cba3abe8d474fd8e0d95e5aab82df756eed2eca01d65a5bbd82bfebb

data/database/VERSION.txt

@@ -1 +1 @@
-1.1.4
+1.1.5

data/database/functions/message-store-version.sql

@@ -2,7 +2,7 @@ CREATE OR REPLACE FUNCTION message_store.message_store_version()
 RETURNS varchar
 AS $$
 BEGIN
-  RETURN '1.1.4';
+  RETURN '1.1.5';
 END;
 $$ LANGUAGE plpgsql
 VOLATILE;

data/database/update/1.0.0.md

@@ -0,0 +1,26 @@
+# 1.0.0 Update
+
+Note: Formerly, `postgres-message-store`.
+
+The following changes are made by the 1.0.0.sh update script:
+
+- **Note: There are no changes to the `messages` table, and no data migration is necessary**
+- The executables named `evt-pg-*` are renamed to `mdb-*`
+- **[breaking change]** The `get_category_messages` server function supports pub/sub directly by receiving a `correlation` argument and composing the correlation metadata query condition directly in the server function ([http://docs.eventide-project.org/user-guide/message-store/server-functions.html#get-messages-from-a-stream](http://docs.eventide-project.org/user-guide/message-store/server-functions.html#get-messages-from-a-stream))
+- **[breaking change]** The message_store database and its objects are contained in a Postgres schema named `message_store`
+- **[breaking change]** The `get_category_messages` server function supports consumer groups via the `consumer_group_member` and `consumer_group_size` parameters ([http://docs.eventide-project.org/user-guide/message-store/server-functions.html#get-messages-from-a-category](http://docs.eventide-project.org/user-guide/message-store/server-functions.html#get-messages-from-a-category))
+- The retrieval server functions provide debugging output that is activated via the Postgres setting, `message_store.debug_get` ([http://docs.eventide-project.org/user-guide/message-store/server-functions.html#debugging-output](http://docs.eventide-project.org/user-guide/message-store/server-functions.html#debugging-output))
+- The write server function provides debugging output that is activated via the Postgres setting, `message_store.debug_write` ([http://docs.eventide-project.org/user-guide/message-store/server-functions.html#debugging-output](http://docs.eventide-project.org/user-guide/message-store/server-functions.html#debugging-output))
+- The `message_store.debug` Postgres setting activates both the retrieval and write debug output ([http://docs.eventide-project.org/user-guide/message-store/server-functions.html#debugging-output](http://docs.eventide-project.org/user-guide/message-store/server-functions.html#debugging-output))
+- `id` stream parsing function ([http://docs.eventide-project.org/user-guide/message-store/server-functions.html#get-the-id-from-a-stream-name](http://docs.eventide-project.org/user-guide/message-store/server-functions.html#get-the-id-from-a-stream-name))
+- `cardinal_id` stream parsing function ([http://docs.eventide-project.org/user-guide/message-store/server-functions.html#get-the-cardinal-id-from-a-stream-name](http://docs.eventide-project.org/user-guide/message-store/server-functions.html#get-the-cardinal-id-from-a-stream-name))
+- `acquire_lock` function encapsulates the application of the advisory lock used by the `write_message` function ([http://docs.eventide-project.org/user-guide/message-store/server-functions.html#get-message-store-database-schema-version](http://docs.eventide-project.org/user-guide/message-store/server-functions.html#get-message-store-database-schema-version))
+- Database management tool output is clarified
+- **[breaking change]** All server function parameter names are no longer named with underscore prefixes ([http://docs.eventide-project.org/user-guide/message-store/server-functions.html](http://docs.eventide-project.org/user-guide/message-store/server-functions.html))
+- Indexes are no longer built with the `CONCURRENTLY` option ([http://docs.eventide-project.org/user-guide/message-store/anatomy.html#source-code](http://docs.eventide-project.org/user-guide/message-store/anatomy.html#source-code))
+- **[breaking change]** The `messages_category_global_position_idx` is removed and replaced with the `messages_category` index, which now indexes correlation metadata
+- **[breaking change]** The `messages_stream_name_position_uniq_idx` is removed and replaced with the `messages_stream` index, which now indexes correlation metadata
+- **[breaking change]** The `messages_id_uniq_idx` is removed and replaced with the `messages_id` index
+- Message DB RubyGem: [https://github.com/message-db/ruby-gem](https://github.com/message-db/ruby-gem)
+- Message DB NPM Module: [https://github.com/message-db/npm-module](https://github.com/message-db/npm-module)
+- Improvements to interactive tests ([https://github.com/eventide-project/postgres-message-store/tree/master/test](https://github.com/eventide-project/postgres-message-store/tree/master/test))

data/database/update/1.0.0.sh

@@ -11,6 +11,9 @@ echo "WARNING:"
 echo "This script updates a pre-v1 message_store database to Message DB v1.x"
 echo "Do not run this script on a Message DB v1 database"
 echo
+echo "Fore more information about the changes made to the message store by"
+echo "this update, see: https://github.com/message-db/message-db/blob/master/database/update/1.0.0.md"
+echo
 echo "- Press CTRL+C to stop this script from running"
 echo "- Press RETURN to allow the script to proceed"
 echo

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: message-db
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - The Eventide Project
@@ -79,6 +79,7 @@ files:
 - database/types/message.sql
 - database/uninstall.sh
 - database/update.sh
+- database/update/1.0.0.md
 - database/update/1.0.0.sh
 - database/views/category-type-summary.sql
 - database/views/stream-summary.sql