Skip to content

Latest commit

 

History

History

oci-serviceconnector-streaming-json-to-parquet-python

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
images
images
 
 
README.md
README.md
 
 
func.py
func.py
 
 
func.yaml
func.yaml
 
 
requirements.txt
requirements.txt
 
 
test.json
test.json
 
 

README.md

Convert JSON to Parquet

This is a sample to convert JSON to Parquet format using Service Connector Hub, Functions and Object Storage.

As you make your way through this tutorial, look out for this icon user input icon. Whenever you see it, it's time for you to perform an action.

Prerequisites

Before you deploy this sample function, make sure you have run steps A, B and C of the Oracle Functions Quick Start Guide for Cloud Shell

  • A - Set up your tenancy
  • B - Create application
  • C - Set up your Cloud Shell dev environment

List Applications

Assuming you have successfully completed the prerequisites, you should see your application in the list of applications.

fn ls apps

Create or Update your Dynamic Group

In order to use other OCI Services, your function must be part of a dynamic group. For information on how to create a dynamic group, refer to the documentation.

When specifying the Matching Rules, we suggest matching all functions in a compartment with:

ALL {resource.type = 'fnfunc', resource.compartment.id = 'ocid1.compartment.oc1..aaaaaxxxxx'}

Create or Update IAM Policies

Create a new policy that allows the dynamic group to manage objects in the functions related compartment.

user input icon

Your policy should look something like this:

Allow dynamic-group <dynamic-group-name> to manage objects in compartment <compartment-name>

For more information on how to create policies, go here.

Review and customize the function

Review the following files in the current folder:

Provide the values for BUCKET_NAME, FILE_NAME and NAME_SPACE in the func.yaml file.

Deploy the function

In Cloud Shell, run the fn deploy command to build this function and its dependencies as a Docker image, push the image to the specified Docker registry, and deploy this function to Oracle Functions in the application created earlier:

user input icon

fn -v deploy --app <app-name>

e.g.,

fn -v deploy --app myapp

Test

In Cloud Shell, run the fn invoke ccommand to unit test this function:

user input icon

fn invoke <app-name> <function-name> < test.json

e.g.,

fn invoke myapp oci-sch-stream-json-to-parquet-python < test.json

You should see the file in your Object Storage bucket.

Create a Service Connector for reading Streaming and send to Functions

  1. From the navigation menu, select Logging, and then select Service Connectors.

  2. Click Create Connector, add a Name, Description, select the compartment, select the Source as Streaming and Target as Functions.

  3. On Configure Source connection, select the compartment, select the your OCI Stream.

  4. On Configure Target connection, select the compartment and select the Function. If prompted to create a policy for writing to functions, click Create.

Monitoring Functions and Service Connector

Make sure you configure basic observability for your function and connector using metrics, alarms and email alerts: