Merge pull request #1186 from oracle-devrel/open_source_bp_2

oac * postgresql

Author: sylwesterdec

data-platform/open-source-data-platforms/oci-postgresql/README.md

@@ -24,6 +24,12 @@ OCI Database with PostgreSQL is designed for high availability by offering durab
 - [Terraform to deploy OCI PostgreSQL database](https://blogs.oracle.com/cloud-infrastructure/post/deploy-managed-oci-database-with-postgresql-service-with-terraform)
 - [Backup and Restore an OCI Database with PostgreSQL](https://docs.oracle.com/en/learn/backup-and-restore-db-with-postgresql/index.html#introduction)
 
+# Reusable Assets
+
+- [Create a connection between OCI PostgreSQL and Oracle Analytics Cloud](https://github.com/oracle-devrel/technology-engineering/tree/main/data-platform/open-source-data-platforms/oci-postgresql/code-examples/connect-to-oac)
+When you are looking to establish an OCI PostgreSQL instance, connect to it, and connect to Oracle Analytics Cloud, use these steps to guide you. The steps include using DBeaver to create a new table and load data, create an OCI PostgreSQL instance, connect to it, and connect the instance as source to Oracle Analytics Cloud.
+
+
 # License
 
 Copyright (c) 2024 Oracle and/or its affiliates.

data-platform/open-source-data-platforms/oci-postgresql/code-examples/connect-to-oac/LICENSE

@@ -0,0 +1,35 @@
+Copyright (c) 2024 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data-platform/open-source-data-platforms/oci-postgresql/code-examples/connect-to-oac/README.md

@@ -0,0 +1,26 @@
+# Connect OCI PostgreSQL to Oracle Analytics Cloud
+
+Reviewed: 29.07.2024
+
+# When to use this asset?
+
+When you are looking to establish an OCI PostgreSQL instance, connect to it, and connect to Oracle Analytics Cloud
+
+# How to use this asset?
+
+Open the connect-to-oac.md file and follow the steps carefully.
+
+# Pre-requisites:
+
+- Create a VCN with public and private subnet
+- Create an OCI PostgreSQL database instance in the private subnet
+- Create a Linux instance in public subnet, same VCN
+- Add port 5432 to the private subnet security list
+
+# License
+
+Copyright (c) 2024 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

data-platform/open-source-data-platforms/oci-postgresql/code-examples/connect-to-oac/files/connect-to-oac.md

@@ -0,0 +1,80 @@
+# Connect to OCI PostgreSQL, load data using DBeaver and connect to Oracle Analytics Cloud
+
+Prerequisites
+- Create a VCN with public and private subnet
+- Create an OCI PostgreSQL database instance in the private subnet
+- Create a Linux instance in public subnet, same VCN
+- Add port 5432 to the private subnet security list
+
+ For more details on using Linux instance to connect to PostgreSQL, [see documentation here](https://www.postgresql.org/download/linux/redhat/).
+
+# Create and access an OCI PostgreSQL database
+
+1. SSH into the Linux instance, make sure the instance is in the public subnet of the same VCN you provisioned the OCI PostgreSQL instance. Run the below command. This will install the client for PostgreSQL version 14. 
+```
+sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm
+sudo dnf -qy module disable postgresql
+sudo dnf install -y postgresql14-server
+sudo /usr/pgsql-14/bin/postgresql-14-setup initdb
+sudo systemctl enable postgresql-14
+sudo systemctl start postgresql-14
+```
+
+2. Following, run the below command.
+```rm -rf ~/.pgpass```
+
+3. Go to your OCI PostgreSQL overview page, click on **Copy** in the CA Certificate or download the certificate. Run the below command in the terminal.
+```
+sudo nano ./dbsystem.pub
+```
+
+4. Copy and paste the full certificate int he dbsystem.pub file. Save and close the file.
+
+5. Test the connection using the following command. Change the private IP and user name.
+```psql -h [DB Private IP] -U [user name] -d postgres```
+
+Example of statement: *psql -h 10.0.1.81 -U admin -d postgres*
+
+6. Run the below statement as test to review the connection.
+```select version();```
+
+7. Connect as user. Change the below command and run in the terminal.
+```psql "sslmode=verify-full sslrootcert=./dbsystem.pub host=<endpoint_fqdn> hostaddr=[DB private IP] dbname=postgres user=<user_name>"```
+
+Example of fulll statement: *psql "sslmode=verify-full sslrootcert=./dbsystem.pub host=e43jihot7lyhlnh6kat3io357iy43a-primary.postgresql.us-ashburn-1.oc1.oraclecloud.com hostaddr=10.0.1.81 dbname=postgres user=admin"*
+
+8. Run something as test the connection is working.
+```select version();```
+
+
+# Connect using DBeaver
+
+9. Install DBeaver locally
+
+10. Add the credentials to connect to the OCI PostgreSQL. See the screenshots. DBeaver will use the same instance in the public subnet (using SSH) to be able to access the OCI PostgreSQL database.
+
+  ![1](images/img_1.png)
+  ![2](images/img_2.png)
+
+11. Create a new table and load some data using DBeaver. See an example of loading .csv file [here](https://dbeaver.com/docs/dbeaver/Data-transfer/).
+
+
+# Connect using Oracle Analytis Cloud (OAC).
+
+12. Create on OAC instance. See documentation here to [create an OAC instance](https://docs.oracle.com/en/cloud/paas/analytics-cloud/acoci/create-services.html#ACOCI-GUID-47022452-65CC-4345-8F7F-A447BB24A48A).
+
+13. Create a new Private Zone in DNS management. See the below screen or review the [documentation](https://docs.oracle.com/en-us/iaas/Content/DNS/Tasks/privatedns.htm#:~:text=Use%20private%20DNS%20to%20create,premises%20or%20other%20private%20networks.).
+
+14. Add a new record in the new private zone, pointing to the private ip/endpoint of the OCI PostgreSQL database instance.
+
+  ![4](images/img_4.png)
+  ![3](images/img_3.png)
+
+15. Create a PAC for the OAC instance. Use the zone just created (not the record). Select the private subnet. Review the steps in this [documentation](https://blogs.oracle.com/analytics/post/create-a-private-access-channel-in-oracle-analytics).
+
+  ![5](images/img_5.png)
+
+16. Open OAC and create the connection to the OCI PostgreSQL instance. Add the correct details: use the just created private zone and record as host. Add the correct username and password.
+  
+  ![5](images/img_6.png)
+  ![6](images/img_7.png)