connectivity/README.md

   1 # Database Connectivity
   2
   3 Contains database pieces, drivers, etc.
   4
   5 `dbaccess` builds UI on top of this.
   6
   7 ## Testing
   8 ### PostgreSQL
   9
  10 For testing, use:
  11
  12     podman pull postgres:latest
  13     podman run --name=postgres -e POSTGRES_PASSWORD=foobarbaz -p 127.0.0.1:5432:5432 postgres:latest
  14
  15 In Base, Connect to an existing database, select PostgreSQL:
  16
  17     URL: host=127.0.0.1 port=5432 dbname=postgres
  18     User: postgres
  19     Password: foobarbaz
  20
  21     podman stop postgres
  22     podman rm postgres
  23
  24 In order to test SCRAM authentication, create the container like this:
  25
  26     podman run --name=postgres -e POSTGRES_PASSWORD=foobarbaz -e POSTGRES_INITDB_ARGS=--auth-host=scram-sha-256 -e POSTGRES_HOST_AUTH_METHOD=scram-sha-256 -p 127.0.0.1:5432:5432 postgres:latest
  27
  28 ### MySQL
  29
  30 For mysql_test:
  31
  32 - The CppunitTest_mysql_test unit test can be used to test the mysqlc
  33 library with any versions of mysql or mariadb server of your choice.
  34
  35 - This test does not run automatically. It can be triggered with setting
  36 the environment variable "CONNECTIVITY_TEST_MYSQL_DRIVER".
  37
  38 - The environment variable should contain a URL of the following format:
  39 `[user]/[passwd]@sdbc:mysql:mysqlc:[host]:[port]/db_name`
  40
  41 - tl;dr:
  42
  43 ```
  44     podman pull mariadb/server
  45     podman run --name=mariadb -e MYSQL_ROOT_PASSWORD=foobarbaz -p 127.0.0.1:3306:3306 mariadb/server
  46     podman exec -it mariadb /bin/bash -c "echo -e CREATE DATABASE test | /usr/bin/mysql -u root"
  47     (cd connectivity && make -srj8 CppunitTest_connectivity_mysql_test CONNECTIVITY_TEST_MYSQL_DRIVER="root/foobarbaz@sdbc:mysql:mysqlc:127.0.0.1:3306/test")
  48     podman stop mariadb
  49     podman rm mariadb
  50 ```