Skip to content

Latest commit

 

History

History
458 lines (330 loc) · 20.2 KB

CHANGELOG.md

File metadata and controls

458 lines (330 loc) · 20.2 KB
Raw

Changelog

Unreleased

  • Update to libpg_query 13-2.0.6
    • Update to Postgres 13.3 patch release
    • Normalize: Don't touch "GROUP BY 1" and "ORDER BY 1" expressions, keep original text
    • Fingerprint: Cache list item hashes to fingerprint complex queries faster
    • Deparser: Emit the RangeVar catalogname if present
    • Fix crash in pg_scan function when encountering backslash escapes
  • Support extracting functions from a parsed query (#147)
    • Adds new functions, ddl_functions and call_functions methods
    • Note that functions are identified by their name only, not their full type definition, since raw query parsetrees don't contain sufficient data to identify the types of arguments when functions are called
  • Relax google-protobuf dependency (#213)
  • Update google-protobuf to 3.17.1 (#212)
    • google-protobuf 3.15.x has a bug that causes a seg fault in Ruby under certain conditions (protocolbuffers/protobuf#8639). Use google-protobuf 3.17.1 instead.
  • Use Protobuf definition for determining JSON field names
    • Note you may see a breaking change if you were using PgQuery::ParseResult.encode_json to map the protobuf result to JSON, since this now respects the intended JSON names from the Proto3 definition (instead of the differently formatted Protobuf field names)

2.0.3 2021-04-05

  • Update to libpg_query 13-2.0.4
    • Normalize: Fix handling of two subsequent DefElem elements (avoids crash)
    • Deparser: Fix crash in CopyStmt with HEADER or FREEZE inside WITH parens

2.0.2 2021-03-31

  • COALESCE arguments are now included in #filter_columns
  • Improve error message for protobuf parse failures
  • Extconf: Fix object path regexp
    • This accidentally replaced .c in the wrong parts of the path in some cases, causing build failures
  • Update to libpg_query 13-2.0.2
    • Fix ARM builds: Avoid dependency on cpuid.h header
    • Simplify deparser of TableLikeClause
    • Fix asprintf warnings by ensuring _GNU_SOURCE is set early enough

2.0.1 2021-03-18

  • Fix gemspec to correctly reference include files
    • This would have shown as a build failure when using the published 2.0.0 gem

2.0.0 2021-03-18

  • Update to PostgreSQL 13 parser
  • Update to libpg_query v2, and new Protobuf-based format
    • WARNING: This is a breaking change if you are directly interacting with the parsetree (helpers like table and such still work the same way)
  • Use actual Ruby classes for parser result, instead of decoded JSON
    • This is essentialy to enable easy and fast two-way communication with the C library, and as a bonus makes for a better interaction on the Ruby side, as we are handling actual objects instead of hashes and arrays.
  • Use new deparser maintained directly in libpg_query
    • This replaces the complete Ruby deparser with a new, more complete deparser that is directly maintained in libpg_query. Further deparser improvements should be directly contributed to libpg_query
  • Tables helper: Return more details through #tables_with_details method
    • This is renamed from the previously badly named #tables_with_types method. Note that this change should not affect the output of the primary tables helper.
  • Replace on-demand libpg_query source download with bundled source code
    • Its unnecessary to download the source on-demand, and makes this more complex than it needs to be. Instead, introduce a new "update_source" rake task that can be called to refresh the source for a specified revision.
  • Re-implement smart truncation without requiring a special node type
    • This ensures the #truncate method works with the new deparser, without the C level code needing to know about it. We may add it in the C library in the future for edge cases that can't be covered by this slightly hack-ish approach, but for now this avoids unnecessary C library deparser modifications with non-standard node types.
  • Update Ruby fingerprinting to new fingerprint format and XXH3 hash
    • Note that its recommended to use PgQuery.fingerprint for performance reasons, but when the tree has been modified, it can be convenient to run a Ruby-side fingerprint instead of the C-based one that is faster.

1.3.0 2020-12-28

  • Incorporate newer libpg_query updates in 10-1.0.3 and 10-1.0.4
    • Adds support for running on ARM
    • Fixes an asprintf warning during builds
    • Updates to newer Postgres 10 patch release (10.15)
  • Deparsing improvements by @emin100
    • Add support for additional DROP statements (#147)
    • Fix CREATE TABLE AS - Support without TEMP, Add ON COMMIT (#149)
    • Empty target list support (#156)
    • UNION parentheses (#158)
    • OVERLAY keyword function (#161)
    • Array indirection (#162)
    • ARRAY functions (#163)
    • Correctly handle column names that need escaping in INSERT and UPDATE statements (#164)
    • INSERT INTO ON CONFLICT (#166)
    • LATERAL JOIN (#168)
    • UPDATE FROM clause (#170)
    • SELECT aggregate FILTER (#175)
    • INTERSECT operator (#176)
  • Deparsing: Improve handling of boolean type casts @himanshu-pro & @emin100
  • tables method: Find tables in the subquery of CREATE TABLE AS (#172) @Tassosb
  • Support Ruby 3.0, verify SHA256 checksum of downloaded libpg_query (#178) @stanhu
    • Verify SHA256 checksum to guard against any malicious attempts to change the archive
    • Use URI.open to fix Ruby 3.0 support

1.2.0 2019-11-10

  • Reduce escaped keywords to Postgres-specific keywords, and ignore unreserved keywords
    • This matches the behaviour of Postgres' quote_identifier function, and avoids problems when doing text comparisons with output involving that function
    • Note that this will lead to different output than in earlier pg_query versions, in some cases

1.1.1 2019-11-10

  • Deparsing improvements by @emin100
    • Deparse ILIKE, COLLATE and DISCARD (#133)
    • CREATE CAST (#136)
    • CREATE SCHEMA (#136)
    • UNION, UNION ALL and EXCEPT in SELECT queries (#136)
    • CREATE DOMAIN (#145)
    • Subquery indirection (#157)
    • Fix Type Cast Parentheses Problem (#152)
    • SELECT INTO (#151)
    • SET DEFAULT in INSERT INTO (#154)
    • REVOKE (#155)
    • PREPARE and EXECUTE (#148)
    • INSERT INTO ... RETURNING (#153)
    • Fix Alter .. RENAME SQL (#146)
  • Deparsing improvements by @herwinw
    • Fix subquery in COPY in deparse (#112)
    • Function call indirection (#116)
    • Function without parameters (#117)
    • CREATE AGGREGATE
    • CREATE OPERATOR
    • CREATE TYPE
    • GRANT statements
    • DROP SCHEMA
  • Deparsing improvements by @akiellor
    • Named window functions (#150)
  • Deparsing improvements by @himanshu
    • Arguments in custom types (#143)
    • Use "double precision" instead of "double" type name (#139)
  • Use explicit -z flag to support OpenBSD tar (#134) @sirn
  • Add Ruby 2.6 to Travis tests
  • Escape identifiers in more cases, if necessary

1.1.0 2018-10-04

1.0.2 2018-04-11

1.0.1 2018-02-02

1.0.0 2017-10-31

  • IMPORTANT: Major version bump to indicate backwards incompatible parse tree change!
  • Update to Postgres 10 parser and fingerprint version 2
    • This is a backwards-incompatible change in parser output format, although it should be relatively easy to update most programs. This can't be avoided since Postgres does not guarantee parse trees stay the same across versions

0.13.5 2017-10-26

  • Update to libpg_query 9.5-1.7.1
    • Allow "$1 FROM $2" to be parsed (new with pg_stat_statements in Postgres 10)

0.13.4 2017-10-20

  • Update to libpg_query 9.5-1.7.0
    • Fixes compilation old gcc before 4.6.0 #73

0.13.3 2017-09-04

  • Fix table detection for SELECTs that have sub-SELECTs without FROM clause #69

0.13.2 2017-08-10

  • Support table detection in sub-SELECTs in JOINs #68 @seanmdick
  • Legacy ".parsetree" helper: Fix "Between" and "In" operator does not have "AEXPR" #66
    • For new applications please use ".tree" method which uses the native structure returned from libpg_query which resembles Postgres node names more closely

0.13.1 2017-08-03

  • Fix regression in 0.13.1 that broke ".tables" logic for COPY statements that don't have a target table (i.e. are reading out data vs copying in)

0.13.0 2017-07-30

  • Introduce split between SELECT/DML/DDL for tables method #65 @chrisfrommann
    • Backwards compatible, use the new select_tables/dml_tables/ddl_tables to access the categorized table references
  • Update libpg_query to 9.5-1.6.2
    • Update to Fingerprinting Version 1.3
      • Attributes to be ignored:
        • RangeVar.relname (if node also has RangeVar.relpersistence = "t")
      • Special cases: List nodes where parent field name is valuesLists
        • Follow same logic described for fromClause/targetList/cols/rexpr

0.12.1 2017-07-29

  • Update libpg_query to 9.5-1.6.1
    • Update to Fingerprinting Version 1.2
      • Ignore portalname in DeclareCursorStmt, FetchStmt and ClosePortalStmt

0.12.0 2017-07-29

  • Update libpg_query to 9.5-1.6.0
    • BREAKING CHANGE in PgQuery.normalize(..) output
    • This matches the change in the upcoming Postgres 10, and makes it easier to migrate applications to the new normalization format using $1..$N instead of ?

0.11.5 2017-07-09

0.11.4 2017-01-18

0.11.3 2016-12-06

  • Update to newest libpg_query version (9.5-1.4.2)
    • Cut off fingerprints at 100 nodes deep to avoid excessive runtimes/memory
    • Fix warning on Linux due to missing asprintf include
  • Improved deparsing @jcsjcs
    • Float #54
    • BETWEEN #55
    • NULLIF #56
    • SELECT NULL and BooleanTest #57
  • Fix build on BSD systems #58 @myfreeweb

0.11.2 2016-06-27

  • Update to newest libpg_query version (9.5-1.4.1)
    • This release makes sure we work correctly in threaded environments

0.11.1 2016-06-26

  • Updated fingerprinting logic to version 1.1
    • Fixes an issue with UpdateStmt target lists being ignored
  • Update to newest libpg_query version (9.5-1.4.0)

0.11.0 2016-06-22

  • Improved table name analysis (#tables method)
    • Don't include CTE names, make them accessible as #cte_names instead #52
    • Include table names in target list sub selects #38
    • Add support for ORDER/GROUP BY, HAVING, and booleans in WHERE #53 @jcoleman
    • Fix parsing of DROP TYPE statements

0.10.0 2016-05-31

  • Based on PostgreSQL 9.5.3
  • Use LLVM extracted parser for significantly improved build times (via libpg_query)
  • Deparsing Improvements

0.9.2 2016-05-03

  • Fix issue with A_CONST string values in .parsetree compatibility layer (Fixes #47)

0.9.1 2016-04-20

  • Add support for Ruby 1.9 (Fixes #44)

0.9.0 2016-04-17

  • Based on PostgreSQL 9.5.2
  • NOTE: Output format for the parse tree has changed (backwards incompatible!), it is recommended you extensively test any direct reading/modification of the tree data in your own code
    • You can use the .parsetree translator method to ease the transition, note however that there are still a few incompatible changes
  • New .fingerprint method (backwards incompatible as well), see https://github.com/lfittl/libpg_query/wiki/Fingerprinting
  • Removes PostgreSQL source and tarball after build process has finished, to reduce diskspace requirements of the installed gem

0.8.0 2016-03-06

  • Use fixed git version for libpg_query (PostgreSQL 9.4 based)
  • NOTE: 0.8 will be the last series with the initial parse tree format, 0.9 will introduce a newer, more stable, but backwards incompatible parse tree format

0.7.2 2015-12-20

0.7.1 2015-11-17

  • Abstracted parser access into libpg_query #24
  • libpg_query
    • Use UTF-8 encoding for parsing #4 @zhm
    • Add type to A_CONST nodes#5 @zhm

0.7.0 2015-10-17

  • Restructure build process to use upstream tarballs #35
    • Avoid bison/flex dependency to make deployment easier #31
  • Solve issues with deployments to Heroku #32
  • Deparsing

0.6.4 2015-10-01

0.6.3 2015-08-20

0.6.2 2015-08-06

  • Speed up gem install by not generating rdoc/ri for the Postgres source

0.6.1 2015-08-06

  • Deparsing: Support WITH clauses in INSERT/UPDATE/DELETE @JackDanger
  • Make sure gemspec includes all necessary files

0.6.0 2015-08-05

  • Deparsing (experimental)
    • Turns parse trees into SQL again
    • New truncate method to smartly truncate based on less important query parts
    • Thanks to @mme & @JackDanger for their contributions
  • Restructure extension C code
  • Add table/filter columns support for CTEs
  • Extract views as tables from CREATE/REFRESH VIEW
  • Refactor code using generic treewalker
  • fingerprint: Normalize IN lists
  • param_refs: Fix length attribute in result

0.5.0 2015-03-26

  • Query fingerprinting
  • Filter columns (aka columns referenced in a query's WHERE clause)
  • Parameter references: Returns all $1/$2/etc like references in the query with their location
  • Remove dependency on active_support

0.4.1 2014-12-18

  • Fix compilation of C extension
  • Fix gemspec

0.4.0 2014-12-18

  • Speed up build time by only building necessary objects
  • PostgreSQL 9.4 parser

See git commit log for previous releases.