connectivity/README.md

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