From: Federico Caselli <cfederico87@gmail.com>
Date: Thu, 6 Jan 2022 11:32:55 +0000 (+0100)
Subject: Add oracle docker instructions to readme unittest
X-Git-Tag: rel_2_0_0b1~553^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a316caa098e7380beaee63a9f274366b3499d6dc;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

Add oracle docker instructions to readme unittest

Change-Id: I6538171b0fa73b25aeb2b1acaca4867cde56c537
---

diff --git a/README.unittests.rst b/README.unittests.rst
index 32b7446123..f30fb360d2 100644
--- a/README.unittests.rst
+++ b/README.unittests.rst
@@ -297,6 +297,27 @@ NOTE: with this configuration the url to use is not the default one configured
 in setup, but ``mssql+pymssql://scott:tiger^5HHH@127.0.0.1:1433/test``.  It can
 be used with pytest by using ``--db docker_mssql``.
 
+**Oracle configuration**::
+
+    # create the container with the proper configuration for sqlalchemy
+    docker run --rm --name oracle -p 127.0.0.1:1521:1521 -d -e ORACLE_PASSWORD=tiger -e ORACLE_DATABASE=test -e APP_USER=scott -e APP_USER_PASSWORD=tiger gvenzl/oracle-xe:21-slim
+
+    # enter the database container and run the command
+    docker exec -ti oracle bash
+    >> sqlplus system/tiger@//localhost/XEPDB1 <<EOF
+    CREATE USER test_schema IDENTIFIED BY tiger;
+    GRANT DBA TO SCOTT;
+    GRANT UNLIMITED TABLESPACE TO scott;
+    GRANT UNLIMITED TABLESPACE TO test_schema;
+    EOF
+
+    # To stop the container. It will also remove it.
+    docker stop oracle
+
+NOTE: with this configuration the url to use is
+``oracle+cx_oracle://scott:tiger@127.0.0.1:1521/?service_name=XEPDB1``.  It can
+be used with pytest by using ``--dburi oracle+cx_oracle://scott:tiger@127.0.0.1:1521/?service_name=XEPDB1``.
+
 CONFIGURING LOGGING
 -------------------
 SQLAlchemy logs its activity and debugging through Python's logging package.