From 5b94a71c8e1e9565c8448877eea78735d193f8c5 Mon Sep 17 00:00:00 2001 From: Emanuel Calvo Date: Thu, 10 Mar 2022 17:29:50 +0100 Subject: [PATCH] Bump version tag to BABEL_1_0_0 (#171) This commit contains the necessary updates for the `BABEL_1_0_0` release : Updated tags across documentation and templates. Bumped ANLTR version to 4.9.3 according to PR 66 in babelfish_extensions. Signed-off-by: Emanuel Calvo emanuel@ongres.com --- .github/ISSUE_TEMPLATE/documentation.yml | 2 +- _data/repos.yml | 2 +- _docs/index.md | 13 ++++----- .../compiling-babelfish-from-source.md | 27 ++++++++++--------- 4 files changed, 24 insertions(+), 20 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/documentation.yml b/.github/ISSUE_TEMPLATE/documentation.yml index a36c85fb..55c29af9 100644 --- a/.github/ISSUE_TEMPLATE/documentation.yml +++ b/.github/ISSUE_TEMPLATE/documentation.yml @@ -29,7 +29,7 @@ body: label: Version description: Select the Babelfish documentation version to which the change applies. options: - - BABEL_1_X_DEV (Default) + - BABEL_1_0_0 (Default) required: true - type: textarea id: docs diff --git a/_data/repos.yml b/_data/repos.yml index f45e0045..a9605f6c 100644 --- a/_data/repos.yml +++ b/_data/repos.yml @@ -16,7 +16,7 @@ special_files: - title: Contributing - url: https://github.com/babelfish-for-postgresql/babelfish_extensions/blob/BABEL_1_X_DEV/CONTRIBUTING.md + url: https://github.com/babelfish-for-postgresql/babelfish_extensions/blob/BABEL_1_0_0/CONTRIBUTING.md - shortname: compass diff --git a/_docs/index.md b/_docs/index.md index 6a729ef3..4cf96e6a 100755 --- a/_docs/index.md +++ b/_docs/index.md @@ -27,11 +27,12 @@ Babelfish for PostgreSQL functionality is distributed in five components: Component | Purpose :--- | :--- -[Babelfish PostgreSQL](https://github.com/babelfish-for-postgresql/postgresql_modified_for_babelfish) | A customized PostgreSQL server that provides hooks used to implement Babelfish. -[Babelfish TDS Extension](https://github.com/babelfish-for-postgresql/babelfish_extensions/tree/BABEL_1_X_DEV/contrib/babelfishpg_tds) | An extension that implements a secondary endpoint that speaks the TDS (SQL Server) network protocol. -[Babelfish Language Extension](https://github.com/babelfish-for-postgresql/babelfish_extensions/tree/BABEL_1_X_DEV/contrib/babelfishpg_tsql) | An extension that provides a procedural language compatible with TSQL Uses ANTLR parser. -[Babelfish Money Type](https://github.com/babelfish-for-postgresql/babelfish_extensions/tree/BABEL_1_X_DEV/contrib/babelfishpg_money) | An extension that supports the money type in SQL Server. This is a variation of the opensource fixeddecimal extension. -[Babelfish Common](https://github.com/babelfish-for-postgresql/babelfish_extensions/tree/BABEL_1_X_DEV/contrib/babelfishpg_common) | An extension that supports the various datatypes used in SQL Server. +[Babelfish Patch](https://github.com/babelfish-for-postgresql/postgresql_modified_for_babelfish) | Enables Babelfish hooks for PostgreSQL. +[Babelfish TDS Extension](https://github.com/babelfish-for-postgresql/babelfish_extensions/tree/BABEL_1_0_0/contrib/babelfishpg_tds) | TDS - provides a secondary endpoint that speaks the TDS (SQL Server) network protocol. +[Balbelfish Language Extension](https://github.com/babelfish-for-postgresql/babelfish_extensions/tree/BABEL_1_0_0/contrib/babelfishpg_tsql) | Provides a procedural language compatible with TSQL Uses ANTLR parser. +[Babelfish Money Type](https://github.com/babelfish-for-postgresql/babelfish_extensions/tree/BABEL_1_0_0/contrib/babelfishpg_money) | Supports the money type in Microsoft SQL Server. This is a variation of the opensource fixeddecimal extension. +[Babelfish Common](https://github.com/babelfish-for-postgresql/babelfish_extensions/tree/BABEL_1_0_0/contrib/babelfishpg_common) | Supports the various datatypes in Microsoft SQL Server. + For information about the project components, see the [Software architecture page](https://babelfishpg.org/docs/internals/software-architecture/). @@ -40,4 +41,4 @@ For information about the project components, see the [Software architecture pag [Babelfish](https://babelfishpg.org/) is supported by Amazon Web Services. All components are available under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0.html) and the [PostgreSQL License](https://www.postgresql.org/about/licence/) on [GitHub](https://github.com/babelfish-for-postgresql). -The project welcomes GitHub issues, bug fixes, features, plugins, and documentation patches. To get involved, see [Contributing to Babelfish](https://github.com/babelfish-for-postgresql/babelfish_extensions/blob/BABEL_1_X_DEV/CONTRIBUTING.md) on the Babelfish for PostgreSQL website. \ No newline at end of file +The project welcomes GitHub issues, bug fixes, features, plugins, documentation---anything at all. To get involved, see [Contributing](https://github.com/babelfish-for-postgresql/babelfish_extensions/blob/BABEL_1_0_0/CONTRIBUTING.md) on the Babelfish for PostgreSQL website. diff --git a/_installation/compiling-babelfish-from-source.md b/_installation/compiling-babelfish-from-source.md index 74e0c513..d42c36cf 100644 --- a/_installation/compiling-babelfish-from-source.md +++ b/_installation/compiling-babelfish-from-source.md @@ -116,7 +116,7 @@ make install # Installs the PostgreSQL default extensions To build the Babelfish extensions, you will need to install some additional tools: ##### Additional required tools -- [Antlr 4.9.2 Runtime](https://www.antlr.org/) +- [Antlr 4.9.3 Runtime](https://www.antlr.org/) - [Open Java 8](https://openjdk.java.net/) - Unzip - [pkgconf](http://pkgconf.org/) @@ -131,7 +131,8 @@ sudo apt install -y openjdk-8-jre unzip libutfcpp-dev cmake curl ##### Installing Antlr4 runtime -> There are no available binaries for for the Antlr4 4.9.2 runtime for C++, so you'll need to compile it from source. Versions below 4.9 have not been fully tested yet. +> For Antlr4 4.9.3 Runtime, there are no available binaries for C++ in Ubuntu Focal, so it's necessary to compile it from source. Versions below 4.9 have not been fully tested yet. + To install the Antlr4 runtime, you will use the Antlr4 .jar file. The Babelfish extensions source code includes the .jar file in `/contrib/babelfishpg_tsql/antlr/thirdparty/antlr`. @@ -139,32 +140,34 @@ the .jar file in `/contrib/babelfishpg_tsql/antlr/thirdparty/antlr`. You can install Antlr4 runtime by running the following commands: ``` sh -# Download the compressed Antlr4 Runtime sources on /opt/antlr4-cpp-runtime-4.9.2-source.zip -sudo curl https://www.antlr.org/download/antlr4-cpp-runtime-4.9.2-source.zip \ - --output /opt/antlr4-cpp-runtime-4.9.2-source.zip +# Dowloads the compressed Antlr4 Runtime sources on /opt/antlr4-cpp-runtime-4.9.3-source.zip +sudo curl https://www.antlr.org/download/antlr4-cpp-runtime-4.9.3-source.zip \ + --output /opt/antlr4-cpp-runtime-4.9.3-source.zip + # Uncompress the source into /opt/antlr4 -sudo unzip -d /opt/antlr4 /opt/antlr4-cpp-runtime-4.9.2-source.zip +sudo unzip -d /opt/antlr4 /opt/antlr4-cpp-runtime-4.9.3-source.zip sudo mkdir /opt/antlr4/build cd /opt/antlr4/build EXTENSIONS_SOURCE_CODE_PATH="" -# Generate the make files for the build -sudo cmake .. -DANTLR_JAR_LOCATION="$EXTENSIONS_SOURCE_CODE_PATH/contrib/babelfishpg_tsql/antlr/thirdparty/antlr/antlr-4.9.2-complete.jar" \ +# Generates the make files for the build +sudo cmake .. -DANTLR_JAR_LOCATION="$EXTENSIONS_SOURCE_CODE_PATH/contrib/babelfishpg_tsql/antlr/thirdparty/antlr/antlr-4.9.3-complete.jar" \ -DCMAKE_INSTALL_PREFIX=/usr/local -DWITH_DEMO=True # Compile and install sudo make sudo make install ``` -Now that you have installed the antlr4 runtime, you will need to copy the -`libantlr4-runtime.so.4.9.2` library into the Babelfish for PostgreSQL -engine libs folder. Use the following command: +Now that we have the antlr4 runtime installed, we need to copy the +`libantlr4-runtime.so.4.9.3` library into the installed Babelfish for PostgreSQL +engine libs folder. We can do that by running the following command: + ``` sh -sudo cp /usr/local/lib/libantlr4-runtime.so.4.9.2 "$INSTALLATION_PATH/lib" +sudo cp /usr/local/lib/libantlr4-runtime.so.4.9.3 "$INSTALLATION_PATH/lib" ```