Skip to content

Commit

Permalink
Migrate Oracle dialect to its own repository (#439)
Browse files Browse the repository at this point in the history
* #438: Migrate Oracle dialect to its own repository
  • Loading branch information
chiaradiamarcelo committed Jan 12, 2021
1 parent 6177d98 commit 4e5adc4
Show file tree
Hide file tree
Showing 43 changed files with 43 additions and 3,115 deletions.
2 changes: 0 additions & 2 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,6 @@ dependency-reduced-pom.xml

# Integration tests
src/test/resources/integration/driver/hive/*.jar
src/test/resources/integration/driver/oracle/*.jar
src/test/resources/integration/driver/oracle/*.zip

# Others
.DS_Store
Expand Down
4 changes: 1 addition & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,7 +140,6 @@ Running the Virtual Schema requires a Java Runtime version 9 or later.
| [JUnit](https://junit.org/junit5) | Unit testing framework | Eclipse Public License 1.0 |
| [Mockito](http://site.mockito.org/) | Mocking framework | MIT License |
| [Microsoft JDBC Driver for SQL Server][sql-server-jdbc-driver] | JDBC driver for SQL Server database | MIT License |
| [Oracle JDBC Driver][oracle-jdbc-driver] | JDBC driver for Oracle database | Oracle Technology Network License|
| [Testcontainers](https://www.testcontainers.org/) | Container-based integration tests | MIT License |
| [Test Database Builder][test-bd-builder] | Fluent database interfaces for testing | MIT License |

Expand All @@ -166,7 +165,6 @@ Running the Virtual Schema requires a Java Runtime version 9 or later.
[hbase-server]: http://hbase.apache.org/
[hive-jdbc-driver]: https://github.com/apache/hive/tree/master/jdbc/src/java/org/apache/hive/jdbc
[maven-enforcer-plugin]: http://maven.apache.org/enforcer/maven-enforcer-plugin/
[oracle-jdbc-driver]: https://www.oracle.com/database/technologies/appdev/jdbc.html
[sql-server-jdbc-driver]: https://github.com/microsoft/mssql-jdbc
[sonatype-oss-index-maven-plugin]: https://sonatype.github.io/ossindex-maven/maven-plugin/
[test-bd-builder]: https://github.com/exasol/test-db-builder-java
Expand All @@ -180,7 +178,7 @@ Running the Virtual Schema requires a Java Runtime version 9 or later.
[hive-dialect-doc]: doc/dialects/hive.md
[impala-dialect-doc]: doc/dialects/impala.md
[mysql-dialect-doc]: https://github.com/exasol/mysql-virtual-schema/blob/main/doc/user_guide/mysql_user_guide.md
[oracle-dialect-doc]: doc/dialects/oracle.md
[oracle-dialect-doc]: https://github.com/exasol/oracle-virtual-schema/blob/main/doc/user_guide/oracle_user_guide.md
[postgresql-dialect-doc]: https://github.com/exasol/postgresql-virtual-schema/blob/main/doc/dialects/postgresql.md
[redshift-dialect-doc]: doc/dialects/redshift.md
[sap-hana-dialect-doc]: doc/dialects/saphana.md
Expand Down
1 change: 1 addition & 0 deletions doc/changes/changelog.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
# Changes

* [6.0.0](changes_6.0.0.md)
* [5.0.0](changes_5.0.0.md)
* [4.0.5](changes_4.0.5.md)
* [4.0.4](changes_4.0.4.md)
Expand Down
17 changes: 17 additions & 0 deletions doc/changes/changes_6.0.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# Exasol Virtual Schemas 6.0.0, released 2021-XX-XX

Code name: Migrated Oracle dialect implementation to its own repository.

## Summary

Please we aware you can not create Oracle Virtual Schemas using this JAR anymore.
Oracle dialect implementation has been migrated to https://github.com/exasol/oracle-virtual-schema.

## Refactoring

* #438: Removed Oracle dialect implementation as it has been migrated to https://github.com/exasol/mysql-virtual-schema.

## Dependency updates

* Removed `org.testcontainers:oracle-xe:1.15.0`
* Removed `com.oracle.ojdbc:ojdbc8:19.3.0.0`
Original file line number Diff line number Diff line change
Expand Up @@ -79,18 +79,15 @@ Therefore we cannot include some jdbc drivers to the projects and you need to do
List of disabled integration tests:

* HiveSqlDialectIT
* OracleSqlDialectIT

### Starting Disabled Integration Test Locally

1. Download a JDBC driver and other necessary files:
- Hive [`HiveJDBC41.jar`](https://www.cloudera.com/downloads/connectors/hive/jdbc/2-5-4.html)
- Oracle [`ojdbc8.jar`](https://www.oracle.com/database/technologies/appdev/jdbc-ucp-19c-downloads.html) and oracle instant client [`instantclient-basic-linux.x64-12.1.0.2.0.zip`](https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html). Please be aware that Exasol currently supports only mentioned version of the Oracle instant client.
2. Temporarily put the files into `src/test/resources/integration/driver/<dialect lowercase name>` directory. Existing dialect directories: `hive`, `oracle`.
1. Download the [Hive JDBC driver `HiveJDBC41.jar`](https://www.cloudera.com/downloads/connectors/hive/jdbc/2-5-4.html)
2. Temporarily put the driver into `src/test/resources/integration/driver/hive` directory.

3. If the files' names are different (you renamed the file, or it has a different version number, for example) from the mentioned above, edit `src/test/resources/integration/driver/<dialect lowercase name>/<dialect lowercase name>.properties` and `settings.cfg` files.
3. If the files' names are different (you renamed the file, or it has a different version number, for example) from the mentioned above, edit `src/test/resources/integration/driver/hive/hive.properties` and `settings.cfg` files.
4. Run the tests from an IDE or temporarily add the integration test name into the `maven-failsafe-plugin`'s includes a section and execute `mvn verify` command.
5. Remove the driver after the test. Do not upload it to the GitHub repository.
5. Remove the driver after the test and **do not upload it to the GitHub repository**.

## See also

Expand Down
2 changes: 1 addition & 1 deletion doc/dialects/athena.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ The SQL statement below creates the adapter script, defines the Java class that
```sql
CREATE OR REPLACE JAVA ADAPTER SCRIPT ADAPTER.JDBC_ADAPTER AS
%scriptclass com.exasol.adapter.RequestDispatcher;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-5.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-6.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/AthenaJDBC42-<JDBC driver version>.jar;
/
;
Expand Down
2 changes: 1 addition & 1 deletion doc/dialects/aurora.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ The SQL statement below creates the adapter script, defines the Java class that
```sql
CREATE OR REPLACE JAVA ADAPTER SCRIPT ADAPTER.JDBC_ADAPTER AS
%scriptclass com.exasol.adapter.RequestDispatcher;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-5.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-6.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/postgresql-<JDBC driver version>.jar;
/
```
Expand Down
2 changes: 1 addition & 1 deletion doc/dialects/bigquery.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ List all the JAR files from Magnitude Simba JDBC driver.
```sql
CREATE JAVA ADAPTER SCRIPT SCHEMA_FOR_VS_SCRIPT.ADAPTER_SCRIPT_BIGQUERY AS
%scriptclass com.exasol.adapter.RequestDispatcher;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-5.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-6.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/GoogleBigQueryJDBC42.jar;
...
...
Expand Down
4 changes: 2 additions & 2 deletions doc/dialects/db2.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ The SQL statement below creates the adapter script, defines the Java class that
```sql
CREATE OR REPLACE JAVA ADAPTER SCRIPT ADAPTER.JDBC_ADAPTER AS
%scriptclass com.exasol.adapter.RequestDispatcher;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-5.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-6.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/db2jcc4.jar;
%jar /buckets/<BFS service>/<bucket>/db2jcc_license_cu.jar;
/
Expand All @@ -68,7 +68,7 @@ CREATE OR REPLACE JAVA ADAPTER SCRIPT ADAPTER.JDBC_ADAPTER AS
```sql
CREATE OR REPLACE JAVA ADAPTER SCRIPT ADAPTER.JDBC_ADAPTER AS
%scriptclass com.exasol.adapter.RequestDispatcher;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-5.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-6.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/db2jcc4.jar;
%jar /buckets/<BFS service>/<bucket>/db2jcc_license_cu.jar;
%jar /buckets/<BFS service>/<bucket>/db2jcc_license_cisuz.jar;
Expand Down
4 changes: 2 additions & 2 deletions doc/dialects/hive.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ The SQL statement below creates the adapter script, defines the Java class that
```sql
CREATE OR REPLACE JAVA ADAPTER SCRIPT ADAPTER.JDBC_ADAPTER AS
%scriptclass com.exasol.adapter.RequestDispatcher;
%jar /buckets/<BFS service>/<bucket>/jars/virtual-schema-dist-8.0.0-bundle-5.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/jars/virtual-schema-dist-8.0.0-bundle-6.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/jars/HiveJDBC41.jar;
/
```
Expand Down Expand Up @@ -302,7 +302,7 @@ In Virtual Schema adapter:
CREATE OR REPLACE JAVA ADAPTER SCRIPT ADAPTER.JDBC_ADAPTER AS
%jvmoption -Dsun.security.krb5.disableReferrals=true;
%scriptclass com.exasol.adapter.RequestDispatcher;
%jar /buckets/<BFS service>/<bucket>/jars/virtual-schema-dist-8.0.0-bundle-5.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/jars/virtual-schema-dist-8.0.0-bundle-6.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/jars/HiveJDBC41.jar;
/
```
Expand Down
2 changes: 1 addition & 1 deletion doc/dialects/impala.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ The SQL statement below creates the adapter script, defines the Java class that
```sql
CREATE OR REPLACE JAVA ADAPTER SCRIPT ADAPTER.JDBC_ADAPTER AS
%scriptclass com.exasol.adapter.RequestDispatcher;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-5.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/virtual-schema-dist-8.0.0-bundle-6.0.0.jar;
%jar /buckets/<BFS service>/<bucket>/ImpalaJDBC41.jar;
/
;
Expand Down

0 comments on commit 4e5adc4

Please sign in to comment.