Skip to content

Commit

Permalink
Bump version tag to BABEL_1_0_0 (#171)
Browse files Browse the repository at this point in the history
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 [email protected]
  • Loading branch information
3manuek authored Mar 10, 2022
1 parent 7139cbc commit 5b94a71
Show file tree
Hide file tree
Showing 4 changed files with 24 additions and 20 deletions.
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/documentation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion _data/repos.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
13 changes: 7 additions & 6 deletions _docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/).

Expand All @@ -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.
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.
27 changes: 15 additions & 12 deletions _installation/compiling-babelfish-from-source.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/)
Expand All @@ -131,40 +131,43 @@ 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`.

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="<the patch in which you downloaded the Babelfish extensions source code>"

# 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"
```


Expand Down

0 comments on commit 5b94a71

Please sign in to comment.