Use numeric port value in params and update postgres ssl configuration (#194)

* use number port value in params

* Update postgresql ssl parameters

Author: ewgenius

spiceaidocs/docs/data-accelerators/postgres/index.md

@@ -41,7 +41,7 @@ datasets:
       engine: postgres
       params:
         pg_host: localhost
-        pg_port: '5432'
+        pg_port: 5432
         pg_db: my_database
         pg_user: my_user
         pg_pass_key: my_secret
@@ -57,7 +57,7 @@ datasets:
     name: my_dataset
     params:
       pg_host: localhost
-      pg_port: '5432'
+      pg_port: 5432
       pg_db: data_store
       pg_user: my_user
       pg_pass_key: my_secret
@@ -66,7 +66,7 @@ datasets:
       engine_secret: pg_backend
       params:
         pg_host: localhost
-        pg_port: '5433'
+        pg_port: 5433
         pg_db: data_store
         pg_user: my_user
         pg_pass_key: my_secret

spiceaidocs/docs/data-connectors/mysql.md

@@ -39,7 +39,7 @@ datasets:
     name: my_dataset
     params:
       mysql_host: localhost
-      mysql_port: '3306'
+      mysql_port: 3306
       mysql_db: my_database
       mysql_user: my_user
       mysql_pass_key: my_secret

spiceaidocs/docs/data-connectors/postgres/index.md

@@ -25,10 +25,12 @@ The connection to PostgreSQL can be configured by providing the following `param
 - `pg_pass_key`: The secret key containing the password to connect with.
 - `pg_pass`: The raw password to connect with, ignored if `pg_pass_key` is provided.
 - `pg_sslmode`: Optional parameter, specifies the SSL/TLS behavior for the connection, supported values:
-  - `prefer`: (default) This mode will try to establish a secure SSL connection if possible, but will connect insecurely if the server does not support SSL.
-  - `required`: This mode requires an SSL connection. If a secure connection cannot be established, server will not connect.
+  - `verify-full`: (default) This mode requires an SSL connection, a valid root certificate, and the server host name to match the one specified in the certificate.
+  - `verify-ca`: This mode requires an SSL connection and a valid root certificate.
+  - `required`: This mode requires an SSL connection.
+  - `prefer`: This mode will try to establish a secure SSL connection if possible, but will connect insecurely if the server does not support SSL.
   - `disable`: This mode will not attempt to use an SSL connection, even if the server supports it.
-- `pg_insecure`: Optional parameter, Allows TLS connectivity to servers with invalid/expired certificates.
+- `pg_sslrootcert`: Optional parameter specifying the path to a custom PEM certificate that the connector will trust.
 
 Configuration `params` are provided either in the top level `dataset` for a dataset source and federated SQL query, or in the `acceleration` section for a data store.
 
@@ -38,12 +40,24 @@ datasets:
     name: my_dataset
     params:
       pg_host: localhost
-      pg_port: '5432'
+      pg_port: 5432
       pg_db: my_database
       pg_user: my_user
       pg_pass_key: my_secret
-      pg_sslmode: required
-      pg_insecure: 'true'
+```
+
+```yaml
+datasets:
+  - from: postgres:path.to.my_dataset
+    name: my_dataset
+    params:
+      pg_host: localhost
+      pg_port: 5432
+      pg_db: my_database
+      pg_user: my_user
+      pg_pass_key: my_secret
+      pg_sslmode: verify-ca
+      pg_sslrootcert: ./custom_cert.pem
 ```
 
 Additionally, an `engine_secret` may be provided when configuring a PostgreSQL data store to allow for using a different secret store to specify the password for a dataset using PostgreSQL as both the data source and data store.
@@ -54,7 +68,7 @@ datasets:
     name: my_dataset
     params:
       pg_host: localhost
-      pg_port: '5432'
+      pg_port: 5432
       pg_db: data_store
       pg_user: my_user
       pg_pass_key: my_secret
@@ -63,7 +77,7 @@ datasets:
       engine_secret: pg_backend
       params:
         pg_host: localhost
-        pg_port: '5433'
+        pg_port: 5433
         pg_db: data_store
         pg_user: my_user
         pg_pass_key: my_secret