Skip to content

Commit c6ca7f0

Browse files
authored
Merge pull request #792 from DeflateAwning/oracle-docs
Add Oracle development setup guide
2 parents 2e1d1e9 + 0543e18 commit c6ca7f0

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

docs/databases/oracle.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,3 +50,28 @@ cx.read_sql(conn, query) # read data from
5050
<p align="center"><img alt="memory chart" src="https://raw.githubusercontent.com/sfu-db/connector-x/main/assets/oracle-mem.png"/></p>
5151

5252
In conclusion, ConnectorX uses **3x** less memory and **3x** less time compared with Pandas.
53+
54+
### Development Setup
55+
56+
To load the database seed data into the database, you will need `sqlplus`.
57+
58+
Install it from Oracle's website's InstantClient page: https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html.
59+
60+
On Linux, this can be done by:
61+
62+
```bash
63+
wget https://download.oracle.com/otn_software/linux/instantclient/2370000/instantclient-sqlplus-linux.x64-23.7.0.25.01.zip
64+
unzip instantclient-sqlplus-linux.x64-23.7.0.25.01.zip
65+
mkdir /opt/oracle/instantclient_23_7/
66+
mv instantclient_23_7/*.so /opt/oracle/instantclient_23_7/
67+
mv instantclient_23_7/* /usr/bin/
68+
export LD_LIBRARY_PATH=/opt/oracle/instantclient_23_7:$LD_LIBRARY_PATH
69+
sqlplus -h
70+
```
71+
72+
Run the Oracle tests with:
73+
```bash
74+
cat scripts/oracle.sql | sqlplus $ORACLE_URL_SCRIPT
75+
76+
cargo test --features all --test test_oracle -- --ignored
77+
```

0 commit comments

Comments
 (0)