Prerequisites

(warning) Request the databaseConfig.json file for your meshlet by contacting Perspectium Support.

(warning) Database and Schema will not be created by the meshlet and are expected to be supplied on use.

(warning) You will need to install the Perspectium Core update set in your ServiceNow instance. You can request a download link for this update set by contacting Perspectium Support.

(warning) Have the following information available: 

  1. Amazon Redshift cluster and database JDBC URL 

  2. AWS username and password 

  3. Amazon role ARN 

    DataSync for Redshift uses role-based access control in order to bulk load records from Amazon S3 to Amazon Redshift. 
    The Redshift cluster must have an IAM role attached in order to access Amazon S3. The role must have permissions to LIST and GET objects from the Amazon S3 bucket being used. The IAM role ARN, or Amazon Resource Name, is a required directive to leverage the COPY command. 

    For more information, see AWS credentials and access permissions.


  4. AWS S3 Bucket access key, secret key, bucket name and region


The meshlet uses the Amazon Redshift COPY command to bulk load data into Redshift. Temporary files are stored in an Amazon S3 Bucket before the data is pushed into Redshift.



Procedure

To set up a DataSync for Redshift integration, follow these steps:



Create or obtain a queue 

A shared queue should have been created by Perspectium Support upon initial configuration of your ServiceNow instance. 

Otherwise, follow Create a ServiceNow shared queue to create a queue that points to your Redshift. 


Create a ServiceNow bulk/dynamic share for Redshift

  1. In ServiceNow's left side navigation window, navigate to Perspectium > Perspectium Core > Shares or simply type and then click on Shares. Then, go to Bulk Share > Create a new bulk share.

  2. In the Name field, type any name for your bulk share. 

  3. Click the dropdown next to Table. Then, search for and choose the table whose data you want to bulk share out.

  4. Click the search icon next to the Target queue field. In the Queues popup, choose the shared queue you created or obtained in the Create or obtain a queue step. 

  5. Choose a method to encrypt the data that will be shared out from the Encryption Method dropdown. (info) NOTE: You will need to specify the encryption method in the YAML file. 

  6. In the Data Enrichment tab, click the search icon next to Table map. From the resulting list, select the table map you want to add. See ServiceNow Table Maps for more information.

  7. Click Submit.  

For any additional information on setting up your bulk share, see Create a ServiceNow bulk share. 


  1. In ServiceNow's left side navigation window, navigate to Perspectium > Perspectium Core > Shares or simply type and then click on Shares. Then, go to Dynamic Share > Create a new dynamic share.

  2. Select Business Rule or Flow Designer and click the Submit button.

  3. Check the Active box to activate your dynamic share and start sharing out record data dynamically.

  4. Click the dropdown next to Table. Then, search for and choose the table whose data you want to dynamic share out.

  5. Click the search icon next to the Target queue field. In the Queues popup, choose the shared queue you created or obtained in the Create or obtain a queue step. 

  6. Choose a method to encrypt the data that will be shared out from the Encryption Method dropdown. (info) NOTE: You will need to specify the encryption method in the YAML file. 

  7. In the Data Enrichment tab, click the search icon next to Table map. From the resulting list, select the table map you want to add. See ServiceNow Table Maps for more information.

  8. Click Submit.  

For any additional information on setting up your bulk share, see Create a ServiceNow dynamic share.



Install and Run the Redshift Meshlet as a Service

Follow the link above to install and run the Redshift meshlet. For additional information on the directives in the YML file, see Meshlet Configurations for Redshift.