Advance PG15 branch to Apache AGE version 1.6.0 (#2196) (#2235)

Updated the following files to advance the Apache AGE version
to 1.6.0

       modified:   Makefile
       modified:   README.md
       modified:   RELEASE
       modified:   age.control
       modified:   docker/Dockerfile
       renamed:    age--1.5.0--y.y.y.sql -> age--1.5.0--1.6.0.sql
       modified:   age--1.5.0--y.y.y.sql
       new file:    age--1.6.0--y.y.y.sql

Resolved conflicts:
       RELEASE
       docker/Dockerfile

Author: jrgemignani

Makefile

@@ -17,7 +17,7 @@
 
 MODULE_big = age
 
-age_sql = age--1.5.0.sql
+age_sql = age--1.6.0.sql
 
 OBJS = src/backend/age.o \
        src/backend/catalog/ag_catalog.o \

README.md

@@ -30,7 +30,7 @@
   </a>
   &nbsp;
   <a href="https://github.com/apache/age/releases">
-    <img src="https://img.shields.io/badge/Release-v1.5.0-FFA500?labelColor=gray&style=flat&link=https://github.com/apache/age/releases"/>
+    <img src="https://img.shields.io/badge/Release-v1.6.0-FFA500?labelColor=gray&style=flat&link=https://github.com/apache/age/releases"/>
   </a>
   &nbsp;
   <a href="https://www.postgresql.org/docs/15/index.html">
@@ -131,7 +131,7 @@ Apache AGE is intended to be simple to install and run. It can be installed with
 &nbsp;Install PostgreSQL
 </h4>
 
-You will need to install an AGE compatible version of Postgres<a>, for now AGE supports Postgres 11, 12, 13, 14 & 15. Supporting the latest versions is on AGE roadmap.
+You will need to install an AGE compatible version of Postgres<a>, for now AGE supports Postgres 13, 14, 15, 16, & 17. Supporting the latest versions is on AGE roadmap.
 
 <h4>
 &nbsp;Installation via Package Manager
@@ -158,7 +158,7 @@ You can <a href="https://www.postgresql.org/ftp/source/"> download the Postgres
 
 Clone the <a href="https://github.com/apache/age">github repository</a> or download the <a href="https://github.com/apache/age/releases">download an official release.
 </a>
-Run the pg_config utility and check the version of PostgreSQL. Currently, only PostgreSQL versions 11, 12, 13, 14 & 15 are supported. If you have any other version of Postgres, you will need to install PostgreSQL version 11, 12, 13, 14, or 15.
+Run the pg_config utility and check the version of PostgreSQL. Currently, only PostgreSQL versions 13, 14, 15, 16, & 17 are supported. If you have any other version of Postgres, you will need to install PostgreSQL version 13, 14, 15, 16, or 17.
 <br>
 
 ```bash

RELEASE

@@ -15,69 +15,91 @@
 # specific language governing permissions and limitations
 # under the License.
 
-Release Notes for Apache AGE release 1.5.0 for PostgreSQL version 15
+Release Notes for Apache AGE release 1.6.0 for PostgreSQL version 15
 
-Apache AGE 1.5.0 - Release Notes
+Apache AGE 1.6.0 - Release Notes
 
-NOTE: Due to the complexity and the amount of additions, there are no
-      upgrade scripts to this release.
-
-NOTE: Some of these reference the master branch PR that was
-      either applied to lower versions via a separate PR or
-      merged into a newly created branch.
-
-Add additional index support and performance enhancements (#1232)
-Add an additional way to find a previous variable ref (#1450)
-Add auto apply labeler workflow for PRs (#1161)
-Add checks for array functions to recognize and decode VPC (#1064)
-Add concat || operator to agtype (#1198)
-Add exist(?, ?|, ?&) operators for agtype (#1218)
-Add missing dependency in cypher_expr.c (#1256)
-Add path extraction(#>, #>>)operators to agtype (#1224)
-Add support for chained expressions in CASE (#1431)
-Clean up agtype_to_int8, agtype_to_int4, & agtype_to_int2 (#1354)
-Clean up #included files in parser directory (#1465)
-Converted SQL main file into multiple files. (#1401)
-docs: Add to Docker setup (#1204)
-Extend access(->, ->>), addition and subtraction operators (#1258)
-Extend agtype containment operators (@>, <@) (#1285)
-Extend EXPLAIN and add config param to switch transformation of property filter (#1262)
-Fix ambiguous conditions (#1373)
-Fix Docker file to reflect PostgreSQL version 15 (#1449)
-Fix DockerHub warning messages for latest (#1380)
-Fix issue #1045 - error using path var in WHERE (#1295)
-Fix Issue #1159 - Server terminates for SET plus-equal (#1160)
-Fix issue #1219 - MERGE not seeing previous clause var (#1441)
-Fix issue #1302 - crash on NULL input to UNWIND (#1304)
-Fix issue #1303 - Server crashes on executing SELECT * FROM agtype(null); (#1317)
-Fix Issue #1305 - drop_label NULL cases (#1306)
-Fix Issue #1329 - agtype_to_int4 crash (#1339)
-Fix issue #1347 - unknow type of agtype container 0 (#1349)
-Fix issue #1389 - Server crash on using null operand for access operators (#1390)
-Fix issue #1393 - previous clause variables not seen with EXISTS (#1426)
-Fix issue #1398 - SET followed by DELETE does not delete (#1412)
-Fix issue #1399 - EXISTS doesn't handle non-existent labels (#1400)
-Fix Issue #945 - incorrect count(*) return values (#1288)
-Fix typo in agtype_raw.h header guard (#1368)
-Implement chained expression order of operations (#1402)
-Implemented age_tail function (#1283)
-Implemented the toBooleanList() function (#1014)
-Implement EXISTS subquery for CASE (#1345)
-Master to PostgreSQL version 16 (#1451)
-Minor fix in `agtype_volatile_wrapper` function (#1172)
-Modify COUNT() to output agtype (#1311)
-Optimize performance of detach delete (#1271)
-Optimize vertex and edge builder functions (#1252)
-py_driver : optimised Antlr4ResultHandler to improve time (#1107)
-Refactor Regression Tests for CASE statement (#1268)
-Refactor the IN operator to use '= ANY()' syntax (#1236)
-Removed unnecessary assignment (#1185)
-Remove redundant job from CIs (#1473)
-Remove unnecessary #include in src/backend/utils
-Updated age.control.
-Updated files, format, and version information.
-Updated Makefile.
-Updated RELEASE.
-Update Discord channel in README.md (#1253)
-Update README.md file for PostgreSQL version 16 support (#1463)
-Update the Python Driver (#1246)
+     Fix issue 2205: left doesn't catch overflow (#2207)
+     Fix issue 2201: unexpected empty string behavior (#2203)
+     Add support for operators in cypher query (#2172)
+     Reimplement list comprehension (#2169)
+     Update labeler.yml (#2186)
+     Fix issue with the CI build and labeler (#2183)
+     Fix CSV import for edge with one property (#2175)
+     Remove stale bot and update .asf.yaml settings (#2171)
+     Prevent object access hook from accesing not installed namespace (#2161)
+     Fix CI build errors caused by missing dependencies (#2163)
+     Add support for external extensions (#2088)
+     Fix issue 2093: pfree() called with a NULL pointer (#2095)
+     Fix issue 1955 - List comprehension in WHERE clause (#2094)
+     Add support for fuzzystrmatch and other external extensions (#2083)
+     Fix memory leaks in functions part 1 (#2066)
+     Issue 1996 - Add agtype to json typecast (#2075)
+     Fix issue 2046: Memory leak during btree(agtype) (#2060)
+     Refactor Dockerfile to use multi-stage builds (#2004)
+     Revamp age csv loader (#2044)
+     Fix issue 2020: Memory leak (#2028)
+     Fix Issue 1907: SET on MERGE not storing edge properties (#2019)
+     Add EmitWarningsOnPlaceholders("age") (#1997)
+     Fix Issue 1988: How to update a property which is a keyword (#2005)
+     Fix obsolete docker-compose command in CIs (#2007)
+     Fix issue 1986: Failure creating label name close to MAX_LABEL_NAME_LEN (#1989)
+     Fix issue 1953 - PG Boolean used as AGTYPE object (#1959)
+     Add graph_exists function (#1958)
+     Fix issue 1956 - null key name passed. (#1957)
+     docs: add link to .NET open-source driver (#1938)
+     Add the `load_from_plugins` parameter in the Python driver to load AGE from the $libdir/plugins directory (#1935)
+     Fix issue 1910: Server crashes when using exists(vle path) (#1924)
+     Converted single line comments to multiline (#1908)
+     Add function is_valid_label_name (#1911) (#1912)
+     Fixes small typos in the python driver's README.md file (#1909)
+     Fix agtype_build_map to allow more than 50 pairs (#1901)
+     Agtype hash cmp (#1893)
+     Order some regression tests for stability on big-endian (#1892)
+     Update github stale action (#1891)
+     Make CALL YIELD grammar more precise (#1852)
+     Fix issue 1878 - Regression test failure with delete global graphs (#1881)
+     Corrected typos and grammatical errors in apache-age-basic.ipynb (#879)
+     Add workflow for stale issues and PRs (#1872)
+     Implement Returnless Unions in Subqueries (#1803)
+     [CI] Update docker image tags (#1865)
+     Add branch protection rules in .asf.yaml (#1854)
+     [CI] Update labeler github action (#1851)
+     Fix error using list comprehension with WITH * (#1838)
+     python driver psycopg3 (#1793)
+     Minor VLE and agtype_eq/ne performance updates (#1808)
+     Fix issue 1767: CREATE TABLE AS SELECT * FROM cypher, errors (#1799)
+     Implement Constraints on Subqueries (#1751)
+     Fix connection string in Python Driver (#1757)
+     Added integer conversion in toBoolean functions (#1199)
+     Update README.md (#1756)
+     Add the command graph_stats and improve VLE messaging for load (#1750)
+     Add helpful messages to the VLE subsystem (#1742)
+     Update README.md (#1728)
+     Added Networkx Support in python driver (#1716)
+     Remove duplicate check (#1740)
+     Fix Issue 1709 - MERGE creates incomplete vertices after the first one (#1721)
+     Fix shift/reduce conflict in grammar (#1719)
+     Fix Issue 1691 - MERGE incorrectly creates multiple vertices (#1718)
+     Implement map projection (#1710)
+     Add hooks for multi-arch builds on dockerhub (#1683)
+     Sample code for AGE-JDBC driver (#390)
+     Allow agtype_build_map to use AGTYPE keys (#1666)
+     Implement EXISTS Subquery      (#1562)
+     Fix Issue 1634: Setting all properties with map object causes error (#1637)
+     Fix Issue 1630: MERGE using array not working in some cases (#1636)
+     Implement list comprehension (#1610)
+     Update Go installation and add in parser files (#1582)
+     Add optional parameter '=' in property constraints (#1516)
+     Fix unsorted output of some queries in the cypher_match test (#1507)
+     Update age_load to make property value conversion optional (#1525)
+     Update the Go driver documentation, Linux installer, and CI (#1527)
+     Fix json serialization error in Python Driver (#1228)
+     Add template for upgrading between versions of Apache AGE (#1506)
+     Update age_load to load scalar property values with appropriate type (#1519)
+     Fix apache#1513 - Invalid variable reuse in CREATE and MERGE clause (#1515)
+     Clean up #included files in src/include directories (#1518)
+     Bump gopkg.in/yaml.v3 in /drivers/golang (#1202)
+     Clean up #included files in catalog & commands directories (#1514)
+     Clean up #included files in nodes, executor, & optimizer directories (#1509)
+     Correct cleanup of age--x.x.x.sql files (#1505)

age--1.5.0--y.y.y.sql age--1.5.0--1.6.0.sqlage--1.5.0--y.y.y.sql renamed to age--1.5.0--1.6.0.sql

@@ -17,16 +17,23 @@
  * under the License.
  */
 
--- This is a template for upgrading from the previous version of Apache AGE
--- It will only work within versions of PostgreSQL, not across.
--- Please adjust the below ALTER EXTENSION to reflect the correct version
--- it is upgrading to.
+--- This will only work within a major version of PostgreSQL, not across
+--- major versions.
+
+--
+-- WARNING!
+--
+-- Since there are modifications to agtype gin operators, users who are
+-- upgrading will have to drop the gin indexes before running this script and
+-- recreate them afterwards.
+--
+-- As always, please backup your database prior to any upgrade.
+--
+-- WARNING!
+--
 
 -- complain if script is sourced in psql, rather than via CREATE EXTENSION
-\echo Use "ALTER EXTENSION age UPDATE TO '1.4.0'" to load this file. \quit
-
--- Please add all additions, deletions, and modifications to the end of this
--- file. We need to keep the order of these changes.
+\echo Use "ALTER EXTENSION age UPDATE TO '1.6.0'" to load this file. \quit
 
 DROP FUNCTION IF EXISTS ag_catalog.load_labels_from_file(name, name, text, bool);
 CREATE FUNCTION ag_catalog.load_labels_from_file(graph_name name,
@@ -83,7 +90,7 @@ CREATE OPERATOR <<@ (
 
 /*
  * We have to drop and recreate the operators, because
- * commutator is not modifiable using ALTER OPERATOR. 
+ * commutator is not modifiable using ALTER OPERATOR.
  */
 ALTER EXTENSION age
     DROP OPERATOR ? (agtype, agtype);

age--1.6.0--y.y.y.sql

@@ -0,0 +1,33 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+--* This is a TEMPLATE for upgrading from the previous version of Apache AGE
+--* Please adjust the below ALTER EXTENSION to reflect the -- correct version it
+--* is upgrading to.
+
+-- This will only work within a major version of PostgreSQL, not across
+-- major versions.
+
+-- complain if script is sourced in psql, rather than via CREATE EXTENSION
+\echo Use "ALTER EXTENSION age UPDATE TO '1.X.0'" to load this file. \quit
+
+--* Please add all additions, deletions, and modifications to the end of this
+--* file. We need to keep the order of these changes.
+--* REMOVE ALL LINES ABOVE, and this one, that start with --*
+

age.control

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
-default_version = '1.5.0'
+default_version = '1.6.0'
 comment = 'AGE database extension'
 module_pathname = '$libdir/age'
 

docker/Dockerfile

@@ -49,7 +49,7 @@ ENV LC_COLLATE=en_US.UTF-8
 ENV LC_CTYPE=en_US.UTF-8
 
 COPY --from=build /usr/lib/postgresql/15/lib/age.so /usr/lib/postgresql/15/lib/
-COPY --from=build /usr/share/postgresql/15/extension/age--1.5.0.sql /usr/share/postgresql/15/extension/
+COPY --from=build /usr/share/postgresql/15/extension/age--1.6.0.sql /usr/share/postgresql/15/extension/
 COPY --from=build /usr/share/postgresql/15/extension/age.control /usr/share/postgresql/15/extension/
 COPY docker/docker-entrypoint-initdb.d/00-create-extension-age.sql /docker-entrypoint-initdb.d/00-create-extension-age.sql